3 11a3ce57 2011-08-16 rsc dd \- convert and copy a file
7 11a3ce57 2011-08-16 rsc .I option value
10 11a3ce57 2011-08-16 rsc .SH DESCRIPTION
12 11a3ce57 2011-08-16 rsc copies the specified input file
13 11a3ce57 2011-08-16 rsc to the specified output with
14 11a3ce57 2011-08-16 rsc possible conversions.
15 11a3ce57 2011-08-16 rsc The standard input and output are used by default.
16 11a3ce57 2011-08-16 rsc The input and output block size may be
17 11a3ce57 2011-08-16 rsc specified to take advantage of raw physical I/O.
18 11a3ce57 2011-08-16 rsc The options are
19 11a3ce57 2011-08-16 rsc .TF "quiet\ \ \fIn
32 11a3ce57 2011-08-16 rsc .BI -ibs\ n\^
33 11a3ce57 2011-08-16 rsc Set input block size to
35 11a3ce57 2011-08-16 rsc bytes (default 512).
37 11a3ce57 2011-08-16 rsc .BI -obs\ n\^
38 11a3ce57 2011-08-16 rsc Set output block size (default 512).
41 11a3ce57 2011-08-16 rsc Set both input and output block size,
46 11a3ce57 2011-08-16 rsc If no conversion is specified,
47 11a3ce57 2011-08-16 rsc preserve the input block size instead of packing short blocks
48 11a3ce57 2011-08-16 rsc into the output buffer.
49 11a3ce57 2011-08-16 rsc This is particularly efficient since no in-core copy need be done.
51 11a3ce57 2011-08-16 rsc .BI -cbs\ n\^
52 11a3ce57 2011-08-16 rsc Set conversion buffer size.
54 11a3ce57 2011-08-16 rsc .BI -skip\ n\^
57 11a3ce57 2011-08-16 rsc input records before copying.
59 11a3ce57 2011-08-16 rsc .BI -iseek\ n\^
62 11a3ce57 2011-08-16 rsc records forward on input file
63 11a3ce57 2011-08-16 rsc before copying.
65 11a3ce57 2011-08-16 rsc .BI -files\ n\^
68 11a3ce57 2011-08-16 rsc input files (useful only for magnetic tape or similar input device).
70 11a3ce57 2011-08-16 rsc .BI -oseek\ n\^
73 11a3ce57 2011-08-16 rsc records from beginning of output file before copying.
75 11a3ce57 2011-08-16 rsc .BI -count\ n\^
78 11a3ce57 2011-08-16 rsc input records.
80 11a3ce57 2011-08-16 rsc .BI -trunc\ n\^
83 11a3ce57 2011-08-16 rsc truncates the output file when it opens it;
86 11a3ce57 2011-08-16 rsc opens it without truncation.
88 11a3ce57 2011-08-16 rsc .BI -quiet\ n\^
91 11a3ce57 2011-08-16 rsc prints the number of blocks read and written
92 11a3ce57 2011-08-16 rsc once it is finished.
95 11a3ce57 2011-08-16 rsc silences this summary.
97 11a3ce57 2011-08-16 rsc \fL-conv\ ascii\ \ \ \ \fRConvert
102 11a3ce57 2011-08-16 rsc .RS "\w'\fLconv\ \fP'u"
103 11a3ce57 2011-08-16 rsc .TP "\w'\fLunblock\ \ \fP'u"
113 11a3ce57 2011-08-16 rsc but with a slightly different character map.
116 11a3ce57 2011-08-16 rsc Convert variable length
118 11a3ce57 2011-08-16 rsc records to fixed length.
121 11a3ce57 2011-08-16 rsc Convert fixed length
123 11a3ce57 2011-08-16 rsc records to variable length.
126 11a3ce57 2011-08-16 rsc Map alphabetics to lower case.
129 11a3ce57 2011-08-16 rsc Map alphabetics to upper case.
132 11a3ce57 2011-08-16 rsc Swap every pair of bytes.
135 11a3ce57 2011-08-16 rsc Do not stop processing on an error.
138 11a3ce57 2011-08-16 rsc Pad every input record to
145 11a3ce57 2011-08-16 rsc Where sizes are specified,
146 11a3ce57 2011-08-16 rsc a number of bytes is expected.
147 11a3ce57 2011-08-16 rsc A number may end with
151 11a3ce57 2011-08-16 rsc to specify multiplication by
152 11a3ce57 2011-08-16 rsc 1024 or 512 respectively;
153 11a3ce57 2011-08-16 rsc a pair of numbers may be separated by
155 11a3ce57 2011-08-16 rsc to indicate a product.
156 11a3ce57 2011-08-16 rsc Multiple conversions may be specified in the style:
157 11a3ce57 2011-08-16 rsc .LR "-conv ebcdic,ucase" .
160 11a3ce57 2011-08-16 rsc is used only if
161 11a3ce57 2011-08-16 rsc .LR ascii\^ ,
162 11a3ce57 2011-08-16 rsc .LR unblock\^ ,
163 11a3ce57 2011-08-16 rsc .LR ebcdic\^ ,
167 11a3ce57 2011-08-16 rsc conversion is specified.
168 11a3ce57 2011-08-16 rsc In the first two cases,
170 11a3ce57 2011-08-16 rsc characters are copied into the conversion buffer, any specified
171 11a3ce57 2011-08-16 rsc character mapping is done,
172 11a3ce57 2011-08-16 rsc trailing blanks are trimmed and new-line is added
173 11a3ce57 2011-08-16 rsc before sending the line to the output.
174 11a3ce57 2011-08-16 rsc In the latter three cases, characters are read into the
175 11a3ce57 2011-08-16 rsc conversion buffer and blanks are added to make up an
176 11a3ce57 2011-08-16 rsc output record of size
180 11a3ce57 2011-08-16 rsc is unspecified or zero, the
181 11a3ce57 2011-08-16 rsc .LR ascii\^ ,
182 11a3ce57 2011-08-16 rsc .LR ebcdic\^ ,
185 11a3ce57 2011-08-16 rsc options convert the character set without changing the block
186 11a3ce57 2011-08-16 rsc structure of the input file; the
187 11a3ce57 2011-08-16 rsc .L unblock\^
190 11a3ce57 2011-08-16 rsc options become a simple file copy.
192 11a3ce57 2011-08-16 rsc .B \*9/src/cmd/dd.c
193 11a3ce57 2011-08-16 rsc .SH "SEE ALSO"
195 11a3ce57 2011-08-16 rsc .SH DIAGNOSTICS
197 11a3ce57 2011-08-16 rsc reports the number of full + partial input and output
198 11a3ce57 2011-08-16 rsc blocks handled.