From: Michael Prokop Date: Wed, 12 Nov 2008 11:53:26 +0000 (+0100) Subject: Update docs to reflect recent development X-Git-Tag: v0.23~15 X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=commitdiff_plain;h=657053eb185fc239f1e27fa8b7b0e6e1c982340f;ds=sidebyside Update docs to reflect recent development --- diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt index 1a0880f..a542304 100644 --- a/grml-debootstrap.8.txt +++ b/grml-debootstrap.8.txt @@ -31,29 +31,34 @@ CAUTION: The grml team does not take responsibility for loss of any data! Options and environment variables --------------------------------- -*-h*, *--help*:: - Show summary of options and exit. +*--boot_append* <_appendline for the kernel_>:: + Specify appendline for the kernel. + E.g. "_pci=nomsi_" -*-v*, *--version*:: - Show version of program and exit. +*-c*, *--config* <_file_>:: + Use specified configuration file, defaults to /etc/debootstrap/config. -*--grub* <_device_>:: - Where do you want to install grub to? Use grub syntax for specifying. - Do not forget to set groot as well. Leave empty to avoid installation of grub. +*-d*, *--confdir* <_path_>:: + Place of configuration files for debootstrap, defaults to /etc/debootstrap. + +*--debconf* <_file_>:: + Use specified file for preseeding Debian packages instead of using + the default /debconf-selections. *--groot* <_device_>:: Specify root device for usage in grub (corresponds with $TARGET). Again, use grub syntax for specifying. Corresponding with configuration variable GROOT. -*--boot_append* <_appendline for the kernel_>:: - Specify appendline for the kernel. - E.g. "_pci=nomsi_" +*--grub* <_device_>:: + Where do you want to install grub to? Use grub syntax for specifying. + Do not forget to set groot as well. Leave empty to avoid installation of grub. -*-m*, *--mirror* <_URL_>:: - Specify mirror which should be used for apt-get/aptitude. Notice that - specifying the mirror also sets the chrootmirror to the given value. - Corresponding with configuration variables MIRROR and CHROOTMIRROR. +*--help*, *-h*:: + Show summary of options and exit. + +*--hostname* <_hostname_>:: + Use specified hostname instead of the default (being 'grml'). *-i*, *--iso* <_/mntpoint_>:: Specify mountpoint where you have a Debian ISO mounted loopback. @@ -62,10 +67,22 @@ Options and environment variables mounted the according Debian-ISO to the given <_/mntpoint_>. See section 'Usage examples' for a demonstration. +*--keep_src_list*:: + Do not overwrite user provided /etc/apt/sources.list. + +*-m*, *--mirror* <_URL_>:: + Specify mirror which should be used for apt-get/aptitude. Notice that + specifying the mirror also sets the chrootmirror to the given value. + Corresponding with configuration variables MIRROR and CHROOTMIRROR. + *-p*, *--mntpoint* <_/mntpoint_>:: Specify mountpoint that should be used for mounting the target system. Corresponding with configuration variable MNTPOINT. +*--packages* <_file_>:: + Use specified file as list for packages that should be installed instead of + the default package list file /packages. + *--password* <_password_>:: Use specified password as password for user root. Use with caution, as your commandline might be visible in the process list and the shell history. @@ -81,6 +98,12 @@ Options and environment variables use a _device_ instead of a directory as _target_ (installation of grub as bootloader when using directories isn't supported yet). +*-v*, *--verbose*:: + Increase verbosity. + +*-V*, *--version*:: + Show version of program and exit. + WARNING: the commandline parsing of grml-debootstrap does not validate the provided arguments for the commandline options. Please be careful and check docs and /etc/debootstrap/config for further information. @@ -88,15 +111,15 @@ arguments for the commandline options. Please be careful and check docs and Usage examples --------------- - grml-debootstrap --target /dev/hda1 --grub hd0 --groot hd0,0 + grml-debootstrap --target /dev/sda1 --grub hd0 --groot hd0,0 -Install default Debian release (stable/etch) on /dev/hda1 and install bootmanager -Grub in MBR (master boot record) of /dev/hda and use /dev/hda1 as system partition. +Install default Debian release (stable/etch) on /dev/sda1 and install bootmanager +Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition. - grml-debootstrap --target /dev/hda6 --grub hd0 --groot hd0,5 --release sid + grml-debootstrap --target /dev/sda6 --grub hd0 --groot hd0,5 --release sid -Install Debian unstable/sid on /dev/hda6, install bootmanager -Grub in MBR (master boot record) of /dev/hda and use /dev/hda6 as system partition. +Install Debian unstable/sid on /dev/sda6, install bootmanager +Grub in MBR (master boot record) of /dev/sda and use /dev/sda6 as system partition. grml-debootstrap --target /data/chroot @@ -109,12 +132,12 @@ Install default Debian release (stable/etch) on /dev/sda3 and install bootmanage Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition. Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one. - mount -o loop /mnt/hda6/debian-40r0-i386-CD-1.iso /mnt/iso - grml-debootstrap --target /dev/hda1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/ + mount -o loop /mnt/sda6/debian-40r0-i386-CD-1.iso /mnt/iso + grml-debootstrap --target /dev/sda1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/ -Install Debian stable/etch on /dev/hda1 using the loopback mounted Debian-ISO +Install Debian stable/etch on /dev/sda1 using the loopback mounted Debian-ISO for the base-system and install bootmanager Grub in MBR (master boot record) of -/dev/hda and use /dev/hda1 as system partition. Please notice, that the chroot +/dev/sda and use /dev/sda1 as system partition. Please notice, that the chroot system requires network access for all packages which are not part of the ISO. @@ -184,7 +207,7 @@ mentioned above): target=... The target partition/directory of the new Debian system. Usage example: -target=/dev/hda1 +target=/dev/sda1 grub=... @@ -215,10 +238,10 @@ argument. Usage example: password=AiTh5ahn Usage example for automatic installation: ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - debian2hd target=/dev/hda1 grub=hd0 groot=hd0,0 mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar + debian2hd target=/dev/sda1 grub=hd0 groot=hd0,0 mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar You have to enter this commandline at the bootprompt of grml. Please make sure -that /dev/hda1 is the partition where you really want to install your new Debian +that /dev/sda1 is the partition where you really want to install your new Debian system. [NOTE] @@ -238,7 +261,7 @@ include::releasetable.txt[] [1] Please notice that Sarge is the current old-stable within Debian. grml-debootstrap can handle the release but you really should not use Sarge anymore unless you really know what you are doing. Choose -Etch instead. +Etch or Lenny instead. ===================================================================== Bugs