2015-02-02 12:34:26 -05:00
|
|
|
.Dd February 2, 2015
|
|
|
|
.Dt DD 1
|
|
|
|
.Os ubase
|
|
|
|
.Sh NAME
|
|
|
|
.Nm dd
|
|
|
|
.Nd convert and copy a file
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
|
|
|
.Op Ar operand...
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
.Nm
|
|
|
|
copies the standard input to the standard output. By default input data is
|
|
|
|
read and written in 64kB blocks. When finished,
|
|
|
|
.Nm
|
|
|
|
displays the number of records read and written as well as the total number
|
|
|
|
of bytes copied.
|
|
|
|
.Nm
|
|
|
|
syncs the filesystem once it is done copying. If you want to disable that use
|
|
|
|
the
|
|
|
|
.Ar nosync
|
|
|
|
option.
|
|
|
|
.Sh OPTIONS
|
|
|
|
.Bl -tag -width Ds
|
2015-02-02 13:54:00 -05:00
|
|
|
.It Ar bs Ns Op Ar =N
|
2015-02-02 12:34:26 -05:00
|
|
|
If
|
|
|
|
.Ar bs
|
|
|
|
is not specified, the default blocksize is 64kB. If
|
|
|
|
.Ar bs
|
|
|
|
is specified
|
|
|
|
without setting it to a specific value then an optimal value between the
|
|
|
|
source and target filesystem will be selected. If this process fails it will
|
|
|
|
fallback to the system's pagesize. Adjust
|
|
|
|
.Ar N
|
|
|
|
to set the block size of the transfers in bytes.
|
|
|
|
.It Ar count=N
|
|
|
|
Copy only
|
|
|
|
.Ar N
|
|
|
|
input blocks.
|
|
|
|
.It Ar direct
|
2014-06-11 06:49:44 -04:00
|
|
|
Use direct I/O for data.
|
2015-02-02 12:34:26 -05:00
|
|
|
.It Ar if=file
|
|
|
|
Read input from
|
|
|
|
.Ar file
|
|
|
|
instead of the standard input.
|
|
|
|
.It Ar nosync
|
2014-06-11 06:49:44 -04:00
|
|
|
Do not sync the filesystem once we are done copying.
|
2015-02-02 12:34:26 -05:00
|
|
|
.It Ar quiet
|
|
|
|
Enable quiet output.
|
|
|
|
.It Ar of=file
|
|
|
|
Write output to
|
|
|
|
.Ar file
|
|
|
|
instead of the standard output. If an initial portion of the output
|
|
|
|
.Ar file
|
|
|
|
is skipped using the seek operand, the output file is truncated at that
|
|
|
|
point.
|
|
|
|
.It Ar seek=N
|
|
|
|
Seek
|
|
|
|
.Ar N
|
|
|
|
blocks from the beginning of the output before copying.
|
|
|
|
.It Ar skip=N
|
|
|
|
Skip
|
2015-02-02 13:54:00 -05:00
|
|
|
.Ar N
|
|
|
|
blocks from the beginning of the input before copying.
|
2015-02-02 12:34:26 -05:00
|
|
|
.El
|