X-Git-Url: https://git.grml.org/?a=blobdiff_plain;f=grml-debootstrap%2Findex.html;h=b002bcb431d67592c9b7f817c3cf74f4dca02cc9;hb=f889fe7bc06111c3007d41058d115dd049d0e7e0;hp=1bc4afe57baa35d986a1c911e897ef1cb2bdad3a;hpb=8322083fcb0aac14729bcb35f79b046b984cf48a;p=grml.org.git

diff --git a/grml-debootstrap/index.html b/grml-debootstrap/index.html
index 1bc4afe..b002bcb 100644
--- a/grml-debootstrap/index.html
+++ b/grml-debootstrap/index.html
@@ -1,9 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
     "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
 <head>
 <meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
-<meta name="generator" content="AsciiDoc 8.6.6" />
+<meta name="generator" content="AsciiDoc 9.0.0rc2" />
 <title>grml-debootstrap(8)</title>
 <style type="text/css">
 /* Shared CSS for AsciiDoc xhtml11 and html5 backends */
@@ -87,10 +88,16 @@ ul, ol, li > p {
 ul > li     { color: #aaa; }
 ul > li > * { color: black; }
 
-pre {
+.monospaced, code, pre {
+  font-family: "Courier New", Courier, monospace;
+  font-size: inherit;
+  color: navy;
   padding: 0;
   margin: 0;
 }
+pre {
+  white-space: pre-wrap;
+}
 
 #author {
   color: #527bbd;
@@ -219,7 +226,7 @@ div.exampleblock > div.content {
 }
 
 div.imageblock div.content { padding-left: 0; }
-span.image img { border-style: none; }
+span.image img { border-style: none; vertical-align: text-bottom; }
 a.image:visited { color: white; }
 
 dl {
@@ -349,7 +356,7 @@ div.colist td img {
   margin-bottom: 0.1em;
 }
 
-div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
+div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
   margin-top: 0;
   margin-bottom: 0;
 }
@@ -407,18 +414,14 @@ span.underline { text-decoration: underline; }
 span.overline { text-decoration: overline; }
 span.line-through { text-decoration: line-through; }
 
+div.unbreakable { page-break-inside: avoid; }
+
 
 /*
  * xhtml11 specific
  *
  * */
 
-tt {
-  font-family: monospace;
-  font-size: inherit;
-  color: navy;
-}
-
 div.tableblock {
   margin-top: 1.0em;
   margin-bottom: 1.5em;
@@ -433,7 +436,7 @@ thead, p.table.header {
 p.table {
   margin-top: 0;
 }
-/* Because the table frame attribute is overriden by CSS in most browsers. */
+/* Because the table frame attribute is overridden by CSS in most browsers. */
 div.tableblock > table[frame="void"] {
   border-style: none;
 }
@@ -452,12 +455,6 @@ div.tableblock > table[frame="vsides"] {
  *
  * */
 
-.monospaced {
-  font-family: monospace;
-  font-size: inherit;
-  color: navy;
-}
-
 table.tableblock {
   margin-top: 1.0em;
   margin-bottom: 1.5em;
@@ -537,6 +534,8 @@ body.manpage div.sectionbody {
 @media print {
   body.manpage div#toc { display: none; }
 }
+
+
 </style>
 <script type="text/javascript">
 /*<![CDATA[*/
@@ -581,7 +580,7 @@ toc: function (toclevels) {
 
   function tocEntries(el, toclevels) {
     var result = new Array;
-    var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
+    var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
     // Function that scans the DOM tree for header elements (the DOM2
     // nodeIterator API would be a better technique but not supported by all
     // browsers).
@@ -610,7 +609,7 @@ toc: function (toclevels) {
   var i;
   for (i = 0; i < toc.childNodes.length; i++) {
     var entry = toc.childNodes[i];
-    if (entry.nodeName == 'div'
+    if (entry.nodeName.toLowerCase() == 'div'
      && entry.getAttribute("class")
      && entry.getAttribute("class").match(/^toclevel/))
       tocEntriesToRemove.push(entry);
@@ -656,7 +655,7 @@ footnotes: function () {
   var entriesToRemove = [];
   for (i = 0; i < noteholder.childNodes.length; i++) {
     var entry = noteholder.childNodes[i];
-    if (entry.nodeName == 'div' && entry.getAttribute("class") == "footnote")
+    if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
       entriesToRemove.push(entry);
   }
   for (i = 0; i < entriesToRemove.length; i++) {
@@ -756,13 +755,15 @@ asciidoc.install();
 <div class="sect1">
 <h2 id="_introduction">Introduction</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap if you
-want) for installing a plain Debian system (e.g. via Grml) very fast and easy.</p></div>
-<div class="paragraph"><p>All you have to do is adjust a few variables in configuration file
-/etc/debootstrap/config (or specify some variables via command line) and invoke
-grml-debootstrap without any further options then.</p></div>
-<div class="paragraph"><p>A plain and base Debian system will be installed on the given device (or
-directory) then. Customization of this process is possible as well.</p></div>
+<div class="paragraph"><p>grml-debootstrap is a wrapper suite around debootstrap (and cdebootstrap and mmdebstrap if you
+want) for installing a plain Debian system very fast and easy.</p></div>
+<div class="paragraph"><p>All you have to do is adjust a few variables in the configuration file
+/etc/debootstrap/config or specify some command line options and invoke
+grml-debootstrap. If invoked without any configuration modifications or command
+line options a dialog based front end will be available to control some basic
+configuration options.</p></div>
+<div class="paragraph"><p>A plain and base Debian system will be installed on the given device, directory
+or virtual image file then. Customization of this process is possible as well.</p></div>
 <div class="admonitionblock">
 <table><tr>
 <td class="icon">
@@ -789,6 +790,16 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--backportrepos</strong>
+</dt>
+<dd>
+<p>
+    Enable Debian&#8217;s Backports repository via the
+    /etc/apt/sources.list.d/backports.list configuration file. This provides the
+    option to install Debian packages from Debian&#8217;s backports repository.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>--bootappend</strong> <em>appendline-for-the-kernel</em>
 </dt>
 <dd>
@@ -817,6 +828,15 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--contrib</strong>
+</dt>
+<dd>
+<p>
+    Enable the <em>contrib</em> repository in COMPONENTS. By default only
+    the <em>main</em> repository is enabled.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>-d</strong>, <strong>--confdir</strong> <em>path</em>
 </dt>
 <dd>
@@ -842,12 +862,47 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--debug</strong>
+</dt>
+<dd>
+<p>
+   Execute in very verbose way. Useful for debugging possible problems
+   with grml-debootstrap or identify what&#8217;s actually executed.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--defaultinterfaces</strong>
+</dt>
+<dd>
+<p>
+   Install a default /etc/network/interfaces file (enabling DHCP for all local
+   Ethernet, WLAN and WWAN interfaces using predictable network interface names
+   and using eth0 as traditional interface name for backward compatibility)
+   instead of taking over config from host system.
+   This option is automatically enabled when using --vm or --vmfile.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--efi</strong> <em>device</em>
+</dt>
+<dd>
+<p>
+    Partition where EFI boot manager should be installed to. If the
+    specified device doesn&#8217;t use a FAT filesystem yet grml-debootstrap
+    automatically creates the filesystem. If a FAT filesystem is already
+    present the filesystem creation is skipped. Please ensure that it&#8217;s
+    a valid FAT32 filesystem and the partition has the <em>boot</em> and <em>esp</em>
+    flags enabled. This option requires EFI support on the running system
+    and the option is NOT supported for Virtual Machine deployments.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>--filesystem</strong> <em>filesystem</em>
 </dt>
 <dd>
 <p>
     Filesystem that should be created when installing to a partition.
-    If unset defaults to ext3. Valid values are all filesystems that
+    If unset defaults to ext4. Valid values are all filesystems that
     can be created through mkfs.<em>filesystem</em>.
 </p>
 </dd>
@@ -895,7 +950,7 @@ directory) then. Customization of this process is possible as well.</p></div>
 </dt>
 <dd>
 <p>
-    Use specified hostname instead of the default (being <em>grml</em>).
+    Use specified hostname instead of the default (being $HOSTNAME or if unset <em>grml</em>).
 </p>
 </dd>
 <dt class="hdlist1">
@@ -911,14 +966,6 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
-<strong>--insecure</strong>
-</dt>
-<dd>
-<p>
-    Do not download and check signatures for retrieved Release files.
-</p>
-</dd>
-<dt class="hdlist1">
 <strong>--keep_src_list</strong>
 </dt>
 <dd>
@@ -944,6 +991,34 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
+<strong>--nointerfaces</strong>
+</dt>
+<dd>
+<p>
+    Do not copy /etc/network/interfaces from host system to the target.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--nokernel</strong>
+</dt>
+<dd>
+<p>
+    Skip installation of default kernel images. This option might be
+    interesting for you if you want a Debian system which doesn&#8217;t
+    need to provide regular boot, e.g. a system which provides
+    ISOs for booting via GRUB using grml-rescueboot.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--non-free</strong>
+</dt>
+<dd>
+<p>
+    Enable the <em>non-free</em> repository in COMPONENTS. By default only
+    the <em>main</em> repository is enabled.
+</p>
+</dd>
+<dt class="hdlist1">
 <strong>--nopackages</strong>
 </dt>
 <dd>
@@ -992,13 +1067,15 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
-<strong>-r</strong>, <strong>--release</strong> <em>releasename</em>
+<strong>--post-scripts</strong> <em>directory</em>
 </dt>
 <dd>
 <p>
-    Specify release of new Debian system. Supported releases names: lenny,
-    squeeze, wheezy (note: requires current version of debootstrap) and sid.
-    Corresponding with configuration variable RELEASE.
+    Execute scripts from specified directory after executing the chroot script.
+    This allows customisation of the system after the chroot has been set up.
+    The environment variable $MNTPOINT is available inside the scripts for
+    direct access of the chroot.
+    Default directory: /etc/debootstrap/post-scripts/
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1014,14 +1091,44 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
-<strong>--scripts</strong> <em>directory</em>
+<strong>-r</strong>, <strong>--release</strong> <em>releasename</em>
 </dt>
 <dd>
 <p>
-    Execute scripts from specified directory. This allows customisation of
-    the system after the chroot has been set up. The environment variable
-    $MNTPOINT is available inside the scripts for direct access of the chroot.
-    Default directory: /etc/debootstrap/scripts/
+    Specify release of new Debian system. Supported releases names: lenny,
+    squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Corresponding with configuration
+    variable RELEASE. Default release: buster
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--remove-configs</strong>
+</dt>
+<dd>
+<p>
+    Delete grml-debootstrap configuration files (/etc/debootstrap/*) from installed
+    system. Useful for reproducible builds or if you don&#8217;t want to leak information.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--sshcopyauth</strong>
+</dt>
+<dd>
+<p>
+    Use locally available <em>$HOME/.ssh/authorized_keys</em> to authorise root login on the target system.
+    This installs <em>$HOME/.ssh/authorized_keys</em> as <em>/root/.ssh/authorized_keys</em> on
+    the target system. If a different file than <em>$HOME/.ssh/authorized_keys</em> should
+    be used, the environment variable <em>AUTHORIZED_KEYS_SOURCE</em> can be used.
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--sshcopyid</strong>
+</dt>
+<dd>
+<p>
+    Use locally available public keys to authorise root login on the target system.
+    Similar to ssh-copy-id(1) (without the -i option) it checks if <code>ssh-add -L</code>
+    provides any output, and if so those keys are appended to
+    <em>/root/.ssh/authorized_keys</em> (creating the file and directory (with mode 0700)).
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1030,9 +1137,7 @@ directory) then. Customization of this process is possible as well.</p></div>
 <dd>
 <p>
     Target partition (/dev/&#8230;) or directory (anything else without /dev at the
-    beginning). To install grub using <strong>--grub</strong> make sure to use a <em>device</em>
-    instead of a directory as <em>target</em> (installation of grub as bootloader when
-    using directories is NOT supported).
+    beginning).
 </p>
 </dd>
 <dt class="hdlist1">
@@ -1044,13 +1149,28 @@ directory) then. Customization of this process is possible as well.</p></div>
 </p>
 </dd>
 <dt class="hdlist1">
-<strong>--vmfile</strong>
+<strong>--vm</strong>
 </dt>
 <dd>
 <p>
-    Set up a Virtual Machine instead of installing to a partition or directory.
+    Set up a Virtual Machine on an existing block device, which will be
+    partitioned.
     This allows deployment of a Virtual Machine. The options needs to be
     combined with the --target option.
+    This option automatically enables the --defaultinterfaces option.
+    Usage example: --vm --target /dev/mapper/your-vm-disk
+</p>
+</dd>
+<dt class="hdlist1">
+<strong>--vmfile</strong>
+</dt>
+<dd>
+<p>
+    Set up a Virtual Machine using a regular file instead of installing to a
+    partition/block device or directory. This allows deployment of a Virtual
+    Machine. The options needs to be combined with the --target option
+    (<em>qemu-img create -f raw &#8230;</em> is executed on the specified target).
+    This option automatically enables the --defaultinterfaces option.
     Usage example: --vmfile --target /mnt/sda1/qemu.img
 </p>
 </dd>
@@ -1079,59 +1199,82 @@ directory) then. Customization of this process is possible as well.</p></div>
 <td class="icon">
 <img src="./images/icons/warning.png" alt="Warning" />
 </td>
-<td class="content">the command line parsing of grml-debootstrap does not validate the provided
-arguments for the command line options. Please be careful and check docs and
-/etc/debootstrap/config for further information.</td>
+<td class="content">the command line parsing of grml-debootstrap usually does not validate
+the provided arguments for the command line options. Please be careful and check
+docs and /etc/debootstrap/config for further information.</td>
 </tr></table>
 </div>
 </div>
 </div>
 <div class="sect1">
+<h2 id="_networking">Networking</h2>
+<div class="sectionbody">
+<div class="paragraph"><p>By default (that is, if none of the options <strong>--nointerfaces</strong>,
+<strong>--defaultinterfaces</strong>, <strong>--vmfile</strong> or <strong>--vm</strong> are given) /etc/network/interfaces
+will be copied from the host to the target system.</p></div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_usage_examples">Usage examples</h2>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre><tt>grml-debootstrap --target /dev/sda1 --grub /dev/sda</tt></pre>
+<pre><code>grml-debootstrap --target /dev/sda1 --grub /dev/sda</code></pre>
+</div></div>
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>grml-debootstrap --release stretch --target /dev/sda1 --grub /dev/sda --hostname debian01 --password changeme</code></pre>
+</div></div>
+<div class="paragraph"><p>Install Debian release stretch on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
+Set hostname to <em>debian01</em> and password for user root to <em>changeme</em>.</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</code></pre>
 </div></div>
-<div class="paragraph"><p>Install default Debian release (stable/squeeze) on /dev/sda1 and install bootmanager
-Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partition.</p></div>
+<div class="paragraph"><p>Install Debian unstable/sid on /dev/sda6 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grml-debootstrap --target /dev/sda6 --grub /dev/sda --release sid</tt></pre>
+<pre><code>DEBOOTSTRAP=mmdebstrap grml-debootstrap --target /dev/sda1 --grub /dev/sda</code></pre>
 </div></div>
-<div class="paragraph"><p>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.</p></div>
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda1 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
+Use mmdebstrap instead of default debootstrap tool for bootstrapping.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>mount /dev/sda1 /data/chroot
-grml-debootstrap --target /data/chroot</tt></pre>
+<pre><code>grml-debootstrap --target /dev/mapper/vg0-rootfs --grub /dev/sda</code></pre>
 </div></div>
-<div class="paragraph"><p>Install default Debian release (stable/squeeze) in directory /data/chroot (without
-any bootloader).</p></div>
+<div class="paragraph"><p>Install default Debian release (buster) on LVM device /dev/mapper/vg0-rootfs and install bootmanager GRUB in MBR (master boot record) of /dev/sda.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grml-debootstrap --target /dev/sda3 --grub /dev/sda  --mirror ftp://ftp.tugraz.at/mirror/debian</tt></pre>
+<pre><code>grml-debootstrap --efi /dev/sda1 --target /dev/sda2 --grub /dev/sda</code></pre>
 </div></div>
-<div class="paragraph"><p>Install default debian release (stable/squeeze) in a Virtual Machine file with
-3GB disk size (including Grub as bootmanager in MBR of the virtual disk file):</p></div>
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda2 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
+Use /dev/sda1 as EFI partition (requires EFI support in booted system).</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>mount /dev/sda1 /mnt/sda1
-grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img</tt></pre>
+<pre><code>mount /dev/sda1 /data/chroot
+grml-debootstrap --target /data/chroot</code></pre>
 </div></div>
-<div class="paragraph"><p>Install default Debian release (stable/squeeze) 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 (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>) one.</p></div>
+<div class="paragraph"><p>Install default Debian release (buster) in directory /data/chroot (without any bootloader).</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>mount -o loop /mnt/sda6/debian-40r0-i386-CD-1.iso /mnt/iso
-grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso file:/mnt/iso/debian/</tt></pre>
+<pre><code>grml-debootstrap --target /dev/sda3 --grub /dev/sda  --mirror ftp://ftp.tugraz.at/mirror/debian</code></pre>
 </div></div>
-<div class="paragraph"><p>Install Debian stable/squeeze on /dev/sda1 using the loopback mounted Debian-ISO
-for the base-system and install bootmanager Grub in MBR (master boot record) of
-/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.</p></div>
+<div class="paragraph"><p>Install default Debian release (buster) on /dev/sda3 and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
+Use specified mirror instead of the default (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>) one.</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>mount /dev/sda1 /mnt/sda1
+grml-debootstrap --vmfile --vmsize 3G --target /mnt/sda1/qemu.img</code></pre>
+</div></div>
+<div class="paragraph"><p>Install default debian release (buster) in a Virtual Machine file with 3GB disk size (including GRUB as bootmanager in MBR of the virtual disk file):</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>mount -o loop ./debian-CD-1.iso /media/cdrom
+grml-debootstrap --target /dev/sda1 --grub /dev/sda --iso /media/cdrom</code></pre>
+</div></div>
+<div class="paragraph"><p>Install Debian on /dev/sda1 using the loopback mounted Debian-ISO for the base-system and install bootmanager GRUB in MBR (master boot record) of /dev/sda.
+Please notice, that the chroot system requires network access for all packages which are not part of the ISO.</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1139,46 +1282,34 @@ ISO.</p></div>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/debootstrap/config</tt></pre>
+<pre><code>/etc/debootstrap/config</code></pre>
 </div></div>
-<div class="paragraph"><p>Main configuration file. You have to adjust it according to your needs
-if you want to execute grml-debootstrap in the non-interactive mode without
-any special command line arguments.</p></div>
+<div class="paragraph"><p>Main configuration file. Adjust it according to your needs if you want to
+execute grml-debootstrap in the non-interactive mode without any special command
+line arguments.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/debootstrap/chroot-script</tt></pre>
+<pre><code>/etc/debootstrap/chroot-script</code></pre>
 </div></div>
 <div class="paragraph"><p>The script executed within the new Debian system as soon as the main system
 has been installed via [c]debootstrap.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/debootstrap/locale.gen</tt></pre>
+<pre><code>/etc/debootstrap/locale.gen</code></pre>
 </div></div>
 <div class="paragraph"><p>Defines the default locales used for generating locales via locale-gen.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/debootstrap/packages</tt></pre>
+<pre><code>/etc/debootstrap/packages</code></pre>
 </div></div>
 <div class="paragraph"><p>Defines the software packages which should be installed in the new
 Debian system by default.</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>/etc/debootstrap/extrapackages/</tt></pre>
+<pre><code>/etc/debootstrap/extrapackages/</code></pre>
 </div></div>
 <div class="paragraph"><p>Debian Packages dropped in this directory will be installed into the new Debian
 system by default (Control variable: EXTRAPACKAGES)</p></div>
-<div class="literalblock">
-<div class="content">
-<pre><tt>/etc/debootstrap/stages/</tt></pre>
-</div></div>
-<div class="paragraph"><p>The default directory for storing information about executed stages. Every
-single function of grml-debootstrap will write <em>done</em> to the stages directory
-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-debootstrap after running it
-successfully once. This should avoid recurrent execution by error of
-grml-debootstrap (which might delete present data).</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1203,44 +1334,44 @@ make sure that EXTRAPACKAGES is set to "yes".</p></div>
 full automatic mode. While this mode isn&#8217;t really useful for interactive
 execution (just configure /etc/debootstrap/configure or specify the relevant
 variables on the command line instead) it is meant for use via boot option
-debian2hd. The boot option debian2hd (more precise: the kernelname on bootprompt)
-supports the following boot options (they correspond with the command line options
-mentioned above):</p></div>
+debian2hd on the Grml live system. The boot option debian2hd (more precise: the
+kernelname at the bootprompt) supports the following boot options (they
+correspond with the command line options mentioned above):</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>target=...</tt></pre>
+<pre><code>target=...</code></pre>
 </div></div>
 <div class="paragraph"><p>The target partition/directory of the new Debian system. Usage example:
 target=/dev/sda1</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>grub=...</tt></pre>
+<pre><code>grub=...</code></pre>
 </div></div>
 <div class="paragraph"><p>Where do you want to install grub to? Usage example: grub=/dev/sda</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>release=...</tt></pre>
+<pre><code>release=...</code></pre>
 </div></div>
-<div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian squeeze. Supported
-relases: lenny, squeeze, wheezy and sid. Usage example: release=sid</p></div>
+<div class="paragraph"><p>Specify release of new Debian system. Defaults to Debian buster. Supported
+releases: lenny, squeeze, wheezy, jessie, stretch, buster, bullseye and sid. Usage example: release=stretch</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>mirror=...</tt></pre>
+<pre><code>mirror=...</code></pre>
 </div></div>
 <div class="paragraph"><p>Specify mirror which should be used for apt-get/aptitude instead
-of the default one (<a href="ftp://ftp.debian.de/debian">ftp://ftp.debian.de/debian</a>).
+of the default one (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>).
 Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian</p></div>
 <div class="literalblock">
 <div class="content">
-<pre><tt>password=...</tt></pre>
+<pre><code>password=...</code></pre>
 </div></div>
 <div class="paragraph"><p>Set password of user root without prompting for it but set it to the given
 argument. Usage example: password=AiTh5ahn</p></div>
 <div class="sect2">
-<h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation:</h3>
+<h3 id="_usage_example_for_automatic_installation">Usage example for automatic installation</h3>
 <div class="literalblock">
 <div class="content">
-<pre><tt>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</tt></pre>
+<pre><code>debian2hd target=/dev/sda1 grub=/dev/sda mirror=ftp://ftp.tugraz.at/mirror/debian password=foobar</code></pre>
 </div></div>
 <div class="paragraph"><p>You have to enter this command line at the bootprompt of the Grml live system.
 Please make sure that /dev/sda1 is the partition where you really want to
@@ -1264,70 +1395,51 @@ boot options for grml-debootstrap.</td>
 <div class="sectionbody">
 <div class="tableblock">
 <table rules="all"
+width="40%"
 frame="hsides"
 cellspacing="0" cellpadding="4">
-<caption class="title">TableCurrent status</caption>
-<col width="114" />
-<col width="205" />
-<col width="182" />
+<caption class="title">Table 1. Current status</caption>
+<col width="50%" />
+<col width="50%" />
 <thead>
-  <tr>
-    <th align="right">
-    Release /
-    </th>
-    <th align="center">
-    Tool  debootstrap
-    </th>
-    <th align="center">
-    cdebootstrap
-    </th>
-  </tr>
+<tr>
+<th align="left" valign="top">Release  </th>
+<th align="left" valign="top">Status</th>
+</tr>
 </thead>
-<tbody valign="top">
-  <tr>
-    <td align="right">
-    Lenny
-    </td>
-    <td align="center">
-    works [1]
-    </td>
-    <td align="center">
-    works [1]
-    </td>
-  </tr>
-  <tr>
-    <td align="right">
-    Squeeze
-    </td>
-    <td align="center">
-    works
-    </td>
-    <td align="center">
-    works
-    </td>
-  </tr>
-  <tr>
-    <td align="right">
-    Wheezy
-    </td>
-    <td align="center">
-    works
-    </td>
-    <td align="center">
-    works
-    </td>
-  </tr>
-  <tr>
-    <td align="right">
-    Sid
-    </td>
-    <td align="center">
-    works [2]
-    </td>
-    <td align="center">
-    works [2]
-    </td>
-  </tr>
+<tbody>
+<tr>
+<td align="left" valign="top"><p class="table">lenny</p></td>
+<td align="left" valign="top"><p class="table">works[1]</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">squeeze</p></td>
+<td align="left" valign="top"><p class="table">works[1]</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">wheezy</p></td>
+<td align="left" valign="top"><p class="table">works[1]</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">jessie</p></td>
+<td align="left" valign="top"><p class="table">works</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">stretch</p></td>
+<td align="left" valign="top"><p class="table">works</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">buster</p></td>
+<td align="left" valign="top"><p class="table">works</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">bullseye</p></td>
+<td align="left" valign="top"><p class="table">works[2]</p></td>
+</tr>
+<tr>
+<td align="left" valign="top"><p class="table">sid</p></td>
+<td align="left" valign="top"><p class="table">works[2]</p></td>
+</tr>
 </tbody>
 </table>
 </div>
@@ -1337,11 +1449,39 @@ cellspacing="0" cellpadding="4">
 <img src="./images/icons/note.png" alt="Note" />
 </td>
 <td class="content">
-<div class="title">lenny release</div>
-<div class="paragraph"><p>[1] Please notice that lenny is the current old-stable release within Debian.
-grml-debootstrap can handle the release but you really should not use lenny
-anymore unless you really know what you are doing. Choose stable (squeeze)
-instead.</p></div>
+<div class="title">lenny/squeeze/wheezy release</div>
+<div class="paragraph"><p>[1] Please notice that releases like lenny, squeeze and wheezy 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.
+See <a href="https://wiki.debian.org/DebianReleases">https://wiki.debian.org/DebianReleases</a> for the list of supported releases.</p></div>
+<div class="paragraph"><p>Notice that you need to specify a mirror providing the lenny and squeeze releases, the
+default (<a href="http://deb.debian.org/debian">http://deb.debian.org/debian</a>) doesn&#8217;t provide it any longer nowadays.
+Set the mirror to e.g. <a href="http://archive.debian.org/debian/">http://archive.debian.org/debian/</a> if you don&#8217;t have
+your own lenny/squeeze mirror.</p></div>
+<div class="paragraph"><p>Older releases might also fail to install when running on top of recent kernel versions,
+throwing segfaults during debootstrap. This can be identified by the following messages inside kernel log (check with <em>dmesg</em>):</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>dpkg[...] vsyscall attempted with vsyscall=none ip:[...]
+dpkg[...]: segfault at [...]</code></pre>
+</div></div>
+<div class="paragraph"><p>To work around this issue boot your system with the kernel boot option <em>vsyscall=emulate</em>.</p></div>
+<div class="paragraph"><p>You also need to specify a filesystem that&#8217;s supported by lenny, e.g.
+<em>--filesystem ext3</em> since grml-debootstrap&#8217;s current default (ext4) isn&#8217;t
+supported by lenny.</p></div>
+<div class="paragraph"><p>Also when debootstrapping lenny on a live system with a kernel version
+like "3.16-1-grml-amd64" lenny&#8217;s libc will fail to install with:</p></div>
+<div class="literalblock">
+<div class="content">
+<pre><code>[...]
+/var/lib/dpkg/tmp.ci/preinst: line 265: [: 3.16-1-grml-amd64: integery expression expected
+/var/lib/dpkg/tmp.ci/preinst: line 231: 3.16-1-grml-amd64: syntax error: invalid arithemtic operator (error token is ".16-1-grml-amd64")
+dpkg: error processing /var/cache/apt/archives/libc6_2.7-18lenny7_amd64.deb (--install):
+[....]</code></pre>
+</div></div>
+<div class="paragraph"><p>To workaround this either debootstrap from a system with an according
+kernel version or use the "fake uname" workaround (just google for it).</p></div>
 <div class="paragraph"><p>When installing lenny to a new mdraid, grml-debootstrap will use md metadata
 format version 0.90. This limits the device to a maximum size of 2TB, but has
 the advantage of grub-legacy actually being able to boot from it.</p></div>
@@ -1354,10 +1494,10 @@ the advantage of grub-legacy actually being able to boot from it.</p></div>
 <img src="./images/icons/note.png" alt="Note" />
 </td>
 <td class="content">
-<div class="title">sid release</div>
-<div class="paragraph"><p>[2] Please notice that sid is Debian/unstable and due to its nature might not be
-always installable. What <em>might</em> work instead is deploying stable (squeeze) or
-testing (wheezy) and upgrade it after installation finished.</p></div>
+<div class="title">unstable and testing releases</div>
+<div class="paragraph"><p>[2] Please notice that Debian/testing and Debian/unstable (sid) might
+not be always installable due to their nature. What <em>might</em> work instead is
+deploying a stable release and upgrade it after installation finished.</p></div>
 </td>
 </tr></table>
 </div>
@@ -1366,13 +1506,13 @@ testing (wheezy) and upgrade it after installation finished.</p></div>
 <div class="sect1">
 <h2 id="_bugs">Bugs</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>Probably. Please send bugreports to Michael Prokop &lt;<a href="mailto:mika@grml.org">mika@grml.org</a>&gt;.</p></div>
+<div class="paragraph"><p>Please report bugs towards <a href="https://github.com/grml/grml-debootstrap/issues">https://github.com/grml/grml-debootstrap/issues</a></p></div>
 </div>
 </div>
 <div class="sect1">
 <h2 id="_see_also">See also</h2>
 <div class="sectionbody">
-<div class="paragraph"><p>debootstrap (8), cdebootstrap (1).</p></div>
+<div class="paragraph"><p>debootstrap (8), cdebootstrap (1), mmdebstrap(1).</p></div>
 </div>
 </div>
 <div class="sect1">
@@ -1385,7 +1525,8 @@ testing (wheezy) and upgrade it after installation finished.</p></div>
 <div id="footnotes"><hr /></div>
 <div id="footer">
 <div id="footer-text">
-Last updated 2012-04-10 12:22:02 CEST
+Last updated
+ 2020-06-03 14:44:11 UTC
 </div>
 </div>
 </body>
