Manpages

NAME

make-live − utility to build Debian Live systems

SYNOPSIS

make-live [−a|−−architecture ARCHITECTURE] [−b|−−bootappend KERNEL_PARAMETER|"KERNEL_PARAMETERS"] [−−config FILE] [−−clone DIRECTORY] [−c|−−chroot DIRECTORY] [−d|−−distribution DISTRIBUTION] [−−filesystem FILESYSTEM] [−f|−−flavour BOOTSTRAP_FLAVOUR] [−−hook COMMAND|"COMMANDS"||FILE] [−−include-chroot FILE|DIRECTORY] [−−include-image FILE|DIRECTORY] [−k|−−kernel KERNEL_FLAVOUR] [−−manifest PACKAGE] [−m|−−mirror URL] [−−mirror-security URL] [−−packages PACKAGE|"PACKAGES"] [−−preseed FILE] [−p|−−package-list LIST|FILE] [−−proxy-ftp URL] [−−proxy-http URL] [−r|−−root DIRECTORY] [−s|−−sections SECTION|"SECTIONS"] [−−server-address HOSTNAME|IP] [−−server-path DIRECTORY] [−−templates DIRECTORY] [−t|−−type TYPE] [−−with-generic-indices] [−−without-generic-indices] [−−with-source] [−−without-source]

make-live −h|−−help
make-live −u|−−usage
make-live −v|−−version

DESCRIPTION

make-live is a utility to build Debian Live systems. It takes a Debian mirror as an input and outputs a live system image (ISO image for CDs and DVDs, or tarball for netboot). make-live is still in the early stage of development, but has basic functionality and can be run successfully.

OPTIONS

−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 (Default: ’dpkg-architecture -qDEB_BUILD_ARCH’).

−b, −−bootappend KERNEL_PARAMETER|"KERNEL_PARAMETERS"

passes kernel parameters to the bootloader, e.g. ’quiet’ or ’vga=792’ etc. Instead of this flag, the environment variable LIVE_BOOTAPPEND can be used (Default: empty).

−−config FILE

uses another configuration file in addition to the default one. Settings in the additional configuration file do overwrite the settings from /etc/make-live.conf. Instead of this flag, the environment variable LIVE_CONFIG can be used (Default: /etc/make-live.conf).

−−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.

−c, −−chroot DIRECTORY

specifies the chroot directory. Instead of this flag, the environment variable LIVE_CHROOT (Default: $LIVE_ROOT/chroot").

−d, −−distribution DISTRIBUTION

specifies the distribution to be used. Allowed values are distributions names like unstable and testing, or codenames like sid and etch. Instead of this flag, the environment variable LIVE_DISTRIBUTION can be used (Default: sid).

−−filesystem FILESYSTEM

Specifies the filesystem for the compressed image. At the moment, ext2, plain and squashfs are supported. Instead of this flag, the environment variable LIVE_FILESYSTEM can be used (Default: squashfs for iso, plain for net).

−f, −−flavour BOOTSTRAP_FLAVOUR

specifies the bootstrap flavour. This can be either standard or minimal. Instead of this flag, the environment variable LIVE_FLAVOUR can be used (Default: standard).

−−hook COMMAND|"COMMANDS"||FILE

specifies one or more commands to be executed in the chroot. Instead of this flag, the environment variable LIVE_HOOK can be used (Default: empty).

−−include-chroot FILE|DIRECTORY

specifies a file or a directory to be included into the chroot. Instead of this flag, the environment variable LIVE_INCLUDE_CHROOT can be used (Default: empty).

−−include-image FILE|DIRECTORY

specifies a file or directory which will be copied inside the image. Instead of this flag, the environment variable LIVE_INCLUDE_IMAGE can be used (Default: empty).

−k, −−kernel KERNEL_FLAVOUR

specifies the kernel image flavour. Instead of this flag, the environment variable LIVE_KERNEL can be used (Default: auto-detected).

−−manifest PACKAGE

specifies the last package to install before creating the filesystem.manifest-desktop list, mainly used with ubuntu live, PACKAGE should probably be "ubuntu-live" for ubuntu desktop livecd’s. Instead of this flag, the environment variable LIVE_MANIFEST can be used (Default: do not create filesystem.manifest-desktop).

−m, −−mirror URL

specifies the debian mirror where make-live will download the packages from. Instead of this flag, the environment variable LIVE_MIRROR can be used (Default: http://ftp.debian.org/debian).

−−mirror-securityURL

specifies the debian security mirror where make-live will download the packages from. Instead of this flag, the environment variable LIVE_MIRROR_SECURITY can be used (Default: http://security.debian.org/debian).

−−packages PACKAGE|"PACKAGES"

specifies a list of packages to install into the chroot. Instead of this flag, the environment variable LIVE_PACKAGES can be used (Default: empty).

−p, −−package-list FILE

specifies an external package list file, one package for each line. It overrides list option. Instead of this flag, the environment variable LIVE_PACKAGE_LIST can be used (Default: standard).

−−preseed FILE

clone the packages selection and configuration from the provided root directory.

−−proxy-ftp URL

specifies the value of ftp_proxy inside the chrooted environment. Instead of this flag, the environment variable LIVE_PROXY_FTP can be used (Default: empty).

−−proxy-http URL

specifies the value of http_proxy inside the chrooted environment. Instead of this flag, the environment variable LIVE_PROXY_HTTP can be used (Default: empty).

−r, −−root DIRECTORY

specifies the root directory where the images/tarballs are built. Instead of this flag, the environment variable LIVE_ROOT can be used (Default: ’pwd’/debian-live).

−s, −−sections SECTIONS

specifies the debian sections. Instead of this flag, the environment variable LIVE_SECTIONS can be used (Default: main).

−−server-address HOSTNAME|IP

specifies the server address you want to use for netboot. Instead of this flag, the environment variable LIVE_SERVER_ADDRESS can be used (Default: 192.168.1.1).

−−server-pathDIRECTORY

specifies the directory on the server, where you have unpacked the netboot image. Instead of this flag, the environment variable LIVE_SERVER_PATH can be used (Default: /srv/debian-live).

−−templates DIRECTORY

specifies a templates directory to use instead of the default one. Instead of this flag, the environment variable LIVE_TEMPLATES can be used (Default: /usr/share/make-live/templates).

−t, −−type TYPE

specifies the image type to generate. Currently, only iso and net are available. Instead of this flag, the environment variable LIVE_TYPE can be used (Default: iso).

−−with-generic-indices

enables use of generic Debian package indices. Instead of this flag, the environment variable LIVE_GENERIC_INDICES can be used (Default: yes).

−−without-generic-indices

disables use of generic Debian package indices. Instead of this flag, the environment variable LIVE_GENERIC_INDICES can be used (Default: yes).

−−with-source

enables generation of source images. Instead of this flag, the environment variable LIVE_SOURCE can be used (Default: no).

−−without-source

disables generation of source images. Instead of this flag, the environment variable LIVE_SOURCE can be used (Default: no).

−h, −−help

display help and exit

−u, −−usage

show usage and exit

−v, −−version

output version information and exit

LISTS

Every list does already include the Debian standard package selection.
gnome | gnome-core | gnome-full

include GNOME.

kde | kde-core | kde-full | kde-extra

include KDE.

x11 | x11-core

include X-Window-System only.

BUGS

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.

HOMEPAGE

Debian Live project <http://live.debian.net/>;

SEE ALSO

make-live.conf(5)

AUTHOR

make-live was written by Daniel Baumann <daniel [AT] debian.org> and Marco Amadori <marco.amadori [AT] gmail.com>.