[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#803267: Instructions for creating syslinux.cfg are incorrect



Package: installation-guide
Tags: patch

Hi,

Syslinux 5.00 makes global APPEND directives be ignored by the DEFAULT
directive:

 http://www.syslinux.org/wiki/index.php/Directives/append#default

Since the Debian installer manual recommends using a global APPEND
directive to specify the initrd, "initrd=initrd.gz" is not used by the
DEFAULT directive, which causes the installer to fail to boot.  The
following patch is one way to address this problem:


Index: manual/en/install-methods/usb-setup/x86.xml
===================================================================
--- manual/en/install-methods/usb-setup/x86.xml	(revision 70046)
+++ manual/en/install-methods/usb-setup/x86.xml	(working copy)
@@ -93,17 +93,18 @@
 </para><para>
 
 Next you should create a <filename>syslinux.cfg</filename> configuration
-file, which at a bare minimum should contain the following two lines (change
-the name of the kernel binary to <quote><filename>linux</filename></quote>
-if you used a <filename>netboot</filename> image):
+file, which at a bare minimum should contain the following line (change
+the name of the kernel binary from
+<quote><filename>vmlinuz</filename></quote> to
+<quote><filename>linux</filename></quote> if you used a
+<filename>netboot</filename> image):
 
 <informalexample><screen>
-default vmlinuz
-append initrd=initrd.gz
+default vmlinuz initrd=initrd.gz
 </screen></informalexample>
 
 For the graphical installer you should add <userinput>vga=788</userinput> to the
-second line. Other parameters can be appended as desired.
+line. Other parameters can be appended as desired.
 
 </para><para>
 


The Syslinux wiki recommends using something like the following, but I
assume the above, shorter version is preferred:

 DEFAULT mylabel
 LABEL mylabel
 KERNEL vmlinuz
 APPEND initrd=initrd.gz

-- 
Matt                                           https://ftbfs.org/~kraai/


Reply to: