Re: CVS commit: src/sys/arch/i386

[Alan Barrett <apb%cequrux.com@localhost>]

On Sat, 11 Oct 2008, Joerg Sonnenberger wrote:
> The second is done. For the former someone should turn the attached
> patch into readable form :)

Does the appended patch look OK?

Also, which of the following things that are documented in i386 boot(8)
should also be in MI boot(8), i386 pxeboot(8), or i386 dosboot(8)?

   * boot "-1" flag
   * boot "-2" flag
   * boot "-b" flag
   * boot "-m" flag
   * "load" command
   * "multiboot" command

--apb (Alan Barrett)

--- share/man/man8/man8.i386/boot.8     6 Oct 2008 21:04:51 -0000       1.43
+++ share/man/man8/man8.i386/boot.8     12 Oct 2008 12:59:12 -0000
@@ -1,6 +1,6 @@
 .\"    $NetBSD: boot.8,v 1.43 2008/10/06 21:04:51 pgoyette Exp $
 .\"
-.\" Copyright (c) 1991, 1993
+.\" Copyright (c) 1991-2008
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
 .\" This code is derived from software written and contributed
@@ -32,7 +32,7 @@
 .\"
 .\"     @(#)boot_i386.8        8.2 (Berkeley) 4/19/94
 .\"
-.Dd July 31, 2008
+.Dd October 12, 2008
 .Os
 .Dt BOOT 8 i386
 .Sh NAME
@@ -266,12 +266,84 @@
 .Cm boot .
 .It Ic help
 Print an overview about commands and arguments.
+.It Ic load Va module Op Va arguments
+Load the specified kernel
+.Va module ,
+and pass it the specified
+.Va arguments.
+If the module name is not an absolute path,
+.Pa /stand/ Xo Ns
+.Aq Sy arch Ns
+.Pa / Ns
+.Aq Sy osversion Ns
+.Pa /modules/ Ns
+.Aq Sy module Ns
+.Pa / Ns
+.Aq Sy module Ns
+.Pa .kmod
+.Xc
+is used.
+Possible used of the
+.Ic load
+command include loading a memory disk image before booting a kernel,
+or loading a Xen DOM0 kernel before booting the Xen hypervisor.
 .It Ic ls Op Pa path
 Print a directory listing of
 .Pa path ,
 containing inode number, filename, and file type.
 .Pa path
 can contain a device specification.
+.It Ic multiboot Va kernel Op Va arguments
+Boot the specified
+.Va kernel ,
+using the
+.Dq multiboot
+protocol instead of the native
+.Nx
+boot protocol.
+The multiboot protocol may be used in the following cases:
+.Bl -tag -width indent
+.It Nx Ns / Ns  Xen No kernels
+The Xen DOM0 kernel must be loaded as a module using the
+.Ic load
+command, and the Xen hypervisor must be booted using the
+.Ic multiboot
+command.
+Options for the DOM0 kernel (such as
+.Dq -s
+for single user mode) must be passed as options to the
+.Ic load
+command.
+Options for the hypervisor (such as
+.Dq dom0_mem=256M
+to reserve 256 MB of memory for DOM0)
+must be passed as options to the
+.Ic multiboot
+command.
+.It Nx No multiboot kernels
+A
+.Nx
+kernel that was built with
+.Cd options MULTIBOOT
+(see
+.Xr multiboot 8 )
+may be booted with either the
+.Ic boot
+or
+.Ic multiboot
+command, passing the same arguments in either case.
+.It Non- Ns Nx No kernels
+A kernel for a
+.No non- Ns Nx
+operating system that expects to be booted using the
+multiboot protocol (such as by the GNU
+.Dq GRUB
+boot loader)
+may be booted using the
+.Ic multiboot
+command.
+See the foreign operating system's documentation for the available arguments.
+.El
 .It Ic quit
 Reboot the system.
 .El
@@ -309,6 +381,7 @@
 .Xr halt 8 ,
 .Xr installboot 8 ,
 .Xr mbr 8 ,
+.Xr multiboot 8 ,
 .Xr pxeboot 8 ,
 .Xr reboot 8 ,
 .Xr shutdown 8 ,