freebsd-ports/sysutils/sformat/files/patch-sformat::sformat.1
Marius Strobl 7c2c6e4327 - Remove obsolete USE_REINPLACE.
- Fix display of literal examples in sformat.1; bump PORTREVISION for
  this. [1]
- While at the man page remove trailing whitespace, fix spelling errors
  and adopt better for FreeBSD.

Reported by:	Alex Teclo [1]
Fix by:		ru [1]
Approved by:	netchild
2006-04-02 14:25:19 +00:00

1125 lines
31 KiB
Groff

--- sformat/sformat.1.orig Mon Dec 16 19:18:21 2002
+++ sformat/sformat.1 Mon Dec 16 19:20:33 2002
@@ -13,7 +13,7 @@
.if n .ds o oe
.if n .ds u ue
.if n .ds s sz
-.TH "SFORMAT draft" 1L "01/04/25" "J\*org Schilling" "Schily\'s USER COMMANDS"
+.TH "SFORMAT draft" 1 "01/04/25" "J\*org Schilling" "Schily\'s USER COMMANDS"
.SH NAME
sformat \- SCSI disk formatting/partitioning/analysis/repair utility
.SH SYNOPSIS
@@ -25,37 +25,37 @@
.PP
The first form will select the named disk directly.
-Have a look at the chapter about
+Have a look at the chapter about
.B "Following The Main Thread
for more details.
.PP
The second form will scan all SCSI busses and enter a selection menu.
-Have a look at the chapter about
+Have a look at the chapter about
.B "The SCSI Selection Menu
for more details.
.PP
.B Sformat
will never destroy or modify any data unless explicitly confirmed
just before the (possibly) destructive action.
-Have a look at the chapter about
-.B "How To Answer Questions
+Have a look at the chapter about
+.B "How To Answer Questions
first.
.SH DESCRIPTION
.B Sformat
-is the first SCSI disk formatting utility that runs under
+is the first SCSI disk formatting utility that runs under
.IR SunOS .
Long before Sun decided that formatting and partitioning a disk
from a stand alone program is less convenient than doing this job
-from a running UNIX,
-.B sformat
+from a running UNIX,
+.B sformat
has been available.
.PP
.B Sformat
leads the beginner through a thread menu and allows the experienced
user to do more things than he could do with other disk maintenance
programs. All partitioning jobs can be done without the need for
-a desc calculator.
+a desk calculator.
.PP
If you want to do more than simple things, you should carefully read the whole
manual. It contains many tips and tricks that will help you to recover
@@ -68,11 +68,11 @@
.SH "Disk Database Entries
.PP
-Be nice to other users of
+Be nice to other users of
.BR sformat .
Create database (sformat.dat) entries for disks that are not in the data base
-using the
-.B \-Proto
+using the
+.B \-Proto
flag and mail them to the author.
This helps other users and you too.
See section on
@@ -82,15 +82,15 @@
.SH OPTIONS
.TP 18
.BR \-help ", " \-h
-Print a summary of the most important options for
+Print a summary of the most important options for
.BR sformat .
.TP
.B \-xhelp
-Print a summary of less frequently used options for
+Print a summary of less frequently used options for
.BR sformat .
.TP
.B \-version
-Prints the
+Prints the
.B sformat
version number string and exists.
.TP
@@ -100,7 +100,7 @@
.TP
.BR \-auto ", " \-a
autoformat mode (for production systems).
-When this option is in effect,
+When this option is in effect,
.B sformat
will not ask whether to modify the format and partition parameters
and will only format disks that are known in the data base.
@@ -127,33 +127,33 @@
.TP
.BI CWveri= "#, " CW= #
Number of blocks/write-verify.
-The limitation noted with the
+The limitation noted with the
.B Cveri
option applies here again and even on newer disks.
.TP
.BI data= name
Name of disk database file (default: 'sformat.dat').
-Use this option to force
+Use this option to force
.B sformat
to use a different disk database than the default.
-In any case,
+In any case,
.B sformat
will search in the current directory first.
If no file of the appropriate name was found in the current directory,
.B sformat
looks in the following path:
.br
-.I /opt schily/etc, /etc, /usr/etc.
+.I %%DATADIR%%.
.TP
.BI debug= "#, " -d
Set the misc debug value to # (with debug=#) or increment
the misc debug level by one (with -d). If you specify
.I -dd,
-this equals to
+this equals to
.BR debug=2.
.TP
.BI kdebug= "#, " kd= "#
-Tell the
+Tell the
.BR scg -driver
to modify the kernel debug value while SCSI commands are running.
.TP
@@ -161,12 +161,12 @@
Set the debug level for the parser of the external disk database.
.TP
.B \-defmodes
-Get default mode parameters from disk. Normally
-.B sformat
+Get default mode parameters from disk. Normally
+.B sformat
retrieves the default modes parameters from the disk by default
when the disk is unformatted or has no sun label and the
current mode parameter if the disk has a valid sun label.
-This option tells
+This option tells
.B sformat
retrieve the default mode parameters in any case.
.TP
@@ -189,30 +189,30 @@
.B \-greassign
Reassign blocks.
This is the guru mode, don't use this. Read the description
-for the
+for the
.I \-reassign
option for more details.
-This option will simply prompt for block numbers
+This option will simply prompt for block numbers
and then reassign them regardless of if they need to be
-reassigned or not. On some disks the block may seem to be
+reassigned or not. On some disks the block may seem to be
defective even after reassigning it because the old data
is copied to the new location without recomputing the CRC.
On other disk the old data will be lost. These problems
-will not arise if you use the
-.I \-reassign
+will not arise if you use the
+.I \-reassign
option instead.
.TP
.B \-ign_not_found
Ignore record not found errors while verifying the disk.
This option is useful when trying to repair disks with
-many defects (see
+many defects (see
.I maxbad
option). Some disk errors may cause the whole track
to appear bad. If the reported error in these cases
-is
+is
.BR "record not found" ,
You should first try to repair as many blocks as possible
-with this option in effect and then repair the remaining
+with this option in effect and then repair the remaining
blocks without this option.
.TP
.B \-inq
@@ -236,7 +236,7 @@
one bad block (maxbad=1), this problem will go away.
.TP
.B \-modes
-Intercative modesense/modeselect.
+Interactive modesense/modeselect.
Each mode page exists in 4 versions:
.br
default (PROM), current (RAM), saved (DISK) and changeable (BITMASK).
@@ -245,23 +245,23 @@
.B "This is currently under construction.
.TP
.B \-noformat
-Force not to format disk even when formatting of the
-disk has been confirmed.
-This option may be used to
+Force not to format disk even when formatting of the
+disk has been confirmed.
+This option may be used to
modify mode parameters without formatting the disk.
.TP
.B \-nomap
Do not map SCSI address to logical disk name. WARNING:
-If you use this option,
+If you use this option,
.B sformat
is not able to check whether the disk has mounted
partitions. This may damage mounted file systems.
.TP
.B \-noparity
Try to disable parity checking on all SCSI commands that are
-sent by
+sent by
.B sformat.
-This may not be possible in all implementations of the
+This may not be possible in all implementations of the
.IR scg -driver.
.TP
.B \-nowait
@@ -269,7 +269,7 @@
.B sformat
will prompt for a modification of the disk label and
partition table before starting to verify the disk.
-If this option is in effect,
+If this option is in effect,
.B sformat
will immediately start to verify the disk after formatting.
.TP
@@ -284,27 +284,27 @@
disk.
.TP
.B \-prgeom
-Get and print geometry data. This is an old option but it
-is useful to get all mode pages that are supported
+Get and print geometry data. This is an old option but it
+is useful to get all mode pages that are supported
by this disk.
.TP
.B \-prcurgeom
Get and print geometry data. This is basically the same as
.I \-prgeom
-except that \-prgeom will obtain the default mode pages,
+except that \-prgeom will obtain the default mode pages,
\-prcurgeom will report the current values.
.TP
.B \-Proto
This option will cause
-.B sformat
+.B sformat
to generate a data base entry for the current disk.
Make sure that this data base entry will be generated with
-the correct format time.
+the correct format time.
.B Sformat
is able to compute a format time from the disk geometry,
but newer disks seem to need more time than computed.
If the format time is too short, the formatting may be
-aborted and the disk will not be accessible until formatted
+aborted and the disk will not be accessible until formatted
again completely.
.TP
.B \-r
@@ -312,8 +312,8 @@
.TP
.B \-randrw
The random read/write test is a method to find problems that
-may be a result of first seeking to a new place on disk
-and then writing data to it as it is frequently done by the unix file system.
+may be a result of first seeking to a new place on disk
+and then writing data to it as it is frequently done by the Unix file system.
This is usually caused by an inode or super block update.
The above problems may be a result of bad bearings in the disk.
If the disk does not produce errors while this test is running,
@@ -321,16 +321,16 @@
that the disk is bad, the data on disk may get corrupted.
To minimize the risk of data loss, the first block containing
the disk label (partition) and the last block containing the
-sinfo data (a
-.B sformat
+sinfo data (a
+.B sformat
specific area) will never be written to.
.TP
.B \-reassign
-Reassign a list of blocks
-.B sformat
+Reassign a list of blocks
+.B sformat
will prompt for.
This is the preferred command when trying to repair
-a block or a list of blocks with already known
+a block or a list of blocks with already known
block addresses.
If you don't know the address of a defective block, use the
.I \-repair
@@ -338,8 +338,8 @@
.B Sformat
will first try to read the old content of the defective block
and then try to refresh the data by writing the old data to the block.
-If it fails to write to the block,
-.B sformat
+If it fails to write to the block,
+.B sformat
will reassign the defective block.
If the block does not cause errors after rewriting the data in it,
.B sformat
@@ -348,14 +348,14 @@
but actually is not.
If for any reason, the disk will be powered off during writing or if
there is electro magnetic noise the CRC for a block may get corrupted
-without any physical harm to the magnetic media. These cases can be
+without any physical harm to the magnetic media. These cases can be
repaired by writing again to the block.
.TP
.B \-refresh_only
.B Sformat
will not try to reassign a block that still fails
after rewriting (refreshing) the data in it.
-This option is useful in conjunction with the
+This option is useful in conjunction with the
.I \-reassign
and the
.I \-repair
@@ -363,7 +363,7 @@
.TP
.B \-repair
This is a combination of the
-.I \-verify
+.I \-verify
and
.I \-reassign
option.
@@ -373,7 +373,7 @@
.TP
.BI RW= #
Number of random R/W loops that is used with the
-.I \-randrw
+.I \-randrw
option.
The default is the number of physical sectors / 100.
This will not last too long and is enough to cover every
@@ -385,9 +385,9 @@
see if a disk has these problems.
.TP
.B \-seek
-Do
+Do
.I random
-or
+or
.I "full stroke
seek tests on the disk. This is done by reading data; trying to
do
@@ -398,7 +398,7 @@
Do a SCSI modeselect with all parameters, that would have been
necessary for a format, but do not format the disk.
This allows to modify the mode pages of a disk without reformatting it.
-If the
+If the
.B \-smp
option is used in conjunction with
.B \-setmodes
@@ -413,7 +413,7 @@
Do not try to save mode parameters when setting them.
This option is useful if a nearly totally damaged disk
must be reformatted. Some disk controllers, in this case will
-reject to format the disk if the area on disk where this data
+reject to format the disk if the area on disk where this data
will be stored is not accessible before formatting the disk.
.TP
.B \-start
@@ -432,8 +432,8 @@
command.
.TP
.BR \-tr ", " \-t
-This is an option that is only useful with old
-.B Adaptec
+This is an option that is only useful with old
+.B Adaptec
SCSI bridge controllers.
These controllers are not able to deal with
logical sector numbers in some cases. Therefore
@@ -444,9 +444,9 @@
sector header. It may fail if the block has a bad sector header.
.TP
.BI VL= #
-Set the number of verify passes that are done
+Set the number of verify passes that are done
after formatting a disk to #. The default value is 5.
-In write verify mode, this number is doubled because
+In write verify mode, this number is doubled because
.B sformat
will alternate write verify and read verify passes
in this case.
@@ -457,7 +457,7 @@
.B \-V
Increment the verbose level in respect of SCSI command transport by one.
This helps to debug problems
-with SCSI commands.
+with SCSI commands.
If you get incomprehensible error messages you should use this flag
to get more detailed output.
.B \-VV
@@ -469,17 +469,17 @@
slows down the process and may be the reason for a buffer underrun.
.TP
.B \-verify
-This options starts
+This options starts
.B sformat
in verify disk (surface analysis) mode.
Verifying a disk is a method that allows to scan for
defects without modifying data on the disk.
-In this mode, the controller will read the disks without
+In this mode, the controller will read the disks without
transferring data to the computer while all error recovery is
disabled.
.TP
.BI Vstart= #
-Set the first block for the
+Set the first block for the
.IR \-verify ,
.IR \-repair ,
.I \-randrw
@@ -491,7 +491,7 @@
is near the end of the disk.
.TP
.BI Vend= #
-Set the last block for the
+Set the last block for the
.IR \-verify ,
.IR \-repair ,
.I \-randrw
@@ -504,13 +504,13 @@
.TP
.B \-wrveri
If this option is used in while formatting a disk,
-it tells
+it tells
.B sformat
to write verify the disk instead of only read verifying it
after formatting.
-If it is used in combination with the
+If it is used in combination with the
.I \-verify
-option,
+option,
.B sformat
will write verify the disk without prior formatting.
In both cases, the old data on disk will be damaged.
@@ -523,30 +523,30 @@
There are four types of questions.
.TP
\(bu
-Questions that can be answered with
+Questions that can be answered with
.I yes
or
.I no.
Yes may be abbreviated with 'y' or 'Y'.
-These questions are always assumed to be answered with
+These questions are always assumed to be answered with
.I no
if you simply enter
.I "carriage return.
-NOTE: the latter is always a
+NOTE: the latter is always a
.I safe
-answer.
-All questions that request confirmation for actions that may damage or modify
+answer.
+All questions that request confirmation for actions that may damage or modify
data on disk are formed in such a way that answering them with
.I no
-or
+or
.I "carriage return
will not harm any data.
All answers to this type of questions
except
.I "[y]es
-or
+or
.I "[Y]ES
-are interpreted as if
+are interpreted as if
.I no
has been entered.
.TP
@@ -560,16 +560,16 @@
\(bu
Questions that need a word selected from a list of valid words as input.
If you enter '?', you will get a list of possible input to that question.
-Each word is on a separate line an (in some cases) is followed by a
+Each word is on a separate line an (in some cases) is followed by a
explanation how to use it.
.TP
\(bu
Questions that need a number within a certain range.
-For this type of questions,
+For this type of questions,
.B sformat
displays the current value and the valid range in parenthesis.
The default radix for numbers is ten. If you need to enter
-a hexadecimal number precede it with
+a hexadecimal number precede it with
.I 0x
if you need to enter an octal number, precede it with
.I 0.
@@ -582,20 +582,20 @@
Entering an dollar sign '$' will set the value to the greatest possible
.TP
+
-Entering a
+Entering a
.I "plus sign
will increment the current value by one.
.TP
-
-Entering a
+Entering a
.I "minus sign
will decrement the current value by one.
.TP
<CR>
-Entering a
+Entering a
.I "carriage return
will not modify the current value.
-If the default value is -1, you need to supply a valid
+If the default value is -1, you need to supply a valid
value to be allowed to leave the question menu.
.RE
.PP
@@ -604,7 +604,7 @@
.SH "The SCSI Selection Menu
.PP
-When
+When
.B Sformat
is started without or with insufficient parameters,
the SCSI menu mode is entered.
@@ -612,7 +612,7 @@
.PP
.nf
.na
-.cs R 4*\w'x'/\n(.s
+.ft C
\s-2sparky joerg > sformat
sformat SCSI format/analysis/repair utilities
Release 3.1, Copyright J. Schilling
@@ -638,7 +638,7 @@
16) *
17) HOST ADAPTOR
Select target -1 (0 - 12)/<cr>: \s+2
-.cs R
+.ft
.ad
.fi
.PP
@@ -646,17 +646,17 @@
.PP
.nf
.na
-.cs R 4*\w'x'/\n(.s
+.ft C
c0t0d0 0) 'Quantum ' 'XP34300 ' 'F76D' Disk
-.cs R
+.ft
.ad
.fi
.PP
-shows the canonical logical disk name (in this case
+shows the canonical logical disk name (in this case
.BR c0t0d0 ),
the menu number, the SCSI inquiry string and a description of the device type
that was found on this SCSI target.
-The menu number is directly related to the SCSI target id of the device and the
+The menu number is directly related to the SCSI target id of the device and the
SCSI bus number.
Number 3 is SCSI target # 3 on SCSI bus # 0.
Number 12 is SCSI target # 2 on SCSI bus # 1.
@@ -668,7 +668,7 @@
.PP
.nf
.na
-.cs R 4*\w'x'/\n(.s
+.ft C
Select target -1 (0 - 6)/<cr>:0
scsibus0 target 0:
c0t0d0 0) 'Quantum ' 'XP34300 ' 'F76D' Disk
@@ -680,7 +680,7 @@
6) 'Quantum ' 'XP34300 ' 'F76D' unsupported
7) 'Quantum ' 'XP34300 ' 'F76D' unsupported
Select lun -1 (0 - 7)/<cr>:
-.cs R
+.ft
.ad
.fi
.PP
@@ -694,26 +694,26 @@
there is actually no device connected.
.PP
When selecting a specific logical unit, the main thread is entered as if
-a complete SCSI target specification has been entered from the command
+a complete SCSI target specification has been entered from the command
line.
.SH "Following The Main Thread
.PP
-If the main formatting thread is entered, the following
+If the main formatting thread is entered, the following
stages are encountered:
.PP
.TP 20
Mapping and checking
-The first thing
-.B sformat
+The first thing
+.B sformat
does, is to map the SCSI target/lun/busid triplet into
a logical disk name and to check if some
part of the disk is currently mounted.
-This mapping will be skipped if the
+This mapping will be skipped if the
.I \-nomap
options is specified.
-If the disk is mounted, the user will be asked if
-it is ok to continue.
+If the disk is mounted, the user will be asked if
+it is ok to continue.
.br
Note: this is currently the one and only question.
.TP
@@ -734,12 +734,12 @@
Read sinfo data
When the device is a disk,
.B sformat
-tries to read the
+tries to read the
.B sinfo
data from the disk.
-This allows the user to see if the device has been formatted with
-.B sformat
-before. If so,
+This allows the user to see if the device has been formatted with
+.B sformat
+before. If so,
.B sformat
will print out the number of reformats and the date of the first and last
format.
@@ -750,9 +750,9 @@
.TP
Process special commands
If options tell
-.B sformat
-to take special actions (like
-.IR \-start " or " \-prdefect ),
+.B sformat
+to take special actions (like
+.IR \-start " or " \-prdefect ),
they are done here.
.B Sformat
terminates after processing them.
@@ -762,23 +762,23 @@
Several other things can be done from this thread.
Modifying the disk label will be one example.
You need not to be in fear that following this thread will modify or harm
-data on the disk.
+data on the disk.
There will be extra questions that secure this case.
.TP
Test whether the disk is formatted
-Several procedures differ if the disk is already formatted and has a
+Several procedures differ if the disk is already formatted and has a
valid label.
.PP
The next parts of the main thread will give you some questions to answer.
You may skip most of the questions if you do not want to modify anything.
.PP
-If some data that is definitely needed by
+If some data that is definitely needed by
+.B sformat
+can not be determined from the disk or the data base,
.B sformat
-can not be determined from the disk or the data base,
-.B sformat
will force you to answer all questions of a group.
-.B Sformat
-will only ask question for parameters that are definitely needed or
+.B Sformat
+will only ask question for parameters that are definitely needed or
may be changed on the current disk. The content of the menus differ from disk
to disk.
.TP
@@ -786,12 +786,12 @@
Several mode pages of the disk are read.
This data and the inquiry data is used to search in the disk data base.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Ignore database disk parameters from 'sformat.dat'?
.br
-If you don't want the data from the data base to be used, negotiate the
+If you don't want the data from the data base to be used, negotiate the
appropriate question.
Some disks cannot be determined from the fetchable data.
This are mainly disks that are connected to a bridge controller e.g.
@@ -802,7 +802,7 @@
capacity and geometry.
If there is more than one possible entry for this disk in the data base,
.br
-.B sformat
+.B sformat
asks:
.br
.I "Select alternate disk type?
@@ -810,7 +810,7 @@
If the disk type menu is entered, all possible data base entries are displayed.
The current entry is marked with '*', the default entry is marked with '+'
and the entry most similar to the current disk is marked with '~'.
-A matching factor is displayed in parenthesis. Higher values
+A matching factor is displayed in parenthesis. Higher values
are indicating a better match.
.TP
Read in label data
@@ -818,18 +818,18 @@
.B sformat
reads in the label and ask whether to remember this data.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Ignore old disk Label?
.br
-I you confirm this question and reformat the disk, the old partitioning
+I you confirm this question and reformat the disk, the old partitioning
information will be lost.
.TP
Disk Parameters Menu
If you want to modify some disk parameters answer the next question with 'y'.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Modify Disk Geometry Parameters?
@@ -841,7 +841,7 @@
Error Recovery
Error recovery parameters include read/write retry count and similar.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Modify Error recovery Parameters?
@@ -850,7 +850,7 @@
Disconnect Parameter
Disconnect parameters are buffer full/empty ratio and bus inactivity limit.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Modify Disconnect Parameters
@@ -860,7 +860,7 @@
If you want to use an alternate label that may be in the data base
go into the next menu.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Select alternate Label?
@@ -868,24 +868,24 @@
The current entry is marked with '*', the default entry is marked with '+'.
.TP
Logical Label Geometry
-.B Sformat
-uses an abstract geometry in the label. This allows to have
+.B Sformat
+uses an abstract geometry in the label. This allows to have
one label for a group of disks. The label geometry menu allows to modify
this abstract geometry.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Modify Label Geometry Parameters?
.br
.TP
SCSI Parameters
-This menu contains questions about command queuing, defect list format and
+This menu contains questions about command queuing, defect list format and
similar.
-Some disks do not support the default block defect list format. Specify
-another format in this case here. If the disk does not support the
-SCSI write-verify command,
-.B sformat
+Some disks do not support the default block defect list format. Specify
+another format in this case here. If the disk does not support the
+SCSI write-verify command,
+.B sformat
allows to split this into a SCSI write and a SCSI verify command.
The data cannot be compared in this case.
If the disk type is generally flaky a data base entry can be set up to do
@@ -893,22 +893,22 @@
If the disk will not handle 1000 blocks per verify command because
of a firmware bug, a smaller value may be specified here.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Modify SCSI Parameters?
.br
.TP
Grown Defect List
-If a disk has not been formatted before or has been refurbished, you should
+If a disk has not been formatted before or has been refurbished, you should
clear the old grown defect list to get a clean start. If the disk
-has bad blocks,
+has bad blocks,
.B sformat
will find them after formatting while doing the surface analysis.
If the disk has known defects you should negotiate the next question to
keep the defect list.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Clear old grown defect list?
@@ -917,12 +917,12 @@
Mode pages
If you want to format the disk, you need to set the mode pages before.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Set mode pages (needed for format)?
.br
-However, if you do not want to format the disk, you may negotiate this
+However, if you do not want to format the disk, you may negotiate this
question and will be lead to the label modification menu.
.TP
Formatting the disk
@@ -930,7 +930,7 @@
If formatting has started, you will see the progress of this process
indicated in the used up percentage of the estimated time.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Format Disk destroys all Data. Really?
@@ -941,14 +941,14 @@
After the disk has been formatted or if the formatting has been denied,
the label menu is entered.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Print disk label?
.br
If you want to see the current layout of the disk label, enter 'y'.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Modify disk label?
@@ -957,42 +957,42 @@
.TP
Inside the label modification menu
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Label: <Quantum XP34300> change ?
.br
If you want to retain the old label name, enter <CR>, else
-enter 'y'.
+enter 'y'.
.B Sformat
will ask for the new Label name.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Enter disk label: Quantum XP34300
.br
You are left in the tty line edit mode and may modify the input line (see
-termio(7) manual page).
+termios(4) manual page).
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Volume Name: <> change ?
.br
If you want to retain the old label name, enter <CR>, else
-enter 'y'.
+enter 'y'.
.B Sformat
will ask for the new Volume name.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Change partition table?
.br
If you want to change the partition table enter 'y'.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Part Tag Flag Cylinders Startsec # of Sec Size Blocks
@@ -1002,29 +1002,29 @@
.I "Change ?
.br
If you want to modify this partition enter 'y', otherwise
-enter <CR> until
-.B sformat
+enter <CR> until
+.B sformat
asks for the partition you want to change.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Enter partition id Tag [root]:
.br
-Enter <CR> if the partition tag is ok for this partition, otherwise
-enter '?' to get a list of valid partition tags or enter the new
+Enter <CR> if the partition tag is ok for this partition, otherwise
+enter '?' to get a list of valid partition tags or enter the new
partition tag.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Enter partition permission Flags [wm]:
.br
-Enter <CR> if the partition flag is ok for this partition, otherwise
-enter '?' to get a list of valid partition flags or enter the new
+Enter <CR> if the partition flag is ok for this partition, otherwise
+enter '?' to get a list of valid partition flags or enter the new
partition flag.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Enter starting cylinder 0 (0 - 3851)/<cr>:
@@ -1033,7 +1033,7 @@
enter '?' to get a list of possible input.
XXX
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Enter number of blocks 67580, 31/0/0 (0 - 8395180)/<cr>:
@@ -1042,7 +1042,7 @@
enter '?' to get a list of possible input.
XXX
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Part Tag Flag Cylinders Startsec # of Sec Size Blocks
@@ -1055,17 +1055,17 @@
You then will be asked again for all parameters of this partition.
Enter 'y' if this partition is now ok.
.sp
-If all partitions are cycled through,
+If all partitions are cycled through,
.B sformat
will display the current label.
.br
-.B Sformat
+.B Sformat
asks:
.br
.I "Use this label?
.br
-If you enter 'y',
-.B sformat
+If you enter 'y',
+.B sformat
will update the label on disk and go into the verify mode.
Anything else will put you into the label modification mode again.
.TP
@@ -1073,7 +1073,7 @@
In disk verification mode,
.B sformat
will do a surface analysis.
-If a bad block is encountered,
+If a bad block is encountered,
.B sformat
will reassign this bad block.
XXX
@@ -1083,7 +1083,7 @@
The number of defects that SCSI disks can handle depends on the defect
mapping system they use. There are several possible systems:
.PP
-The mapping system depends on the # of tracks per zone in the
+The mapping system depends on the # of tracks per zone in the
SCSI disk parameters.
Mapping area in this table means spare location.
.PP
@@ -1104,20 +1104,20 @@
there still may be an additional mapping area at the end of the disk.
This is controlled by the alternate tracks per volume parameter.
.PP
-If your disk says
+If your disk says
.I "no defect spare location,
you may be able to
get extra space by going into the disk parameter menu of sformat
-and change a value. Note: some disks tell you that some of the
+and change a value. Note: some disks tell you that some of the
values are changeable (there is a range in parenthesis) but
actually ignore the new value. You will have to read the values
after formatting to see if the new parameters are in effect.
.SH "How To Modify A Label
-Remember, don't panic. You need no desc calculator to create or modify
+Remember, don't panic. You need no desk calculator to create or modify
a partition table.
.PP
-The alternate cylinders are historic relics. In good old days (1982) when
+The alternate cylinders are historic relics. In good old days (1982) when
SMD disks that were not able to do defect mapping have been used,
these alternates were added to do the defect mapping in the driver.
In these days the space occupied by these spare cylinders really has been
@@ -1127,17 +1127,17 @@
an outdated copy of the defect list is only able to hold 127 defects :-(.
.PP
-The label geometry cannot be changed in the partition menu. It must be set
-before from the
+The label geometry cannot be changed in the partition menu. It must be set
+before from the
.B "Label Parameters
menu.
.TP 30
Print disk label?
-If this question is answered with 'y', the label and partitioning info
+If this question is answered with 'y', the label and partitioning info
will be displayed.
.TP
Modify disk label?
-If this question is answered with 'y', the label modification menu will
+If this question is answered with 'y', the label modification menu will
be entered.
.TP
Label: <Toshiba 1015MB> change ?
@@ -1153,7 +1153,7 @@
.SH "Graphical Label Display
.PP
-When printing the label or partition data,
+When printing the label or partition data,
.B sformat
uses a simple ASCII graphical display to visualize the layout of the partitions.
The symbols used in this graphic display are described below.
@@ -1162,7 +1162,7 @@
.PP
.nf
.na
-.cs R 4*\w'x'/\n(.s
+.ft C
a I--/
b /-----------/
c I----------------------------------------------------------------------I
@@ -1174,7 +1174,7 @@
WARNING:
part 'e' has unaligned start.
part 'g' has unaligned start.
-.cs R
+.ft
.ad
.fi
.fi
@@ -1188,7 +1188,7 @@
Partition starts before zero or exceeds end of disk.
.TP
/
-Partition has an adjacent start or end with another
+Partition has an adjacent start or end with another
partition (no error).
.TP
+