Add documentation for --defaultinterfaces command line option
[grml-debootstrap.git] / grml-debootstrap.8.txt
index 69af5f4..46af45e 100644 (file)
@@ -83,6 +83,11 @@ Options and environment variables
    Execute in very verbose way. Useful for debugging possible problems
    with grml-debootstrap or identify what's actually executed.
 
+*--defaultinterfaces*::
+
+   Install a default /etc/network/interfaces file (enabling DHCP for eth0)
+   instead of taking over config from host system.
+
 *--efi* _device_::
 
     Partition where EFI boot manager should be installed to. If the
@@ -211,8 +216,8 @@ Options and environment variables
 *-r*, *--release* _releasename_::
 
     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.
+    squeeze, wheezy, jessie, stretch and sid. Corresponding with configuration
+    variable RELEASE. Default release: stretch
 
 *--remove-configs*::
 
@@ -264,7 +269,7 @@ Usage examples
 
   grml-debootstrap --target /dev/sda1 --grub /dev/sda
 
-Install default Debian release (jessie) on /dev/sda1 and install bootmanager
+Install default Debian release (stretch) 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/sda6 --grub /dev/sda --release sid
@@ -275,19 +280,19 @@ Install Debian unstable/sid on /dev/sda6, install bootmanager Grub in MBR
   mount /dev/sda1 /data/chroot
   grml-debootstrap --target /data/chroot
 
-Install default Debian release (jessie) in directory /data/chroot (without
+Install default Debian release (stretch) in directory /data/chroot (without
 any bootloader).
 
   grml-debootstrap --target /dev/sda3 --grub /dev/sda  --mirror ftp://ftp.tugraz.at/mirror/debian
 
-Install default Debian release (jessie) on /dev/sda3 and install bootmanager
+Install default Debian release (stretch) 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://httpredir.debian.org/debian) one.
 
   mount /dev/sda1 /mnt/sda1
   grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img
 
-Install default debian release (jessie) in a Virtual Machine file with
+Install default debian release (stretch) in a Virtual Machine file with
 3GB disk size (including Grub as bootmanager in MBR of the virtual disk file):
 
   mount -o loop /mnt/sda6/debian-CD-1.iso /mnt/iso
@@ -363,7 +368,7 @@ Where do you want to install grub to? Usage example: grub=/dev/sda
 
   release=...
 
-Specify release of new Debian system. Defaults to Debian jessie. Supported
+Specify release of new Debian system. Defaults to Debian stretch. Supported
 releases: lenny, squeeze, wheezy, jessie, stretch and sid. Usage example: release=sid
 
   mirror=...
@@ -398,17 +403,17 @@ Supported Releases
 include::releasetable.txt[]
 
 [NOTE]
-.lenny release
+.lenny/squeeze release
 ================================================================================
-[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 8.0 (jessie) or
-something newer instead.
+[1] Please notice that lenny and squeeze are unsupported releases within Debian nowadays.
+grml-debootstrap can handle the releases but you really should not use them
+anymore unless you really know what you are doing. Choose the current Debian
+stable version instead.
 
-Notice that you need to specify a mirror providing the lenny release, the
+Notice that you need to specify a mirror providing the lenny/squeeze releases, the
 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.
+your own lenny/squeeze 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