hardenedbsd/HardenedBSD
1
0
Fork 0
mirror of https://git.hardenedbsd.org/hardenedbsd/HardenedBSD.git synced 2025-01-01 00:18:15 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

ru's mdoc(7) style police was here.

Browse Source 
Submitted by:	ru
This commit is contained in:
Joerg Wunsch 2004-06-02 20:21:28 +00:00
parent 7585929e25
commit 493db0bf12
1 changed files with 23 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

46
sbin/sunlabel/sunlabel.8
View File

@ -74,8 +74,7 @@ In addition,
.Nm .Nm
can install bootstrap code. can install bootstrap code.
.Ss Introduction .Ss Introduction
.Pp The label occupies the first sector (i.e., 512 bytes) of each disk.
The label occupies the first sector (i. e. 512 bytes) of each disk.
It starts with a textual description which by convention also mentions It starts with a textual description which by convention also mentions
the disk geometry in textual form (number of cylinders, alternate the disk geometry in textual form (number of cylinders, alternate
cylinders, heads, and sectors per track), optionally followed by a cylinders, heads, and sectors per track), optionally followed by a
@ -99,7 +98,7 @@ by the
.Fx .Fx
kernel. kernel.
It is maintained solely for compatibilty with the It is maintained solely for compatibilty with the
.Em Solaris .Tn Solaris
operating system that might share disks with operating system that might share disks with
.Fx .Fx
on the same hardware platform. on the same hardware platform.
@ -114,7 +113,7 @@ Note that the hardware platform mandates that two cylinders are set
aside as aside as
.Em alternate cylinders .Em alternate cylinders
which are not available to user programs (and not even through the which are not available to user programs (and not even through the
.Ql backup .Dq Li backup
partition). partition).
.Ss Options .Ss Options
Options are listed in alphabetical order here. Options are listed in alphabetical order here.
@ -169,7 +168,7 @@ option are not suited for re-installing using the
option. option.
.It Fl n .It Fl n
No changes. No changes.
All operations, checks etc. are performed normally, but nothing All operations, checks etc., are performed normally, but nothing
is written to disk. is written to disk.
.It Fl r .It Fl r
Obsolete option that used to indicate that the operation should Obsolete option that used to indicate that the operation should
@ -199,7 +198,7 @@ but this functionality is not supported by
Instead, the only allowable Instead, the only allowable
.Ar type .Ar type
argument is the string argument is the string
.Dq auto , .Dq Li auto ,
indicating that an automatically created label should be written indicating that an automatically created label should be written
to disk. to disk.
This automatism will try to create an initial label that fits as This automatism will try to create an initial label that fits as
@ -207,15 +206,16 @@ best as possible into the available disk capacity.
.El .El
.Pp .Pp
If neither of the If neither of the
.Fl e , .Fl e , R ,
.Fl R ,
or or
.Fl w .Fl w
options is present, the existing label for options are present, the existing label for
.Ar disk .Ar disk
will be printed to standard output. will be printed to standard output.
.Pp .Pp
The
.Ar disk .Ar disk
argument
must be given as a plain disk name, without any leading must be given as a plain disk name, without any leading
.Pa /dev/ . .Pa /dev/ .
.Ss Edit mode .Ss Edit mode
@ -229,36 +229,36 @@ to edit the label.
The label is then checked and examined for any errors. The label is then checked and examined for any errors.
If no errors have been found, the new label is written to disk. If no errors have been found, the new label is written to disk.
If there were any errors, a message is printed to standard If there were any errors, a message is printed to standard
error output, and the user is asked whether they want to edit error output, and the user is given the opportunity to edit
the template file again. the template file again.
If accepted, editing starts over, if declined, no changes will If accepted, editing starts over.
If declined, no changes will
be written to disk. be written to disk.
.Pp .Pp
The label presented for editing is the same as the standard The label presented for editing is the same as the standard
printout, with some added hints about the possible options to printout, with some added hints about the possible options to
specify the sector size and starting cylinder. specify the sector size and starting cylinder.
There are two areas in the template that can be edited: There are two areas in the template that can be edited:
.Pp
.Bl -tag -width indent .Bl -tag -width indent
.It Sy Textual label, geometry emulation .It Sy Textual label, geometry emulation
The line The line
.Dl "text: XXXX cyl CC alt 2 hd HH sec SS" .D1 Li text: Ar XXXX Li cyl Ar CC Li alt 2 hd Ar HH Li sec Ar SS
represents the label text. represents the label text.
It must be retained exactly in the form shown. It must be retained exactly in the form shown.
The editable text The editable text
.Sy XXXX .Ar XXXX
is a simple (non-whitespace) text describing the disk. is a simple (non-whitespace) text describing the disk.
By convention, this text mentions the approximate size of the By convention, this text mentions the approximate size of the
disk, as in disk, as in
.Ql SUN9.0G .Dq Li SUN9.0G
for a 9 GB disk shipped by Sun. for a 9 GB disk shipped by Sun.
.Pp .Pp
The values The values
.Sy CC , .Ar CC ,
.Sy HH , .Ar HH ,
and and
.Sy SS .Ar SS
describe the number of cylinders, heads (aka. tracks per describe the number of cylinders, heads (tracks per
cylinder), and sectors per track respectively. cylinder), and sectors per track respectively.
They might be modified to change the geometry emulation. They might be modified to change the geometry emulation.
Each number must be between 1 and 65535. Each number must be between 1 and 65535.
@ -289,14 +289,14 @@ for megabytes, or
.Ql g .Ql g
for gigabytes. for gigabytes.
The last partition entry may specify the size as The last partition entry may specify the size as
.Ql \&* .Ql *
to indicate that this entry should consume the rest of disk not to indicate that this entry should consume the rest of disk not
consumed by any other partition so far. consumed by any other partition so far.
.Pp .Pp
The start of partition is always taken as a cylinder number (starting The start of partition is always taken as a cylinder number (starting
at 0) since this is what the underlying hardware uses. at 0) since this is what the underlying hardware uses.
Alternatively, specifying it as Alternatively, specifying it as
.Ql \&* .Ql *
will make the computation automatically chose the nearest possible will make the computation automatically chose the nearest possible
cylinder boundary. cylinder boundary.
.Pp .Pp
@ -345,13 +345,13 @@ for octal numbers).
If the flag field is omitted, it defaults to If the flag field is omitted, it defaults to
.Ql wm . .Ql wm .
If the tag field is also omitted, it defaults to If the tag field is also omitted, it defaults to
.Ql unassigned . .Dq Li unassigned .
If none of the partitions lists any VTOC tag/flags, no If none of the partitions lists any VTOC tag/flags, no
SVR4-compatible VTOC elements will be written to disk. SVR4-compatible VTOC elements will be written to disk.
If VTOC-style elements are present, partition If VTOC-style elements are present, partition
.Ql c .Ql c
must be marked as must be marked as
.Ql backup .Dq Li backup
(and should be marked (and should be marked
.Ql wu ) . .Ql wu ) .
.El .El