diff options
Diffstat (limited to 'usr.sbin/boot0cfg/boot0cfg.8')
-rw-r--r-- | usr.sbin/boot0cfg/boot0cfg.8 | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/usr.sbin/boot0cfg/boot0cfg.8 b/usr.sbin/boot0cfg/boot0cfg.8 new file mode 100644 index 0000000..28a5d9e --- /dev/null +++ b/usr.sbin/boot0cfg/boot0cfg.8 @@ -0,0 +1,137 @@ +.\" Copyright (c) 1999 Robert Nordier +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, +.\" OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT +.\" OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR +.\" BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +.\" WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE +.\" OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, +.\" EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" $Id: $ +.\" +.Dd February 21, 1999 +.Dt BOOT0CFG 8 +.Os +.Sh NAME +.Nm boot0cfg +.Nd boot manager installation/configuration utility +.Sh SYNOPSIS +.Nm boot0cfg +.Op Fl Bv +.Op Fl b Ar boot0 +.Op Fl d Ar drive +.Op Fl f Ar file +.Op Fl o Ar options +.Op Fl t Ar ticks +.Ar disk +.Sh DESCRIPTION +The FreeBSD +.Sq boot0 +boot manager permits the operator to select from which disk and which +slice an i386 machine (PC) is booted. +.Pp +Note that what are referred to here as +.Dq slices +are typically called +.Dq partitions +in non-BSD documentation relating to the PC. Typically, only +non-removable disks are sliced. +.Pp +The +.Nm +utility optionally installs the +.Sq boot0 +boot manager on the specified +.Ar disk ; +and allows various operational parameters to be configured. +.Pp +On PCs, a boot manager typically occupies sector 0 of a disk, which is +known as the Master Boot Record (MBR). The MBR contains both code (to +which control is passed by the PC BIOS) and data (an embedded table of +defined slices). +.Pp +The options are: +.Bl -tag -width indent +.It Fl B +Install the +.Sq boot0 +boot manager. This option causes MBR code to be replaced, but without +affecting the embedded slice table. +.It Fl v +Verbose: display information about the slices defined, etc. +.It Fl b Ar boot0 +Specify which +.Sq boot0 +image to use. The default is /boot/boot0. +.It Fl d Ar drive +Specify the drive number used by the PC BIOS in referencing the drive +which contains the specified +.Ar disk . +Typically this will be 0x80 for the first hard drive, 0x81 for the +second hard drive, and so on; however any integer between 0 and 0xff +is acceptable here. +.It Fl f Ar file +Specify that a backup copy of the preexisting MBR should be written to +.Ar file . +This file is created if it does not exist, and truncated if it does. +.It Fl o Ar options +A comma-separated string of any of the following options may be +specified (with +.Dq no +prepended as necessary): +.Bl -tag -width indent +.It packet +Use the disk packet (BIOS Int 0x13 extensions) interface rather than +the conventional (CHS) interface, when accessing disk-related BIOS +services. The default is +.Sq nopacket . +.It setdrv +Causes the drive containing the disk to be referenced using drive +number definable by means of the -d option. The default is +.Sq nosetdrv . +.It update +Allow the MBR to be updated by the boot manager. (The MBR may be +updated to flag slices as +.Sq active , +and to save slice selection information.) This is the default; a +.Sq noupdate +option causes the MBR to be treated as read-only. +.El +.It Fl t Ar secs +Set the timeout value to +.Ar ticks . +(There are approximately 18.2 ticks per second.) +.El +.Sh SEE ALSO +.Xr boot 8 , +.Xr fdisk 8 . +.Sh DIAGNOSTICS +Exit status is 0 on success and >0 on error. +.Sh AUTHORS +.An Robert Nordier Aq rnordier@FreeBSD.org . +.Sh BUGS +Use of the +.Sq packet +option may cause +.Sq boot0 +to fail, depending on the nature of BIOS support. +.Pp +The +.Sq setdrv +option is presently implemented +.Dq syntactically but not semantically . |