1DCFLDD(1) User Commands DCFLDD(1)
2
6 dcfldd - manual page for dcfldd (dcfldd) 1.3.4
7
9 dcfldd [OPTION]...
10
12 Copy a file, converting and formatting according to the options.
13 bs=BYTES
15 force ibs=BYTES and obs=BYTES
16 cbs=BYTES
18 convert BYTES bytes at a time
19 conv=KEYWORDS
21 convert the file as per the comma separated keyword list
22 count=BLOCKS
24 copy only BLOCKS input blocks
25 ibs=BYTES
27 read BYTES bytes at a time
28 if=FILE
30 read from FILE instead of stdin
31 obs=BYTES
33 write BYTES bytes at a time
34 of=FILE
36 write to FILE instead of stdout
37 NOTE: of=FILE may be used several times to write
39 output to multiple files simultaneously
41 of:=COMMAND
43 exec and write output to process COMMAND
44 seek=BLOCKS
46 skip BLOCKS obs-sized blocks at start of output
47 skip=BLOCKS
49 skip BLOCKS ibs-sized blocks at start of input
50 pattern=HEX
52 use the specified binary pattern as input
53 textpattern=TEXT
55 use repeating TEXT as input
56 errlog=FILE
58 send error messages to FILE as well as stderr
59 hashwindow=BYTES
61 perform a hash on every BYTES amount of data
62 hash=NAME
64 either md5, sha1, sha256, sha384 or sha512
65 default algorithm is md5. To select multiple algorithms to run
67 simultaneously enter the names in a comma separated list
68 hashlog=FILE
70 send MD5 hash output to FILE instead of stderr
71 if you are using multiple hash algorithms you can send each to a
73 seperate file using the convention ALGORITHMlog=FILE, for exam‐
74 ple md5log=FILE1, sha1log=FILE2, etc.
75 hashlog:=COMMAND
77 exec and write hashlog to process COMMAND
78 ALGORITHMlog:=COMMAND also works in the same fashion
80 hashconv=[before|after]
82 perform the hashing before or after the conversions
83 hashformat=FORMAT
85 display each hashwindow according to FORMAT
86 the hash format mini-language is described below
88 totalhashformat=FORMAT
90 display the total hash value according to FORMAT
91 status=[on|off]
93 display a continual status message on stderr
94 default state is "on"
96 statusinterval=N
98 update the status message every N blocks
99 default value is 256
101 sizeprobe=[if|of]
103 determine the size of the input or output file
104 for use with status messages. (this option gives you a percent‐
106 age indicator) WARNING: do not use this option against a
107 tape device.
109 split=BYTES
111 write every BYTES amount of data to a new file
112 This operation applies to any of=FILE that follows
114 splitformat=TEXT
116 the file extension format for split operation.
117 you may use any number of 'a' or 'n' in any combo the default
119 format is "nnn" NOTE: The split and splitformat options take
120 effect
121 only for output files specified AFTER these options appear in
123 the command line. Likewise, you may specify these several times
124 for for different output files within the same command line. you
125 may use as many digits in any combination you would like. (e.g.
126 "anaannnaana" would be valid, but quite insane)
127 vf=FILE
129 verify that FILE matches the specified input
130 verifylog=FILE
132 send verify results to FILE instead of stderr
133 verifylog:=COMMAND
135 exec and write verify results to process COMMAND
136 --help display this help and exit
138 --version
140 output version information and exit
141 The structure of of FORMAT may contain any valid text and special vari‐
143 ables. The built-in variables are used the following format: #vari‐
144 able_name# To pass FORMAT strings to the program from a command line,
145 it may be necessary to surround your FORMAT strings with "quotes." The
146 built-in variables are listed below:
147 window_start
149 The beginning byte offset of the hashwindow
150 window_end
152 The ending byte offset of the hashwindow
153 block_start
155 The beginning block (by input blocksize) of the window
156 block_end
158 The ending block (by input blocksize) of the hash window
159 hash The hash value
161 algorithm
163 The name of the hash algorithm
164 For example, the default FORMAT for hashformat and totalhashformat are:
166 hashformat="#window_start# - #window_end#: #hash#" totalhashfor‐
167 mat="Total (#algorithm#): #hash#"
168 The FORMAT structure accepts the following escape codes:
170 \n Newline
171 \t Tab
173 \r Carriage return
175 \\ Insert the '\' character
177 ## Insert the '#' character as text, not a variable
179 BLOCKS and BYTES may be followed by the following multiplicative suf‐
181 fixes: xM M, c 1, w 2, b 512, kD 1000, k 1024, MD 1,000,000, M
182 1,048,576, GD 1,000,000,000, G 1,073,741,824, and so on for T, P, E, Z,
183 Y. Each KEYWORD may be:
184 ascii from EBCDIC to ASCII
186 ebcdic from ASCII to EBCDIC
188 ibm from ASCII to alternated EBCDIC
190 block pad newline-terminated records with spaces to cbs-size
192 unblock
194 replace trailing spaces in cbs-size records with newline
195 lcase change upper case to lower case
197 notrunc
199 do not truncate the output file
200 ucase change lower case to upper case
202 swab swap every pair of input bytes
204 noerror
206 continue after read errors
207 sync pad every input block with NULs to ibs-size; when used with
209 block or unblock, pad with spaces rather than NULs
210
212 Written by: dcfldd by Nicholas Harbour, GNU dd by Paul Rubin, David
213 MacKenzie and Stuart Kemp.
214
216 Report bugs to <nicholasharbour@yahoo.com>.
217
219 Copyright © 1985-2006 Free Software Foundation, Inc.
220 This is free software; see the source for copying conditions. There is
221 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
222 PURPOSE.
223
225 The full documentation for dcfldd is maintained as a Texinfo manual.
226 If the info and dcfldd programs are properly installed at your site,
227 the command
228 info dcfldd
230 should give you access to the complete manual.
232dcfldd (dcfldd) 1.3.4 February 2006 DCFLDD(1)