Notice: the grml team is migrating from Mercurial to Git.
Please visit git.grml.org instead!
| author | Michael Prokop <mika@grml.org> |
| Mon Apr 16 18:07:27 2007 +0200 (19 months ago) | |
| changeset 130 | 085f69f37d4f |
| manifest | 085f69f37d4f |
| parent 129 | cd494ca7906a |
| child 131 | 13f3e9e6c5e5 |
--- a/debian/grml-debootstrap.8 Mon Apr 16 18:06:35 2007 +0200+++ /dev/null Thu Jan 01 00:00:00 1970 +0000@@ -1,142 +0,0 @@-.TH GRML-DEBOOTSTRAP 8-.SH NAME-grml-debootstrap \- wrapper around debootstrap for installing plain Debian via grml-.SH SYNOPSIS-.B grml-debootstrap-.RI [ options ]-.SH DESCRIPTION-This manual page documents briefly the-.B grml-debootstrap-command.-.PP-\fBgrml-debootstrap\fP is a wrapper suite around debootstrap-(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 (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 (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 and exit.-.TP-.B \-v, \-\-version-Show version of program and exit.-.TP-.B \-\-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.-.TP-.B \-\-groot <device>-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 <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.-.TP-.B \-p, \-\-mntpoint </mntpoint>-Specify mountpoint that should be used for mounting the target system.-Corresponding with configuration variable MNTPOINT.-.TP-.B \-r, \-\-release <releasename>-Specify release of new Debian system. Supported relases: sarge, etch, lenny and sid.-Corresponding with configuration variable RELEASE.-.TP-.B \-t, \-\-target <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 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-Current status:-- +----------------+-------------+-----------------+- | Release / Tool | debootstrap | cdebootstrap |- +----------------+-------------+-----------------+- | 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 <mika@grml.org>.-.SH SEE ALSO-.BR debootstrap (8),-.BR cdebootstrap (1).-.SH AUTHOR-grml-debootstrap was written by Michael Prokop <mika@grml.org>.-.PP-This manual page was written by Michael Prokop <mika@grml.org>-for the grml project (but may be used by others).