CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: njoly Date: Sat Jul 13 10:52:50 UTC 2013 Modified Files: src/share/man/man8/man8.i386: dosboot.8 Log Message: Adjust -width argument to match reality; and while here quote it. To generate a diff of this commit: cvs rdiff -u -r1.21 -r1.22 src/share/man/man8/man8.i386/dosboot.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.i386/dosboot.8 diff -u src/share/man/man8/man8.i386/dosboot.8:1.21 src/share/man/man8/man8.i386/dosboot.8:1.22 --- src/share/man/man8/man8.i386/dosboot.8:1.21 Mon Apr 25 22:26:29 2011 +++ src/share/man/man8/man8.i386/dosboot.8 Sat Jul 13 10:52:50 2013 @@ -1,4 +1,4 @@ -.\ $NetBSD: dosboot.8,v 1.21 2011/04/25 22:26:29 wiz Exp $ +.\ $NetBSD: dosboot.8,v 1.22 2013/07/13 10:52:50 njoly Exp $ .\ .\ Copyright (c) 1997 .\ Matthias Drochner. All rights reserved. @@ -59,7 +59,7 @@ shares common code with the standard boo .Xr boot 8 . .Pp The recognized options are: -.Bl -tag -width -ads -offset 04n +.Bl -tag -width -adqsv -offset 04n .It Fl c Execute .Ar command
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Tue Sep 13 10:33:11 UTC 2011 Modified Files: src/share/man/man8/man8.i386: mbr.8 Log Message: Case fixes and a comma from Snader_LB. To generate a diff of this commit: cvs rdiff -u -r1.4 -r1.5 src/share/man/man8/man8.i386/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.i386/mbr.8 diff -u src/share/man/man8/man8.i386/mbr.8:1.4 src/share/man/man8/man8.i386/mbr.8:1.5 --- src/share/man/man8/man8.i386/mbr.8:1.4 Mon Apr 25 22:26:29 2011 +++ src/share/man/man8/man8.i386/mbr.8 Tue Sep 13 10:33:11 2011 @@ -1,4 +1,4 @@ -.\ $NetBSD: mbr.8,v 1.4 2011/04/25 22:26:29 wiz Exp $ +.\ $NetBSD: mbr.8,v 1.5 2011/09/13 10:33:11 wiz Exp $ .Dd January 20, 2008 .Dt MBR 8 i386 .Os @@ -36,7 +36,7 @@ The choices and default settings can be configured through .Xr fdisk 8 . .It Sy Extended Bootselector Pa /usr/mdec/mbr_ext -The Extended Bootselecting MBR additionally allows +The extended bootselecting MBR additionally allows .Nx to be loaded from an Extended partition. It only supports systems whose BIOS supports the extensions to @@ -49,7 +49,7 @@ .It Sy Serial Bootselector Pa /usr/mdec/mbr_com0_9600 This has the same features as .Pa mbr_com0 . -Additionally it initializes the serial port to 9600 baud. +Additionally, it initializes the serial port to 9600 baud. .El .Pp The rest of this manual page will discuss the bootselecting versions of
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: uebayasi Date: Tue May 31 03:43:47 UTC 2011 Modified Files: src/share/man/man8/man8.i386: boot.8 Log Message: Sort list items. Remove a trailing whitespace. To generate a diff of this commit: cvs rdiff -u -r1.57 -r1.58 src/share/man/man8/man8.i386/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.i386/boot.8 diff -u src/share/man/man8/man8.i386/boot.8:1.57 src/share/man/man8/man8.i386/boot.8:1.58 --- src/share/man/man8/man8.i386/boot.8:1.57 Thu May 26 04:25:26 2011 +++ src/share/man/man8/man8.i386/boot.8 Tue May 31 03:43:47 2011 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.57 2011/05/26 04:25:26 uebayasi Exp $ +.\ $NetBSD: boot.8,v 1.58 2011/05/31 03:43:47 uebayasi Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -346,20 +346,6 @@ .Sx Console Selection Policy in .Xr boot_console 8 . -.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 -.Va modenum -should be in the form of -.Ar 0x100 , 800x600 , 800x600x32 . -The values -.Ar enabled , on -put the display into the default mode, and -.Ar disabled , off -returns the display into standard vga mode. -The value -.Ar list -lists all supported modes. .It Ic dev Op Va device Set the default drive and partition for subsequent filesystem operations. @@ -423,7 +409,7 @@ .Xr pxeboot 8 ) . .It Ic console Ns = Ns Ar dev Console used by DOM0 kernel during boot. -.Ar dev +.Ar dev accepts the same values as the ones given for the .Cm consdev command. @@ -567,6 +553,20 @@ These commands are processed before the interactive .Xr userconf 4 shell is executed, if requested . +.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 +.Va modenum +should be in the form of +.Ar 0x100 , 800x600 , 800x600x32 . +The values +.Ar enabled , on +put the display into the default mode, and +.Ar disabled , off +returns the display into standard vga mode. +The value +.Ar list +lists all supported modes. .El .Pp In an emergency, the bootstrap methods described in the
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Mon Apr 25 22:26:30 UTC 2011 Modified Files: src/share/man/man8/man8.i386: dosboot.8 mbr.8 Log Message: Spelling. To generate a diff of this commit: cvs rdiff -u -r1.20 -r1.21 src/share/man/man8/man8.i386/dosboot.8 cvs rdiff -u -r1.3 -r1.4 src/share/man/man8/man8.i386/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.i386/dosboot.8 diff -u src/share/man/man8/man8.i386/dosboot.8:1.20 src/share/man/man8/man8.i386/dosboot.8:1.21 --- src/share/man/man8/man8.i386/dosboot.8:1.20 Mon May 18 14:46:51 2009 +++ src/share/man/man8/man8.i386/dosboot.8 Mon Apr 25 22:26:29 2011 @@ -1,4 +1,4 @@ -.\ $NetBSD: dosboot.8,v 1.20 2009/05/18 14:46:51 wiz Exp $ +.\ $NetBSD: dosboot.8,v 1.21 2011/04/25 22:26:29 wiz Exp $ .\ .\ Copyright (c) 1997 .\ Matthias Drochner. All rights reserved. @@ -69,9 +69,9 @@ .Nm will present a prompt, allowing input of commands (see below). .It Fl u -Boot from a UFS filesystem instead of an +Boot from a UFS file system instead of an .Tn MS-DOS -filesystem. +file system. .It Ar path Specifies the kernel file. In @@ -85,10 +85,10 @@ .Ic mode ufs command), a path in a .Nx -filesystem is expected. +file system is expected. By default, the file is looked up in partition .Sq a -of the first harddisk. +of the first hard disk. Another device or partition can be specified by prepending a block device name in terms of .Nx , @@ -116,7 +116,7 @@ .Xr boot 8 for full details. .It Ic dev Op device -Set the default device and partition for subsequent filesystem operations. +Set the default device and partition for subsequent file system operations. Without an operand, print the current setting. This setting doesn't apply to .Tn MS-DOS @@ -131,7 +131,7 @@ .Pa path can contain a device specification. .It Ic mode Va fstype -Switch filesystem type; +Switch file system type; .Va fstype should be one of .Ar dos Index: src/share/man/man8/man8.i386/mbr.8 diff -u src/share/man/man8/man8.i386/mbr.8:1.3 src/share/man/man8/man8.i386/mbr.8:1.4 --- src/share/man/man8/man8.i386/mbr.8:1.3 Sun Jan 20 15:05:15 2008 +++ src/share/man/man8/man8.i386/mbr.8 Mon Apr 25 22:26:29 2011 @@ -1,4 +1,4 @@ -.\ $NetBSD: mbr.8,v 1.3 2008/01/20 15:05:15 dsl Exp $ +.\ $NetBSD: mbr.8,v 1.4 2011/04/25 22:26:29 wiz Exp $ .Dd January 20, 2008 .Dt MBR 8 i386 .Os @@ -21,7 +21,7 @@ MBR itself. .Pp .Nx -supplies serveral versions of the MBR bootcode: +supplies several versions of the MBR bootcode: .Bl -tag -width 20 .It Sy Normal boot code Pa /usr/mdec/mbr This version has the same functionality as that supplied by DOS/Windows and @@ -45,11 +45,11 @@ This has the same features as .Pa mbr_ext but will read and write from the first serial port. -It assumes that the BIOS has initialised the baud rate. +It assumes that the BIOS has initialized the baud rate. .It Sy Serial Bootselector Pa /usr/mdec/mbr_com0_9600 This has the same features as .Pa mbr_com0 . -Additionally it initialises the serial port to 9600 baud. +Additionally it initializes the serial port to 9600 baud. .El .Pp The rest of this manual page will discuss the bootselecting versions of @@ -85,7 +85,7 @@ through .Sy h for the serial versions) -will boot from harddisks 0 through 7 (BIOS numbers 0x80 through 0x87). +will boot from hard disks 0 through 7 (BIOS numbers 0x80 through 0x87). Booting from a drive is simply done by reading the MBR of that drive and executing it, so the bootcode present in the MBR of the chosen drive determines which partition (if any) will be booted in
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: jym Date: Thu Jan 13 10:03:29 UTC 2011 Modified Files: src/share/man/man8/man8.i386: boot.8 Log Message: Now that we have pciback(4), Xref it for Xen boot(8), rather than pcictl(8). To generate a diff of this commit: cvs rdiff -u -r1.55 -r1.56 src/share/man/man8/man8.i386/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.i386/boot.8 diff -u src/share/man/man8/man8.i386/boot.8:1.55 src/share/man/man8/man8.i386/boot.8:1.56 --- src/share/man/man8/man8.i386/boot.8:1.55 Mon Nov 29 12:44:17 2010 +++ src/share/man/man8/man8.i386/boot.8 Thu Jan 13 10:03:29 2011 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.55 2010/11/29 12:44:17 jym Exp $ +.\ $NetBSD: boot.8,v 1.56 2011/01/13 10:03:29 jym Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -463,13 +463,14 @@ .Ar rootpath is the remote mount point for the root file system. .It Ic pciback.hide Ns = Ns Ar pcidevs -Pass a list of PCI IDs for use with the PCI backend driver. +Pass a list of PCI IDs for use with the PCI backend driver, +.Xr pciback 4 . .Ar pcidevs is formed of multiple IDs (in bus:device.function notation), each ID being surrounded with brackets. PCI domain IDs are currently ignored. -You can obtains PCI IDs through -.Xr pcictl 8 . +See +.Xr pciback 4 . .El .It Ic ls Op Pa path Print a directory listing of @@ -585,6 +586,7 @@ .El .Sh SEE ALSO .Xr ddb 4 , +.Xr pciback 4 , .Xr userconf 4 , .Xr boot.cfg 5 , .Xr boot_console 8 , @@ -593,7 +595,6 @@ .Xr installboot 8 , .Xr mbr 8 , .Xr multiboot 8 , -.Xr pcictl 8 , .Xr pxeboot 8 , .Xr reboot 8 , .Xr shutdown 8 ,
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Sun Nov 7 12:01:08 UTC 2010 Modified Files: src/share/man/man8/man8.i386: boot.8 Log Message: Minor cleanup. To generate a diff of this commit: cvs rdiff -u -r1.53 -r1.54 src/share/man/man8/man8.i386/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.i386/boot.8 diff -u src/share/man/man8/man8.i386/boot.8:1.53 src/share/man/man8/man8.i386/boot.8:1.54 --- src/share/man/man8/man8.i386/boot.8:1.53 Sat Nov 6 23:28:42 2010 +++ src/share/man/man8/man8.i386/boot.8 Sun Nov 7 12:01:07 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.53 2010/11/06 23:28:42 jym Exp $ +.\ $NetBSD: boot.8,v 1.54 2010/11/07 12:01:07 wiz Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -393,7 +393,8 @@ .Tn Xen DOM0 kernel before booting the .Tn Xen -hypervisor. See +hypervisor. +See .Xr boot.cfg 5 for examples. .Pp @@ -402,24 +403,24 @@ options specified above, the DOM0 kernel accepts .Po Ar arguments being separated with spaces -.Pc Ns : +.Pc : .Bl -tag -width xxx .It Ic bootdev Ns = Ns Ar dev Po or Ic root Ns = Ns Ar dev Pc Override the default boot device. .Ar dev can be a unit name .Po Dq wd0 -.Pc Ns , +.Pc , or an interface name .Po Dq bge0 , .Dq wm0 , .Ns ... -.Pc Ns , +.Pc , for cases where the root file system has to be loaded from network (see the .Sx BUGS section in -.Xr pxeboot 8 Ns ). +.Xr pxeboot 8 ) . .It Ic console Ns = Ns Ar dev Console used by DOM0 kernel during boot. .Ar dev @@ -450,7 +451,7 @@ address of the host .It Va iface interface -.Po eg. Dq xennet0 +.Po e.g. Dq xennet0 or .Dq eth0 .Pc @@ -465,8 +466,8 @@ Pass a list of PCI IDs for use with the PCI backend driver. .Ar pcidevs is formed of multiple IDs (in bus:device:function notation), -each ID being surrounded with brackets. PCI domain IDs -are currently ignored. +each ID being surrounded with brackets. +PCI domain IDs are currently ignored. You can obtains PCI IDs through .Xr pcictl 8 . .El
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: jym Date: Sat Nov 6 23:28:42 UTC 2010 Modified Files: src/share/man/man8/man8.i386: boot.8 Log Message: - bring some command definitions on par with their code - describe the arguments that can be passed to NetBSD DOM0 kernel (bootdev, console, ip, nfsroot, pciback.hide) - document the modules command to boot(8) - Xen is a trademark, hence .Tn - add a reference to pcictl(8) for getting PCI IDs (used by pciback.hide) Bump date. To generate a diff of this commit: cvs rdiff -u -r1.52 -r1.53 src/share/man/man8/man8.i386/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.i386/boot.8 diff -u src/share/man/man8/man8.i386/boot.8:1.52 src/share/man/man8/man8.i386/boot.8:1.53 --- src/share/man/man8/man8.i386/boot.8:1.52 Fri Sep 4 23:29:03 2009 +++ src/share/man/man8/man8.i386/boot.8 Sat Nov 6 23:28:42 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.52 2009/09/04 23:29:03 apb Exp $ +.\ $NetBSD: boot.8,v 1.53 2010/11/06 23:28:42 jym 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 4, 2009 +.Dd November 7, 2010 .Dt BOOT 8 i386 .Os .Sh NAME @@ -346,7 +346,7 @@ .Sx Console Selection Policy in .Xr boot_console 8 . -.It Ic vesa Va modenum | on | off | enabled | disabled | list +.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 .Va modenum @@ -369,11 +369,11 @@ .Cm boot . .It Ic help Print an overview about commands and arguments. -.It Ic load Va module Op Va arguments +.It Ic load Va module Op Ar arguments Load the specified kernel .Va module , and pass it the specified -.Va arguments . +.Ar arguments . If the module name is not an absolute path, .Pa /stand/ Xo Ns .Aq Sy arch Ns @@ -389,14 +389,104 @@ 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. +or loading a +.Tn Xen +DOM0 kernel before booting the +.Tn Xen +hypervisor. See +.Xr boot.cfg 5 +for examples. +.Pp +In addition to the +.Cm boot +options specified above, the DOM0 kernel accepts +.Po Ar arguments +being separated with spaces +.Pc Ns : +.Bl -tag -width xxx +.It Ic bootdev Ns = Ns Ar dev Po or Ic root Ns = Ns Ar dev Pc +Override the default boot device. +.Ar dev +can be a unit name +.Po Dq wd0 +.Pc Ns , +or an interface name +.Po Dq bge0 , +.Dq wm0 , +.Ns ... +.Pc Ns , +for cases where the root file system has to be loaded +from network (see the +.Sx BUGS +section in +.Xr pxeboot 8 Ns ). +.It Ic console Ns = Ns Ar dev +Console used by DOM0 kernel during boot. +.Ar dev +accepts the same values as the ones given for the +.Cm consdev +command. +See +.Sx Console Selection Policy +in +.Xr 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 +.Xc +Specify various parameters for a network boot (IPs are in +dot notation), +each one separated by a colon: +.Bl -tag -width xxx +.It Va my_ip +address of the host +.It Va serv_ip +address of the NFS server +.It Va gw_ip +address of the gateway +.It Va mask +network mask +.It Va host +address of the host +.It Va iface +interface +.Po eg. Dq xennet0 +or +.Dq eth0 +.Pc +.El +.It Ic nfsroot Ns = Ns Ar address Ns : Ns Ar rootpath +Boot the system with root on NFS. +.Ar address +is the address of the NFS server, and +.Ar rootpath +is the remote mount point for the root file system. +.It Ic pciback.hide Ns = Ns Ar pcidevs +Pass a list of PCI IDs for use with the PCI backend driver. +.Ar pcidevs +is formed of multiple IDs (in bus:device:function notation), +each ID being surrounded with brackets. PCI domain IDs +are currently ignored. +You can obtains PCI IDs through +.Xr pcictl 8 . +.El .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 +.It Ic modules Bro Ar on | off | enabled | disabled Brc +The values +.Ar enabled , on +will enable module loading for +.Cm boot +and +.Cm multiboot , +whereas +.Ar disabled , off +will turn off the feature. +.It Ic multiboot Va kernel Op Ar arguments Boot the specified .Va kernel , using the @@ -413,9 +503,13 @@ 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 +The +.Tn Xen +DOM0 kernel must be loaded as a module using the .Ic load -command, and the Xen hypervisor must be booted using the +command, and the +.Tn Xen +hypervisor must be booted using the .Ic multiboot command. Options
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: jym Date: Sat Nov 6 23:33:29 UTC 2010 Modified Files: src/share/man/man8/man8.i386: pxeboot.8 Log Message: - similar to bootconf, document that pxeboot_ia32.bin has the module loading option turned off by default, and explain how to turn it on. - remove XXX comment: yes, even when boot.cfg is loaded, DHCP is still used to get file names (checked with a quick PXE boot + DHCP/TFTP platform) - document in BUGS section that all DOM0 kernels are loaded as modules, so you may have to explicitely set the boot device for root fs on network, depending on your setup Bump date. Blessed by agc :) To generate a diff of this commit: cvs rdiff -u -r1.17 -r1.18 src/share/man/man8/man8.i386/pxeboot.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.i386/pxeboot.8 diff -u src/share/man/man8/man8.i386/pxeboot.8:1.17 src/share/man/man8/man8.i386/pxeboot.8:1.18 --- src/share/man/man8/man8.i386/pxeboot.8:1.17 Tue Apr 6 22:41:41 2010 +++ src/share/man/man8/man8.i386/pxeboot.8 Sat Nov 6 23:33:29 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: pxeboot.8,v 1.17 2010/04/06 22:41:41 wiz Exp $ +.\ $NetBSD: pxeboot.8,v 1.18 2010/11/06 23:33:29 jym Exp $ .\ .\ Copyright (c) 2003 .\ 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 April 6, 2010 +.Dd November 7, 2010 .Dt PXEBOOT 8 i386 .Os .Sh NAME @@ -45,20 +45,17 @@ .Pq Tn PXE specification. .Pp -This manual page assumes the +By default, the .Nm -program has been configured -via -.Xr installboot 8 -to use a -.Xr boot.cfg 5 -file. -For historical reasons +program is configured with modules loading and .Xr boot.cfg 5 -is NOT loaded by default. +support disabled. See .Sx EXAMPLES -for how to enable it. +for how to enable these options individually. +This manual page assumes that +.Xr boot.cfg 5 +support is enabled. .Pp Network booting a system through .Tn PXE @@ -92,9 +89,6 @@ not to be a boot configuration file, the file is skipped. Otherwise it is loaded and obeyed as described in .Xr boot.cfg 5 . -.\ XXX Now, if the boot.cfg is loaded, is DHCP still used to get the -.\ XXX file name for the kernel? If only the person who had made the -.\ XXX changes had documented them. 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. @@ -269,6 +263,13 @@ installboot -e -o bootconf pxeboot_ia32.bin .Ed .Pp +To enable modules loading support in the +.Nm +program: +.Bd -literal -offset indent +installboot -e -o modules pxeboot_ia32.bin +.Ed +.Pp The first .Pa /etc/dhcpd.conf example shows a simple configuration which just loads @@ -396,3 +397,22 @@ .Nm from an i386 build to boot an i386 kernel, and that from an amd64 build to boot an amd64 kernel. +.Pp +In a +.Tn Xen +setup, the +.Nx +DOM0 kernel is loaded as a module, and cannot know the device +from which the +.Tn Xen +hypervisor was booted. +In this case, the DOM0 kernel will fall back to the default boot +device (typically the first disk on the host). +If the boot device is different from the default one, consider +passing additional arguments, like +.Ar bootdev , +to the DOM0 kernel as explained +in the +.Cm load +command subsection in +.Xr boot 8 .
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: tnn Date: Tue Apr 6 20:15:22 UTC 2010 Modified Files: src/share/man/man8/man8.i386: pxeboot.8 Log Message: The pxeboot manpage implies that boot.cfg gets loaded by default, but this is no longer true following i386/stand/pxeboot/main.c v1.23. To generate a diff of this commit: cvs rdiff -u -r1.15 -r1.16 src/share/man/man8/man8.i386/pxeboot.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.i386/pxeboot.8 diff -u src/share/man/man8/man8.i386/pxeboot.8:1.15 src/share/man/man8/man8.i386/pxeboot.8:1.16 --- src/share/man/man8/man8.i386/pxeboot.8:1.15 Fri Apr 10 23:22:30 2009 +++ src/share/man/man8/man8.i386/pxeboot.8 Tue Apr 6 20:15:22 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: pxeboot.8,v 1.15 2009/04/10 23:22:30 wiz Exp $ +.\ $NetBSD: pxeboot.8,v 1.16 2010/04/06 20:15:22 tnn Exp $ .\ .\ Copyright (c) 2003 .\ 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 April 10, 2008 +.Dd April 06, 2010 .Dt PXEBOOT 8 i386 .Os .Sh NAME @@ -45,6 +45,20 @@ .Pq Tn PXE specification. .Pp +This manual page assumes the +.Nm +program has been configured +via +.Xr installboot 8 +to use a +.Xr boot.cfg 5 +file. For historical reasons +.Xr boot.cfg 5 +is NOT loaded by default. +See +.Sx EXAMPLES +for how to enable it. +.Pp Network booting a system through .Tn PXE is a two-stage process: @@ -245,6 +259,15 @@ .It Pa /usr/mdec/pxeboot_ia32.bin .El .Sh EXAMPLES +To enable +.Xr boot.cfg 5 +support in the +.Nm +program: +.Bd -literal -offset indent +installboot -e -o bootconf pxeboot_ia32.bin +.Ed +.Pp The first .Pa /etc/dhcpd.conf example shows a simple configuration which just loads @@ -293,7 +316,6 @@ } } } -} .Ed .Pp The following
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Tue Apr 6 22:41:41 UTC 2010 Modified Files: src/share/man/man8/man8.i386: pxeboot.8 Log Message: Fix Dd argument (no leading zeroes). New sentence, new line. To generate a diff of this commit: cvs rdiff -u -r1.16 -r1.17 src/share/man/man8/man8.i386/pxeboot.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.i386/pxeboot.8 diff -u src/share/man/man8/man8.i386/pxeboot.8:1.16 src/share/man/man8/man8.i386/pxeboot.8:1.17 --- src/share/man/man8/man8.i386/pxeboot.8:1.16 Tue Apr 6 20:15:22 2010 +++ src/share/man/man8/man8.i386/pxeboot.8 Tue Apr 6 22:41:41 2010 @@ -1,4 +1,4 @@ -.\ $NetBSD: pxeboot.8,v 1.16 2010/04/06 20:15:22 tnn Exp $ +.\ $NetBSD: pxeboot.8,v 1.17 2010/04/06 22:41:41 wiz Exp $ .\ .\ Copyright (c) 2003 .\ 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 April 06, 2010 +.Dd April 6, 2010 .Dt PXEBOOT 8 i386 .Os .Sh NAME @@ -48,11 +48,12 @@ This manual page assumes the .Nm program has been configured -via +via .Xr installboot 8 to use a .Xr boot.cfg 5 -file. For historical reasons +file. +For historical reasons .Xr boot.cfg 5 is NOT loaded by default. See
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: ahoka Date: Tue Sep 1 21:30:17 UTC 2009 Modified Files: src/share/man/man8/man8.i386: boot.8 Log Message: Document the vesa command. To generate a diff of this commit: cvs rdiff -u -r1.50 -r1.51 src/share/man/man8/man8.i386/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.i386/boot.8 diff -u src/share/man/man8/man8.i386/boot.8:1.50 src/share/man/man8/man8.i386/boot.8:1.51 --- src/share/man/man8/man8.i386/boot.8:1.50 Mon May 18 12:26:15 2009 +++ src/share/man/man8/man8.i386/boot.8 Tue Sep 1 21:30:17 2009 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.50 2009/05/18 12:26:15 wiz Exp $ +.\ $NetBSD: boot.8,v 1.51 2009/09/01 21:30:17 ahoka 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 October 30, 2008 +.Dd September 1, 2009 .Dt BOOT 8 i386 .Os .Sh NAME @@ -350,6 +350,20 @@ .Sx Console Selection Policy in .Xr boot_console 8 . +.It Ic vesa Va modenum | on | off | enabled | disabled | list +Initialise the video card to the specified resolution and bit depth. +The +.Va modenum +should be in the form of +.Ar 0x100 , 800x600 , 800x600x32 . +The values +.Ar enabled , on +put the display into the default mode, and +.Ar disabled , off +returns the display into standard vga mode. +The value +.Ar list +lists all supported modes. .It Ic dev Op Va device Set the default drive and partition for subsequent filesystem operations.
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Mon May 18 12:26:16 UTC 2009 Modified Files: src/share/man/man8/man8.i386: boot.8 Log Message: New sentence, new line. Mark up path with .Pa. To generate a diff of this commit: cvs rdiff -u -r1.49 -r1.50 src/share/man/man8/man8.i386/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.i386/boot.8 diff -u src/share/man/man8/man8.i386/boot.8:1.49 src/share/man/man8/man8.i386/boot.8:1.50 --- src/share/man/man8/man8.i386/boot.8:1.49 Wed Mar 11 19:26:09 2009 +++ src/share/man/man8/man8.i386/boot.8 Mon May 18 12:26:15 2009 @@ -1,4 +1,4 @@ -.\ $NetBSD: boot.8,v 1.49 2009/03/11 19:26:09 joerg Exp $ +.\ $NetBSD: boot.8,v 1.50 2009/05/18 12:26:15 wiz Exp $ .\ .\ Copyright (c) 1991, 1993 .\ The Regents of the University of California. All rights reserved. @@ -136,10 +136,12 @@ by holding down a shift key, as some BIOSes and BIOS extensions will drain the keystroke buffer at various points during POST. .Pp -If present, the file /boot.cfg will be used to configure the behaviour of the -boot loader including setting the timeout, choosing a console device, altering -the banner text and displaying a menu allowing boot commands to be easily -chosen. See +If present, the file +.Pa /boot.cfg +will be used to configure the behaviour of the boot loader including +setting the timeout, choosing a console device, altering the banner +text and displaying a menu allowing boot commands to be easily chosen. +See .Xr boot.cfg 5 . .Pp The @@ -173,7 +175,8 @@ .Ss Interactive mode In interactive mode, the boot loader will present a prompt, allowing input of these commands: -.\ NOTE: much of this text is duplicated in the MI boot.8. Some of it is +.\ NOTE: much of this text is duplicated in the MI boot.8. +.\ Some of it is .\ also duplicated in the i386-specific dosboot.8 and pxeboot.8; .\ please try to keep all relevant files synchronized. .Bl -tag -width 04n -offset 04n @@ -202,8 +205,8 @@ .Pp .Bl -hang -compact .It hd -Hard disks as numbered by the BIOS. This includes -ST506, IDE, ESDI, RLL disks on a WD100[2367] or +Hard disks as numbered by the BIOS. +This includes ST506, IDE, ESDI, RLL disks on a WD100[2367] or lookalike controller(s), and SCSI disks on SCSI controllers recognized by the BIOS. .It fd
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Mon May 18 14:46:51 UTC 2009 Modified Files: src/share/man/man8/man8.i386: dosboot.8 Log Message: New sentence, new line. Use \e for a backslash. Sort option descriptions. To generate a diff of this commit: cvs rdiff -u -r1.19 -r1.20 src/share/man/man8/man8.i386/dosboot.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.i386/dosboot.8 diff -u src/share/man/man8/man8.i386/dosboot.8:1.19 src/share/man/man8/man8.i386/dosboot.8:1.20 --- src/share/man/man8/man8.i386/dosboot.8:1.19 Wed Mar 11 19:26:09 2009 +++ src/share/man/man8/man8.i386/dosboot.8 Mon May 18 14:46:51 2009 @@ -1,4 +1,4 @@ -.\ $NetBSD: dosboot.8,v 1.19 2009/03/11 19:26:09 joerg Exp $ +.\ $NetBSD: dosboot.8,v 1.20 2009/05/18 14:46:51 wiz Exp $ .\ .\ Copyright (c) 1997 .\ Matthias Drochner. All rights reserved. @@ -42,14 +42,14 @@ .Nm is an .Tn MS-DOS -program. It is a boot loader for +program. +It is a boot loader for .Nx Ns Tn /i386 designed to permit .Nx to be booted directly from .Tn MS-DOS . -By default, it boots a file with -name +By default, it boots a file with name .Pa NETBSD in the current .Tn MS-DOS @@ -60,10 +60,6 @@ .Pp The recognized options are: .Bl -tag -width -ads -offset 04n -.It Fl u -Boot from a UFS filesystem instead of an -.Tn MS-DOS -filesystem. .It Fl c Execute .Ar command @@ -72,9 +68,13 @@ Enter interactive mode. .Nm will present a prompt, allowing input of commands (see below). -.Pp -.It Pa path -Specifies the kernel file. In +.It Fl u +Boot from a UFS filesystem instead of an +.Tn MS-DOS +filesystem. +.It Ar path +Specifies the kernel file. +In .Tn MS-DOS mode (default) a normal .Tn MS-DOS @@ -85,13 +85,14 @@ .Ic mode ufs command), a path in a .Nx -filesystem -is expected. By default, the file is looked up in partition 'a' of -the first harddisk. Another device or partition can be specified +filesystem is expected. +By default, the file is looked up in partition +.Sq a +of the first harddisk. +Another device or partition can be specified by prepending a block device name in terms of .Nx , -followed -by a colon (see +followed by a colon (see .Xr boot 8 and examples). .It Fl adqsv @@ -125,8 +126,10 @@ .It Ic ls Op Pa path Print a directory listing of .Pa path , -containing inode number, filename and file type. This command works in -UFS mode only. path can contain a device specification. +containing inode number, filename and file type. +This command works in UFS mode only. +.Pa path +can contain a device specification. .It Ic mode Va fstype Switch filesystem type; .Va fstype @@ -155,7 +158,7 @@ .Tn MS-DOS drive D, one would issue: .Bd -literal -offset indent -dosboot D:\\NODOS\\NETBSD +dosboot D:\eNODOS\eNETBSD .Ed .Pp To boot from a @@ -176,8 +179,8 @@ .Nx 1.3 . .Sh BUGS .Nm -assumes that the processor is in real mode at startup. It does not work -well in the presence of +assumes that the processor is in real mode at startup. +It does not work well in the presence of .Tn MS-DOS extenders and memory managers. .Pp
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: perry Date: Fri Apr 10 21:11:28 UTC 2009 Modified Files: src/share/man/man8/man8.i386: pxeboot.8 Log Message: Make this reflect reality more -- next-server is necessary, there is now this boot.cfg thing, etc. Also add a reasonable hint on how to set up dhcp for booting install kernels via tftp. To generate a diff of this commit: cvs rdiff -u -r1.13 -r1.14 src/share/man/man8/man8.i386/pxeboot.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.i386/pxeboot.8 diff -u src/share/man/man8/man8.i386/pxeboot.8:1.13 src/share/man/man8/man8.i386/pxeboot.8:1.14 --- src/share/man/man8/man8.i386/pxeboot.8:1.13 Wed Mar 11 19:26:09 2009 +++ src/share/man/man8/man8.i386/pxeboot.8 Fri Apr 10 21:11:28 2009 @@ -1,4 +1,4 @@ -.\ $NetBSD: pxeboot.8,v 1.13 2009/03/11 19:26:09 joerg Exp $ +.\ $NetBSD: pxeboot.8,v 1.14 2009/04/10 21:11:28 perry Exp $ .\ .\ Copyright (c) 2003 .\ 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 October 13, 2008 +.Dd April 10, 2008 .Dt PXEBOOT 8 i386 .Os .Sh NAME @@ -66,16 +66,33 @@ .Nx .Nm program takes control. -An interactive mode is entered if the -user presses a key within five seconds. -After this time or after the user's +It immediately issues another +.Tn DHCP +request to get the name of a +.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 boot.cfg 5 . +.\ XXX Now, if the boot.cfg is loaded, is DHCP still used to get the +.\ XXX file name for the kernel? If only the person who had made the +.\ XXX changes had documented them. +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. +After this time, or after the user's .Ic boot command, another .Tn DHCP -request is issued and the kernel -is loaded as specified in the +request is issued and the kernel filename returned by the .Tn DHCP -reply. +reply, using +.Dq netbsd +by default, +is loaded. To read the kernel file, the .Tn NFS .Pq version 2 @@ -92,11 +109,14 @@ program has the following special parameters: .Bl -tag -width .It Bootfile name -is set to the +is set to +.Dq boot.cfg +during the first request, and then to +the .Va filename argument on the .Ic boot -command line typed in by the user (can be empty), or to +command line typed in by the user (can be empty), using .Dq netbsd in the non-interactive case. .It DHCP Vendor class identifier tag @@ -106,15 +126,18 @@ .Pp The .Tn DHCP -server can use these fields to distinguish between -the various originators of requests (first and second -.Tn PXE +server can use these fields (i.e. the +.Tn DHCP +vendor class identifier tag and the requested file name, possibly +supplied by the user's command line input to the +.Nm +program) to distinguish between the various originators of requests +(PXE BIOS, first and second +.Nm stage, .Nx -kernel), and to control conditional behaviour depending on the -user's command line input to the -.Nm -program, e.g. to support alternative +kernel), and to alter its behaviour. +For example, this can be used to support alternative .Nx installations on one machine. .Pp @@ -125,14 +148,15 @@ .Bl -tag -width .It Bootfile name specifies the protocol to be used, and the filename of the +boot config or .Nx kernel to be booted, separated by a colon. Available protocols are .Dq nfs and .Dq tftp . -The kernel filename part is interpreted relatively to the NFS root directory -(see the +The boot config or kernel filename part is interpreted relatively to +the NFS root directory (see the .Em Root path reply field below) or the TFTP server's root directory (which might be a subdirectory within the TFTP server's filesystem, depending on the @@ -152,6 +176,8 @@ If no protocol was specified, .Dq nfs is assumed. +.It Next server +is used as the location of the tftp server. .It Swap server can be used to override the .Dq server IP address @@ -221,7 +247,9 @@ .Sh EXAMPLES The first .Pa /etc/dhcpd.conf -example shows a simple configuration which just loads a file +example shows a simple configuration which just loads +.Dq boot.cfg +and .Dq netbsd from the client's NFS root directory, using the defaults for protocol and kernel filename. @@ -240,6 +268,36 @@ .Pp The following .Pa /etc/dhcpd.conf +entry sets loads the boot config and kernel over tftp. +This can be used, for example, for installing machines by using +an install kernel. +.Pp +.Bd -literal +host myhost { +hardware ethernet 00:00:00:00:00:00; +fixed-address
CVS commit: src/share/man/man8/man8.i386
Module Name:src Committed By: wiz Date: Fri Apr 10 23:22:30 UTC 2009 Modified Files: src/share/man/man8/man8.i386: pxeboot.8 Log Message: Drop trailing whitespace. To generate a diff of this commit: cvs rdiff -u -r1.14 -r1.15 src/share/man/man8/man8.i386/pxeboot.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.i386/pxeboot.8 diff -u src/share/man/man8/man8.i386/pxeboot.8:1.14 src/share/man/man8/man8.i386/pxeboot.8:1.15 --- src/share/man/man8/man8.i386/pxeboot.8:1.14 Fri Apr 10 21:11:28 2009 +++ src/share/man/man8/man8.i386/pxeboot.8 Fri Apr 10 23:22:30 2009 @@ -1,4 +1,4 @@ -.\ $NetBSD: pxeboot.8,v 1.14 2009/04/10 21:11:28 perry Exp $ +.\ $NetBSD: pxeboot.8,v 1.15 2009/04/10 23:22:30 wiz Exp $ .\ .\ Copyright (c) 2003 .\ Matthias Drochner. All rights reserved. @@ -75,7 +75,7 @@ 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 +Otherwise it is loaded and obeyed as described in .Xr boot.cfg 5 . .\ XXX Now, if the boot.cfg is loaded, is DHCP still used to get the .\ XXX file name for the kernel? If only the person who had made the @@ -136,7 +136,7 @@ .Nm stage, .Nx -kernel), and to alter its behaviour. +kernel), and to alter its behaviour. For example, this can be used to support alternative .Nx installations on one machine.