X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.8.txt;h=8b7866949e07a3c0b7eb107c6c18fd30a04a29a6;hp=245978eab76ebfc5a504c8bbff072a7515cbe0e5;hb=813cdabf07b257c55d0dc943fc33f52a027a8f9d;hpb=b473b2b0ae99153dfb0c2afa877bfc86d3e58855 diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index 245978e..8b78669 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -182,11 +182,13 @@ Options and environment variables command line might be visible in the process list and the shell history. It's meant for automatic installation only. -*-r*, *--release* _releasename_:: +*--post-scripts* _directory_:: - Specify release of new Debian system. Supported releases names: lenny, - squeeze, wheezy, jessie, stretch (note: requires a recent version of debootstrap) - and sid. Corresponding with configuration variable RELEASE. + Execute scripts from specified directory after executing the chroot script. + This allows customisation of the system after the chroot has been set up. + The environment variable $MNTPOINT is available inside the scripts for + direct access of the chroot. + Default directory: /etc/debootstrap/post-scripts/ *--pre-scripts* _directory_:: @@ -196,12 +198,16 @@ Options and environment variables scripts for direct access of the chroot. Default directory: /etc/debootstrap/pre-scripts/ -*--scripts* _directory_:: +*-r*, *--release* _releasename_:: - Execute scripts from specified directory. This allows customisation of - the system after the chroot has been set up. The environment variable - $MNTPOINT is available inside the scripts for direct access of the chroot. - Default directory: /etc/debootstrap/scripts/ + Specify release of new Debian system. Supported releases names: lenny, + squeeze, wheezy, jessie, stretch (note: requires a recent version of debootstrap) + and sid. Corresponding with configuration variable RELEASE. + +*--remove-configs*:: + + Delete grml-debootstrap configuration files (/etc/debootstrap/*) from installed + system. Useful for reproducible builds or if you don't want to leak information. *-t*, *--target* _target_:: @@ -222,9 +228,10 @@ Options and environment variables *--vmfile*:: - Set up a Virtual Machine instead of installing to a partition or directory. - This allows deployment of a Virtual Machine. The options needs to be - combined with the --target option. + Set up a Virtual Machine using a regular file instead of installing to a + partition/block device or directory. This allows deployment of a Virtual + Machine. The options needs to be combined with the --target option + ('qemu-img create -f raw ...' is executed on the specified target). Usage example: --vmfile --target /mnt/sda1/qemu.img *--vmsize* _size_:: @@ -265,7 +272,7 @@ any bootloader). Install default Debian release (jessie) on /dev/sda3 and install bootmanager Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition. -Use specified mirror instead of the default (http://http.debian.net/debian) one. +Use specified mirror instead of the default (http://httpredir.debian.org/debian) one. mount /dev/sda1 /mnt/sda1 grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img @@ -352,7 +359,7 @@ releases: lenny, squeeze, wheezy, jessie, stretch and sid. Usage example: releas mirror=... Specify mirror which should be used for apt-get/aptitude instead -of the default one (http://http.debian.net/debian). +of the default one (http://httpredir.debian.org/debian). Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian password=... @@ -385,14 +392,18 @@ include::releasetable.txt[] ================================================================================ [1] Please notice that lenny is an unsupported release within Debian nowadays. grml-debootstrap can handle the release but you really should not use lenny -anymore unless you really know what you are doing. Choose Debian 7.0 (wheezy) or +anymore unless you really know what you are doing. Choose Debian 8.0 (jessie) or something newer instead. Notice that you need to specify a mirror providing the lenny release, the -default (http://http.debian.net/debian) doesn't provide it any longer nowadays. +default (http://httpredir.debian.org/debian) doesn't provide it any longer nowadays. Set the mirror to e.g. http://archive.debian.org/debian/ if you don't have your own lenny mirror. +You also need to specify a filesystem that's supported by lenny, e.g. +'--filesystem ext3' since grml-debootstrap's current default (ext4) isn't +supported by lenny. + Also when debootstrapping lenny on a live system with a kernel version like "3.16-1-grml-amd64" lenny's libc will fail to install with: