diff --git a/dasdfmt/dasdfmt.8 b/dasdfmt/dasdfmt.8 index bef5c097..82a5fd9e 100644 --- a/dasdfmt/dasdfmt.8 +++ b/dasdfmt/dasdfmt.8 @@ -15,13 +15,13 @@ dasdfmt \- formatting of DASD (ECKD) disk drives. .SH DESCRIPTION \fBdasdfmt\fR formats a DASD (ECKD) disk drive to prepare it -for usage with Linux for S/390. +for usage with Linux for S/390. The \fIdevice\fR is the node of the device (e.g. '/dev/dasda'). -Any device node created by udev for kernel 2.6 can be used +Any device node created by udev for kernel 2.6 can be used (e.g. '/dev/dasd/0.0.b100/disc'). .br -\fBWARNING\fR: Careless usage of \fBdasdfmt\fR can result in +\fBWARNING\fR: Careless usage of \fBdasdfmt\fR can result in \fBLOSS OF DATA\fR. .SH OPTIONS @@ -31,7 +31,7 @@ Print usage and exit. .TP \fB-t\fR or \fB--test\fR -Disables any modification of the disk drive. +Disables any modification of the disk drive. .br \fBdasdfmt\fR just prints out, what it \fBwould\fR do. @@ -41,7 +41,7 @@ out, what it \fBwould\fR do. Increases verbosity. .TP -\fB-y\fR +\fB-y\fR Start formatting without further user-confirmation. .TP @@ -59,7 +59,7 @@ Omit the writing of a disk label after formatting. .br This makes only sense for the 'ldl' disk layout. .br -The '-L' option has to be specified after the '-d ldl' option. +The '-L' option has to be specified after the '-d ldl' option. .br e.g. dasdfmt -d ldl -L /dev/... @@ -84,13 +84,13 @@ Formats the device with compatible disk layout or linux disk layout. \fIlayout\fR is either \fIcdl\fR for the compatible disk layout (default) or \fIldl\fR for the linux disk layout. .br -Compatible disk layout means a special handling of the -first two tracks of the volume. This enables other S/390 or zSeries +Compatible disk layout means a special handling of the +first two tracks of the volume. This enables other S/390 or zSeries operating systems to access this device (e.g. for backup purposes). .TP \fB-p\fR or \fB--progressbar\fR -Print a progress bar while formatting. +Print a progress bar while formatting. Do not use this option if you are using a 3270 console, running in background or redirecting the output to a file. @@ -164,30 +164,30 @@ and always be a power of two. The recommended blocksize is 4096 bytes. .TP \fB-l\fR \fIvolser\fR or \fB--label\fR=\fIvolser\fR -Specify the volume serial number or volume identifier to be written -to disk after formatting. If no label is specified, a sensible default -is used. \fIvolser\fR is interpreted as ASCII string and is automatically +Specify the volume serial number or volume identifier to be written +to disk after formatting. If no label is specified, a sensible default +is used. \fIvolser\fR is interpreted as ASCII string and is automatically converted to uppercase and then to EBCDIC. .br e.g. -l LNX001 or --label=DASD01 .br -The \fIvolser\fR identifies by serial number the volume. A volume serial +The \fIvolser\fR identifies by serial number the volume. A volume serial number is 1 through 6 alphanumeric or one of the following special -characters: $, #, @, %. Enclose a serial number that contains special -characters in apostrophes. If the number is shorter than six +characters: $, #, @, %. Enclose a serial number that contains special +characters in apostrophes. If the number is shorter than six characters, it is padded with trailing blanks. -.br +.br -Do not code a volume serial number as SCRTCH, PRIVAT, or Lnnnnn (L with -five numbers); these are used in OS/390 messages to ask the operator to -mount a volume. Do not code a volume serial number as MIGRAT, which is -used by the OS/390 Hierarchical Storage Manager DFSMShsm for migrated +Do not code a volume serial number as SCRTCH, PRIVAT, or Lnnnnn (L with +five numbers); these are used in OS/390 messages to ask the operator to +mount a volume. Do not code a volume serial number as MIGRAT, which is +used by the OS/390 Hierarchical Storage Manager DFSMShsm for migrated data sets. .br -NOTE: Try to avoid using special characters in the volume serial. This may cause problems accessing a disk by volser. +NOTE: Try to avoid using special characters in the volume serial. This may cause problems accessing a disk by volser. .br In case you really have to use special characters, make sure you are using quotes. In addition there is a special handling for the '$' sign. Please specify it using '\\$' if necessary. .br