original/man1/dd.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH DD "1" "January 2016" "GNU coreutils 8.25" "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
  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=LEVEL
  53 The LEVEL of information to print to stderr;
  54 \&'none' suppresses everything but error messages,
  55 \&'noxfer' suppresses the final transfer statistics,
  56 \&'progress' shows periodic transfer statistics
  57 .PP
  58 N and BYTES may be followed by the following multiplicative suffixes:
  59 c =1, w =2, b =512, kB =1000, K =1024, MB =1000*1000, M =1024*1024, xM =M
  60 GB =1000*1000*1000, G =1024*1024*1024, and so on for T, P, E, Z, Y.
  61 .PP
  62 Each CONV symbol may be:
  63 .TP
  64 ascii
  65 from EBCDIC to ASCII
  66 .TP
  67 ebcdic
  68 from ASCII to EBCDIC
  69 .TP
  70 ibm
  71 from ASCII to alternate EBCDIC
  72 .TP
  73 block
  74 pad newline\-terminated records with spaces to cbs\-size
  75 .TP
  76 unblock
  77 replace trailing spaces in cbs\-size records with newline
  78 .TP
  79 lcase
  80 change upper case to lower case
  81 .TP
  82 ucase
  83 change lower case to upper case
  84 .TP
  85 sparse
  86 try to seek rather than write the output for NUL input blocks
  87 .TP
  88 swab
  89 swap every pair of input bytes
  90 .TP
  91 sync
  92 pad every input block with NULs to ibs\-size; when used
  93 with block or unblock, pad with spaces rather than NULs
  94 .TP
  95 excl
  96 fail if the output file already exists
  97 .TP
  98 nocreat
  99 do not create the output file
 100 .TP
 101 notrunc
 102 do not truncate the output file
 103 .TP
 104 noerror
 105 continue after read errors
 106 .TP
 107 fdatasync
 108 physically write output file data before finishing
 109 .TP
 110 fsync
 111 likewise, but also write metadata
 112 .PP
 113 Each FLAG symbol may be:
 114 .TP
 115 append
 116 append mode (makes sense only for output; conv=notrunc suggested)
 117 .TP
 118 direct
 119 use direct I/O for data
 120 .TP
 121 directory
 122 fail unless a directory
 123 .TP
 124 dsync
 125 use synchronized I/O for data
 126 .TP
 127 sync
 128 likewise, but also for metadata
 129 .TP
 130 fullblock
 131 accumulate full blocks of input (iflag only)
 132 .TP
 133 nonblock
 134 use non\-blocking I/O
 135 .TP
 136 noatime
 137 do not update access time
 138 .TP
 139 nocache
 140 Request to drop cache.  See also oflag=sync
 141 .TP
 142 noctty
 143 do not assign controlling terminal from file
 144 .TP
 145 nofollow
 146 do not follow symlinks
 147 .TP
 148 count_bytes
 149 treat 'count=N' as a byte count (iflag only)
 150 .TP
 151 skip_bytes
 152 treat 'skip=N' as a byte count (iflag only)
 153 .TP
 154 seek_bytes
 155 treat 'seek=N' as a byte count (oflag only)
 156 .PP
 157 Sending a USR1 signal to a running 'dd' process makes it
 158 print I/O statistics to standard error and then resume copying.
 159 .PP
 160 Options are:
 161 .TP
 162 \fB\-\-help\fR
 163 display this help and exit
 164 .TP
 165 \fB\-\-version\fR
 166 output version information and exit
 167 .SH AUTHOR
 168 Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
 169 .SH "REPORTING BUGS"
 170 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
 171 .br
 172 Report dd translation bugs to <http://translationproject.org/team/>
 173 .SH COPYRIGHT
 174 Copyright \(co 2016 Free Software Foundation, Inc.
 175 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 176 .br
 177 This is free software: you are free to change and redistribute it.
 178 There is NO WARRANTY, to the extent permitted by law.
 179 .SH "SEE ALSO"
 180 Full documentation at: <http://www.gnu.org/software/coreutils/dd>
 181 .br
 182 or available locally via: info \(aq(coreutils) dd invocation\(aq