xenial (1) dc3dd.1.gz

Provided by: dc3dd_7.2.641-3_amd64 bug

NAME

       dc3dd - convert and copy a file

DESCRIPTION

       ------ usage: ------

              dc3dd [OPTION 1] [OPTION 2] ... [OPTION N]

              *or*

              dc3dd [HELP OPTION]

              where  each  OPTION is selected from the basic or advanced options listed below, or HELP OPTION is
              selected from the help options listed below.

       -------------- basic options: --------------

       if=DEVICE or FILE
              Read input from a device or a file (see note #1 below for how to read from standard  input).  This
              option can only be used once and cannot be combined with ifs=, pat=, or tpat=.

       ifs=BASE.FMT
              Read  input from a set of files with base name BASE and sequential file name extensions conforming
              to the format specifier FMT (see note #4 below for how to specify FMT). This option  can  only  be
              used once and cannot be combined with if=, pat=, or tpat=.

       of=FILE or DEVICE
              Write  output  to  a  file or device (see note #2 below for how to write to standard output). This
              option can be used more than once (see note #3 below for how to generate multiple outputs).

       hof=FILE or DEVICE
              Write output to a file or device, hash the output  bytes,  and  verify  by  comparing  the  output
              hash(es)  to the input hash(es). This option can be used more than once (see note #3 below for how
              to generate multiple outputs).

       ofs=BASE.FMT
              Write output to a set of files with base name BASE and sequential file name  extensions  generated
              from  the format specifier FMT (see note #4 below for how to specify FMT). This option can be used
              more than once (see note #3 below for how to generate multiple outputs). Specify the maximum  size
              of each file in the set using ofsz=.

       hofs=BASE.FMT
              Write  output  to a set of files with base name BASE and sequential file name extensions generated
              from the format specifier FMT (see note #4 below for how to specify FMT). Hash  the  output  files
              and  verify  by  comparing the output hash(es) to the input hash(es). This option can be used more
              than once (see note #3 below for how to generate multiple outputs). Specify the  maximum  size  of
              each file in the set using ofsz=.

       ofsz=BYTES
              Set the maximum size of each file in the sets of files specified using ofs= or hofs= to BYTES (see
              note  #5  below).  A  default  value  for  this  option  may  be  set  at   compile   time   using
              -DDEFAULT_OUTPUT_FILE_SIZE followed by the desired value in BYTES.

       hash=ALGORITHM
              Compute  an  ALGORITHM  hash  of the input and also of any outputs specified using hof=, hofs=, or
              fhod=, where ALGORITHM is one of md5, sha1, sha256, or sha512. This option may be  used  once  for
              each  supported  ALGORITHM.  Alternatively,  hashing can be activated at compile time using one or
              more of -DDEFAULT_HASH_MD5,-DDEFAULT_HASH_SHA1, -DDEFAULT_HASH_SHA256, and -DDEFAULT_HASH_SHA512.

       log=FILE
              Log I/O statistcs, diagnostics, and total hashes of input and output to  FILE.  If  hlog=  is  not
              specified, piecewise hashes of multiple file input and output are also logged to FILE. This option
              can be used more than once to generate multiple logs.

       hlog=FILE
              Log total hashes and piecewise hashes to FILE.  This option can be used more than once to generate
              multiple logs.

       mlog=FILE
              Create hash log that is easier for machine to read

       ----------------- advanced options: -----------------

       fhod=DEVICE
              The  same  as  hof=DEVICE, with additional hashing of the entire output DEVICE. This option can be
              used more than once (see note #3 below for how to generate multiple outputs).

       rec=off
              By default, zeros are written to the output(s) in place of bad sectors when the input is a device.
              Use this option to cause the program to instead exit when a bad sector is encountered.

       wipe=DEVICE
              Wipe DEVICE by writing zeros (default) or a pattern specified by pat= or tpat=.

       hwipe=DEVICE
              Wipe  DEVICE  by  writing  zeros  (default) or a pattern specified by pat= or tpat=. Verify DEVICE
              after writing it by hashing it and comparing the hash(es) to the input hash(es).

       pat=HEX
              Use pattern as input, writing HEX to every byte of the output. This option can only be  used  once
              and cannot be combined with if=, ifs=, or tpat=.

       tpat=TEXT
              Use  text pattern as input, writing the string TEXT repeatedly to the output. This option can only
              be used once and cannot be combined with if=, ifs=, or pat=.

       cnt=SECTORS
              Read only SECTORS input sectors. Must be used with pat= or tpat= if not  using  the  pattern  with
              wipe= or hwipe= to wipe a device.

       iskip=SECTORS
              Skip SECTORS sectors at start of the input device or file.

       oskip=SECTORS
              Skip SECTORS sectors at start of the output file. Specifying oskip= automatically sets app=on.

       app=on Do not overwrite an output file specified with of= if it already exists, appending output instead.

       ssz=BYTES
              Unconditionally  use  BYTES  (see  note #5 below) bytes for sector size. If ssz= is not specified,
              sector size is determined by probing the device; if the probe fails or the target is not a device,
              a sector size of 512 bytes is assumed.

       bufsz=BYTES
              Set  the size of the internal byte buffers to BYTES (see note #5 below). This effectively sets the
              maximum number of bytes that may be read at a time from the input. BYTES must  be  a  multiple  of
              sector size. Use this option to fine-tune performance.

       verb=on
              Activate  verbose  reporting,  where  sectors  in/out  are reported for each file in sets of files
              specified using ifs=, ofs=, or hofs=.   Alternatively,  verbose  reporting  may  be  activated  at
              compile time using -DDEFAULT_VERBOSE_REPORTING.

       nwspc=on
              Activate  compact  reporting,  where  the  use  of  white  space to divide log output into logical
              sections is suppressed. Alternatively, compact reporting may be activated at  compile  time  using
              -DDEFAULT_COMPACT_REPORTING.

       b10=on Activate  base  10  bytes reporting, where the progress display reports 1000 bytes instead of 1024
              bytes as 1 KB. Alternatively, base 10 bytes reporting may  be  activated  at  compile  time  using
              -DDEFAULT_BASE_TEN_BYTES_REPORTING.

       corruptoutput=on
              For  verification  testing and demonstration purposes, corrupt the output file(s) with extra bytes
              so a hash mismatch is guaranteed.

       ------------- help options: -------------

       --help display this help and exit

       --version
              output version information and exit

       --flags
              display compile-time flags and exit

       ------ notes: ------

       1. To read from stdin, do not specify if=, ifs=, pat=, or tpat=.  2. To write to stdout, do  not  specify
       of=, hof=, ofs=, hofs=, fhod=,

              wipe=, or hwipe=.

       3. To write to multiple outputs specify more than one of of=, hof=, ofs=,

              hofs=, or fhod=, in any combination.

       4. FMT is a pattern for a sequence of file extensions that can be numerical

              starting  at  zero,  numerical  starting at one, or alphabetical. Specify FMT by using a series of
              zeros, ones, or a's, respectively. The number of characters used indicates the desired  length  of
              the  extensions.   For  example,  a  FMT  specifier  of  0000  indicates  four character numerical
              extensions starting with 0000.

   5. 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), GB (1000*1000*1000),  G
              (1024*1024*1024), and so on for T, P, E, Z, and Y.

       6. Consider using cnt=, iskip= and oskip= to work around

              unreadable sectors if error recovery fails.

       7. Sending an interrupt (e.g., CTRL+C) to dc3dd will cause

              the program to report the work completed at the time the interrupt is received and then exit.

       dc3dd completed at 2014-10-24 12:18:49 +0000

AUTHOR

       Written  by  Paul  Rubin, David MacKenzie, Stuart Kemp, Jesse Kornblum, Andrew Medico, Richard Cordovano,
       and Justin Lowe.

REPORTING BUGS

       Report bugs to <dc3dd@dc3.mil>.

       Copyright  ©  2008  Free  Software  Foundation,  Inc.   License  GPLv3+:  GNU  GPL  version  3  or  later
       <http://gnu.org/licenses/gpl.html>
       This  is  free software: you are free to change and redistribute it.  There is NO WARRANTY, to the extent
       permitted by law.

SEE ALSO

       The full documentation for dc3dd is maintained as a Texinfo manual.  If the info and dc3dd  programs  are
       properly installed at your site, the command

              info dc3dd

       should give you access to the complete manual.