GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  DCFLDD (1)

NAME

dcfldd - manual page for dcfldd (dcfldd) 1.3.4

CONTENTS

Synopsis
Description
Author
Copyright

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
hashwindow=BYTES
  perform a hash on every BYTES amount of data
hash=NAME
  either md5, sha1, sha256, sha384 or sha512
default algorithm is md5. To select multiple algorithms to run simultaneously enter the names in a comma separated list
hashlog=FILE
  send MD5 hash output to FILE instead of stderr
if you are using multiple hash algorithms you can send each to a seperate file using the convention ALGORITHMlog=FILE, for example 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 percentage 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. "anaannnaana" would be valid, but quite insane)
vf=FILE
  verify that FILE matches the specified input
verifylog=FILE
  send verify results to FILE instead of stderr
verifylog:=COMMAND
  exec and write verify results to process COMMAND
--help display this help and exit
--version
  output version information and exit
The structure of of FORMAT may contain any valid text and special variables. The built-in variables are used the following format: #variable_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#" totalhashformat="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 suffixes: 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
unblock
  replace trailing spaces in cbs-size records with newline
lcase change upper case to lower case
notrunc
  do not truncate the output file
ucase change lower case to upper case
swab swap every pair of input bytes
noerror
  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 © 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.
Search for    or go to Top of page |  Section 1 |  Main Index


dcfldd (dcfldd) 1.3.4 DCFLDD (1) February 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.