Debian Codegraph @

upstream/debian-unstable/man1/dd.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH DD "1" "February 2026" "GNU coreutils 9.10" "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 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddbs'\fBbs=BYTES\fP\X'tty: link'
17 read and write up to BYTES bytes at a time (default: 512);
18 overrides ibs and obs
19 .TP
20 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddcbs'\fBcbs=BYTES\fP\X'tty: link'
21 convert BYTES bytes at a time
22 .TP
23 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddconv'\fBconv=CONVS\fP\X'tty: link'
24 convert the file as per the comma separated symbol list
25 .TP
26 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddcount'\fBcount=N\fP\X'tty: link'
27 copy only N input blocks
28 .TP
29 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddibs'\fBibs=BYTES\fP\X'tty: link'
30 read up to BYTES bytes at a time (default: 512)
31 .TP
32 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddif'\fBif=FILE\fP\X'tty: link'
33 read from FILE instead of standard input
34 .TP
35 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddiflag'\fBiflag=FLAGS\fP\X'tty: link'
36 read as per the comma separated symbol list
37 .TP
38 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddobs'\fBobs=BYTES\fP\X'tty: link'
39 write BYTES bytes at a time (default: 512)
40 .TP
41 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddof'\fBof=FILE\fP\X'tty: link'
42 write to FILE instead of standard output
43 .TP
44 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddoflag'\fBoflag=FLAGS\fP\X'tty: link'
45 write as per the comma separated symbol list
46 .TP
47 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddseek'\fBseek=N\fP\X'tty: link'
48 (or oseek=N) skip N obs sized output blocks
49 .TP
50 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddskip'\fBskip=N\fP\X'tty: link'
51 (or iseek=N) skip N ibs sized input blocks
52 .TP
53 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#ddstatus'\fBstatus=LEVEL\fP\X'tty: link'
54 The LEVEL of information to print to standard error;
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 \X'tty: link https://www.gnu.org/software/coreutils/dd#dd--help'\fB\-\-help\fP\X'tty: link'
157 display this help and exit
158 .TP
159 \X'tty: link https://www.gnu.org/software/coreutils/dd#dd--version'\fB\-\-version\fP\X'tty: link'
160 output version information and exit
161 .SH AUTHOR
162 Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
163 .SH "REPORTING BUGS"
164 Report bugs to: bug\[email protected]
165 .br
166 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
167 .br
168 General help using GNU software: <https://www.gnu.org/gethelp/>
169 .br
170 Report any translation bugs to <https://translationproject.org/team/>
171 .SH "SEE ALSO"
172 Full documentation <https://www.gnu.org/software/coreutils/dd>
173 .br
174 or available locally via: info \(aq(coreutils) dd invocation\(aq
175 .PP
176 .br
177 Packaged by Debian (9.10\-1)
178 .br
179 Copyright \(co 2026 Free Software Foundation, Inc.
180 .br
181 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
182 .br
183 This is free software: you are free to change and redistribute it.
184 .br
185 There is NO WARRANTY, to the extent permitted by law.