diff options
Diffstat (limited to 'make-live.8')
-rw-r--r-- | make-live.8 | 188 |
1 files changed, 188 insertions, 0 deletions
diff --git a/make-live.8 b/make-live.8 new file mode 100644 index 000000000..70e499dff --- /dev/null +++ b/make-live.8 @@ -0,0 +1,188 @@ +.TH MAKE-LIVE 8 "Jul, 27 2006" "0.99" "Debian Live framework" + +.SH NAME +make-live \- An utility for building Debian Live systems. + +.SH SYNOPSIS +.B make-live +.RB [\| \-a \||\| \-\-architecture +.IR ARCHITECTURE \|] +.RB [\| \-c \||\| \-\-conffile +.IR FILE \|] +.RB [\| \-\-clone +.IR DIRECTORY \|] +.RB [\| \-d \||\| \-\-distribution +.IR DISTRIBUTION \|] +.BR [\| \-\-debug \|] +.RB [\| \-f \||\| \-\-filesystem +.IR FILESYSTEM \|] +.RB [\| \-\-flavour +.IR FLAVOUR \|] +.RB [\| \-\-hook +.RI \|" COMMAND .\|.\|.\|"\|] +.RB [\| \-\-include\-image +.IR FILE \||\| DIRECTORY \|] +.RB [\| \-\-include\-rootfs +.IR FILE \||\| DIRECTORY \|] +.RB [\| \-\-linux\-image +.IR FLAVOUR \|] +.RB [\| \-\-logfile +.IR FILE \|] +.RB [\| \-p \||\| \-\-package-list +.IR FILE \|] +.RB [\| \-\-preseed +.IR FILE \|] +.RB [\| \-\-rootfs +.IR DIRECTORY \|] +.RB [\| \-s \||\| \-\-section +.RI \|" SECTION \|.\|.\|.\|"\|] +.RB [\| \-\-splashy +.RI [\| THEME \|]\|] +.RB [\| \-t \||\| \-\-type +.IR TYPE \|] +.RB [\| \-\-templates +.IR DIRECTORY \|] +.RB [\| \-\-verbose \|] +.RI [\| LIST \|] +.PP +.B make-live +.RB [\| \-h \||\| \-\-help \|] +.br +.B make-live +.RB [\| \-u \||\| \-\-usage \|] +.br +.B make-live +.RB [\| \-v \||\| \-\-version \|] + +.SH DESCRIPTION +The Debian Live framework lets you automagically create live system images. +.PP + +.SH OPTIONS +.TP +.BI "\-a, \-\-architecture " ARCHITECTURE +Build an image for another architecture than the autodetected one. This is +usefull for e.g. building i386 images on an amd64 machine. Instead of this flag, +the environment variable LIVE_ARCHITECTURE can be used. +.TP +.BI "\-c, \-\-conffile " FILE +Uses another configuration file in addition to the default one, if existing, in +/etc/make-live.conf. Settings in the additional configuration file do overwrite +the settings from /etc/make-live.conf. Instead of this flag, the environment +varibale LIVE_CONFFILE can be used. +.TP +.BI "\-\-clone " DIRECTORY +Clones the package selection and configuration from a given root directory. It +will output the settings to $LIVE_ROOT/preseed.cloned and $LIVE_ROOT/plist.clone +for easy reuse with \-\-preseed and \-\-package-list. Instead of this flag, the +environment variable LIVE_CLONE can be used. +.TP +.BI "\-d, \-\-distribution " DISTRIBUTION +Specifies the distribution to be used. Allowed values are all Debian +distributions (oldstable, stable, testing, unstable), although only unstable +(default) is possible for now. Instead of this flag, the environment variable +LIVE_DISTRIBUTION can be used. +.TP +.B \-\-debug +Enables debut output of make-live itself (this includes \-\-verbose too). +Instead of this environment variable, LIVE_DEBUG can be used. +.TP +.BI "\-f, \-\-filesystem " FILESYSTEM +Specifies the filesystem for the compressed image. At the moment, only squashfs +(default) and ext2 are allowed values. Instead of this flag, the environment +variable LIVE_FILESYSTEM can be used. +.TP +.BI "\-\-flavour " FLAVOUR +Specifies the bootstrap flavour. This can be either standard (default) or +minimal. Instead of this flag, the environment variable LIVE_FLAVOUR can be +used. +.TP +.\" FIXME +.BI "\-\-hook " COMMAND "\|.\|.\|.\|" +Specifies a command which will be executed at the end of the chroot setup and +before the mastering of the image. Instead of this flag, the environment +variable LIVE_HOOK can be used. +.TP +.BI "\-\-include\-image " FILE \||\| DIRECTORY +specifies a file or directory which will be copied inside the image. Can be also +set through LIVE_INCLUDE_IMAGE environment variable. +.TP +.BI "\-\-include\-rootfs " FILE \||\| DIRECTORY +specifies a file or directory which will be copied inside the root filesystem of +the image. Can be also set through the LIVE_INCLUDE_ROOTFS environment variable. +.TP +.BI "\-\-linux\-image " FLAVOUR +.TP +.BI "\-p, \-\-package-list " FILE +specifies a package list file, one package for each line. It overrides list option. +.TP +.BI "\-\-logfile " FILE +specifies the location of the logfile. It can be set through LIVE_LOGFILE, +default is \$LIVE_ROOT/make-live.log +.TP +.BI "\-\-preseed " FILE +clone the packages selection and configuration from the provided +root directory. +.TP +.BI "\-\-rootfs " DIRECTORY +skip all phases of rootfs generation and just install casper and the +kernel in the specified root directory (must be a debian). +.TP +.BI "\-s, \-\-section " SECTION "\|.\|.\|.\|" +specifies which sections are going to be availble for the package selection inside the chroot (Default: main). Can be set to every combination of "main contrib non-free", also through LIVE_SECTIONS. +.TP +.BI "\-\-splashy [\|" THEME \|] +specifies that splashy should be installed and included in initamfs, an optional +official THEME could be selected or an exernal theme could be installed, in the +second case the .tar.gz theme should be passed without extension and must be in +the current directory. Can be also set through LIVE_SPLASHY and +LIVE_SPLASHY_THEME environment variables. +.TP +.BI "\-t, \-\-type " TYPE +specifies the image type to generate. Currently, only iso and net are available. +.TP +.BI "\-\-templates " DIRECTORY +specifies a templates directory to use instead of the default one. +.TP +.B \-\-verbose +providing debug information for third-party tools. +.TP +.B \-h, \-\-help +display this help and exit. +.TP +.B \-u, \-\-usage +show usage and exit. +.TP +.B \-v, \-\-version +output version information and exit. + +.SH LISTS +Every list does already include the Debian standard package selection. +.TP +.B gnome | gnome-core | gnome-full +include GNOME. +.TP +.B kde | kde-core | kde-full | kde-extra +include KDE. +.TP +.B x11 | x11-core +include X-Window-System only. +.TP +.B xfce +include Xfce. + +.SH BUGS +.B make-live +works fully on amd64 and i386, partially on alpha, hppa, ia64, mips, mipsel, +powerpc, s390 and sparc. Other architectures, such as arm and m68k, as well as +non-linux ports of Debian, like hurd-i386, are currently not supported. + +.SH HOMEPAGE +Debian Live project <http://live.debian.net/> + +.SH SEE ALSO +.BR make-live.conf (8). + +.SH AUTHOR +make-live was written by Daniel Baumann <daniel@debian.org> and Marco Amadori +<marco.amadori@gmail.com>. |