docs/70952: Handbook section 16.6.2 has bad example

[Jon Wallace]

>Number:         70952
>Category:       docs
>Synopsis:       Handbook section 16.6.2 has bad example
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Aug 25 19:10:22 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Jon Wallace
>Release:        FreeBSD 5.2.1-RELEASE
>Organization:
Advanced Digital Research
>Environment:
# uname -a
FreeBSD wallace 5.2.1-RELEASE FreeBSD 5.2.1-RELEASE #4: Mon Aug  9 21:29:44 EDT 2004     root at wallace:/usr/obj/usr/src/sys/WALLACE  i386
>Description:
The example provided in Handbook Section 16.6.2 contains an example that results in an error on the OS.  The example is:
# mkisofs -U -R -b boot/cdboot -o /tmp/bootable.iso /tmp/myboot

Running this command however, produces the following error:
# mkisofs -U -R -b boot/cdboot -o ../test.iso .
Warning: creating filesystem that does not conform to ISO-9660.
Size of boot image is 4 sectors -> mkisofs: Error - boot image './boot/cdboot' is not the an allowable size.

The mkisofs command stops and no image is created.  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.
>How-To-Repeat:
1)Try to create a bootable cdrom with
# mkisofs -U -R -b boot/cdboot -o /tmp/bootable.iso /tmp/myboot
2) You should see an error:
Size of boot image is 4 sectors -> mkisofs: Error - boot image './boot/cdboot' is not the an allowable size.

1) Try to build a bootable cdrom with the command
mkisofs -U -R -b boot/cdboot -no-emul-boot -o ../test.iso .
2) Burn a cdrom with the test image
3) Boot the cdrom
4) The bootup will fail to find /boot/loader and stop
>Fix:
1) Create a bootable cdrom with:
mkisofs -L -D -R -b boot/cdboot -no-emul-boot -o ../test.iso .

>Release-Note:
>Audit-Trail:
>Unformatted: