manual/GNU_coreutils/original/man1/dd.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
   2 .TH DD "1" "May 2014" "GNU coreutils 8.22" "User Commands"
   3 .SH NAME
   4 dd \- convert and copy a file
   5 .SH SYNOPSIS
   6 .B dd
   7 [\fIOPERAND\fR]...
   8 .br
   9 .B dd
  10 \fIOPTION\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
  18 .TP
  19 cbs=BYTES
  20 convert BYTES bytes at a time
  21 .TP
  22 conv=CONVS
  23 convert the file as per the comma separated symbol list
  24 .TP
  25 count=N
  26 copy only N input blocks
  27 .TP
  28 ibs=BYTES
  29 read up to BYTES bytes at a time (default: 512)
  30 .TP
  31 if=FILE
  32 read from FILE instead of stdin
  33 .TP
  34 iflag=FLAGS
  35 read as per the comma separated symbol list
  36 .TP
  37 obs=BYTES
  38 write BYTES bytes at a time (default: 512)
  39 .TP
  40 of=FILE
  41 write to FILE instead of stdout
  42 .TP
  43 oflag=FLAGS
  44 write as per the comma separated symbol list
  45 .TP
  46 seek=N
  47 skip N obs\-sized blocks at start of output
  48 .TP
  49 skip=N
  50 skip N ibs\-sized blocks at start of input
  51 .TP
  52 status=WHICH
  53 WHICH info to suppress outputting to stderr;
  54 \&'noxfer' suppresses transfer stats, 'none' suppresses all
  55 .PP
  56 N and BYTES may be followed by the following multiplicative suffixes:
  57 c =1, w =2, b =512, kB =1000, K =1024, MB =1000*1000, M =1024*1024, xM =M
  58 GB =1000*1000*1000, G =1024*1024*1024, and so on for T, P, E, Z, Y.
  59 .PP
  60 Each CONV symbol may be:
  61 .TP
  62 ascii
  63 from EBCDIC to ASCII
  64 .TP
  65 ebcdic
  66 from ASCII to EBCDIC
  67 .TP
  68 ibm
  69 from ASCII to alternate EBCDIC
  70 .TP
  71 block
  72 pad newline\-terminated records with spaces to cbs\-size
  73 .TP
  74 unblock
  75 replace trailing spaces in cbs\-size records with newline
  76 .TP
  77 lcase
  78 change upper case to lower case
  79 .TP
  80 ucase
  81 change lower case to upper case
  82 .TP
  83 sparse
  84 try to seek rather than write the output for NUL input blocks
  85 .TP
  86 swab
  87 swap every pair of input bytes
  88 .TP
  89 sync
  90 pad every input block with NULs to ibs\-size; when used
  91 with block or unblock, pad with spaces rather than NULs
  92 .TP
  93 excl
  94 fail if the output file already exists
  95 .TP
  96 nocreat
  97 do not create the output file
  98 .TP
  99 notrunc
 100 do not truncate the output file
 101 .TP
 102 noerror
 103 continue after read errors
 104 .TP
 105 fdatasync
 106 physically write output file data before finishing
 107 .TP
 108 fsync
 109 likewise, but also write metadata
 110 .PP
 111 Each FLAG symbol may be:
 112 .TP
 113 append
 114 append mode (makes sense only for output; conv=notrunc suggested)
 115 .TP
 116 direct
 117 use direct I/O for data
 118 .TP
 119 directory
 120 fail unless a directory
 121 .TP
 122 dsync
 123 use synchronized I/O for data
 124 .TP
 125 sync
 126 likewise, but also for metadata
 127 .TP
 128 fullblock
 129 accumulate full blocks of input (iflag only)
 130 .TP
 131 nonblock
 132 use non\-blocking I/O
 133 .TP
 134 noatime
 135 do not update access time
 136 .TP
 137 nocache
 138 discard cached data
 139 .TP
 140 noctty
 141 do not assign controlling terminal from file
 142 .TP
 143 nofollow
 144 do not follow symlinks
 145 .TP
 146 count_bytes
 147 treat 'count=N' as a byte count (iflag only)
 148 .TP
 149 skip_bytes
 150 treat 'skip=N' as a byte count (iflag only)
 151 .TP
 152 seek_bytes
 153 treat 'seek=N' as a byte count (oflag only)
 154 .PP
 155 Sending a USR1 signal to a running 'dd' process makes it
 156 print I/O statistics to standard error and then resume copying.
 157 .IP
 158 \f(CW$ dd if=/dev/zero of=/dev/null& pid=$!\fR
 159 .br
 160 \f(CW$ kill -USR1 $pid; sleep 1; kill $pid\fR
 161 .IP
 162 18335302+0 records in
 163 18335302+0 records out
 164 9387674624 bytes (9.4 GB) copied, 34.6279 seconds, 271 MB/s
 165 .PP
 166 Options are:
 167 .TP
 168 \fB\-\-help\fR
 169 display this help and exit
 170 .TP
 171 \fB\-\-version\fR
 172 output version information and exit
 173 .PP
 174 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
 175 Report dd translation bugs to <http://translationproject.org/team/>
 176 .SH AUTHOR
 177 Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
 178 .SH COPYRIGHT
 179 Copyright \(co 2013 Free Software Foundation, Inc.
 180 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 181 .br
 182 This is free software: you are free to change and redistribute it.
 183 There is NO WARRANTY, to the extent permitted by law.
 184 .SH "SEE ALSO"
 185 The full documentation for
 186 .B dd
 187 is maintained as a Texinfo manual.  If the
 188 .B info
 189 and
 190 .B dd
 191 programs are properly installed at your site, the command
 192 .IP
 193 .B info coreutils \(aqdd invocation\(aq
 194 .PP
 195 should give you access to the complete manual.