199 lines
5.5 KiB
HTML
199 lines
5.5 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of DD</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>DD</H1>
|
|
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
dd - convert and copy a file
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>dd</B>
|
|
|
|
[<I>,OPERAND/</I>]...
|
|
<BR>
|
|
|
|
<B>dd</B>
|
|
|
|
<I>,OPTION/</I>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
|
|
<P>
|
|
|
|
Copy a file, converting and formatting according to the operands.
|
|
<DL COMPACT>
|
|
<DT id="1">bs=BYTES<DD>
|
|
read and write up to BYTES bytes at a time (default: 512);
|
|
overrides ibs and obs
|
|
<DT id="2">cbs=BYTES<DD>
|
|
convert BYTES bytes at a time
|
|
<DT id="3">conv=CONVS<DD>
|
|
convert the file as per the comma separated symbol list
|
|
<DT id="4">count=N<DD>
|
|
copy only N input blocks
|
|
<DT id="5">ibs=BYTES<DD>
|
|
read up to BYTES bytes at a time (default: 512)
|
|
<DT id="6">if=FILE<DD>
|
|
read from FILE instead of stdin
|
|
<DT id="7">iflag=FLAGS<DD>
|
|
read as per the comma separated symbol list
|
|
<DT id="8">obs=BYTES<DD>
|
|
write BYTES bytes at a time (default: 512)
|
|
<DT id="9">of=FILE<DD>
|
|
write to FILE instead of stdout
|
|
<DT id="10">oflag=FLAGS<DD>
|
|
write as per the comma separated symbol list
|
|
<DT id="11">seek=N<DD>
|
|
skip N obs-sized blocks at start of output
|
|
<DT id="12">skip=N<DD>
|
|
skip N ibs-sized blocks at start of input
|
|
<DT id="13">status=LEVEL<DD>
|
|
The LEVEL of information to print to stderr;
|
|
'none' suppresses everything but error messages,
|
|
'noxfer' suppresses the final transfer statistics,
|
|
'progress' shows periodic transfer statistics
|
|
</DL>
|
|
<P>
|
|
|
|
N and BYTES may be followed by the following multiplicative suffixes:
|
|
c =1, w =2, b =512, kB =1000, K =1024, MB =1000*1000, M =1024*1024, xM =M,
|
|
GB =1000*1000*1000, G =1024*1024*1024, and so on for T, P, E, Z, Y.
|
|
<P>
|
|
|
|
Each CONV symbol may be:
|
|
<DL COMPACT>
|
|
<DT id="14">ascii<DD>
|
|
from EBCDIC to ASCII
|
|
<DT id="15">ebcdic<DD>
|
|
from ASCII to EBCDIC
|
|
<DT id="16">ibm<DD>
|
|
from ASCII to alternate EBCDIC
|
|
<DT id="17">block<DD>
|
|
pad newline-terminated records with spaces to cbs-size
|
|
<DT id="18">unblock<DD>
|
|
replace trailing spaces in cbs-size records with newline
|
|
<DT id="19">lcase<DD>
|
|
change upper case to lower case
|
|
<DT id="20">ucase<DD>
|
|
change lower case to upper case
|
|
<DT id="21">sparse<DD>
|
|
try to seek rather than write the output for NUL input blocks
|
|
<DT id="22">swab<DD>
|
|
swap every pair of input bytes
|
|
<DT id="23">sync<DD>
|
|
pad every input block with NULs to ibs-size; when used
|
|
with block or unblock, pad with spaces rather than NULs
|
|
<DT id="24">excl<DD>
|
|
fail if the output file already exists
|
|
<DT id="25">nocreat<DD>
|
|
do not create the output file
|
|
<DT id="26">notrunc<DD>
|
|
do not truncate the output file
|
|
<DT id="27">noerror<DD>
|
|
continue after read errors
|
|
<DT id="28">fdatasync<DD>
|
|
physically write output file data before finishing
|
|
<DT id="29">fsync<DD>
|
|
likewise, but also write metadata
|
|
</DL>
|
|
<P>
|
|
|
|
Each FLAG symbol may be:
|
|
<DL COMPACT>
|
|
<DT id="30">append<DD>
|
|
append mode (makes sense only for output; conv=notrunc suggested)
|
|
<DT id="31">direct<DD>
|
|
use direct I/O for data
|
|
<DT id="32">directory<DD>
|
|
fail unless a directory
|
|
<DT id="33">dsync<DD>
|
|
use synchronized I/O for data
|
|
<DT id="34">sync<DD>
|
|
likewise, but also for metadata
|
|
<DT id="35">fullblock<DD>
|
|
accumulate full blocks of input (iflag only)
|
|
<DT id="36">nonblock<DD>
|
|
use non-blocking I/O
|
|
<DT id="37">noatime<DD>
|
|
do not update access time
|
|
<DT id="38">nocache<DD>
|
|
Request to drop cache. See also oflag=sync
|
|
<DT id="39">noctty<DD>
|
|
do not assign controlling terminal from file
|
|
<DT id="40">nofollow<DD>
|
|
do not follow symlinks
|
|
<DT id="41">count_bytes<DD>
|
|
treat 'count=N' as a byte count (iflag only)
|
|
<DT id="42">skip_bytes<DD>
|
|
treat 'skip=N' as a byte count (iflag only)
|
|
<DT id="43">seek_bytes<DD>
|
|
treat 'seek=N' as a byte count (oflag only)
|
|
</DL>
|
|
<P>
|
|
|
|
Sending a USR1 signal to a running 'dd' process makes it
|
|
print I/O statistics to standard error and then resume copying.
|
|
<P>
|
|
|
|
Options are:
|
|
<DL COMPACT>
|
|
<DT id="44"><B>--help</B><DD>
|
|
display this help and exit
|
|
<DT id="45"><B>--version</B><DD>
|
|
output version information and exit
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Written by Paul Rubin, David MacKenzie, and Stuart Kemp.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>REPORTING BUGS</H2>
|
|
|
|
GNU coreutils online help: <<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>>
|
|
<BR>
|
|
|
|
Report dd translation bugs to <<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
Copyright © 2018 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>>.
|
|
<BR>
|
|
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
Full documentation at: <<A HREF="https://www.gnu.org/software/coreutils/dd">https://www.gnu.org/software/coreutils/dd</A>>
|
|
<BR>
|
|
|
|
or available locally via: info '(coreutils) dd invocation'
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="46"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="47"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="48"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="49"><A HREF="#lbAE">AUTHOR</A><DD>
|
|
<DT id="50"><A HREF="#lbAF">REPORTING BUGS</A><DD>
|
|
<DT id="51"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
<DT id="52"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:09 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|