SYNOPSIS

       dcfldd [OPTION]...

DESCRIPTION

       Copy a file, converting and formatting according to the options.

       bs=BYTES
              force ibs=BYTES and obs=BYTES

       cbs=BYTES
              convert BYTES bytes at a time

       conv=KEYWORDS
              convert the file as per the comma separated keyword list

       count=BLOCKS
              copy only BLOCKS input blocks

       ibs=BYTES
              read BYTES bytes at a time

       if=FILE
              read from FILE instead of stdin

       obs=BYTES
              write BYTES bytes at a time

       of=FILE
              write to FILE instead of stdout

              NOTE: of=FILE may be used several times to write

              output to multiple files simultaneously

       of:=COMMAND
              exec and write output to process COMMAND

       seek=BLOCKS
              skip BLOCKS obs-sized blocks at start of output

       skip=BLOCKS
              skip BLOCKS ibs-sized blocks at start of input

       pattern=HEX
              use the specified binary pattern as input

       textpattern=TEXT
              use repeating TEXT as input

       errlog=FILE
              send error messages to FILE as well as stderr

              ple md5log=FILE1, sha1log=FILE2, etc.

       hashlog:=COMMAND
              exec and write hashlog to process COMMAND

              ALGORITHMlog:=COMMAND also works in the same fashion

       hashconv=[before|after]
              perform the hashing before or after the conversions

       hashformat=FORMAT
              display each hashwindow according to FORMAT

              the hash format mini-language is described below

       totalhashformat=FORMAT
              display the total hash value according to FORMAT

       status=[on|off]
              display a continual status message on stderr

              default state is "on"

       statusinterval=N
              update the status message every N blocks

              default value is 256

       sizeprobe=[if|of]
              determine the size of the input or output file

              for use with status messages. (this option gives you a  percent-
              age indicator) WARNING: do not use this option against a

              tape device.

       split=BYTES
              write every BYTES amount of data to a new file

              This operation applies to any of=FILE that follows

       splitformat=TEXT
              the file extension format for split operation.

              you  may  use  any number of 'a' or 'n' in any combo the default
              format is "nnn" NOTE: The split  and  splitformat  options  take
              effect

              only  for  output  files specified AFTER these options appear in
              the command line.  Likewise, you may specify these several times
              for for different output files within the same command line. you
              may use as many digits in any combination you would like.  (e.g.
              output version information and exit

       The structure of of FORMAT may contain any valid text and special vari-
       ables.  The built-in variables are used the  following  format:  #vari-
       able_name#  To  pass FORMAT strings to the program from a command line,
       it may be necessary to surround your FORMAT strings with "quotes."  The
       built-in variables are listed below:

       window_start
              The beginning byte offset of the hashwindow

       window_end
              The ending byte offset of the hashwindow

       block_start
              The beginning block (by input blocksize) of the window

       block_end
              The ending block (by input blocksize) of the hash window

       hash   The hash value

       algorithm
              The name of the hash algorithm

   For example, the default FORMAT for hashformat and totalhashformat are:
              hashformat="#window_start# - #window_end#: #hash#" totalhashfor-
              mat="Total (#algorithm#): #hash#"

   The FORMAT structure accepts the following escape codes:
       \n     Newline

       \t     Tab

       \r     Carriage return

       \\     Insert the '\' character

       ##     Insert the '#' character as text, not a variable

       BLOCKS and BYTES may be followed by the following  multiplicative  suf-
       fixes:  xM  M,  c  1,  w  2,  b  512,  kD 1000, k 1024, MD 1,000,000, M
       1,048,576, GD 1,000,000,000, G 1,073,741,824, and so on for T, P, E, Z,
       Y.  Each KEYWORD may be:

       ascii  from EBCDIC to ASCII

       ebcdic from ASCII to EBCDIC

       ibm    from ASCII to alternated EBCDIC

       block  pad newline-terminated records with spaces to cbs-size
              continue after read errors

       sync   pad  every  input  block  with  NULs to ibs-size; when used with
              block or unblock, pad with spaces rather than NULs

AUTHOR

       Written by: dcfldd by Nicholas Harbour, GNU dd  by  Paul  Rubin,  David
       MacKenzie and Stuart Kemp.

REPORTING BUGS

       Report bugs to <nicholasharbour@yahoo.com>.

COPYRIGHT

       Copyright (C) 1985-2006 Free Software Foundation, Inc.
       This is free software; see the source for copying conditions.  There is
       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
       PURPOSE.

SEE ALSO

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

              info dcfldd

       should give you access to the complete manual.



dcfldd (dcfldd) 1.3.4            February 2006                       DCFLDD(1)