Debian Codegraph @

upstream/debian-trixie/man1/dd.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH DD "1" "June 2025" "GNU coreutils 9.7" "User Commands"
3 .SH NAME
4 dd \- convert and copy a file
5 .SH SYNOPSIS
6 .B dd
7 [\fI\,OPERAND\/\fR]...
8 .br
9 .B dd
10 \fI\,OPTION\/\fR
11 .SH DESCRIPTION
12 .\" Add any additional description here
13 .PP
14 Copy a file, converting and formatting according to the operands.
15 .TP
16 bs=BYTES
17 read and write up to BYTES bytes at a time (default: 512);
18 overrides ibs and obs
19 .TP
20 cbs=BYTES
21 convert BYTES bytes at a time
22 .TP
23 conv=CONVS
24 convert the file as per the comma separated symbol list
25 .TP
26 count=N
27 copy only N input blocks
28 .TP
29 ibs=BYTES
30 read up to BYTES bytes at a time (default: 512)
31 .TP
32 if=FILE
33 read from FILE instead of stdin
34 .TP
35 iflag=FLAGS
36 read as per the comma separated symbol list
37 .TP
38 obs=BYTES
39 write BYTES bytes at a time (default: 512)
40 .TP
41 of=FILE
42 write to FILE instead of stdout
43 .TP
44 oflag=FLAGS
45 write as per the comma separated symbol list
46 .TP
47 seek=N
48 (or oseek=N) skip N obs\-sized output blocks
49 .TP
50 skip=N
51 (or iseek=N) skip N ibs\-sized input blocks
52 .TP
53 status=LEVEL
54 The LEVEL of information to print to stderr;
55 \&'none' suppresses everything but error messages,
56 \&'noxfer' suppresses the final transfer statistics,
57 \&'progress' shows periodic transfer statistics
58 .PP
59 N and BYTES may be followed by the following multiplicative suffixes:
60 c=1, w=2, b=512, kB=1000, K=1024, MB=1000*1000, M=1024*1024, xM=M,
61 GB=1000*1000*1000, G=1024*1024*1024, and so on for T, P, E, Z, Y, R, Q.
62 Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
63 If N ends in 'B', it counts bytes not blocks.
64 .PP
65 Each CONV symbol may be:
66 .TP
67 ascii
68 from EBCDIC to ASCII
69 .TP
70 ebcdic
71 from ASCII to EBCDIC
72 .TP
73 ibm
74 from ASCII to alternate EBCDIC
75 .TP
76 block
77 pad newline\-terminated records with spaces to cbs\-size
78 .TP
79 unblock
80 replace trailing spaces in cbs\-size records with newline
81 .TP
82 lcase
83 change upper case to lower case
84 .TP
85 ucase
86 change lower case to upper case
87 .TP
88 sparse
89 try to seek rather than write all\-NUL output blocks
90 .TP
91 swab
92 swap every pair of input bytes
93 .TP
94 sync
95 pad every input block with NULs to ibs\-size; when used
96 with block or unblock, pad with spaces rather than NULs
97 .TP
98 excl
99 fail if the output file already exists
100 .TP
101 nocreat
102 do not create the output file
103 .TP
104 notrunc
105 do not truncate the output file
106 .TP
107 noerror
108 continue after read errors
109 .TP
110 fdatasync
111 physically write output file data before finishing
112 .TP
113 fsync
114 likewise, but also write metadata
115 .PP
116 Each FLAG symbol may be:
117 .TP
118 append
119 append mode (makes sense only for output; conv=notrunc suggested)
120 .TP
121 direct
122 use direct I/O for data
123 .TP
124 directory
125 fail unless a directory
126 .TP
127 dsync
128 use synchronized I/O for data
129 .TP
130 sync
131 likewise, but also for metadata
132 .TP
133 fullblock
134 accumulate full blocks of input (iflag only)
135 .TP
136 nonblock
137 use non\-blocking I/O
138 .TP
139 noatime
140 do not update access time
141 .TP
142 nocache
143 Request to drop cache. See also oflag=sync
144 .TP
145 noctty
146 do not assign controlling terminal from file
147 .TP
148 nofollow
149 do not follow symlinks
150 .PP
151 Sending a USR1 signal to a running 'dd' process makes it
152 print I/O statistics to standard error and then resume copying.
153 .PP
154 Options are:
155 .TP
156 \fB\-\-help\fR
157 display this help and exit
158 .TP
159 \fB\-\-version\fR
160 output version information and exit
161 .SH AUTHOR
162 Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
163 .SH "REPORTING BUGS"
164 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
165 .br
166 Report any translation bugs to <https://translationproject.org/team/>
167 .SH "SEE ALSO"
168 Full documentation <https://www.gnu.org/software/coreutils/dd>
169 .br
170 or available locally via: info \(aq(coreutils) dd invocation\(aq
171 .PP
172 .br
173 Packaged by Debian (9.7\-3)
174 .br
175 Copyright \(co 2025 Free Software Foundation, Inc.
176 .br
177 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
178 .br
179 This is free software: you are free to change and redistribute it.
180 .br
181 There is NO WARRANTY, to the extent permitted by law.