[src/trunk]: src/share/man/man8/man8.x86 Document fs, menu, rndseed, and spla...

[apb <apb%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/8707389f8752
branches:  trunk
changeset: 801750:8707389f8752
user:      apb <apb%NetBSD.org@localhost>
date:      Sat Aug 16 11:41:37 2014 +0000

description:
Document fs, menu, rndseed, and splash commands.
Add rescue(8) to SEE ALSO.
Also a little copy editing.

diffstat:

 share/man/man8/man8.x86/boot.8 |  58 +++++++++++++++++++++++++++++++++++++++--
 1 files changed, 54 insertions(+), 4 deletions(-)

diffs (121 lines):

diff -r b1bab4080cef -r 8707389f8752 share/man/man8/man8.x86/boot.8
--- a/share/man/man8/man8.x86/boot.8    Sat Aug 16 11:39:47 2014 +0000
+++ b/share/man/man8/man8.x86/boot.8    Sat Aug 16 11:41:37 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: boot.8,v 1.2 2014/08/16 08:43:12 apb Exp $
+.\"    $NetBSD: boot.8,v 1.3 2014/08/16 11:41:37 apb Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -48,7 +48,9 @@
 and its clones
 .Pc
 that can run
-.Nx Ns /x86
+.Nx Ns /i386
+or
+.Nx Ns /amd64
 can use any of the following boot procedures, depending on what the hardware and
 .Tn BIOS
 support:
@@ -137,7 +139,7 @@
 text and displaying a menu allowing boot commands to be easily chosen.
 See
 .Xr boot.cfg 5 .
-.Pp
+.Ss Boot Protocol
 The
 .Nx Ns /x86
 boot loader can boot a kernel using either the native
@@ -347,6 +349,13 @@
 .Va device
 is of the form specified in
 .Cm boot .
+.It Ic fs Va file
+Load a file system image from the specified
+.Ar file ,
+and request the kernel to use it as the root file system.
+The
+.Xr makefs 8
+utility may be used to create suitable file system images.
 .It Ic help
 Print an overview about commands and arguments.
 .It Ic load Va module Op Ar arguments
@@ -380,7 +389,9 @@
 .Pp
 In addition to the
 .Cm boot
-options specified above, the DOM0 kernel accepts
+options specified above, the
+.Tn Xen
+DOM0 kernel accepts
 .Po Ar arguments
 being separated with spaces
 .Pc :
@@ -458,6 +469,10 @@
 containing inode number, filename, and file type.
 .Pa path
 can contain a device specification.
+.It Ic menu
+Display the boot menu and initiate a countdown,
+similarly to what would have happened if interactive mode
+had not been entered.
 .It Ic modules Bro Ar on | off | enabled | disabled Brc
 The values
 .Ar enabled , on
@@ -538,6 +553,32 @@
 .El
 .It Ic quit
 Reboot the system.
+.It Ic rndseed Ar file
+Load the specified
+.Ar file
+and request the kernel to use it as a seed for the
+.Xr rnd 4
+random number generator.
+The
+.Ar file
+should be in the private format used by
+.Xr rndctl 8 ,
+and should have been saved by
+.Ql "rndctl -S"
+shortly before the previous shutdown.
+See the
+.Va random_seed
+and
+.Va random_file
+variables in
+.Xr rc.conf 5 ,
+and the
+.Pa /etc/rc.d/random_seed
+script, for a way to manage the seed file.
+Using the same seed file on more then one host,
+or for more than one boot on the same host,
+will reduce the quality of random numbers
+and may impact system security.
 .It Ic userconf Va command
 Pass command
 .Va command
@@ -547,6 +588,14 @@
 These commands are processed before the interactive
 .Xr userconf 4
 shell is executed, if requested.
+.It Ic splash Ar file
+Load a graphical image from the specified
+.Ar file
+and request the kernel to use it as a splash screen.
+The
+.Ar file
+should contain an image in one of these formats:
+JPEG, PNG, BMP, GIF, PSD, or PIC.
 .It Ic vesa Bro Va modenum | Ar on | off | enabled | disabled | list Brc
 Initialise the video card to the specified resolution and bit depth.
 The
@@ -600,6 +649,7 @@
 .Xr multiboot 8 ,
 .Xr pxeboot 8 ,
 .Xr reboot 8 ,
+.Xr rescue 8 ,
 .Xr shutdown 8 ,
 .Xr boothowto 9
 .Sh BUGS