Module Name: src
Committed By: wiz
Date: Sat Sep 5 11:37:53 UTC 2009
Modified Files:
src/share/man/man8/man8.amiga: boot.8
src/share/man/man8/man8.atari: boot.8
src/share/man/man8/man8.mac68k: boot.8
src/share/man/man8/man8.pmax: boot.8
src/share/man/man8/man8.vax: boot.8
src/share/man/man8/man8.x68k: boot.8
Log Message:
New sentence, new line.
To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man8/man8.amiga/boot.8
cvs rdiff -u -r1.12 -r1.13 src/share/man/man8/man8.atari/boot.8
cvs rdiff -u -r1.9 -r1.10 src/share/man/man8/man8.mac68k/boot.8
cvs rdiff -u -r1.14 -r1.15 src/share/man/man8/man8.pmax/boot.8
cvs rdiff -u -r1.11 -r1.12 src/share/man/man8/man8.vax/boot.8
cvs rdiff -u -r1.13 -r1.14 src/share/man/man8/man8.x68k/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.amiga/boot.8
diff -u src/share/man/man8/man8.amiga/boot.8:1.11 src/share/man/man8/man8.amiga/boot.8:1.12
--- src/share/man/man8/man8.amiga/boot.8:1.11 Thu Aug 7 10:31:22 2003
+++ src/share/man/man8/man8.amiga/boot.8 Sat Sep 5 11:37:52 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.11 2003/08/07 10:31:22 agc Exp $
+.\" $NetBSD: boot.8,v 1.12 2009/09/05 11:37:52 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
@@ -46,20 +46,22 @@
When the
.Nx
kernel is booted normally (using one of the two methods discussed below),
-it initializes itself and proceeds to boot the system. An automatic
-consistency check of the file systems takes place, and unless this
-fails, the system comes up to multi-user operations. The proper way
-to shut the system down is with the
+it initializes itself and proceeds to boot the system.
+An automatic consistency check of the file systems takes place,
+and unless this fails, the system comes up to multi-user operations.
+The proper way to shut the system down is with the
.Xr shutdown 8
command.
.Pp
If the system crashes, it will enter the kernel debugger,
.Xr ddb 4 ,
-if it is configured in the kernel. If the debugger is not present,
+if it is configured in the kernel.
+If the debugger is not present,
or the debugger is exited, the system will attempt a dump to the
configured dump device (which will be automatically recovered with
.Xr savecore 8
-during the next boot cycle). After the dump is complete (successful
+during the next boot cycle).
+After the dump is complete (successful
or not), the system will attempt a reboot.
.Ss Booting NetBSD using the bootloader
When a bootable
@@ -74,10 +76,13 @@
partition is selected by means of the boot menu,
the Amiga ROM will automatically start the
.Nx
-bootloader. By default it will, after a short timeout, load the kernel image
+bootloader.
+By default it will, after a short timeout, load the kernel image
.Pa /netbsd
-and attempt to boot it into multi-user mode. This behaviour can be changed by
-typing in an alternate command sequence. The command line looks like:
+and attempt to boot it into multi-user mode.
+This behaviour can be changed by
+typing in an alternate command sequence.
+The command line looks like:
.Bd -ragged -offset indent
.Ar kernel-path
.Op Fl abknpqstvADZ
@@ -131,8 +136,10 @@
.Ar mask
is a bitmap expressed in C notation (e.g., 0xff)
with 4*8bits, each bit, if set to 1, disabling sync negotiation for
-the corresponding target. Note that this only applies to (some of the)
-real SCSI busses, but not, e.g., to internal IDE. The bytes are used up
+the corresponding target.
+Note that this only applies to (some of the)
+real SCSI busses, but not, e.g., to internal IDE.
+The bytes are used up
from right to left by SCSI bus drivers using this convention.
.It Fl S
Load the kernel symbols
@@ -187,27 +194,33 @@
.It Fl A
enable AGA modes.
.It Fl D
-Enter the kernel debugger after booting. Best with -S.
+Enter the kernel debugger after booting.
+Best with
+.Fl S .
.It Fl I Ar mask
inhibit sync negotiation as follows: The
.Ar mask
is a bitmap expressed in hexadecimal (e.g., ff)
with 4*8bits, each bit, if set to 1, disabling sync negotiation for
-the corresponding target. Note that this only applies to (some of the)
-real SCSI busses, but not, e.g., to internal IDE. The bytes are used up
+the corresponding target.
+Note that this only applies to (some of the)
+real SCSI busses, but not, e.g., to internal IDE.
+The bytes are used up
from right to left by SCSI bus drivers using this convention.
.It Fl S
include kernel debug symbols (for use by -D).
.It Fl Z
-Force load via chip memory. Won't work if kernel is larger than the chip
-memory size or on the DraCo.
+Force load via chip memory.
+Won't work if kernel is larger than the chip memory size or on the
+DraCo.
.El
.Pp
Note: Because the loadbsd program can only read kernels from a AmigaOS
filesystem, the file
.Ar /netbsd
-is often not the same as the actual kernel booted. This can cause some
-programs to fail. However, note that you can use third-party Berkeley
+is often not the same as the actual kernel booted.
+This can cause some programs to fail.
+However, note that you can use third-party Berkeley
filesystems such as bffs to access the
.Nx
root partition from AmigaOS.
@@ -238,7 +251,8 @@
-O
or with
.Nx 0.9 )
-with the boot block. You can use
+with the boot block.
+You can use
.Ic loadbsd
to boot from AmigaOS, or upgrade the file system with
.Ar fsck_ffs -c 2 .
Index: src/share/man/man8/man8.atari/boot.8
diff -u src/share/man/man8/man8.atari/boot.8:1.12 src/share/man/man8/man8.atari/boot.8:1.13
--- src/share/man/man8/man8.atari/boot.8:1.12 Thu Aug 7 10:31:23 2003
+++ src/share/man/man8/man8.atari/boot.8 Sat Sep 5 11:37:52 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.12 2003/08/07 10:31:23 agc Exp $
+.\" $NetBSD: boot.8,v 1.13 2009/09/05 11:37:52 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
@@ -46,21 +46,23 @@
When the
.Nx
kernel is booted normally (using one of the two methods discussed below),
-it initializes itself and proceeds to boot the system. An automatic
-consistency check of the file systems takes place, and unless this
-fails, the system comes up to multi-user operations. The proper way
-to shut the system down is with the
+it initializes itself and proceeds to boot the system.
+An automatic consistency check of the file systems takes place,
+and unless this fails, the system comes up to multi-user operations.
+The proper way to shut the system down is with the
.Xr shutdown 8
command.
.Pp
If the system crashes, it will enter the kernel debugger,
.Xr ddb 4 ,
-if it is configured in the kernel. If the debugger is not present,
+if it is configured in the kernel.
+If the debugger is not present,
or the debugger is exited, the system will attempt a dump to the
configured dump device (which will be automatically recovered with
.Xr savecore 8
-during the next boot cycle). After the dump is complete (successful
-or not), the system will attempt a reboot.
+during the next boot cycle).
+After the dump is complete (successful or not), the system will
+attempt a reboot.
.Ss Booting NetBSD using the bootloader
When a bootable
.Nx
@@ -70,20 +72,21 @@
.Nx
, the Atari BIOS will automatically start the
.Nx
-bootloader. By default
-it will load the kernel image
+bootloader.
+By default it will load the kernel image
.Pa /netbsd
-and attempts to boot it into multi-user mode. This behaviour can be changed by
-either keeping the
+and attempts to boot it into multi-user mode.
+This behaviour can be changed by either keeping the
.Pa Alternate
or the
.Pa Right-Shift
-key pressed during the boot. When
-the
+key pressed during the boot.
+When the
.Pa Alternate
key is pressed, the bootstrap is aborted, causing the BIOS
to continue scanning the disks for a bootable partition (this is compatible
-with AHDI 3.0). Pressing the
+with AHDI 3.0).
+Pressing the
.Pa Right-Shift
key during the boot, causes the boot loader to enter the interactive mode.
In interactive mode, the command line looks like:
@@ -108,7 +111,8 @@
If something other than
.Pa .netbsd
is specified, control is returned to the BIOS with the boot preference set to
-the selected type. Due to limitations of the BIOS however, the search for
+the selected type.
+Due to limitations of the BIOS however, the search for
bootblocks is continued rather than restarted.
.It boot-path
This gives you the opportunity to boot another kernel, say:
@@ -139,8 +143,8 @@
.Nx
from GEM, you have to use the
.Xr loadbsd 8
-program that is supplied on the kernel-floppy. The loadbsd command line
-specification is:
+program that is supplied on the kernel-floppy.
+The loadbsd command line specification is:
.Bd -ragged -offset indent
.Nm loadbsd
.Op Fl abdhqstvwDV
@@ -177,15 +181,17 @@
.It Fl v
Boot in verbose mode.
.It Fl w
-Wait for a keypress before exiting loadbsd. This is useful when starting this
-program under GEM.
+Wait for a keypress before exiting loadbsd.
+This is useful when starting this program under GEM.
.It Fl D
Show debugging output while booting the kernel.
.It Fl S Ar amount
-Set the amount of available ST compatible RAM in bytes. Normally this
+Set the amount of available ST compatible RAM in bytes.
+Normally this
value is set automatically from the values initialized by the BIOS.
.It Fl T Ar amount
-Set the amount of available TT compatible RAM in bytes. Normally this
+Set the amount of available TT compatible RAM in bytes.
+Normally this
value is set automatically from the values initialized by the BIOS.
.It Fl V
Print the version of
@@ -198,8 +204,8 @@
Note: Because the loadbsd program can only read kernels from a GEMDOS
filesystem, the file
.Ar /netbsd
-is usually not the same as the actual kernel booted. This can cause some
-programs to fail.
+is usually not the same as the actual kernel booted.
+This can cause some programs to fail.
.Sh FILES
.Bl -tag -width /netbsd -compact
.It Pa /netbsd
Index: src/share/man/man8/man8.mac68k/boot.8
diff -u src/share/man/man8/man8.mac68k/boot.8:1.9 src/share/man/man8/man8.mac68k/boot.8:1.10
--- src/share/man/man8/man8.mac68k/boot.8:1.9 Wed Sep 24 20:07:05 2008
+++ src/share/man/man8/man8.mac68k/boot.8 Sat Sep 5 11:37:52 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.9 2008/09/24 20:07:05 reed Exp $
+.\" $NetBSD: boot.8,v 1.10 2009/09/05 11:37:52 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
@@ -46,45 +46,50 @@
Normally, the
.Nx
kernel on the mac68k architecture is booted from the native operating
-system by means of an application program. When the kernel takes over,
-it initializes itself and proceeds to boot the system. An automatic
-consistency check of the file systems takes place, and unless this
-fails, the system comes up to multi-user operations. The proper way
-to shut the system down is with the
+system by means of an application program.
+When the kernel takes over,
+it initializes itself and proceeds to boot the system.
+An automatic consistency check of the file systems takes place,
+and unless this fails, the system comes up to multi-user operations.
+The proper way to shut the system down is with the
.Xr shutdown 8
command.
.Pp
If the system crashes, it will enter the kernel debugger,
.Xr ddb 4 ,
-if it is configured in the kernel. If the debugger is not present,
+if it is configured in the kernel.
+If the debugger is not present,
or the debugger is exited, the system will attempt a dump to the
configured dump device (which will be automatically recovered with
.Xr savecore 8
-during the next boot cycle). After the dump is complete (successful
+during the next boot cycle).
+After the dump is complete (successful
or not), the system will attempt a reboot.
.Pp
On most mac68k machines with "soft-power" after the IIcx, the power
switch can be physically rotated and locked in the 'on' position.
The native OS can be configured to automatically start the
.Nx
-boot program. Additionally, the
+boot program.
+Additionally, the
.Nx
boot program can be configured to boot
.Nx
-without intervention. When a system is so configured, it can crash
-or lose power and reboot back to a fully multi-user state without
-any intervention.
+without intervention.
+When a system is so configured, it can crash or lose power and
+reboot back to a fully multi-user state without any intervention.
.Pp
.Ss The boot application
-The boot application runs in the native OS on the system. It has a
-dialog where booting preferences may be changed and an option whereby
-these options may be saved. The preferences are stored in the program
+The boot application runs in the native OS on the system.
+It has a dialog where booting preferences may be changed and an
+option whereby these options may be saved.
+The preferences are stored in the program
itself, not in a preferences folder--thus allowing two separate copies
of the program to be configured differently (e.g. to boot different
netbsd or netbsd.test, or to boot from two different drives).
.Pp
-One option that may be specified is a boot to single-user mode. This
-stops the boot process very early on and allows system maintenance.
+One option that may be specified is a boot to single-user mode.
+This stops the boot process very early on and allows system maintenance.
If one wishes to provide some security at this phase of the boot, remove
the
.Ql secure
@@ -93,8 +98,10 @@
file.
.Pp
Another useful option that may be specified is the "serial console"
-option. This will allow a serial device (terminal or computer) to
-act as a console for the system. This device must be configured to
+option.
+This will allow a serial device (terminal or computer) to
+act as a console for the system.
+This device must be configured to
use 9600 baud, eight bits, no parity, and one stop bit (9600-N81).
Either the printer port or the modem port (tty01 and tty00,
respectively) may be used for this.
@@ -102,7 +109,9 @@
It is sometimes useful to boot a kernel that resides in a folder
in native OS rather than from the usual location in the
.Nx
-file system. A radio button is supplied for this purpose. Note that
+file system.
+A radio button is supplied for this purpose.
+Note that
some programs will not run properly if the kernel is not found as
.Ar /netbsd
within the
Index: src/share/man/man8/man8.pmax/boot.8
diff -u src/share/man/man8/man8.pmax/boot.8:1.14 src/share/man/man8/man8.pmax/boot.8:1.15
--- src/share/man/man8/man8.pmax/boot.8:1.14 Mon Mar 23 01:27:59 2009
+++ src/share/man/man8/man8.pmax/boot.8 Sat Sep 5 11:37:52 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.14 2009/03/23 01:27:59 joerg Exp $
+.\" $NetBSD: boot.8,v 1.15 2009/09/05 11:37:52 wiz Exp $
.\"
.\" Copyright (c) 1990, 1991 The Regents of the University of California.
.\" All rights reserved.
@@ -54,18 +54,20 @@
.Nm haltaction
environment
variable in EEPROM to determine whether or not to attempt to boot
-automatically. If this
-variable is set to
+automatically.
+If this variable is set to
.Sq h ,
the ROM prints a prompt on the console and
-waits for user commands. If set to
+waits for user commands.
+If set to
.Sq b ,
the ROM attempts to autoboot.
.Sh DECSTATION 2100 and 3100
On the DECstation 2100 and 3100, the path used for automatic booting is
stored in the
.Nm bootpath
-environment variable. The path is made up of a
+environment variable.
+ The path is made up of a
device type specifier (e.g., rz, tz, mop or tftp) followed by
a triplet in the form (x,y,z), followed by a filename to load.
.Pp
@@ -78,10 +80,11 @@
.Pp
The filename is optional for bootp/tftp and mop booting, since in
these cases the network protocol can be used to determine which
-file to boot. When booting off the tape, no filename should be
-specified. When booting off of disk, the filename is optional but is usually specified. If no filename is
-specified when booting off disk, the following filenames are
-tried in order:
+file to boot.
+When booting off the tape, no filename should be specified.
+When booting off of disk, the filename is optional but is usually specified.
+If no filename is specified when booting off disk, the following
+filenames are tried in order:
.Nm netbsd.pmax ,
.Nm netbsd ,
.Nm netbsd.gz ,
@@ -101,7 +104,8 @@
.Nm auto
or the
.Nm boot
-command. If the
+command.
+If the
.Nm auto
command is used, the
.Fl a
@@ -117,7 +121,8 @@
or the
.Nm auto
command is issued with no arguments, the kernel specified in the bootpath
-environment variable is booted. With the
+environment variable is booted.
+With the
.Nm boot
command, an alternative kernel may be specified
with the
@@ -128,29 +133,34 @@
.Sh TURBOCHANNEL DECstations
On TurboChannel machines (all DECstation 5000 models), the boot path
is specified in the boot environment variable, along with any arguments
-to be passed to the kernel. Note that to specify boot arguments (e.g.,
+to be passed to the kernel.
+Note that to specify boot arguments (e.g.,
.Fl a )
when setting the
.Nm boot
environment variable, the filename and arguments
-must be enclosed in quotes. For example:
+must be enclosed in quotes.
+For example:
.Dl Ic setenv boot Dq Ic "3/rz4/netbsd -a"
.Pp
The device from which to boot is specified as the TurboChannel slot
number, a TurboChannel-option-specific device name, and a path to the
-file to load, all separated by slashes. You can get a list of the
+file to load, all separated by slashes.
+You can get a list of the
devices installed in your TurboChannel slots (as well as any built-in
devices which appear as TurboChannel slots) by typing the
.Nm cnfg
command
-at the boot prompt. You can get more detailed information about a specific
+at the boot prompt.
+You can get more detailed information about a specific
TurboChannel option by typing
.Nm cnfg
followed by the slot number of that
option.
.Pp
For SCSI devices, the option-specific device identifier is either rz# for
-disks or tz# for tapes, where # is the SCSI id of the device. For network
+disks or tz# for tapes, where # is the SCSI id of the device.
+For network
devices, the option-specific protocol identifier is either mop or tftp.
Filename requirements are as for the DECstation 2100 and 3100.
.Pp
@@ -158,13 +168,15 @@
.Nx
from the boot prompt, the
.Nm boot
-command must be used. With no arguments, this simply boots the default
+command must be used.
+With no arguments, this simply boots the default
kernel with the default arguments as set with
.Nm setenv
.Nm boot .
If no boot environment variable is set or if an alternative kernel is to be
booted, the path of that kernel may be specified after the boot command as
-described above, and any arguments may be passed similarly. For example:
+described above, and any arguments may be passed similarly.
+For example:
.Dl Ic boot 3/rz4/netbsd.new -a
.Sh KERNEL ARGUMENTS
The kernel supports the following arguments:
Index: src/share/man/man8/man8.vax/boot.8
diff -u src/share/man/man8/man8.vax/boot.8:1.11 src/share/man/man8/man8.vax/boot.8:1.12
--- src/share/man/man8/man8.vax/boot.8:1.11 Wed Sep 24 20:07:05 2008
+++ src/share/man/man8/man8.vax/boot.8 Sat Sep 5 11:37:52 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.11 2008/09/24 20:07:05 reed Exp $
+.\" $NetBSD: boot.8,v 1.12 2009/09/05 11:37:52 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -177,7 +177,10 @@
as on the 11/750.
.Pp
The 11/750 boot procedure uses the boot ROMs to load block 0 off of
-the specified device. The /usr/mdec directory contains a number
+the specified device.
+The
+.Pa /usr/mdec
+directory contains a number
of bootstrap programs for the various disks which should be placed
in a new pack by
.Xr disklabel 8 .
Index: src/share/man/man8/man8.x68k/boot.8
diff -u src/share/man/man8/man8.x68k/boot.8:1.13 src/share/man/man8/man8.x68k/boot.8:1.14
--- src/share/man/man8/man8.x68k/boot.8:1.13 Wed Mar 11 19:13:54 2009
+++ src/share/man/man8/man8.x68k/boot.8 Sat Sep 5 11:37:53 2009
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.13 2009/03/11 19:13:54 joerg Exp $
+.\" $NetBSD: boot.8,v 1.14 2009/09/05 11:37:53 wiz Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@@ -57,13 +57,15 @@
.Pa fdboot_ufs
program at the top of the disk, and then the fdboot_ufs program loads the
.Pa /boot
-program from the FFS or LFS file system. Normally, the
+program from the FFS or LFS file system.
+Normally, the
.Pa /boot
program then loads the
.Nx
kernel
.Pa /netbsd
-from the same floppy. In addition, the
+from the same floppy.
+In addition, the
.Pa /boot
program has abilities to uncompress gzip'ed kernels, to read
the kernel from other disks of other file systems etc (see below).
@@ -77,21 +79,23 @@
program loader on the SCSI host adapter's ROM reads the
operating system-independent IPL menu program at the top of the disk.
The IPL menu program recognizes the partition table, and selects the partition
-to read the operating system kernel. During this phase, when the
-HELP key on the keyboard is pressed, the IPL menu program displays
-the partition menu of that disk to prompt the user to select the boot
-partition (although the
+to read the operating system kernel.
+During this phase, when the HELP key on the keyboard is pressed,
+the IPL menu program displays the partition menu of that disk to
+prompt the user to select the boot partition (although the
.Nx
implementation of the IPL menu,
.Pa /usr/mdec/mboot ,
does not have this functionality).
.Pp
Next, the IPL menu reads the OS-dependent boot program from the
-top of the selected partition. For
+top of the selected partition.
+For
.Nx
FFS/LFS file systems
.Pa sdboot_ufs
-is used. The
+is used.
+The
.Pa sdboot_ufs
program then loads the
.Pa /boot
@@ -105,8 +109,8 @@
booting sd0a:netbsd - starting in 5
.Ed
.Pp
-After a countdown, the system image listed will be loaded. (In the
-example above, it will be
+After a countdown, the system image listed will be loaded.
+(In the example above, it will be
.Dq Li sd0a:netbsd
which is the file
.Nm netbsd
@@ -149,8 +153,8 @@
.Pp
.Bl -hang -compact
.It sd
-SCSI disks on a controller recognized by the IOCS. The
-unit number is the SCSI ID.
+SCSI disks on a controller recognized by the IOCS.
+The unit number is the SCSI ID.
.It fd
Floppy drives as numbered by the IOCS.
.El
@@ -173,8 +177,8 @@
device, and the path to
.Xr init 8 .
.It Fl d
-Bring the system up in debug mode. Here it waits for a kernel
-debugger connect; see
+Bring the system up in debug mode.
+Here it waits for a kernel debugger connect; see
.Xr ddb 4 .
.It Fl q
Boot the system in quiet mode.
