mdoc nits. New sentence, new line. Remove a comment about tahoe.

This commit is contained in:
wiz 2002-09-28 00:24:13 +00:00
parent b64db12921
commit bd9e498edd
1 changed files with 46 additions and 27 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: disklabel.8,v 1.40 2002/08/19 01:54:58 enami Exp $
.\" $NetBSD: disklabel.8,v 1.41 2002/09/28 00:24:13 wiz Exp $
.\"
.\" Copyright (c) 1987, 1988, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -36,7 +36,7 @@
.\"
.\" @(#)disklabel.8 8.2 (Berkeley) 4/19/94
.\"
.Dd April 19, 1994
.Dd December 14, 2001
.Dt DISKLABEL 8
.Os
.Sh NAME
@ -133,14 +133,14 @@ flag are described with the affected commands.
The read and install forms also support the
.Fl B
option to install bootstrap code on some platforms,
e.g. hp300, vax, and arm32.
e.g., hp300, vax, and arm32.
The
.Fl B
option is not supported on all platforms.
These variants are described later.
.Pp
The first form of the command (read) is used to examine the label on the named
disk drive (e.g. sd0 or /dev/rsd0c).
disk drive (e.g., sd0 or /dev/rsd0c).
It will display all of the parameters associated with the drive
and its partition layout.
Unless the
@ -206,7 +206,8 @@ The
.Fl C
flag causes the partition offset and size values to be displayed in
.Aq cylinder/track/sector
format. Note that, regardless of whether
format.
Note that, regardless of whether
.Fl C
was specified, this format is always accepted by
.Nm
@ -268,8 +269,11 @@ the secondary boot program.
If the names are not explicitly given, standard boot programs will be used.
The boot programs are located in
.Pa /usr/mdec .
The names of the programs are taken from the ``b0'' and ``b1'' parameters
of the
The names of the programs are taken from the
.Dq b0
and
.Dq b1
parameters of the
.Xr disktab 5
entry for the disk if
.Ar disktype
@ -308,16 +312,19 @@ Display the in-core label for sd0 as obtained via
.Pp
.Dl disklabel -w -r /dev/rsd0c sd2212 foo
.Pp
Create a label for sd0 based on information for ``sd2212'' found in
Create a label for sd0 based on information for
.Dq sd2212
found in
.Pa /etc/disktab ,
using
.Pa foo
as the disk pack label.
Any existing bootstrap code will be clobbered. If you do not have an
entry for your disk in
Any existing bootstrap code will be clobbered.
If you do not have an entry for your disk in
.Pa /etc/disktab ,
you can use this style to put
an initial label onto a new disk. Then dump the label to a file (using
an initial label onto a new disk.
Then dump the label to a file (using
.Em disklabel sd0 \*[Gt]
.Em protofile ) ,
editing the file, and replacing the label with
@ -361,15 +368,17 @@ On-disk and in-core labels are unchanged.
Install a new label and bootstrap (on platforms which support the
.Fl B
option, see above).
The label is derived from disktab information for ``sd2212'' and
installed both in-core and on-disk.
The label is derived from disktab information for
.Dq sd2212
and installed both in-core and on-disk.
The bootstrap code comes from the file
.Pa /usr/mdec/newboot .
.Pp
.Dl disklabel -R -r sd0 \*[Lt]protofile\*[Gt]
.Pp
Install a new label and bootstrap on a disk, from a prototype label
file. This is a good way to install a label on a previously unlabeled
file.
This is a good way to install a label on a previously unlabeled
disk for which no entry appears in
.Pa /etc/disktab ,
if you create the
@ -379,17 +388,22 @@ it appropriately (total size, partition offsets, types, etc.)
The kernel device drivers will not allow the size of a disk partition
to be decreased or the offset of a partition to be changed while it is open.
Some device drivers create a label containing only a single large partition
if a disk is unlabeled; thus, the label must be written to the ``a''
if a disk is unlabeled; thus, the label must be written to the
.Dq a
partition of the disk while it is open.
This sometimes requires the desired label to be set in two steps,
the first one creating at least one other partition,
and the second setting the label on the new partition
while shrinking the ``a'' partition.
while shrinking the
.Dq a
partition.
.Pp
On some machines the bootstrap code may not fit entirely in the area
allocated for it by some filesystems.
As a result, it may not be possible to have filesystems on some partitions
of a ``bootable'' disk.
of a
.Dq bootable
disk.
When installing bootstrap code,
.Nm
checks for these cases.
@ -409,31 +423,36 @@ will not install bootstrap code that overlaps it.
.Xr mbrlabel 8
.Sh BUGS
If the disk partition is not specified in the disk name
(i.e. ``xy0'' instead of ``/dev/rxy0c''),
(i.e.,
.Dq xy0
instead of
.Dq /dev/rxy0c ) ,
.Nm
will construct the full pathname of the disk and use
the ``a'' partition on the tahoe,
the ``d'' partition on i386 or hpcmips or arc, and
the ``c'' partition on all others.
will construct the full pathname of the disk and use the
.Dq d
partition on i386, hpcmips, or arc, and the
.Dq c
partition on all others.
.Pp
On the sparc, sparc64, sun2 and sun3
On the sparc, sparc64, sun2, and sun3
.Nx
systems, the size of each partition must be a multiple of the number
of sectors per cylinder (i.e. each partition must be an integer
of sectors per cylinder (i.e., each partition must be an integer
number of cylinders), or the boot ROMs will declare the label
invalid and fail to boot the system.
.Pp
In addition, the
.Fl r
option should never be used on a sparc, sparc64, sun2 or sun3 system
option should never be used on a sparc, sparc64, sun2 or sun3 system
boot disk - the
.Nx
kernel translates the
.Nx
disk label into a SunOS compatible format (which is required by the
boot PROMs) when it writes the label. Using the
boot PROMs) when it writes the label.
Using the
.Fl r
causes
flag causes
.Nm
to write directly to disk, and bypass the format translation.
This will result in a disk label that the PROMs will not recognize,