The kaarpux/master directory

The kaarpux/master directory contains all the files needed to build KaarPux (except the source tar-balls for each package).

Files

kaarpux/master/default_definitions.shinc
Shell include script containing definitions for building KaarPux. Do not edit this file. Override the settings by editing kaarpux/custom_definitions.shinc instead.
kaarpux/master/make_dist.sh
Archive the kaarpux/master files into kaarpux/dist/kaarpux.tar.gz. The archive file can be copied to (e.g. using ssh) the target system and unpacked there.
kaarpux/master/make_doc.sh
Make documentation. Processes kaarpux/master/doc and produces kaarpux/doc
kaarpux/master/make_kxbuild_user.sh
Create a new unix user called kxbuild. The user is configured so it can correctly bootstrap KaarPux.
kaarpux/master/make_scripts.sh
Create and populate kaarpux/bootstrap and kaarpux/linux.
kaarpux/master/master.yaml
Defines the whole build sequence. Processed by kaarpux/master/perl/make_build_scripts.pl, which may be consulted to see what each YAML node does.

Directories

kaarpux/master/chroot_scripts
Scripts which are used in the chroot during bootstrap. Copied to kaarpux/bootstrap/chroot_scripts by kaarpux/master/make_scripts.sh.
kaarpux/master/doc
Source files for KaarPux DocBook documentation.
kaarpux/master/files
Files which are copied to the target system by kaarpux/bootstrap/chroot_scripts/install_files.sh. Some of the files will be preprocessed by sed to replace occurances of the form @KX_*@ with the definitions from kaarpux/master/default_definitions.shinc and kaarpux/custom_definitions.shinc.
kaarpux/master/host_files
Files which are useful when referenced from the host system.
kaarpux/master/host_scripts
Scripts which are used on the host system during bootstrap. Copied to kaarpux/bootstrap/host_scripts by kaarpux/master/make_scripts.sh.
kaarpux/master/linux_scripts
Scripts which are used when building on the KaarPux target system. Copied to kaarpux/linux/linux_scripts by kaarpux/master/make_scripts.sh.
kaarpux/master/packages
Has one subdirectory per letter in the alphabet. Each subdirectory contains the packages starting with that letter. kaarpux/master/packages/[a-z]/*.yaml contains the definitions needed to build the package; kaarpux/master/packages/[a-z]/*.files contains any needed auxilliary files, such as patches or init scripts.
kaarpux/master/perl
perl scripts used by kaarpux/master/make_scripts.sh.
kaarpux/master/shinc
Files included by shell scripts.
kaarpux/master/tools
Stand-alone tools.