aboutsummaryrefslogtreecommitdiff
path: root/man/man1/dd.1
blob: 63b35e145bd180390c6a09206e47a6a17d1cf976 (plain)
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
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
.TH DD 1
.SH NAME
dd \- convert and copy a file
.SH SYNOPSIS
.B dd
[
.I option value
]
\&...
.SH DESCRIPTION
.I Dd\^
copies the specified input file
to the specified output with
possible conversions.
The standard input and output are used by default.
The input and output block size may be
specified to take advantage of raw physical I/O.
The options are
.TF "quiet\ \ \fIn
.PD
.TP
.BI -if\  f
Open file
.I f
for input.
.TP
.BI -of\  f
Open file
.I f
for output.
.TP
.BI -ibs\  n\^
Set input block size to
.I n\^
bytes (default 512).
.TP
.BI -obs\  n\^
Set output block size (default 512).
.TP
.BI -bs\  n\^
Set both input and output block size,
superseding
.I ibs\^
and
.IR obs .
If no conversion is specified,
preserve the input block size instead of packing short blocks
into the output buffer.
This is particularly efficient since no in-core copy need be done.
.TP
.BI -cbs\  n\^
Set conversion buffer size.
.TP
.BI -skip\  n\^
Skip
.I n
input records before copying.
.TP
.BI -iseek\  n\^
Seek
.I n
records forward on input file
before copying.
.TP
.BI -files\  n\^
Catenate
.I n 
input files (useful only for magnetic tape or similar input device).
.TP
.BI -oseek\  n\^
Seek
.I n\^
records from beginning of output file before copying.
.TP
.BI -count\  n\^
Copy only
.I n
input records.
.TP
.BI -trunc\  n\^
By default,
.I dd
truncates the output file when it opens it;
.B -trunc
.B 0
opens it without truncation.
.TP
.BI -quiet\  n\^
By default,
.I dd
prints the number of blocks read and written
once it is finished.
.B -quiet
.B 1
silences this summary.
.HP
\fL-conv\ ascii\ \ \ \ \fRConvert
.SM EBCDIC
to
.SM ASCII.
.PD0
.RS "\w'\fLconv\ \fP'u"
.TP "\w'\fLunblock\ \ \fP'u"
.B ebcdic
Convert
.SM ASCII
to
.SM EBCDIC.
.TP
.B ibm
Like
.B ebcdic
but with a slightly different character map.
.TP
.B block
Convert variable length
.SM ASCII
records to fixed length.
.TP
.B unblock
Convert fixed length
.SM ASCII
records to variable length.
.TP
.B lcase
Map alphabetics to lower case.
.TP
.B ucase
Map alphabetics to upper case.
.TP
.B swab
Swap every pair of bytes.
.TP
.B noerror
Do not stop processing on an error.
.TP
.B sync
Pad every input record to
.I  ibs\^
bytes.
.RE
.PD
.PP
.fi
Where sizes are specified,
a number of bytes is expected.
A number may end with
.L k
or
.LR b
to specify multiplication by
1024 or 512 respectively;
a pair of numbers may be separated by
.L x
to indicate a product.
Multiple conversions may be specified in the style:
.LR "-conv ebcdic,ucase" .
.PP
.L Cbs\^
is used only if
.LR ascii\^ ,
.LR unblock\^ ,
.LR ebcdic\^ ,
.LR ibm\^ ,
or
.L block\^
conversion is specified.
In the first two cases,
.I n
characters are copied into the conversion buffer, any specified
character mapping is done,
trailing blanks are trimmed and new-line is added
before sending the line to the output.
In the latter three cases, characters are read into the
conversion buffer and blanks are added to make up an
output record of size
.IR n .
If
.L cbs\^
is unspecified or zero, the
.LR ascii\^ ,
.LR ebcdic\^ ,
and
.L ibm\^
options convert the character set without changing the block
structure of the input file; the
.L unblock\^
and
.L block\^
options become a simple file copy.
.SH SOURCE
.B \*9/src/cmd/dd.c
.SH "SEE ALSO"
.IR cp (1)
.SH DIAGNOSTICS
.I Dd
reports the number of full + partial input and output
blocks handled.