LeSpocky / ptxdist

Personal fork of PTXdist by @pengutronix
https://www.ptxdist.org/
Other
4 stars 0 forks source link
linux

PTXdist

Installation

To install PTXdist, just run

./configure --prefix=<installpath>

to configure the packet, then

make

to build everything and

make install

to install it. When you start using PTXdist, make sure your $PATH environment variable points to /bin, because that's where the PTXdist frontend program is being installed to.

For developers who want to work with git versions of PTXdist it is only necessary to run "./autogen.sh && ./configure && make" and set the PATH variable to the bin/ directory inside the PTXdist tree.

Idea

PTXdist is a build system which can be used to generate a root tree and disk images for all kinds of Linux systems. It was written with embedded systems in mind, but there is no reason why you can't use it to configure your firewall, router or whatever dedicated "device" comes to your mind.

The job works like this: you run 'ptxdist menuconfig' and 'ptxdist platformconfig', configure what you need. Run 'ptxdist images' and you'll find a root tree in ./platform-/root/, and disk images in ./platform-/images/. Voilà.

All magic necessary to do these things in a cross enviroment are written into "recipes", living in rules/.make, and config menues in rules/.in.

Contributing

See doc/contributing.rst for the contribution guidelines.

Documentation

See https://www.ptxdist.org/doc/ for the full documentation, which includes a quickstart guide as well as a reference for users and developers. You can also find the documentation in reStructuredText form in the doc/ directory inside this PTXdist tree, which you can build into HTML with

./bin/ptxdist docs-html

The generated HTML documents will be created in Documentation/html/.

Bugs