X-Git-Url: https://git.grml.org/?p=grml-debootstrap.git;a=blobdiff_plain;f=grml-debootstrap.txt;h=e04624e7c5fee64271c195ac2d0679ab104d1fb2;hp=e13cbe08304e82b4b0ce2a9e1f9749759d7503dc;hb=1754303c804e1b30189bbdd160e7cb5aa814a3a5;hpb=21192478af7d33cd7c19b254ab5bef5a75028184

diff --git a/grml-debootstrap.txt b/grml-debootstrap.txt
index e13cbe0..e04624e 100644
--- a/grml-debootstrap.txt
+++ b/grml-debootstrap.txt
@@ -61,6 +61,12 @@ Corresponding with configuration variables MIRROR and CHROOTMIRROR.
 Specify mountpoint that should be used for mounting the target system.
 Corresponding with configuration variable MNTPOINT.
 
+  --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.
+It's meant for automatic installation only.
+
   -r, --release <releasename>
 
 Specify release of new Debian system. Supported relases: sarge, etch, lenny and sid.
@@ -125,7 +131,7 @@ Debian system by default.
 
 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.
+into a file named as the function itself if it has been executed successfully.
 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
@@ -144,13 +150,70 @@ want to put existing files to the new Debian system you can place them into the
 /etc/debootstrap/. Every existing directory will be copied to the new Debian
 system then.
 
+Automatic installation
+----------------------
+
+If environment variable AUTOINSTALL is set grml-debootstrap can be executed in a
+full automatic mode. While this mode isn't really useful for interactive
+execution (just configure /etc/debootstrap/configure or specify the relevant
+variables on the commandline instead) it is meant for use via bootoption
+debian2hd. The bootoption debian2hd (more precise: the kernelname on bootprompt)
+supports the following bootoptions (they correspond with the commandline options
+mentioned above):
+
+  target=...
+
+The target partition/directory of the new Debian system. Usage example:
+target=/dev/hda1
+
+  grub=...
+
+Where do you want to install grub to? Use grub syntax for specifying.
+Usage example: grub=hd0
+
+  groot=...
+
+Specify root device for usage in grub (corresponds with $TARGET).
+Again, use grub syntax for specifying. Usage example: groot=hd0,0
+
+  release=...
+
+Specify release of new Debian system. Defaults to Debian stable.
+Supported relases: sarge, etch, lenny and sid. Usage example: release=sid
+
+  mirror=...
+
+Specify mirror which should be used for apt-get/aptitude instead
+of the default one (ftp://ftp.debian.de/debian).
+Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian
+
+  password=...
+
+Set passwort of user root without prompting for it but set it to the given
+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
+
+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
+system.
+
+[NOTE]
+Automatic installation within booting process is done in grml-autoconfig via
+setting environment variable AUTOINSTALL and creation of
+/usr/bin/grml-debootstrap_noninteractive with the available and relevant
+bootoptions for grml-debootstrap.
+
 Supported Releases
 ------------------
 
 include::releasetable.txt[]
 
 [NOTE]
-.A Sarge-Release
+.Sarge-Release
 =====================================================================
 [1] Please notice that Sarge is the current old-stable within Debian.
 grml-debootstrap can handle the release but you really should not