| 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. |