CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: gutteridge Date: Tue Jun 22 03:39:21 UTC 2021 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: boot.8: minor grammar tweaks To generate a diff of this commit: cvs rdiff -u -r1.25 -r1.26 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.25 src/share/man/man8/man8.x86/boot.8:1.26 --- src/share/man/man8/man8.x86/boot.8:1.25 Sun May 30 06:05:24 2021 +++ src/share/man/man8/man8.x86/boot.8 Tue Jun 22 03:39:21 2021 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.25 2021/05/30 06:05:24 mlelstv Exp $ +.\" $NetBSD: boot.8,v 1.26 2021/06/22 03:39:21 gutteridge Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -877,13 +877,13 @@ field of the disklabel (if it is a hard disk). .Pp .Tn UEFI -implementation are supposed to support either +implementations are supposed to support either .Xr x86/mbr 8 or .Xr gpt 8 partitioning, but some do not handle the latter. .Tn UEFI -Booting +booting from a .Xr gpt 8 partitioned disk is still possible in this case, by adding
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: gutteridge Date: Tue Jun 22 03:30:06 UTC 2021 Modified Files: src/share/man/man8/man8.x86: mbr.8 Log Message: mbr.8: fix a typo To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man8/man8.x86/mbr.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/mbr.8 diff -u src/share/man/man8/man8.x86/mbr.8:1.4 src/share/man/man8/man8.x86/mbr.8:1.5 --- src/share/man/man8/man8.x86/mbr.8:1.4 Mon Jul 3 21:31:01 2017 +++ src/share/man/man8/man8.x86/mbr.8 Tue Jun 22 03:30:06 2021 @@ -1,4 +1,4 @@ -.\" $NetBSD: mbr.8,v 1.4 2017/07/03 21:31:01 wiz Exp $ +.\" $NetBSD: mbr.8,v 1.5 2021/06/22 03:30:06 gutteridge Exp $ .Dd February 17, 2017 .Dt MBR 8 x86 .Os @@ -96,7 +96,7 @@ The key will cause the bootcode to find the active partition, and boot from it. If no key is pressed, the (configurable) default selection is picked. .Sh DIAGNOSTICS -The following error are detected: +The following errors are detected: .Bl -column Code "No active partition" .It Em Code Ta Em "Text message" Ta Em Explanation .It 1 Ta "No active partition" Ta
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: mlelstv Date: Sun May 30 06:05:24 UTC 2021 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Add "root" command to pass a root specification. To generate a diff of this commit: cvs rdiff -u -r1.24 -r1.25 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.24 src/share/man/man8/man8.x86/boot.8:1.25 --- src/share/man/man8/man8.x86/boot.8:1.24 Thu Apr 22 01:36:25 2021 +++ src/share/man/man8/man8.x86/boot.8 Sun May 30 06:05:24 2021 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.24 2021/04/22 01:36:25 rin Exp $ +.\" $NetBSD: boot.8,v 1.25 2021/05/30 06:05:24 mlelstv Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -617,6 +617,9 @@ See the foreign operating system's docum .El .It Ic quit Reboot the system. +.It Ic root Ar spec +Pass an explicit root specification to the kernel. +See BTINFO_ROOTDEVICE for details. .It Ic rndseed Ar file Load the specified .Ar file @@ -713,8 +716,10 @@ This will be automatically substituted b .Xr dk 4 wedge if one is discovered. .Pp -The bootloader passes a wedge name as +If the bootloader passes a wedge name as .Dq Li wedge: +or +.Dq Li NAME= followed by the name. The kernel will search for a .Xr dk 4
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: rin Date: Thu Apr 22 01:36:25 UTC 2021 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Capitalize /EFI and /EFI/NetBSD as usual. Both are case-insensitive although. Maybe not worth bumping dates... To generate a diff of this commit: cvs rdiff -u -r1.23 -r1.24 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.23 src/share/man/man8/man8.x86/boot.8:1.24 --- src/share/man/man8/man8.x86/boot.8:1.23 Mon Aug 10 01:10:26 2020 +++ src/share/man/man8/man8.x86/boot.8 Thu Apr 22 01:36:25 2021 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.23 2020/08/10 01:10:26 uwe Exp $ +.\" $NetBSD: boot.8,v 1.24 2021/04/22 01:36:25 rin Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -797,7 +797,7 @@ bootstraps for and .Nx Ns /amd64 , which should be copied to the -.Pa /efi/boot +.Pa /EFI/boot directory in a .Tn FAT formatted partition of type @@ -812,7 +812,7 @@ section). .Nx .Tn UEFI bootstrap reads its configuration from the -.Pa /efi/netBSD/boot.cfg +.Pa /EFI/NetBSD/boot.cfg file in the .Tn EFI partition.
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: uwe Date: Mon Aug 10 01:10:26 UTC 2020 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Formatting fixes for PostScript output. Mostly use .Ar instead of .Va and use -literal, .Ql, etc where appropriate. To generate a diff of this commit: cvs rdiff -u -r1.22 -r1.23 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.22 src/share/man/man8/man8.x86/boot.8:1.23 --- src/share/man/man8/man8.x86/boot.8:1.22 Sun Aug 9 18:54:59 2020 +++ src/share/man/man8/man8.x86/boot.8 Mon Aug 10 01:10:26 2020 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.22 2020/08/09 18:54:59 kim Exp $ +.\" $NetBSD: boot.8,v 1.23 2020/08/10 01:10:26 uwe Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -99,7 +99,7 @@ master boot record - see .Xr x86/mbr 8 ) . .Ss Normal Operation Once running, a banner similar to the following will appear: -.Bd -unfilled -offset indent +.Bd -literal -offset indent >> NetBSD BIOS Boot, revision 3.0 >> (user@buildhost, builddate) >> Memory: 637/15360 k @@ -113,7 +113,7 @@ In the example above, it will be which is the file .Pa /netbsd on partition -.Dq a +.Dq Li a of the .Nx .Tn MBR @@ -122,7 +122,7 @@ partition of the first hard disk known t .Po which is an .Tn IDE -or similar device - see the +or similar device \(em see the .Sx BUGS section .Pc . @@ -173,9 +173,9 @@ input of these commands: .\" also duplicated in the x86-specific x86/dosboot.8 and x86/pxeboot.8; .\" please try to keep all relevant files synchronized. .Bl -tag -width 04n -offset 04n -.It Ic boot Oo Va device : Oc Ns Oo Va filename Oc Oo Fl 1234abcdmqsvxz Oc +.It Ic boot Oo Ar device Ns Ic \&: Oc Ns Oo Ar filename Oc Oo Fl 1234abcdmqsvxz Oc The default -.Va device +.Ar device will be set to the disk from which the boot loader was loaded. The partition is set to the first match in this list: .Bl -enum @@ -196,22 +196,22 @@ The first partition. .Pp To boot from an alternate disk, the full name of the device should be given at the prompt. -.Va device +.Ar device is of the form -.Va NAME=partition_label +.Li NAME= Ns Ar partition_label when booting from a .Xr gpt 8 partitioned disk. Otherwise, the syntax is -.Xo Va xd -.Op Va N Ns Op Va x +.Xo Ar xd\^ Ns +.Op Ar N\^ Ns Op Ar x .Xc where -.Va xd +.Ar xd is the device from which to boot, -.Va N +.Ar N is the unit number, and -.Va x +.Ar x is the partition letter. .Pp In the latter case, the following list of supported devices may @@ -238,7 +238,7 @@ attribute set. Inner RAIDframe partitions can also be given to the .Ic dev command using he -.Va NAME=partition_label +.Li NAME= Ns Ar partition_label syntax. .El .Pp @@ -261,7 +261,7 @@ Options are: .Bl -tag -width xxx .It Fl 1 Sets the machine-dependent flag -.Sy RB_MD1 +.Dv RB_MD1 in .Va boothowto . In @@ -270,7 +270,7 @@ this disables multiprocessor boot; the kernel will boot in uniprocessor mode. .It Fl 2 Sets the machine-dependent flag -.Sy RB_MD2 +.Dv RB_MD2 in .Va boothowto . In @@ -278,7 +278,7 @@ In this disables ACPI. .It Fl 3 Sets the machine-dependent flag -.Sy RB_MD3 +.Dv RB_MD3 in .Va boothowto . In @@ -286,7 +286,7 @@ In this disables SVS. .It Fl 4 Sets the machine-dependent flag -.Sy RB_MD4 +.Dv RB_MD4 in .Va boothowto . In @@ -294,7 +294,7 @@ In this has no effect. .It Fl a Sets the -.Sy RB_ASKNAME +.Dv RB_ASKNAME flag in .Va boothowto . This causes the kernel to prompt for the root file system device, @@ -302,13 +302,13 @@ the system crash dump device, and the pa .Xr init 8 . .It Fl b Sets the -.Sy RB_HALT +.Dv RB_HALT flag in .Va boothowto . This causes subsequent reboot attempts to halt instead of rebooting. .It Fl c Sets the -.Sy RB_USERCONF +.Dv RB_USERCONF flag in .Va boothowto . This causes the kernel to enter the @@ -320,7 +320,7 @@ allows devices to be enabled or disabled to be modified before the kernel attempts to attach the devices. .It Fl d Sets the -.Sy RB_KDB +.Dv RB_KDB flag in .Va boothowto . Requests the kernel to enter debug mode, in which it @@ -328,76 +328,76 @@ waits for a connection from a kernel deb .Xr ddb 4 . .It Fl m Sets the -.Sy RB_MINIROOT +.Dv RB_MINIROOT flag in .Va boothowto . Informs the kernel that a mini-root file system is present in memory. .It Fl q Sets the -.Sy AB_QUIET +.Dv AB_QUIET flag in .Va boothowto . Boot the system in quiet mode. .It Fl s Sets the -.Sy RB_SINGLE +.Dv RB_SINGLE flag in .Va boothowto . Boot the system in single-user mode. .It Fl v Sets the -.Sy AB_VERBOSE +.Dv AB_VERBOSE flag in .Va boothowto . Boot the system in verbose mode. .It Fl x Sets the -.Sy AB_DEBUG +.Dv AB_DEBUG flag in .Va boothowto . Boot the system with debug
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: kim Date: Sun Aug 9 18:54:59 UTC 2020 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Fix cross-refs to x86/mbr that were still missing x86 Additionally made some typo fixes, and added some vertical whitespace to lists that felt crowded. Unified markup for displaying commands. To generate a diff of this commit: cvs rdiff -u -r1.21 -r1.22 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.21 src/share/man/man8/man8.x86/boot.8:1.22 --- src/share/man/man8/man8.x86/boot.8:1.21 Wed Jul 15 12:38:30 2020 +++ src/share/man/man8/man8.x86/boot.8 Sun Aug 9 18:54:59 2020 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.21 2020/07/15 12:38:30 kim Exp $ +.\" $NetBSD: boot.8,v 1.22 2020/08/09 18:54:59 kim Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -178,7 +178,7 @@ The default .Va device will be set to the disk from which the boot loader was loaded. The partition is set to the first match in this list: -.Bl -enum -compact +.Bl -enum .It The first .Xr gpt 8 @@ -193,6 +193,7 @@ The first partition with a file system t .It The first partition. .El +.Pp To boot from an alternate disk, the full name of the device should be given at the prompt. .Va device @@ -213,10 +214,9 @@ is the unit number, and .Va x is the partition letter. .Pp -In the later case, the following list of supported devices may +In the latter case, the following list of supported devices may vary from installation to installation: -.Pp -.Bl -hang -compact +.Bl -hang .It hd Hard disks as numbered by the BIOS. This includes ST506, IDE, ESDI, RLL disks on a WD100[2367] or @@ -767,7 +767,7 @@ directory in a formatted partition of type .Tn EFI (Either -.Xr mbr 8 +.Xr x86/mbr 8 and .Xr gpt 8 , see the @@ -839,10 +839,10 @@ disklabel (if it is a hard disk). .Pp .Tn UEFI implementation are supposed to support either -.Xr mbr 8 +.Xr x86/mbr 8 or .Xr gpt 8 -partitionning, but some do not handle the later. +partitioning, but some do not handle the latter. .Tn UEFI Booting from a @@ -851,17 +851,20 @@ partitioned disk is still possible in th an overlapping .Tn EFI partition in the protective -.Xr mbr 8 +.Xr x86/mbr 8 block. This can be achieved using the following commands (you must adapt the hard disk and .Tn EFI partition start end size to fit your setup): -.Dl Ic dd if=/dev/rwd0d bs=512 count=1 of=mbr -.Dl Ic fdisk -FIfaui1s 4/34/32768 -c /usr/mdec/mbr mbr -.Dl Ic dd if=mbr bs=512 count=1 of=/dev/rwd0d conv=notrunc +.Bd -unfilled -offset indent +.Cm dd if=/dev/rwd0d bs=512 count=1 of=mbr +.Cm fdisk -FIfaui1s 4/34/32768 -c /usr/mdec/mbr mbr +.Cm dd if=mbr bs=512 count=1 of=/dev/rwd0d conv=notrunc +.Ed +.Pp The resulting -.Xr mbr 8 +.Xr x86/mbr 8 partition table will look like this: .Bd -unfilled -offset indent 0: GPT Protective MBR (sysid 238)
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: kim Date: Wed Jul 15 12:38:30 UTC 2020 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Document optional speed argument to consdev To generate a diff of this commit: cvs rdiff -u -r1.20 -r1.21 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.20 src/share/man/man8/man8.x86/boot.8:1.21 --- src/share/man/man8/man8.x86/boot.8:1.20 Mon Sep 16 01:57:58 2019 +++ src/share/man/man8/man8.x86/boot.8 Wed Jul 15 12:38:30 2020 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.20 2019/09/16 01:57:58 manu Exp $ +.\" $NetBSD: boot.8,v 1.21 2020/07/15 12:38:30 kim Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 .\" -.Dd September 13, 2019 +.Dd July 15, 2020 .Dt BOOT 8 x86 .Os .Sh NAME @@ -363,7 +363,7 @@ flag in .Va boothowto . Boot the system in silent mode. .El -.It Ic consdev Va dev +.It Ic consdev Va dev Ns Oo Ns , Ns Va speed Oc Immediately switch the console to the specified device .Va dev and reprint the banner. @@ -379,6 +379,17 @@ See .Sx Console Selection Policy in .Xr x86/boot_console 8 . +.Pp +A +.Va speed +for the serial port is optional and defaults to 9600. +If a value of zero is specified, then the current baud rate (set by the +BIOS) will be used. +Setting the +.Va speed +with the +.Ar pc +device is not possible. .It Ic dev Op Va device Set the default drive and partition for subsequent file system operations.
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: wiz Date: Tue Nov 27 10:35:03 UTC 2018 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Remove superfluous Ns. To generate a diff of this commit: cvs rdiff -u -r1.13 -r1.14 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.13 src/share/man/man8/man8.x86/boot.8:1.14 --- src/share/man/man8/man8.x86/boot.8:1.13 Sun Nov 25 18:14:55 2018 +++ src/share/man/man8/man8.x86/boot.8 Tue Nov 27 10:35:03 2018 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.13 2018/11/25 18:14:55 maya Exp $ +.\" $NetBSD: boot.8,v 1.14 2018/11/27 10:35:03 wiz Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -423,8 +423,8 @@ See in .Xr x86/boot_console 8 . .It Xo Ic ip Ns = Ns -.Ar my_ip Ns : Ns Ar serv_ip Ns : Ns Ar gw_ip Ns : Ns -.Ar mask Ns : Ns Ar host Ns : Ns Ar iface +.Ar my_ip : Ns Ar serv_ip : Ns Ar gw_ip : Ns +.Ar mask : Ns Ar host : Ns Ar iface .Xc Specify various parameters for a network boot (IPs are in dot notation), @@ -447,7 +447,7 @@ or .Dq eth0 .Pc .El -.It Ic nfsroot Ns = Ns Ar address Ns : Ns Ar rootpath +.It Ic nfsroot Ns = Ns Ar address : Ns Ar rootpath Boot the system with root on NFS. .Ar address is the address of the NFS server, and
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: maya Date: Sun Nov 25 18:14:55 UTC 2018 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: port-i386/44562: mention correct kernel name order. To generate a diff of this commit: cvs rdiff -u -r1.12 -r1.13 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.12 src/share/man/man8/man8.x86/boot.8:1.13 --- src/share/man/man8/man8.x86/boot.8:1.12 Mon Jul 3 21:31:01 2017 +++ src/share/man/man8/man8.x86/boot.8 Sun Nov 25 18:14:55 2018 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.12 2017/07/03 21:31:01 wiz Exp $ +.\" $NetBSD: boot.8,v 1.13 2018/11/25 18:14:55 maya Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 .\" -.Dd February 17, 2017 +.Dd November 25, 2018 .Dt BOOT 8 x86 .Os .Sh NAME @@ -213,11 +213,11 @@ if the boot loader fails to successfully open that image, it then tries .Pa netbsd.gz (expected to be a kernel image compressed by gzip), followed by -.Pa netbsd.old , -.Pa netbsd.old.gz , .Pa onetbsd , +.Pa onetbsd.gz , +.Pa netbsd.old , and finally -.Pa onetbsd.gz . +.Pa netbsd.old.gz . Alternate system images can be loaded by just specifying the name of the image. .Pp Options are:
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: christos Date: Sat Feb 18 21:51:36 UTC 2017 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: remove extra / To generate a diff of this commit: cvs rdiff -u -r1.10 -r1.11 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.10 src/share/man/man8/man8.x86/boot.8:1.11 --- src/share/man/man8/man8.x86/boot.8:1.10 Sat Feb 18 16:39:53 2017 +++ src/share/man/man8/man8.x86/boot.8 Sat Feb 18 16:51:36 2017 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.10 2017/02/18 21:39:53 wiz Exp $ +.\" $NetBSD: boot.8,v 1.11 2017/02/18 21:51:36 christos Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -717,7 +717,7 @@ partition by .Xr x86/mbr 8 , .Xr x86/multiboot 8 , .Xr x86/pxeboot 8 , -.Xr /boothowto 9 +.Xr boothowto 9 .Sh BUGS The kernel file name must be specified before, not after, the boot options. Any
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: wiz Date: Sat Feb 18 21:39:53 UTC 2017 Modified Files: src/share/man/man8/man8.x86: boot.8 boot_console.8 mbr.8 pxeboot.8 Log Message: Fix xrefs, sort. To generate a diff of this commit: cvs rdiff -u -r1.9 -r1.10 src/share/man/man8/man8.x86/boot.8 cvs rdiff -u -r1.3 -r1.4 src/share/man/man8/man8.x86/boot_console.8 \ src/share/man/man8/man8.x86/pxeboot.8 cvs rdiff -u -r1.2 -r1.3 src/share/man/man8/man8.x86/mbr.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.9 src/share/man/man8/man8.x86/boot.8:1.10 --- src/share/man/man8/man8.x86/boot.8:1.9 Fri Feb 17 22:30:28 2017 +++ src/share/man/man8/man8.x86/boot.8 Sat Feb 18 21:39:53 2017 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.9 2017/02/17 22:30:28 christos Exp $ +.\" $NetBSD: boot.8,v 1.10 2017/02/18 21:39:53 wiz Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -138,7 +138,7 @@ will be used to configure the behaviour setting the timeout, choosing a console device, altering the banner text and displaying a menu allowing boot commands to be easily chosen. See -.Xr x86/boot.cfg 5 . +.Xr boot.cfg 5 . .Ss Boot Protocol The .Nx Ns /x86 @@ -153,7 +153,7 @@ boot protocol, options are passed from t to the kernel via flag bits in the .Va boothowto variable (see -.Xr x86/boothowto 9 ) . +.Xr boothowto 9 ) . In the multiboot protocol, options are passed from the boot loader to the kernel as strings. .Ss Diagnostic Output @@ -384,7 +384,7 @@ DOM0 kernel before booting the .Tn Xen hypervisor. See -.Xr x86/boot.cfg 5 +.Xr boot.cfg 5 for examples. .Pp In addition to the @@ -521,7 +521,7 @@ must be passed as options to the .Ic multiboot command. See -.Xr x86/boot.cfg 5 +.Xr boot.cfg 5 for examples on how to boot .Nx Ns / Ns Xen. .It Nx No multiboot kernels @@ -630,7 +630,7 @@ file system to mount as root. There are three methods: .Bl -tag -width 04n -offset 04n .It Ic BTINFO_ROOTDEVICE Va from -.Xr x86/boot.cfg 5 +.Xr boot.cfg 5 or multiboot. The bootloader passes the root device name as driver, unit, and partition (like sd0a). @@ -706,7 +706,7 @@ partition by .Xr fd 4 , .Xr pciback 4 , .Xr userconf 4 , -.Xr x86/boot.cfg 5 , +.Xr boot.cfg 5 , .Xr halt 8 , .Xr installboot 8 , .Xr reboot 8 , @@ -717,7 +717,7 @@ partition by .Xr x86/mbr 8 , .Xr x86/multiboot 8 , .Xr x86/pxeboot 8 , -.Xr x86/boothowto 9 +.Xr /boothowto 9 .Sh BUGS The kernel file name must be specified before, not after, the boot options. Any Index: src/share/man/man8/man8.x86/boot_console.8 diff -u src/share/man/man8/man8.x86/boot_console.8:1.3 src/share/man/man8/man8.x86/boot_console.8:1.4 --- src/share/man/man8/man8.x86/boot_console.8:1.3 Fri Feb 17 22:30:28 2017 +++ src/share/man/man8/man8.x86/boot_console.8 Sat Feb 18 21:39:53 2017 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot_console.8,v 1.3 2017/02/17 22:30:28 christos Exp $ +.\" $NetBSD: boot_console.8,v 1.4 2017/02/18 21:39:53 wiz Exp $ .\" .\" Copyright (c) 1997 .\" Matthias Drochner. All rights reserved. @@ -130,8 +130,8 @@ compile time options for the boot progra .\" .Sh SEE ALSO .Xr console 4 , -.Xr x86/boot 8 , -.Xr installboot 8 +.Xr installboot 8 , +.Xr x86/boot 8 .\" .Sh BUGS The serial communication parameters (byte-size, parity, stop-bits) are Index: src/share/man/man8/man8.x86/pxeboot.8 diff -u src/share/man/man8/man8.x86/pxeboot.8:1.3 src/share/man/man8/man8.x86/pxeboot.8:1.4 --- src/share/man/man8/man8.x86/pxeboot.8:1.3 Fri Feb 17 22:30:28 2017 +++ src/share/man/man8/man8.x86/pxeboot.8 Sat Feb 18 21:39:53 2017 @@ -1,4 +1,4 @@ -.\" $NetBSD: pxeboot.8,v 1.3 2017/02/17 22:30:28 christos Exp $ +.\" $NetBSD: pxeboot.8,v 1.4 2017/02/18 21:39:53 wiz Exp $ .\" .\" Copyright (c) 2003 .\" Matthias Drochner. All rights reserved. @@ -48,13 +48,13 @@ specification. By default, the .Nm program is configured with modules loading and -.Xr x86/boot.cfg 5 +.Xr boot.cfg 5 support disabled. See .Sx EXAMPLES for how to enable these options individually. This manual page assumes that -.Xr x86/boot.cfg 5 +.Xr boot.cfg 5 support is enabled. .Pp Network booting a system through @@ -81,14 +81,14 @@ program takes control. It immediately issues another .Tn DHCP request to get the name of a -.Xr x86/boot.cfg 5 +.Xr boot.cfg 5 file to load, using .Dq boot.cfg by default. If the boot config file is not found, or if the supplied file appears not to be a boot configuration file, the file is skipped. Otherwise it is loaded and obeyed as described in -.Xr x86/boot.cfg 5 . +.Xr boot.cfg 5 . If a boot configuration is not loaded, the user has the option to enter a limited version of the standard interactive boot mode by pressing a key within five seconds. @@ -255,7 +255,7 @@ file. .El .Sh EXAMPLES To enable -.Xr
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: christos Date: Fri Feb 17 21:31:49 UTC 2017 Modified Files: src/share/man/man8/man8.x86: boot.8 boot_console.8 Log Message: fix cross references. To generate a diff of this commit: cvs rdiff -u -r1.7 -r1.8 src/share/man/man8/man8.x86/boot.8 cvs rdiff -u -r1.1 -r1.2 src/share/man/man8/man8.x86/boot_console.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.7 src/share/man/man8/man8.x86/boot.8:1.8 --- src/share/man/man8/man8.x86/boot.8:1.7 Sun Jun 19 18:27:56 2016 +++ src/share/man/man8/man8.x86/boot.8 Fri Feb 17 16:31:49 2017 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.7 2016/06/19 22:27:56 pgoyette Exp $ +.\" $NetBSD: boot.8,v 1.8 2017/02/17 21:31:49 christos Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -32,7 +32,7 @@ .\" .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 .\" -.Dd April 25, 2015 +.Dd February 17, 2017 .Dt BOOT 8 x86 .Os .Sh NAME @@ -54,18 +54,18 @@ or can use any of the following boot procedures, depending on what the hardware and .Tn BIOS support: -.Bl -tag -width "pxeboot(8)" +.Bl -tag -width "x86/pxeboot(8)" .It boot bootstrap .Nx from the system .Tn BIOS -.It Xr dosboot 8 +.It Xr x86/dosboot 8 bootstrap .Nx from .Tn MS-DOS -.It Xr pxeboot 8 +.It Xr x86/pxeboot 8 network bootstrap .Nx from a @@ -95,7 +95,7 @@ or by a boot selector program (such as O .Nx Ns 's .No boot-selecting master boot record - see -.Xr mbr 8 ) . +.Xr x86/mbr 8 ) . .Ss Normal Operation Once running, a banner similar to the following will appear: .Bd -unfilled -offset indent @@ -160,7 +160,7 @@ to the kernel as strings. If the first stage boot fails to load the boot, it will print a terse message indicating the reason for the failure. The possible error messages and their cause are listed in -.Xr mbr 8 . +.Xr x86/mbr 8 . .Pp If the first stage boot succeeds, the banner will be shown and the error messages should be self-explanatory. @@ -169,7 +169,7 @@ In interactive mode, the boot loader wil input of these commands: .\" NOTE: much of this text is duplicated in the MI boot.8. .\" Some of it is -.\" also duplicated in the x86-specific dosboot.8 and pxeboot.8; +.\" also duplicated in the x86-specific x86/dosboot.8 and x86/pxeboot.8; .\" please try to keep all relevant files synchronized. .Bl -tag -width 04n -offset 04n .It Ic boot Oo Va device : Oc Ns Oo Va filename Oc Oo Fl 1234abcdmqsvxz Oc @@ -341,7 +341,7 @@ or See .Sx Console Selection Policy in -.Xr boot_console 8 . +.Xr x86/boot_console 8 . .It Ic dev Op Va device Set the default drive and partition for subsequent file system operations. @@ -411,7 +411,7 @@ for cases where the root file system has from network (see the .Sx BUGS section in -.Xr pxeboot 8 ) . +.Xr x86/pxeboot 8 ) . .It Ic console Ns = Ns Ar dev Console used by DOM0 kernel during boot. .Ar dev @@ -421,7 +421,7 @@ command. See .Sx Console Selection Policy in -.Xr boot_console 8 . +.Xr x86/boot_console 8 . .It Xo Ic ip Ns = Ns .Ar my_ip Ns : Ns Ar serv_ip Ns : Ns Ar gw_ip Ns : Ns .Ar mask Ns : Ns Ar host Ns : Ns Ar iface @@ -530,7 +530,7 @@ A kernel that was built with .Cd options MULTIBOOT (see -.Xr multiboot 8 ) +.Xr x86/multiboot 8 ) may be booted with either the .Ic boot or @@ -707,16 +707,16 @@ partition by .Xr pciback 4 , .Xr userconf 4 , .Xr boot.cfg 5 , -.Xr boot_console 8 , -.Xr dosboot 8 , .Xr halt 8 , .Xr installboot 8 , -.Xr mbr 8 , -.Xr multiboot 8 , -.Xr pxeboot 8 , .Xr reboot 8 , .Xr rescue 8 , .Xr shutdown 8 , +.Xr x86/boot_console 8 , +.Xr x86/dosboot 8 , +.Xr x86/mbr 8 , +.Xr x86/multiboot 8 , +.Xr x86/pxeboot 8 , .Xr boothowto 9 .Sh BUGS The kernel file name must be specified before, not after, the boot options. Index: src/share/man/man8/man8.x86/boot_console.8 diff -u src/share/man/man8/man8.x86/boot_console.8:1.1 src/share/man/man8/man8.x86/boot_console.8:1.2 --- src/share/man/man8/man8.x86/boot_console.8:1.1 Wed Jul 31 17:01:13 2013 +++ src/share/man/man8/man8.x86/boot_console.8 Fri Feb 17 16:31:49 2017 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot_console.8,v 1.1 2013/07/31 21:01:13 soren Exp $ +.\" $NetBSD: boot_console.8,v 1.2 2017/02/17 21:31:49 christos Exp $ .\" .\" Copyright (c) 1997 .\" Matthias Drochner. All rights reserved. @@ -24,7 +24,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd July 3, 2004 +.Dd February 17, 2017 .Dt BOOT_CONSOLE 8 x86 .Os .Sh NAME @@ -42,7 +42,7 @@ When booting from the system BIOS, the c are saved in the primary bootstrap by .Xr installboot 8 . For other boot procedures (such as -.Xr dosboot 8 ) +.Xr x86/dosboot 8 ) the selection process is controlled by bootloader compile-time options and system setup at the bootloader
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: pgoyette Date: Sun Jun 19 22:27:56 UTC 2016 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Fix typo. To generate a diff of this commit: cvs rdiff -u -r1.6 -r1.7 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.6 src/share/man/man8/man8.x86/boot.8:1.7 --- src/share/man/man8/man8.x86/boot.8:1.6 Sat Apr 25 14:27:02 2015 +++ src/share/man/man8/man8.x86/boot.8 Sun Jun 19 22:27:56 2016 @@ -1,4 +1,4 @@ -.\" $NetBSD: boot.8,v 1.6 2015/04/25 14:27:02 wiz Exp $ +.\" $NetBSD: boot.8,v 1.7 2016/06/19 22:27:56 pgoyette Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -375,7 +375,7 @@ If the module name is not an absolute pa .Pa .kmod .Xc is used. -Possible used of the +Possible uses of the .Ic load command include loading a memory disk image before booting a kernel, or loading a
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: mlelstv Date: Sat Apr 25 14:05:43 UTC 2015 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Explain how the kernel determines the root filesystem from information passed by the bootloader. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.4 src/share/man/man8/man8.x86/boot.8:1.5 --- src/share/man/man8/man8.x86/boot.8:1.4 Sat Aug 16 12:30:12 2014 +++ src/share/man/man8/man8.x86/boot.8 Sat Apr 25 14:05:43 2015 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.4 2014/08/16 12:30:12 apb Exp $ +.\ $NetBSD: boot.8,v 1.5 2015/04/25 14:05:43 mlelstv Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -624,6 +624,55 @@ In an emergency, the bootstrap methods d installation notes for the x86 architectures can be used to boot from floppy or other media, or over the network. +.Ss Locating the root filesystem +The kernel uses information from the bootloader to locate the +filesystem to mount as root. There are three methods: +.Bl -tag -width 04n -offset 04n +.It Ic BTINFO_ROOTDEVICE Va from +.Xr boot.cfg 5 +or multiboot. +The bootloader passes the root device name as driver,unit and +partition (like sd0a). This will be automatically substituted +by a +.Xr dk 4 +wedge if one is discovered. +.Pp +The bootloader passes a wedge name as wedge: followed by the name. +The kernel will search for a +.Xr dk 4 +device with that name. +.It Ic BTINFO_BOOTWEDGE Va determined by bootblock +The bootloader passes start offset and length of a hard disk partition +and a offset, size and hash of a boot area. Then kernel searches +all disks and wedges for a block sequence at that offset with a +matching hash. If one is found, the kernel will look for a wedge +on that device at the same offset. +.Pp +An additional partition number is provided if the bootloader also +passed a BTINFO_BOOTDISK record. This (or partition 'a') will be used +by the kernel as a fallback if there is no matching wedge. +.It Ic BTINFO_BOOTDISK Va determined by bootblock +This uses the device number passed by the BIOS that +distinguishes between floppy, hard drive and CD-ROM boot. +.Bl -tag -width xxx +.It Ic Floppy +The kernel searches for the +.Xr fd 4 +device with the correct unit, the partition number is used +to select a specific disk format. See +.Xr fd 4 for details. +.It Ic Hard drive +The bootloader passed a partition number and disklabel +data (offset, type, checksum, packname). The kernel searches +all disks for a matching disklabel. If one is found, the +kernel will use that device and partition number. +.It Ic CDROM +The BIOS does not distinguish between multiple CD devices. +The kernel searches for the first +.Xr cd 4 +device. So you can only boot from unit 0. +.El +.El .Sh FILES .Bl -tag -width /usr/mdec/bootxx_fstype -compact .It Pa /boot @@ -647,6 +696,7 @@ partition by .Xr ddb 4 , .Xr pciback 4 , .Xr userconf 4 , +.Xr fd 4 , .Xr boot.cfg 5 , .Xr boot_console 8 , .Xr dosboot 8 ,
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: wiz Date: Sat Apr 25 14:27:02 UTC 2015 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: New sentence, new line. Bump date for previous. Various minor changes. To generate a diff of this commit: cvs rdiff -u -r1.5 -r1.6 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.5 src/share/man/man8/man8.x86/boot.8:1.6 --- src/share/man/man8/man8.x86/boot.8:1.5 Sat Apr 25 14:05:43 2015 +++ src/share/man/man8/man8.x86/boot.8 Sat Apr 25 14:27:02 2015 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.5 2015/04/25 14:05:43 mlelstv Exp $ +.\ $NetBSD: boot.8,v 1.6 2015/04/25 14:27:02 wiz Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -32,7 +32,7 @@ .\ .\ @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 .\ -.Dd August 16, 2014 +.Dd April 25, 2015 .Dt BOOT 8 x86 .Os .Sh NAME @@ -343,7 +343,7 @@ See in .Xr boot_console 8 . .It Ic dev Op Va device -Set the default drive and partition for subsequent filesystem +Set the default drive and partition for subsequent file system operations. Without an argument, print the current setting. .Va device @@ -442,7 +442,7 @@ network mask address of the host .It Va iface interface -.Po e.g. Dq xennet0 +.Po e.g., Dq xennet0 or .Dq eth0 .Pc @@ -624,16 +624,17 @@ In an emergency, the bootstrap methods d installation notes for the x86 architectures can be used to boot from floppy or other media, or over the network. -.Ss Locating the root filesystem +.Ss Locating the root file system The kernel uses information from the bootloader to locate the -filesystem to mount as root. There are three methods: +file system to mount as root. +There are three methods: .Bl -tag -width 04n -offset 04n .It Ic BTINFO_ROOTDEVICE Va from .Xr boot.cfg 5 or multiboot. -The bootloader passes the root device name as driver,unit and -partition (like sd0a). This will be automatically substituted -by a +The bootloader passes the root device name as driver, unit, and +partition (like sd0a). +This will be automatically substituted by a .Xr dk 4 wedge if one is discovered. .Pp @@ -643,13 +644,16 @@ The kernel will search for a device with that name. .It Ic BTINFO_BOOTWEDGE Va determined by bootblock The bootloader passes start offset and length of a hard disk partition -and a offset, size and hash of a boot area. Then kernel searches +and a offset, size and hash of a boot area. +Then kernel searches all disks and wedges for a block sequence at that offset with a -matching hash. If one is found, the kernel will look for a wedge +matching hash. +If one is found, the kernel will look for a wedge on that device at the same offset. .Pp An additional partition number is provided if the bootloader also -passed a BTINFO_BOOTDISK record. This (or partition 'a') will be used +passed a BTINFO_BOOTDISK record. +This (or partition 'a') will be used by the kernel as a fallback if there is no matching wedge. .It Ic BTINFO_BOOTDISK Va determined by bootblock This uses the device number passed by the BIOS that @@ -659,18 +663,23 @@ distinguishes between floppy, hard drive The kernel searches for the .Xr fd 4 device with the correct unit, the partition number is used -to select a specific disk format. See -.Xr fd 4 for details. +to select a specific disk format. +See +.Xr fd 4 +for details. .It Ic Hard drive The bootloader passed a partition number and disklabel -data (offset, type, checksum, packname). The kernel searches -all disks for a matching disklabel. If one is found, the +data (offset, type, checksum, packname). +The kernel searches +all disks for a matching disklabel. +If one is found, the kernel will use that device and partition number. .It Ic CDROM The BIOS does not distinguish between multiple CD devices. The kernel searches for the first .Xr cd 4 -device. So you can only boot from unit 0. +device. +So you can only boot from unit 0. .El .El .Sh FILES @@ -686,7 +695,7 @@ gzip-compressed system code .It Pa /usr/mdec/boot master copy of the boot program (copy to /boot) .It Pa /usr/mdec/bootxx_fstype -primary bootstrap for filesystem type fstype, copied to the start of +primary bootstrap for file system type fstype, copied to the start of the .Nx partition by @@ -694,9 +703,9 @@ partition by .El .Sh SEE ALSO .Xr ddb 4 , +.Xr fd 4 , .Xr pciback 4 , .Xr userconf 4 , -.Xr fd 4 , .Xr boot.cfg 5 , .Xr boot_console 8 , .Xr dosboot 8 ,
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: apb Date: Sat Aug 16 11:41:38 UTC 2014 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Document fs, menu, rndseed, and splash commands. Add rescue(8) to SEE ALSO. Also a little copy editing. To generate a diff of this commit: cvs rdiff -u -r1.2 -r1.3 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.2 src/share/man/man8/man8.x86/boot.8:1.3 --- src/share/man/man8/man8.x86/boot.8:1.2 Sat Aug 16 08:43:12 2014 +++ src/share/man/man8/man8.x86/boot.8 Sat Aug 16 11:41:37 2014 @@ -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 @@ the 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 @@ setting the timeout, choosing a console 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 @@ Without an argument, print the current s .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 @@ for examples. .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 @@ Print a directory listing of 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 @@ See the foreign operating system's docum .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 @@ at boot time. 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 @@ partition by .Xr multiboot 8 , .Xr pxeboot 8 , .Xr reboot 8 , +.Xr rescue 8 , .Xr shutdown 8 , .Xr boothowto 9 .Sh BUGS
CVS commit: src/share/man/man8/man8.x86
Module Name:src Committed By: apb Date: Sat Aug 16 12:30:12 UTC 2014 Modified Files: src/share/man/man8/man8.x86: boot.8 Log Message: Document supported subsets of image formats, extracted from comments in src/sys/dev/stbi/stb_image.c. XXX: This is not the right place to document supported image formats for splash screens. To generate a diff of this commit: cvs rdiff -u -r1.3 -r1.4 src/share/man/man8/man8.x86/boot.8 Please note that diffs are not public domain; they are subject to the copyright notices on the relevant files. Modified files: Index: src/share/man/man8/man8.x86/boot.8 diff -u src/share/man/man8/man8.x86/boot.8:1.3 src/share/man/man8/man8.x86/boot.8:1.4 --- src/share/man/man8/man8.x86/boot.8:1.3 Sat Aug 16 11:41:37 2014 +++ src/share/man/man8/man8.x86/boot.8 Sat Aug 16 12:30:12 2014 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.3 2014/08/16 11:41:37 apb Exp $ +.\ $NetBSD: boot.8,v 1.4 2014/08/16 12:30:12 apb Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -595,7 +595,14 @@ and request the kernel to use it as a sp The .Ar file should contain an image in one of these formats: -JPEG, PNG, BMP, GIF, PSD, or PIC. +JPEG (baseline only, not progressive), +PNG (8-bit only), +TGA, +BMP (non-1bpp, non-RLE), +GIF, +PSD (composited view only), +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
