manpagez: man pages & more
man dc3dd(1)
Home | html | info | man
dc3dd(1)                         User Commands                        dc3dd(1)




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=.  If FILE is a
              device, use rdisk for direct (unbuffered) input to  enable  read
              error recovery unless rec=off is specified.

       ifs=BASE.FMT
              Read  input  from a set of files with base name BASE and sequen-
              tial 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 sequen-
              tial 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  sequen-
              tial  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  -DDE-
              FAULT_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  acti-
              vated   at   compile   time   using   one   or   more  of  -DDE-
              FAULT_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 com-
              bined 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.  Alterna-
              tively, 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  guaran-
              teed.

       ------------- 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, respec-
              tively. 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 inter-
              rupt is received and then exit.

       dc3dd completed at 2015-05-14 19:46:35 -0500


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

       Copyright  (C) 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.



dc3dd 7.2.641                      May 2015                           dc3dd(1)

dc3dd 7.2.641 - Generated Fri May 15 12:41:59 CDT 2015
© manpagez.com 2000-2019
Individual documents may contain additional copyright information.