subject=Re: docs/70952: Handbook section 16.6.2 has bad example

[Sebastian Schulze Struchtrup]

The following reply was made to PR docs/70952; it has been noted by GNATS.

From: Sebastian Schulze Struchtrup <seb at struchtrup.com>
To: freebsd-gnats-submit at FreeBSD.org, jon at whoweb.com
Cc:  
Subject: subject=Re: docs/70952: Handbook section 16.6.2 has bad example
Date: Mon, 11 Oct 2004 19:17:44 +0200

 doc/70952:
 > There appear to be two problems with the example
 > First, the cdboot file is not a standard floppy boot size so using
 > the -b flag without a corresponding -no-emul-boot flag.  
 > The mkisofs(8) manpage describes this.Second, the -U flag does not
 > appear to work with FreeBSD.  Booting a CDrom created with -U
 > produces the following boot error: 
 > Looking up /BOOT/LOADER...file not found
 > and the boot procedure hangs.
 
 
 I discoved the same problem regarding the missing -no-emul-boot 
 parameter to mkisofs.
 But booting the created CDROM (with -U) works fine for me.
 The boot code looks for /BOOT/LOADER and /boot/loader.
 
 A patch to correct the documentation is attached below.
 I have added the -no-emul-boot flag and added another sentence 
 describing the reason for adding this.
 
 
 Index: chapter.sgml
 ===================================================================
 RCS file: /usr/home/cvs/freebsd/doc/en_US.ISO8859-1/books/handbook/disks/chapter.sgml,v
 retrieving revision 1.222
 diff -U2 -r1.222 chapter.sgml
 --- chapter.sgml	26 Sep 2004 20:08:31 -0000	1.222
 +++ chapter.sgml	8 Oct 2004 16:01:55 -0000
 @@ -1032,5 +1032,9 @@
  	<quote>El Torito</quote> bootable CD. This option takes an
  	argument which is the path to a boot image from the top of the
 -	tree being written to the CD. So, given that
 +	tree being written to the CD. The default for mkisofs is to use
 +	floopy disc emulation with an image sizes of exactly 1200, 1440 or
 +	2880 KB. The FreeBSD cdrom boot loader <filename>/boot/cdboot</filename>
 +	does not use any emulation. Hence, we have to add the
 +	<option>-no-emul-boot</option>. So, given that 
  	<filename>/tmp/myboot</filename> holds a bootable FreeBSD system
  	with the boot image in
 @@ -1039,5 +1043,5 @@
  	<filename>/tmp/bootable.iso</filename> like so:</para>
  
 -      <screen>&prompt.root; <userinput>mkisofs -U -R -b boot/cdboot -o /tmp/bootable.iso /tmp/myboot</userinput></screen>
 +      <screen>&prompt.root; <userinput>mkisofs -U -R -no-emul-boot -b boot/cdboot -o /tmp/bootable.iso /tmp/myboot</userinput></screen>
  
        <para>Having done that, if you have <devicename>vn</devicename>