From 68193d8c674402b5b19eae091ccc07a207080fa2 Mon Sep 17 00:00:00 2001 From: Neil Williams Date: Sun, 31 Jul 2016 13:57:41 +0100 Subject: add note about syslinux on stretch/sid and ext4 --- doc/overview.rst | 30 ++++++++++++++++++++++++++---- 1 file changed, 26 insertions(+), 4 deletions(-) (limited to 'doc') diff --git a/doc/overview.rst b/doc/overview.rst index d76c952..65f039a 100644 --- a/doc/overview.rst +++ b/doc/overview.rst @@ -74,9 +74,9 @@ Options :file:`/usr/share/vmdebootstrap/examples/` will be checked as a fallback. The script needs to be executable and is passed the root directory of the - debootstrap as the only argument. Use chroot if - you need to execute binaries within the - debootstrap. + debootstrap and the image name as the only arguments. + Use chroot if you need to execute binaries within + the chroot created by debootstrap. --hostname=HOSTNAME set name to HOSTNAME (debian) --user=USERSTRING create USER with PASSWORD. The USERSTRING needs to be of the format: USER/PASSSWORD. @@ -157,7 +157,7 @@ Options --convert-qcow2 Convert the final raw image to qcow2 format. --no-systemd-networkd Do not use Predictable Network Interface Names using - systemd-networkd. + systemd-networkd. Configuration files and settings ******************************** @@ -255,6 +255,28 @@ Unless the ``--no-extlinux`` or ``--grub`` options are specified, the image will use ``extlinux`` as a boot loader. ``bootsize`` is not recommended when using ``extlinux`` --- use ``grub`` instead. +.. _extlinux_ext4: + +extlinux support issues with ext4 +================================= + +VMs using ext4 may not boot when using extlinux - unless the build is +performed on Jessie. Builds using ext2 and ext3 work normally. + +.. important:: This problem depends on the **external** distribution, + **not** the distribution you are trying to build. When building on + Jessie, ``extlinux`` succeeds but when building on Stretch or Sid, + ``extlinux`` fails to make a bootable system if the filesystem of + that system is **ext4**. ext2 and ext3 work. + +Version 1.6 of vmdebootstrap adds a warning but allows the build to +proceed (to allow for the bug to be fixed). Sadly, downgrading the +version of extlinux to the version in Jessie does not fix the problem +when building on stretch or sid. Hence, vmdebootstrap can only output +a warning. + +.. seealso:: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=833057 + .. _wheezy_grub: Versions of grub2 in wheezy -- cgit v1.2.1