man/dd.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH DD "1" "March 2007" "GNU coreutils 6.9" "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 force ibs=BYTES and obs=BYTES
  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=BLOCKS
  26 copy only BLOCKS input blocks
  27 .TP
  28 ibs=BYTES
  29 read BYTES bytes at a time
  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
  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=BLOCKS
  47 skip BLOCKS obs\-sized blocks at start of output
  48 .TP
  49 skip=BLOCKS
  50 skip BLOCKS ibs\-sized blocks at start of input
  51 .TP
  52 status=noxfer
  53 suppress transfer statistics
  54 .PP
  55 BLOCKS and BYTES may be followed by the following multiplicative suffixes:
  56 xM M, c 1, w 2, b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024,
  57 GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y.
  58 .PP
  59 Each CONV symbol may be:
  60 .TP
  61 ascii
  62 from EBCDIC to ASCII
  63 .TP
  64 ebcdic
  65 from ASCII to EBCDIC
  66 .TP
  67 ibm
  68 from ASCII to alternate EBCDIC
  69 .TP
  70 block
  71 pad newline\-terminated records with spaces to cbs\-size
  72 .TP
  73 unblock
  74 replace trailing spaces in cbs\-size records with newline
  75 .TP
  76 lcase
  77 change upper case to lower case
  78 .TP
  79 nocreat
  80 do not create the output file
  81 .TP
  82 excl
  83 fail if the output file already exists
  84 .TP
  85 notrunc
  86 do not truncate the output file
  87 .TP
  88 ucase
  89 change lower case to upper case
  90 .TP
  91 swab
  92 swap every pair of input bytes
  93 .TP
  94 noerror
  95 continue after read errors
  96 .TP
  97 sync
  98 pad every input block with NULs to ibs\-size; when used
  99 with block or unblock, pad with spaces rather than NULs
 100 .TP
 101 fdatasync
 102 physically write output file data before finishing
 103 .TP
 104 fsync
 105 likewise, but also write metadata
 106 .PP
 107 Each FLAG symbol may be:
 108 .TP
 109 append
 110 append mode (makes sense only for output; conv=notrunc suggested)
 111 .TP
 112 direct
 113 use direct I/O for data
 114 .IP
 115 directory fail unless a directory
 116 dsync     use synchronized I/O for data
 117 sync      likewise, but also for metadata
 118 nonblock  use non\-blocking I/O
 119 noatime   do not update access time
 120 noctty    do not assign controlling terminal from file
 121 nofollow  do not follow symlinks
 122 .PP
 123 Sending a USR1 signal to a running `dd' process makes it
 124 print I/O statistics to standard error and then resume copying.
 125 .IP
 126 \f(CW$ dd if=/dev/zero of=/dev/null& pid=$!\fR
 127 .br
 128 \f(CW$ kill -USR1 $pid; sleep 1; kill $pid\fR
 129 .IP
 130 18335302+0 records in
 131 18335302+0 records out
 132 9387674624 bytes (9.4 GB) copied, 34.6279 seconds, 271 MB/s
 133 .PP
 134 Options are:
 135 .TP
 136 \fB\-\-help\fR
 137 display this help and exit
 138 .TP
 139 \fB\-\-version\fR
 140 output version information and exit
 141 .SH AUTHOR
 142 Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
 143 .SH "REPORTING BUGS"
 144 Report bugs to <bug\-coreutils@gnu.org>.
 145 .SH COPYRIGHT
 146 Copyright \(co 2007 Free Software Foundation, Inc.
 147 .br
 148 This is free software.  You may redistribute copies of it under the terms of
 149 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 150 There is NO WARRANTY, to the extent permitted by law.
 151 .SH "SEE ALSO"
 152 The full documentation for
 153 .B dd
 154 is maintained as a Texinfo manual.  If the
 155 .B info
 156 and
 157 .B dd
 158 programs are properly installed at your site, the command
 159 .IP
 160 .B info dd
 161 .PP
 162 should give you access to the complete manual.