LIVE-BUILD(1) Live Systems Project LIVE-BUILD(1)

NAME

live-build - Live System Build Components

SYNOPSIS

lb binary-hooks [--verbose] lb binary-hooks [--help] lb binary-hooks [--version]

DESCRIPTION

live-build contains the components to build a live system from a con‐ figuration directory. The lb binary-hooks command executes hook files after the binary stage.

SPECIFICATION

lb binary-hooks executes any hook files found in the config/hooks directory within the configuration directory. Hook files do not require to have a specific owner nor specific permis‐ sions. They are marked executable by lb binary-hooks automatically when they are executed. Hook files must either have the suffix *.hook or *.hook.binary. Hook files with the suffix *.hook are executed first, hook files with the suffix *.hook.binary are executed second. Hook files are executed in alphanumberical order by lb binary-hooks. If one hook file depends on being run after another, best practise is to use number prefixes (nnnn, starting with 0001) to ensure the order of execution. Hook files are copied into the binary/live-build directory by lb binary-hooks. They are executed from within the binary directory and can read the configuration directory in live-build/config within the binary directory. Warning: hook files are not executed within a chroot but within the context of the host system in the binary directory. They have root privileges and access to the all host system resources (devices, filesystems, network, etc.).

OPTIONS

--verbose sets verbose option (default: False). -h, --help show help message and exit. --version show program's version number and exit.

FILES

config/hooks/*.hook: generic hook files. config/hooks/*.hook.binary: hook files specific for the binary stage. binary: directory in which the hook files are executed. binary/live-build/config: bind mounted configuration directory within the binary directory to be read by hook files. binary/live-build: directory in which hook files are copied.

SEE ALSO

lb-bootstrap-hooks(1) lb-chroot-hooks(1) lb-source-hooks(1)

HOMEPAGE

More information about live-build and the Live Systems project can be found on the homepage at <http://live-systems.org/> and in the manual at <http://live-systems.org/manual/>.

BUGS

Bugs can be reported by submitting a bugreport for the live-build pack‐ age in the Bug Tracking System at <http://bugs.debian.org/> or by writ‐ ing a mail to the Live Systems mailing list at <debian-live@lists.debian.org>.

AUTHOR

live-build was written by Daniel Baumann <mail@daniel-baumann.ch>. 4.0~alpha33-1 2014-03-31 LIVE-BUILD(1)