X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=debian%2Fgrml-debootstrap.8;h=2884cc8983615bab664f082ec7b83c36e769e318;hp=196ec69552d41d57709f726f9e3c74aa4cf5c0ef;hb=dbb3c9ae6f976fe981d05f3aa32d2208ae8eb8b7;hpb=39563a562d5225615961fe23573c15d9e2f5a79c diff --git a/debian/grml-debootstrap.8 b/debian/grml-debootstrap.8 index 196ec69..2884cc8 100644 --- a/debian/grml-debootstrap.8 +++ b/debian/grml-debootstrap.8 @@ -13,34 +13,101 @@ command. (and cdebootstrap if you want) for installing a plain Debian system via grml very fast and easy. -All you have to do is adjust a few variables in configuration -file /etc/debootstrap/config and invoke grml-debootstrap without -any further options then. +All you have to do is adjust a few variables in configuration file +/etc/debootstrap/config (or specify some variables via commandline) and invoke +grml-debootstrap without any further options then. A plain and base Debian system will be installed on the given -device then. Customization of this process is possible as well. +device (or directory) then. Customization of this process is +possible as well. .SH OPTIONS grml-debootstrap supports the following options: .TP .B \-h, \-\-help -Show summary of options. +Show summary of options and exit. .TP .B \-v, \-\-version -Show version of program. +Show version of program and exit. +.TP +.B \-\-grub +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. +.TP +.B \-\-groot +Specify root device for usage in grub (corresponds with $TARGET). +Again, use grub syntax for specifying. +Corresponding with configuration variable GROOT. +.TP +.B \-m, \-\-mirror +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. +.TP +.B \-p, \-\-mntpoint +Specify mountpoint that should be used for mounting the target system. +Corresponding with configuration variable MNTPOINT. +.TP +.B \-r, \-\-release +Specify release of new Debian system. Supported relases: sarge, etch, lenny and sid. +Corresponding with configuration variable RELEASE. +.TP +.B \-t, \-\-target +Target partition (/dev/...) or directory (anything else without /dev at the +beginning). +.SH USAGE EXAMPLES +.TP +.B grml-debootstrap --target /dev/hda1 --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. +.TP +.B grml-debootstrap --target /dev/hda6 --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. +.TP +.B grml-debootstrap --target /data/chroot +Install default Debian release (stable/etch) in directory /data/chroot (without +any bootloader). +.TP +.B grml-debootstrap --target /dev/sda3 --grub hd0 --groot hd0,2 --mirror ftp://ftp.tugraz.at/mirror/debian +Install default Debian release (stable/etch) on /dev/sda3 and install bootmanager +Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition. +Use specifed mirror instead of the default (ftp://ftp.debian.de/debian) one. .SH FILES .TP .B /etc/debootstrap/config Main configuration file. You have to adjust it according to your needs before you are able to run grml-debootstrap. +.TP +.B /etc/debootstrap/chroot-script +The script executed within the new Debian system as soon as the main system +has been installed via [c]debootstrap. +.TP +.B /etc/debootstrap/locale.gen +Defines the default locales used for generating locales via locale-gen. +.TP +.B /etc/debootstrap/packages +Defines the software packages which should be installed in the new +Debian system by default. +.TP +.B /etc/debootstrap/stages/ +The default directory for storing information about executed stages. Every +single function of grml-debootstrap will write 'done' to the stages directory +into a file named as the function itself if it has been executed sucessfully. +You can adjust the location of the directory via configuration variable STAGES +via /etc/debootstrap/config. Please notice that you have to remove the stages +directory on your own if you want to re-execute grml-deboostrap after running it +successfully once. This should avoid recurrent execution by error of +grml-debootstrap (which might delete present data). .SH CUSTOMIZATION You can control execution of grml-debootstrap via adjusting -/etc/debootstrap/config for some main stuff. The packages which should be -installed in the new Debian system can be defined via the file -/etc/debootstrap/packages. If you want to put existing files to the new -Debian system you can place them into the (by default non-existing) -directories boot, etc, share, usr and var in /etc/debootstrap/. Every -existing directory will be copied to the new Debian system then. +/etc/debootstrap/config for some main stuff or via setting some selected +variables via commandline. The packages which should be installed in the new +Debian system can be defined via the file /etc/debootstrap/packages. If you +want to put existing files to the new Debian system you can place them into the +(by default non-existing) directories boot, etc, share, usr and var in +/etc/debootstrap/. Every existing directory will be copied to the new Debian +system then. .SH SUPPORTED RELEASES .TP @@ -49,12 +116,20 @@ Current status: +----------------+-------------+-----------------+ | Release / Tool | debootstrap | cdebootstrap | +----------------+-------------+-----------------+ - | Sarge | works | broken: #390510 | + | Sarge | works [1] | works [1] | +----------------+-------------+-----------------+ | Etch | works | works | +----------------+-------------+-----------------+ + | Lenny | works | works | + +----------------+-------------+-----------------+ | Sid | works | works | +----------------+-------------+-----------------+ + +[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. + .SH BUGS Probably. Please send bugreports to Michael Prokop . .SH SEE ALSO