7.2.5 dd
Convert and copy a file.
Syntax
dd [ --if=name ] [ --of=name ] [ --bs=bytes ] [ --count=num ]
[ --ibs=bytes ] [ --obs=bytes ] [ --seek=num ] [ --skip=num ]
[ --imirror=num ] [ --omirror=num ] [ --mirror=num ]
[ --truncate ] [ --aio=naio ] [ --block ]
[{ -w | --wallet } wallet-location ] [{ -T | --trace } trace-level ]
Command Options
The options for the dd
command are:
-
--if
: Specifies the name of the input file to use instead of standard input. -
--of
: Specifies the name of the output file to use instead of standard output. -
--bs
: Specifies the number of bytes to read and write in each block. The default value is512
. -
--count
: Specifies the number of input blocks. -
--ibs
: Specifies the number of bytes to read at a time. The default value is512
. -
--obs
: Specifies the number of bytes to write at a time. The default value is512
. -
--seek
: Specifies the number ofobs
-sized blocks to skip at the start of the output. -
--skip
: Specifies the number ofibs
-sized blocks to skip at the start of the input. -
--imirror
: Specifies the input mirror number. The first mirror is0
, the second mirror is1
, and so on. The default value is255
, which means 'read any mirror.' -
--omirror
: Specifies the output mirror number. The first mirror is0
, the second mirror is1
, and so on. The default value is255
, which means 'write all mirrors.' -
--mirror
: Specifies the input and output mirror number. The first mirror is0
, the second mirror is1
, and so on. The default value is255
, which means 'all mirrors.' -
--truncate
Resizes the output file. -
--aio
: Specifies the number of async I/Os to use. The default value is 4. -
--block
: Specifies that the I/O offsets should be divisible by the relevant I/O block size. -
-w
,--wallet
: Optionally specifies the path to the Exascale wallet directory. -
-T
,--trace
: Optionally enables tracing and sets the trace level to1
(minimum tracing),2
(medium tracing), or3
(maximum tracing).If the
$ADR_BASE
environment variable is set, the trace file is written to:$ADR_BASE/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trc
Otherwise, the trace file is written to:
/tmp/diag/EXC/xsh_<username>/<hostname>/trace/xsh_<date>.trc
Parent topic: XSH Command Reference