mirror of
https://github.com/ibm-s390-linux/s390-tools.git
synced 2026-08-05 02:14:52 +00:00
3a60b4caa8
Hyphens are converted by groff to a different unicode character leading to failing command execution of copy-pasted options or examples. Ensure that all hyphens are properly escaped. Reviewed-by: Stefan Haberland <sth@linux.ibm.com> Signed-off-by: Jan Höppner <hoeppner@linux.ibm.com> Signed-off-by: Steffen Eiden <seiden@linux.ibm.com>
186 lines
5.0 KiB
Groff
186 lines
5.0 KiB
Groff
.\" Copyright 2017 IBM Corp.
|
|
.\" s390-tools is free software; you can redistribute it and/or modify
|
|
.\" it under the terms of the MIT license. See LICENSE for details.
|
|
.\"
|
|
.TH FDASD 8 "Apr 2006" "s390-tools"
|
|
.SH NAME
|
|
fdasd \- partitioning tool.
|
|
.SH SYNOPSIS
|
|
interactive mode:
|
|
.br
|
|
\fBfdasd\fR [\-s] [\-r] [\-C] \fIdevice\fR
|
|
.br
|
|
command line mode:
|
|
.br
|
|
\fBfdasd\fR [\-s] [\-r] [\-C] {\-a[\-k|\-l \fIvolser\fR]|\-i|\-p|\-c \fIconf_file\fR}
|
|
[-f \fI[type,blocksize]\fR] \fIdevice\fR
|
|
.br
|
|
help:
|
|
.br
|
|
\fBfdasd\fR {\-h|\-v}
|
|
.SH DESCRIPTION
|
|
\fBfdasd\fR writes a partition table to a cdl (compatible disk layout)
|
|
formatted DASD, in the form of
|
|
a VTOC (volume table of contents) for usage with Linux for S/390
|
|
or zSeries. If fdasd detects a valid \fBVOL1\fR volume label, it
|
|
will use it, otherwise it asks to write a new one.
|
|
.br
|
|
|
|
\fBAttention\fR: Careless use of
|
|
\fBfdasd\fR can result in loss of data.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-h\fR or \fB\-\-help\fR
|
|
Print usage information, then exit.
|
|
|
|
.TP
|
|
\fB\-v\fR or \fB\-\-version\fR
|
|
Print version information, then exit.
|
|
|
|
.TP
|
|
\fB\-s\fR or \fB\-\-silent\fR
|
|
Suppress messages in non-interactive mode.
|
|
|
|
.TP
|
|
\fB\-r\fR or \fB\-\-verbose\fR
|
|
Provide more verbose output.
|
|
|
|
.TP
|
|
\fB\-a\fR or \fB\-\-auto\fR
|
|
Automatically create a partition using the entire disk in non-interactive
|
|
mode.
|
|
|
|
.TP
|
|
\fB\-k\fR or \fB\-\-keep_volser\fR
|
|
Keeps the Volume Serial Number when writing the Volume Label.
|
|
.br
|
|
This is useful if the volume already has a Serial Number that should not be
|
|
overwritten. This option is only applicable in non-interactive mode.
|
|
|
|
.TP
|
|
\fB\-l\fR \fIvolser\fR or \fB\-\-label\fR \fIvolser\fR
|
|
Specify the volume serial.
|
|
.br
|
|
\fIvolser\fR is interpreted as ASCII string and is automatically converted to
|
|
uppercase, padded with blanks and finally converted to EBCDIC to be written
|
|
to disk. This option is only applicable in non-interactive mode.
|
|
.br
|
|
|
|
Do not use the following reserved volume serial: SCRTCH, PRIVAT, MIGRAT,
|
|
or Lnnnnn (L with five digit number); These are used as keywords by
|
|
other operating systems (OS/390).
|
|
.br
|
|
|
|
A volume serial is 1 through 6 alphanumeric characters or one of the
|
|
following special characters: $, #, @, %. All other characters are simply
|
|
ignored.
|
|
.br
|
|
Try to avoid using special characters in the volume serial.
|
|
This may cause problems accessing a disk by volser.
|
|
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
|
|
|
|
e.g. \-l 'a@b\\$c#' to get A@B$C#
|
|
.br
|
|
|
|
Omitting this parameter causes fdasd to ask for it in case it is needed.
|
|
.br
|
|
|
|
.TP
|
|
\fB\-c\fR \fIconf_file\fR or \fB\-\-config\fR \fIconf_file\fR
|
|
Use this option to create multiple partitions according to
|
|
specifications in a configuration file, \fIconf_file\fR.
|
|
.br
|
|
The configuration file contains one line for each partition. The lines
|
|
have this format:
|
|
.sp
|
|
[<first>,<last>,<type>]
|
|
.br
|
|
|
|
where:
|
|
|
|
.br
|
|
<first> and <last> are numbers that specify the first and the last
|
|
track of the partition. Instead of a numerical value, you can
|
|
specify 'first' for the first possible track on the disk and 'last'
|
|
for the last possible track on disk.
|
|
.br
|
|
|
|
<type> is optional and specifies the partition type. <type> can be one
|
|
of: native, swap, raid, lvm, or gpfs.
|
|
If omitted, 'native' is used.
|
|
.br
|
|
|
|
The configuration file of the following example specifies three
|
|
partitions that use the entire disk:
|
|
.sp
|
|
[first,1000]
|
|
.br
|
|
[1001,2000,swap]
|
|
.br
|
|
[2001,last,lvm]
|
|
.br
|
|
|
|
.TP
|
|
\fB\-i\fR or \fB\-\-volser\fR
|
|
Print the volume serial, then exit.
|
|
|
|
.TP
|
|
\fB\-p\fR or \fB\-\-table\fR
|
|
Print partition table, then exit.
|
|
.br
|
|
In combination with the \-s option fdasd will display a short version of the
|
|
partition table.
|
|
|
|
.TP
|
|
\fB\-C\fR or \fB\-\-check_host_count\fR
|
|
Force fdasd to check the host access open count to ensure the device
|
|
is not online on another operating system instance
|
|
|
|
.TP
|
|
\fB\-f\fR \fI[type,blocksize]\fR or \fB\-\-force\fR \fI[type,blocksize]\fR
|
|
Force fdasd to work on non DASD devices.
|
|
.br
|
|
If fdasd is to be used on a block device that is neither a native DASD
|
|
nor exposes the proper disk geometry of a DASD of type 3390,
|
|
then the \-\-force option can be used to assume the geometry of a
|
|
given device type. The default device type is 3390 and the default
|
|
block size is 4096. An optional argument of <device type>,<blocksize>
|
|
can be used to specify type and blocksize explicitly. For example:
|
|
|
|
\-f
|
|
|
|
has the same effect as
|
|
|
|
\-f3390,4096 or \-\-force=3390,4096
|
|
|
|
Valid device types are: 3390, 3380, 9345
|
|
.br
|
|
Valid block sizes are: 4096, 2048, 1024, 512
|
|
|
|
You can use the verbose option to get information about the disk
|
|
geometry that fdasd has computed from device type and block size.
|
|
|
|
.TP
|
|
\fIdevice\fR
|
|
This parameter specifies the device to be partitioned:
|
|
.sp
|
|
\fB/dev/dasd/\fR\fIxxxx\fR\fB/device\fR
|
|
.br
|
|
|
|
where \fIxxxx\fR is the four-letter devno (device number).
|
|
.br
|
|
|
|
In case your are not using the device file system, please specify:
|
|
.sp
|
|
\fB/dev/dasd\fR\fIx\fR
|
|
.br
|
|
|
|
where \fIx\fR is one or more lowercase letter(s) or any other device
|
|
node specification configured by udev for kernel 2.6 or higher.
|
|
|
|
.SH SEE ALSO
|
|
.BR dasdfmt (8)
|