[go: up one dir, main page]

File: fdasd.8

package info (click to toggle)
s390-tools 1.6.2-1
  • links: PTS
  • area: main
  • in suites: lenny
  • size: 2,160 kB
  • ctags: 3,968
  • sloc: ansic: 26,413; asm: 5,072; sh: 4,042; cpp: 1,518; perl: 1,299; makefile: 587
file content (145 lines) | stat: -rw-r--r-- 3,777 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
.TH FDASD 8 "Apr 2006" "s390-tools"
.SH NAME
fdasd \- partitioning tool.
.SH SYNOPSIS
interactive mode:
.br
     \fBfdasd\fR [-s] [-r] \fIdevice\fR
.br
command line mode:
.br
     \fBfdasd\fR [-s] [-r] {-a[-k|-l \fIvolser\fR]|-i|-p|-c \fIconf_file\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 when writing the volume label. 
.br
This is useful, if the volume serial has been written before and 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
This option enables you to create several partitions in non-interactive mode, 
controlled by the plain text configuration file \fIconf_file\fR.
.br

\fIconf_file\fR contains one line for each partition, using the following
 format:
.sp
[\fIx\fR,\fIy\fR]
.br

where \fIx\fR is the the first track and \fIy\fR is the last track of 
that partition.
Keyword \fIfirst\fR can be used to specify the first possible track 
and \fIlast\fR for the last possible track on disk.
.br

The following is an example of a config file to create three partitions 
using the entire disk:
.sp
[first,1000]
.br
[1001,2000]
.br
[2001,last]
.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
\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)