diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/AUTHORS | 4 | ||||
-rw-r--r-- | doc/CREDITS | 30 | ||||
-rw-r--r-- | doc/ChangeLog | 4 | ||||
-rw-r--r-- | doc/ChangeLog.old | 474 | ||||
-rw-r--r-- | doc/NEWS | 27 | ||||
-rw-r--r-- | doc/README | 84 | ||||
-rw-r--r-- | doc/TODO | 13 | ||||
-rw-r--r-- | doc/faq.txt | 9 | ||||
-rw-r--r-- | doc/man/make-live.8 | 215 | ||||
-rw-r--r-- | doc/man/make-live.conf.5 | 94 |
10 files changed, 636 insertions, 318 deletions
diff --git a/doc/AUTHORS b/doc/AUTHORS new file mode 100644 index 000000000..ce0a01a76 --- /dev/null +++ b/doc/AUTHORS @@ -0,0 +1,4 @@ +Main Authors: + + * Daniel Baumann <daniel@debian.org> + * Marco Amadori <marco.amadori@gmail.com> diff --git a/doc/CREDITS b/doc/CREDITS new file mode 100644 index 000000000..cf8a3d470 --- /dev/null +++ b/doc/CREDITS @@ -0,0 +1,30 @@ +Patches (alphabetical order): + + * Alex Owen <r.a.owen@qmul.ac.uk> + * Bas Wijnen <wijnen@debian.org> + * Ben Armstrong <synrg@debian.org> + * Cedric Lucantis <omer@no-log.org> + * Frederic Lehobey <Frederic.Lehobey@free.fr> + * Guerkan Senguen <gurkan@linuks.mine.nu> + * Hadar Weiss <whadar@gmail.com> + * Jason D. Clinton <me@jasonclinton.com> + * Kai Hendry <hendry@iki.fi> + * Marcelo D. Re <mdre@rectorado.unl.edu.ar> + * Markus Bauer <bauer-markus@web.de> + * Mathieu Geli <mathieu.geli@gmail.com> + * Otavio Salvador <otavio@debian.org> + * Scott Edwards <debian@foss.daxal.com> + * Sebastian Raveau <sebastien.raveau@epita.fr> + +Donations (alphaetical order): + + * Gracie <gracie@bithawk.net> + +Special thanks (alphabetical order): + + * Ben Armstrong <synrg@debian.org> for his IRC support. + * Jason D. Clinton <me@jasonclinton.com> for his work on netboot type. + * Otavio Salvador <otavio@debian.org> for his QA patches. + * Sebastian Raveau <sebastien.raveau@epita.fr> for his work on encryption + support. + * Scott Edwards <debian@foss.daxal.com> for his work on d-i/g-i integration. diff --git a/doc/ChangeLog b/doc/ChangeLog new file mode 100644 index 000000000..fff62793b --- /dev/null +++ b/doc/ChangeLog @@ -0,0 +1,4 @@ +2007-03-12 Daniel Baumann <daniel@debian.org> + + * Rewritten live-package. + * Uploaded 1.0~a1-1. diff --git a/doc/ChangeLog.old b/doc/ChangeLog.old new file mode 100644 index 000000000..03dba6415 --- /dev/null +++ b/doc/ChangeLog.old @@ -0,0 +1,474 @@ +2007-03-10 Daniel Baumann <daniel@debian.org> + + * Added knoppix and knoppix-dvd package lists. + +2007-03-09 Daniel Baumann <daniel@debian.org> + + * Getting free loopdevice from inside the chroot, not outside. + +2007-03-09 Daniel Baumann <daniel@debian.org> + + * Added kbd to all !minimal lists. + * Uploaded 0.99.25. + +2007-03-08 Otavio Salvador <otavio@debian.org> + + * helpers/lh_configapt: Fix aptitude configuration to really avoid + recommended packages to get installed. + * src/scripts/02defaults.sh: Export LIVE_ISOLINUX_SPLASH. + +2007-03-04 Daniel Baumann <daniel@debian.org> + + * Replaced removal of kernel on minimal flavours with excludes on the + mksquashfs call. + * Added LIVE_INCLUDE_CHROOT to the manual exported variables as reported + by Mathieu Geli <mathieu.geli@gmail.com>. + * Exported CODENAME_* manually as reported by Cédric Lucantis + <omer@no-log.org>. + * Fixed typo s/aptiude/aptitude/ as reported by Kai Hendry + <hendry@iki.fi>. + * Uploaded 0.99.24. + +2007-02-22 Daniel Baumann <daniel@debian.org> + + * Added xresprobe to all x11 lists. + +2007-02-22 Daniel Baumann <daniel@debian.org> + + * Applied patches from Otavio Salvador <otavio@debian.org>: + - add and cleanup variable exporting in defaults. + - add LIVE_BOOTSTRAP_CONFIG to lh_debootstrap. + * Uploaded 0.99.23. + +2007-02-21 Daniel Baumann <daniel@debian.org> + + * Added gnome-junior, kde-junior and xfce-junior lists. + * Uploaded 0.99.22. + +2007-02-19 Daniel Baumann <daniel@debian.org> + + * Fixed manifest. + +2007-02-15 Daniel Baumann <daniel@debian.org> + + * Applied patch from Sebastian Raveau <sebastien.raveau@epita.fr> to + add support for filesystem images encrypted with loop-aes. + +2007-02-13 Daniel Baumann <daniel@debian.org> + + * Broken out scripts into modularized lh_* subscripts. + +2007-02-12 Daniel Baumann <daniel@debian.org> + + * Added some code as suggested by Alex Owen <r.a.owen@qmul.ac.uk> to + check if the depends (syslinux, memtest etc.) are intentionally + installed in the chroot, and hence, don't remove them. + * Moved some depends into the chroot. + * Uploaded 0.99.21. + +2007-02-11 Daniel Baumann <daniel@debian.org> + + * Added mini flavour. + +2007-02-10 Daniel Baumann <daniel@debian.org> + + * Added legacy code for genisoimage. + * Uploaded 0.99.20. + +2007-02-09 Daniel Baumann <daniel@debian.org> + + * Added usb type. + +2007-02-08 Daniel Baumann <daniel@debian.org> + + * Added desktop task to the *-desktop flavours. + +2007-02-07 Daniel Baumann <daniel@debian.org> + + * Extended cron job a bit. + * Fixed manual pruning in minimal flavour as suggested by Bas Wijnen + <wijnen@debian.org> + +2007-02-02 Daniel Baumann <daniel@debian.org> + + * Added "--without-daemons". + +2007-02-01 Daniel Baumann <daniel@debian.org> + + * Added "--tasks". + * Added desktop-base to all desktop package lists. + +2007-01-31 Daniel Baumann <daniel@debian.org> + + * Changed vars in autobuilding script to be able to source + make-live.conf. + * Uploaded 0.99.19. + +2007-01-30 Daniel Baumann <daniel@debian.org> + + * Added cron job for autobuilding images. + +2007-01-25 Daniel Baumann <daniel@debian.org> + + * Added additional pruning to minimal flavour. + * Using interactive frontend while processing --hook. + * Uploaded 0.99.18. + +2007-01-24 Daniel Baumann <daniel@debian.org> + + * Applied patches from Otavio Salvador <otavio@debian.org>: + - adding "--keyring" flag. + - adding LIVE_DISK_VOLUME. + - adding start-stop-daemon wrapper to avoid daemons to be started. + - adding workaround to prevent binfmt locking /proc. + - adding LIVE_ISOLINUX_SPLASH. + * Uploaded 0.99.17. + +2007-01-19 Daniel Baumann <daniel@debian.org> + + * Replacing mkisofs with genisoimage. + +2007-01-18 Daniel Baumann <daniel@debian.org> + + * Cleanups. + * Uploaded 0.99.16. + +2007-01-16 Daniel Baumann <daniel@debian.org> + + * Switched default distribution back to unstable, as unstable is usable + again from the kernel point of view. + * Added file to the minimal package list. + * Uploaded 0.99.15. + +2007-01-04 Daniel Baumann <daniel@debian.org> + + * Added workaround for new xorg packages by including + xserver-xorg-input-all and xserver-xorg-video-all in all X11 package + lists. See #405639 for more information. + * Added xdebconfigurator to all X11 package lists. + * Adding workaround for initrd backup files. + +2006-11-06 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.14. + +2006-11-05 Daniel Baumann <daniel@debian.org> + + * Applied patch from Markus Bauer <bauer-markus@web.de>: + - fixing script sourcing to exclude files in .svn + +2006-11-03 Daniel Baumann <daniel@debian.org> + + * Fixed typo in the policy-rc.d hack. + +2006-11-02 Daniel Baumann <daniel@debian.org> + + * Using aptitude instead of apt-get. + * Added '--with-recommends' and '--without-recommends'. + +2006-11-01 Daniel Baumann <daniel@debian.org> + + * Fixed regression when using -d ${CODENAME} wrt/ kernel packages. + +2006-10-30 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.13. + +2006-10-29 Daniel Baumann <daniel@debian.org> + + * Added minimal-net flavour. + +2006-10-28 Daniel Baumann <daniel@debian.org> + + * Added console-common to standard selection. + +2006-10-27 Daniel Baumann <daniel@debian.org> + + * Added patch from Otavio Salvador <otavio@debian.org>: + - fixing preseeding error-handling. + +2006-10-26 Daniel Baumann <daniel@debian.org> + + * Added gnustep package selection based on the suggestion of + Guerkan Senguen <gurkan@linuks.mine.nu>. + +2006-10-25 Daniel Baumann <daniel@debian.org> + + * Applied patch from Marcelo D. Re <mdre@rectorado.unl.edu.ar>: + - skip deb-src source-list entries when building images with + --without-source. + * Applied patches from Otavio Salvador <otavio@debian.org>: + - adding '--bootstrap-config' to support cdebootstraps + '--suite-config'. + - allowing override of ${BASE}. + - adjust sourcing of scripts, so that only the real scripts are + sourced and not other (backup) files. + - allowing override of kernel-packages. + * Reverted mangling of LIVE_DISTRIBUTION for sources.list generation. + +2006-10-23 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.12. + +2006-10-18 Daniel Baumann <daniel@debian.org> + + * Autodetecting proxy now. + +2006-10-16 Daniel Baumann <daniel@debian.org> + + * Readded and slightly changed --clone and --preseed. + * Uploaded 0.99.11. + +2006-10-09 Daniel Baumann <daniel@debian.org> + + * Cleanups. + * Uploaded 0.99.10. + +2006-10-02 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.9. + +2006-10-01 Daniel Baumann <daniel@debian.org> + + * Added multiple repositories. + * Using LIVE_PROXY_* also for bootstraping. + +2006-09-27 Daniel Baumann <daniel@debian.org> + + * Changing manpage section. + +2006-09-26 Daniel Baumann <daniel@debian.org> + + * Added default flavour hooks. + * minimal flavour does not install debian-archive-keyring to save space. + * Adjusted network patch. + +2006-09-25 Daniel Baumann <daniel@debian.org> + + * Removed now unused initramfs-tools hack. + * Simplified xorg check based on distribution rather than version. + * Added fix from Bas Wijnen <wijnen@debian.org> for space handling in + arguments. + * Fixed package list handling similar to the fix suggested by Alex Owen + <r.alex.owen@gmail.com>. + * Uploaded 0.99.8. + +2006-09-24 Marco Amadori <marco.amadori@gmail.com> + + * 13hack.sh: initramfs-tools hack, check added for xorg. + +2006-09-18 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.7. + +2006-09-15 Daniel Baumann <daniel@debian.org> + + * Added eject to minimal package selection. + +2006-09-14 Daniel Baumann <daniel@debian.org> + + * Adjustements for linux 2.6.17 testing propagation. + +2006-09-11 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.6. + +2006-09-08 Marco Amadori <marco.amadori@gmail.com> + + * 23net.sh: Fixed binary missing directory creation. + * templates/iso: Moved common files to templates/common. + +2006-09-07 Daniel Baumann <daniel@debian.org> + + * Minor cleanups. + * Fixed dist target. + +2006-09-06 Marco Amadori <marco.amadori@gmail.com> + + * 14chroot.sh, main.sh: Added manifest support. + * 23net.sh: Added 2 variables for basenames to ease readability. + * main.sh, 02default.sh: Modified Usage() uses. + +2006-09-04 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.5. + +2006-09-03 Daniel Baumann <daniel@debian.org> + + * Added dist parameter to easily pull images for live.debian.net. + * Added "--output" to specify the image name prefix. + * Exclude iso templates for minimal flavour. + +2006-09-02 Daniel Baumann <daniel@debian.org> + + * Added experimental as distribution. + * Added source image generation. + * Using dpkg instead of dpkg-architecture, removed dpkg-dev dependency. + +2006-08-31 Daniel Baumann <daniel@debian.org> + + * Added "--disable-generic-indices" and "--enable-generic-indices". + * Fixed i18n lists. + * Rewritten all lists, comments are now possible. + * Lists must be now explicitly given with --package-list, no longer as + last argument of the make-live call. + * Setting default sources.list while the image generation, restoring + customized ones afterwards. + +2006-08-30 Daniel Baumann <daniel@debian.org> + + * Cleanups: + - moved 14patch_packages.sh to 13hack.sh. + - simplified 13hack.sh. + +2006-08-29 Marco Amadori <marco.amadori@gmail.com> + + * pxelinux.cfg: Updated to right defaults, first cifs then nfs or + select your favorite way. Rationale: /dev/nfs is for kernel + discovering, not for initramfs discover, casper will be just fine + with "netboot". + * 13chroot.sh, 14patch_packages.sh: Added a simple system for patching + packages, mainly for xserver-xorg so far. + +2006-08-28 Daniel Baumann <daniel@debian.org> + + * Updated documentation. + * Added patch from Alex Owen <r.a.owen@qmul.ac.uk> to update + pxelinux.cfg for NFS root in casper. + * Uploaded 0.99.4. + +2006-08-27 Daniel Baumann <daniel@debian.org> + + * Cleanups. + +2006-08-27 Marco Amadori <marco.amadori@gmail.com> + + * Added sysv init blocking policy. + +2006-08-22 Daniel Baumann <daniel@debian.org> + + * Reorganised sources. + * Added staging support. + * Cleaned up parameter names. + * testing is now supported. + +2006-08-21 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.3. + +2006-08-02 Marco Amadori <marco.amadori@gmail.com> + + * Rewrote netboot support. + * Added support for pure directory rootfs images. + +2006-07-31 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.2. + +2006-07-28 Daniel Baumann <daniel@debian.org> + + * Added DEBIAN_FRONTEND to chroots(), now completely non-interactive. + * Fixed wrong chroot patch. + +2006-07-27 Marco Amadori <marco.amadori@gmail.com> + + * Changed amd64 kernel naming scheme. + +2006-07-24 Daniel Baumann <daniel@debian.org> + + * Uploaded 0.99.1. + +2006-07-19 Daniel Baumann <daniel@debian.org> + + * Bugfixes. + +2006-07-18 Daniel Baumann <daniel@debian.org> + + * Added iso templates. + +2006-07-17 Daniel Baumann <daniel@debian.org> + + * Added chroot to 01-patch.sh. + * Added "--logfile". + * Uploaded 0.99. + +2006-07-01 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Added "--flavour". + +2006-06-28 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Added "--debug" and "--verbose". + +2006-06-23 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Rewritten manpages. + +2006-06-19 Marco Amadori <marco.amadori@gmail.com> + + * Added "--templates" options. + * Fixed some typos. + +2006-06-15 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * General fixes. + +2006-06-18 Marco Amadori <marco.amadori@gmail.com> + + * Added "-a|--architecture" and "-p|--package-list" options. + * Reworked how lists works. + +2006-06-15 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * General cleanup. + +2006-06-14 Marco Amadori <marco.amadori@gmail.com> + + * Re-added "-f|--filesystem". + +2006-06-12 Marco Amadori <marco.amadori@gmail.com> + + * Added "--conffile", "--preseed", "--clone", and "--rootfs" options. + +2006-06-12 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Added new splash.rle. + * Added memtest86+. + * Added "--distribution", and "--section" options. + * Moved /etc/default/make-live to /etc/make-live.conf. + +2006-06-11 Marco Amadori <marco.amadori@gmail.com> + + * Added handling of md5sums. + +2006-06-09 Marco Amadori <marco.amadori@gmail.com> + + * Added splashy support. + * Added ext2 rootfs support. + * Added external hook and path support. + * Swiched to getopt. + +2006-06-02 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Added patch from Jason D. Clinton <me@jasonclinton.com>: + - Added netboot flavour. + - Thanks to SafeDesk Solutions <http://www.safedesk.com/>. + +2006-06-01 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Moved syslinux inside the chroot. + +2006-05-31 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Added kde-*i18n and standard-i18n lists. + +2006-05-28 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Added patch from Frederic Lehobey <Frederic.Lehobey@free.fr>: + - Added locales to LIVE_PACKAGES. + - Added LIVE_MIRROR_KEY, LIVE_REPOSITORY, LIVE_REPOSITORY_KEY, and + LIVE_BOOTAPPEND. + +2006-05-27 Daniel Baumann <daniel.baumann@panthera-systems.net> + + * Initial release. diff --git a/doc/NEWS b/doc/NEWS new file mode 100644 index 000000000..3b7dbc764 --- /dev/null +++ b/doc/NEWS @@ -0,0 +1,27 @@ +News: + + * 2006-02-14: Project announcement. + http://blog.daniel-baumann.ch/2006/02/14#20060214_debian-live-initiative + + * 2006-02-28: Setup project resources. + http://blog.daniel-baumann.ch/2006/02/28#20060228_debian-live-resources + + * 2006-03-16: Added support for ISO image generation. + http://lists.alioth.debian.org/pipermail/debian-live-devel/2006-March/000048.html + + * 2006-06-02: Added support for netboot image generation. + http://lists.alioth.debian.org/pipermail/debian-live-devel/2006-May/000185.html + + * 2006-07-17: Uploaded live-package to Debian unstable. + http://packages.debian.org/changelogs/pool/main/l/live-package/current/changelog#versionversion0.99-1 + + * 2007-02-05: Setup image autobuild server. + http://lists.alioth.debian.org/pipermail/debian-live-devel/2007-February/000764.html + + * 2007-02-10: Added support for USB image generation. + http://lists.alioth.debian.org/pipermail/debian-live-devel/2007-February/000790.html + + * 2007-02-17: Added support for encrypted live filesystem. + http://lists.alioth.debian.org/pipermail/debian-live-devel/2007-February/000836.html + + * 2007-03-12: Uploaded live-helper to Debian unstable. diff --git a/doc/README b/doc/README new file mode 100644 index 000000000..dbccc7c86 --- /dev/null +++ b/doc/README @@ -0,0 +1,84 @@ + * lh_config + + * lh_bootstrap + |_ lh_cdebootstrap | lh_debootstrap + + * lh_chroot + |_ lh_chroot_proc install + |_ lh_chroot_sysfs install + |_ lh_chroot_debianchroot install + |_ lh_chroot_sysvrc install + |_ lh_chroot_hosts install + |_ lh_chroot_resolv install + |_ lh_chroot_apt install + |_ lh_chroot_sources install + |_ lh_chroot_linuximage install + | + |_ lh_chroot_tasks + |_ lh_chroot_packageslists + |_ lh_chroot_packages + |_ lh_chroot_localpackages + |_ lh_chroot_localpackageslist + |_ lh_chroot_localization + |_ lh_chroot_hacks + |_ lh_chroot_localincludes + |_ lh_chroot_sysvinit + |_ lh_chroot_hooks + |_ lh_chroot_localhooks + |_ lh_chroot_symlinks + | + |_ lh_chroot_linuximage remove + |_ lh_chroot_sources remove + |_ lh_chroot_apt remove + |_ lh_chroot_resolv remove + |_ lh_chroot_hosts remove + |_ lh_chroot_sysvrc remove + |_ lh_chroot_debianchroot remove + |_ lh_chroot_sysfs remove + |_ lh_chroot_proc remove + + * lh_binary + |_ lh_binary_rootfs + |_ lh_binary_manifest + |_ lh_binary_encryption + | + |_ lh_chroot_proc install + |_ lh_chroot_sysfs install + |_ lh_chroot_hosts install + |_ lh_chroot_resolv install + |_ lh_chroot_sources install + | + |_ lh_binary_linuximage + |_ lh_binary_memtest86 + |_ lh_binary_syslinux + |_ lh_binary_includes + |_ lh_binary_localincludes + |_ lh_binary_md5sum + | + |_ lh_binary_iso + |_ lh_binary_net + |_ lh_binary_usb + | + |_ rm -f .stage/chroot_sources + |_ lh_chroot_resolv remove + |_ lh_chroot_hosts remove + |_ lh_chroot_sysfs remove + |_ lh_chroot_proc remove + + * lh_source + |_ lh_chroot_hosts install + |_ lh_chroot_resolv install + |_ lh_chroot_sources install + | + |_ lh_source_download + | + |_ lh_source_generic + |_ lh_source_iso + |_ lh_source_net + |_ lh_source_usb + | + |_ rm -f .stage/chroot_sources + |_ lh_chroot_resolv remove + |_ lh_chroot_hosts remove + + * lh_clean diff --git a/doc/TODO b/doc/TODO new file mode 100644 index 000000000..b1c0faf28 --- /dev/null +++ b/doc/TODO @@ -0,0 +1,13 @@ +Fixme: + + * check all Require_stagefile calls + * make helpers call required stuff when needed + * integrate lh_chroot_hacks + * cleanup variable names + * do not use full-path anymore + +Todo: + + * write manpage and documentation + * write lh_binary_di and lh_binary_gi + * write lh_binary_grub diff --git a/doc/faq.txt b/doc/faq.txt deleted file mode 100644 index e83dcd6db..000000000 --- a/doc/faq.txt +++ /dev/null @@ -1,9 +0,0 @@ -Debian Live Framework: Frequently Asked Questions (FAQ) -======================================================= - -Q: What is the root password? -A: There is none. You can switch to root with 'sudo su -' or set a password with - 'sudo passwd'. - -Q: What is the user password? -A: The user password for casper is 'live'. diff --git a/doc/man/make-live.8 b/doc/man/make-live.8 deleted file mode 100644 index ee2d8d9b5..000000000 --- a/doc/man/make-live.8 +++ /dev/null @@ -1,215 +0,0 @@ -.TH MAKE-LIVE 8 "Mon, 4 Sep 2006" "0.99" "Debian Live framework" - -.SH NAME -make-live \- utility to build Debian Live systems - -.SH SYNOPSIS -.B make-live -.RB [\| \-a \||\| \-\-architecture -.IR ARCHITECTURE \|] -.RB [\| \-b \||\| \-\-bootappend -.IR KERNEL_PARAMETER \||\| \|"KERNEL_PARAMETERS\|" \|] -.RB [\| \-\-config -.IR FILE \|] -.RB [\| \-\-clone -.IR DIRECTORY \|] -.RB [\| \-c \||\| \-\-chroot -.IR DIRECTORY \|] -.RB [\| \-d \||\| \-\-distribution -.IR DISTRIBUTION \|] -.RB [\| \-e \||\| \-\-encryption -.IR ALGORITHM \|] -.RB [\| \-\-filesystem -.IR FILESYSTEM \|] -.RB [\| \-f \||\| \-\-flavour -.IR BOOTSTRAP_FLAVOUR \|] -.RB [\| \-\-hook -.IR COMMAND \||\| \|"COMMANDS\|" \||\|| FILE \|] -.RB [\| \-\-include-chroot -.IR FILE \||\| DIRECTORY \|] -.RB [\| \-\-include-image -.IR FILE \||\| DIRECTORY \|] -.RB [\| \-k \||\| \-\-kernel -.IR KERNEL_FLAVOUR \|] -.RB [ \-\-manifest -.IR PACKAGE \|] -.RB [\| \-m \||\| \-\-mirror -.IR URL \|] -.RB [\| \-\-mirror-security -.IR URL \|] -.RB [\| \-\-packages -.IR PACKAGE \||\| \|"PACKAGES\|" \|] -.RB [\| \-\-preseed -.IR FILE \|] -.RB [\| \-p \||\| \-\-package-list -.IR LIST \||\| FILE \|] -.RB [\| \-\-proxy-ftp -.IR URL \|] -.RB [\| \-\-proxy-http -.IR URL \|] -.RB [\| \-r \||\| \-\-root -.IR DIRECTORY \|] -.RB [\| \-s \||\| \-\-sections -.IR SECTION \||\| \|"SECTIONS\|" \|] -.RB [\| \-\-server-address -.IR HOSTNAME \||\| IP \|] -.RB [\| \-\-server-path -.IR DIRECTORY \|] -.RB [\| \-\-templates -.IR DIRECTORY \|] -.RB [\| \-t \||\| \-\-type -.IR TYPE \|] -.RB [\| \-\-with-generic-indices \|] -.RB [\| \-\-without-generic-indices \|] -.RB [\| \-\-with-source \|] -.RB [\| \-\-without-source \|] -.PP -.B make-live -.RB \-h \||\| \-\-help -.br -.B make-live -.RB \-u \||\| \-\-usage -.br -.B make-live -.RB \-v \||\| \-\-version - -.SH 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. - -.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 (Default: `dpkg-architecture -qDEB_BUILD_ARCH`). -.TP -.BI "\-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). -.TP -.BI "\-\-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). -.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 "\-c, \-\-chroot " DIRECTORY -specifies the chroot directory. Instead of this flag, the environment variable LIVE_CHROOT (Default: $LIVE_ROOT/chroot"). -.TP -.BI "\-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). -.TP -.BI "\-e, \-\-encryption " ALGORITHM -specifies the filesystem encryption algorithm. Does not work if -t is set to plain. Instead of this flag, the environment variable LIVE_ENCRYPTION can be used (Default: empty). Valid algorithms are: AES128, AES192 and AES256. -.TP -.BI "\-\-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). -.TP -.BI "\-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). -.TP -.BI "\-\-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). -.TP -.BI "\-\-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). -.TP -.BI "\-\-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). -.TP -.BI "\-k, \-\-kernel " KERNEL_FLAVOUR -specifies the kernel image flavour. Instead of this flag, the environment variable LIVE_KERNEL can be used (Default: auto-detected). -.TP -.BI "\-\-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). -.TP -.BI "\-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). -.TP -.BI "\-\-mirror-security" URL -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). -.TP -.BI "\-\-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). -.TP -.BI "\-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). -.TP -.BI "\-\-preseed " FILE -clone the packages selection and configuration from the provided -root directory. -.TP -.BI "\-\-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). -.TP -.BI "\-\-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). -.TP -.BI "\-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). -.TP -.BI "\-s, \-\-sections " SECTIONS -specifies the debian sections. Instead of this flag, the environment variable LIVE_SECTIONS can be used (Default: main). -.TP -.BI "\-\-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). -.TP -.BI "\-\-server-path" DIRECTORY -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). -.TP -.BI "\-\-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). -.TP -.BI "\-t, \-\-type " TYPE -specifies the image type to generate. TYPE can be one of: iso, net, or usb. Instead of this flag, the environment variable LIVE_TYPE can be used (Default: iso). -.TP -.B \-\-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). -.TP -.B \-\-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). -.TP -.B \-\-with-source -enables generation of source images. Instead of this flag, the environment variable LIVE_SOURCE can be used (Default: no). -.TP -.B \-\-without-source -disables generation of source images. Instead of this flag, the environment variable LIVE_SOURCE can be used (Default: no). -.PP -.TP -.B \-h, \-\-help -display 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(5) - -.SH AUTHOR -make-live was written by Daniel Baumann <daniel@debian.org> and Marco Amadori -<marco.amadori@gmail.com>. diff --git a/doc/man/make-live.conf.5 b/doc/man/make-live.conf.5 deleted file mode 100644 index f44351df4..000000000 --- a/doc/man/make-live.conf.5 +++ /dev/null @@ -1,94 +0,0 @@ -.TH MAKE-LIVE.CONF 5 "Mon, 4 Sep 2006" "0.99" "Debian Live framework" - -.SH NAME -make-live.conf \- configuration file for make-live(1) - -.SH 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. - -.SH ENVIRONMENT -.TP -.B LIVE_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 environment variable, the flag \-a, \-\-architecture can be used (Default: `dpkg-architecture -qDEB_BUILD_ARCH`). -.TP -.B LIVE_BOOTAPPEND -specifies additional bootparameters to the kernel (Default: none). -.TP -.B LIVE_CONFIG -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 variable, the flag \-c or \-\-config can be used (Default: empty). -.TP -.B LIVE_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 environment variable, the flag \-d, \-\-distribution can be used (Default: unstable). -.TP -.B LIVE_FLAVOUR -specifies the bootstrap flavour. This can be either standard (default) or minimal. Instead of this environment variable, the flag \-f, \-\-flavour can be used. -.TP -.B LIVE_FILESYSTEM -specifies the filesystem to be used for the root filesystem image -(Default: squashfs). -.TP -.B LIVE_GENERIC_INDICES -specifies if generic Debian indices should be used (Default: enable). -.TP -.B LIVE_FTPPROXY -specifies the value of ftp_proxy inside the chrooted environment. Instead of this environment variable, the flag \-\-ftp-proxy can be used (Default: empty). -.TP -.B LIVE_HOOK -specifies one or more commands to be executed in the chroot. Instead of this environment variable, the flag \-\-hook can be used (Default: empty). -.TP -.B LIVE_INCLUDE_ROOT -specifies a file or a directory to be included into the chroot. Instead of this environment variable. the flag \-\-include-root can be used (Default: empty). -.TP -.B LIVE_KERNEL -specifies the kernel image flavour. Instead of this environment variable, the flag \-k, \-\-kernel can be used. -.TP -.BI LIVE_MANIFEST -specifies the last package to install before creating the filesystem.manifest-desktop list, mainly used with ubuntu live, in those system it should probably be set to "ubuntu-live" for ubuntu desktop livecd's (Default: do not create filesystem.manifest-desktop). -.TP -.B LIVE_MIRROR -specifies the debian mirror where make-live will download the packages from. Instead of this environment variable, the flag \-m, \-\-mirror LIVE_MIRROR can be used (Default: http://ftp.debian.org/debian). -.B LIVE_MIRROR_KEY -specifies the archive signing key. Instead of this environment variable, the flav \-\-mirror-key can be used (Default: http://ftp-master.debian.org/ziyi_key_2006.asc). -.TP -.B LIVE_PACKAGES -specifies a list of packages to install into the chroot. Instead of this environment variable, the flag \-\-packakges can be used (Default: empty). -.TP -.B LIVE_PACKAGE_LIST -specifies a file which contains a list of packages to install. -.TP -.B LIVE_PROXY_FTP -specifies the value of ftp_proxy inside the chrooted environment. Instead of this environment variable, the flag \-\-ftp-proxy can be used (Default: empty). -.TP -.B LIVE_PROXY_HTTP -specifies the value of http_proxy inside the chrooted environment. Instead of this environment variable, the flag \-\-http-proxy can be used (Default: empty). -.TP -.B LIVE_ROOT -specifies the root directory where the images/tarballs are built. Instead of this environment variable, the flag \-r or \-\-root can bse used (Default: `pwd`/debian-live). -.B LIVE_SECTIONS -specifies the debian sections. Instead of this environment variable, the flag \-s, \-\-sections can be used (Default: main). -.B LIVE_SERVER_ADDRESS -specifies the IP address or hostname of the netboot server (Default: none). -.TP -.B LIVE_SERVER_PATH -specifies the directory of the chroot on the netboot server (Default: none). -.TP -.B LIVE_TEMPLATES -specifies a directory to be used for templates instead of the default one. -(Default: "/usr/share/make-live/templates") -.TP -.B LIVE_TYPE -specifies the image type. - -.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(1) - -.SH AUTHOR -make-live was written by Daniel Baumann <daniel@debian.org> and Marco Amadori -<marco.amadori@gmail.com>. |