home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / man / manpages.zoo / dd.1 < prev    next >
Encoding:
Text File  |  1991-11-11  |  3.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DD(1L)                                                     DD(1L)
  5.  
  6.  
  7.  
  8. NAME
  9.      dd - convert a file while copying it
  10.  
  11. SYNOPSIS
  12.      dd [if=file] [of=file] [ibs=bytes] [obs=bytes] [bs=bytes]
  13.      [cbs=bytes] [skip=blocks] [seek=blocks] [count=blocks]
  14.      [conv={ascii,ebcdic,ibm,block,unblock,lcase,ucase,swab,noerror,notrunc,
  15.      sync}]
  16.  
  17. DESCRIPTION
  18.      This manual page documents the GNU version of dd.  dd copies
  19.      a file (from the standard input to the standard output, by
  20.      default) with a user-selectable blocksize, while optionally
  21.      performing conversions on it.
  22.  
  23.      OPTIONS
  24.      Numbers can be followed by a multiplier:
  25.      b=512, k=1024, w=2, xm=number m
  26.  
  27.      _✓i_✓f=_✓f_✓i_✓l_✓e
  28.           Read from _✓f_✓i_✓l_✓e instead of the standard input.
  29.  
  30.      _✓o_✓f=_✓f_✓i_✓l_✓e
  31.           Write to _✓f_✓i_✓l_✓e instead of the standard output.  Unless
  32.           _✓c_✓o_✓n_✓v=_✓n_✓o_✓t_✓r_✓u_✓n_✓c is given, truncate _✓f_✓i_✓l_✓e to the size speci-
  33.           fied by _✓s_✓e_✓e_✓k= (0 bytes if _✓s_✓e_✓e_✓k= is not given).
  34.  
  35.      _✓i_✓b_✓s=_✓b_✓y_✓t_✓e_✓s
  36.           Read _✓b_✓y_✓t_✓e_✓s bytes at a time.
  37.  
  38.      _✓o_✓b_✓s=_✓b_✓y_✓t_✓e_✓s
  39.           Write _✓b_✓y_✓t_✓e_✓s bytes at a time.
  40.  
  41.      _✓b_✓s=_✓b_✓y_✓t_✓e_✓s
  42.           Read and write _✓b_✓y_✓t_✓e_✓s bytes at atime.  Override ibs and
  43.           obs.
  44.  
  45.      _✓c_✓b_✓s=_✓b_✓y_✓t_✓e_✓s
  46.           Convert _✓b_✓y_✓t_✓e_✓s bytes at a time.
  47.  
  48.      _✓s_✓k_✓i_✓p=_✓b_✓l_✓o_✓c_✓k_✓s
  49.           Skip _✓b_✓l_✓o_✓c_✓k_✓s ibs-sized blocks at start of input.
  50.  
  51.      _✓s_✓e_✓e_✓k=_✓b_✓l_✓o_✓c_✓k_✓s
  52.           Skip _✓b_✓l_✓o_✓c_✓k_✓s obs-sized blocks at start of output.
  53.  
  54.      _✓c_✓o_✓u_✓n_✓t=_✓b_✓l_✓o_✓c_✓k_✓s
  55.           Copy only _✓b_✓l_✓o_✓c_✓k_✓s ibs-sized input blocks.
  56.  
  57.      _✓c_✓o_✓n_✓v=_✓c_✓o_✓n_✓v_✓e_✓r_✓s_✓i_✓o_✓n[,_✓c_✓o_✓n_✓v_✓e_✓r_✓s_✓i_✓o_✓n...]
  58.           Convert the file as specified by the _✓c_✓o_✓n_✓v_✓e_✓r_✓s_✓i_✓o_✓n argu-
  59.           ments.
  60.  
  61.  
  62.  
  63. Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DD(1L)                                                     DD(1L)
  71.  
  72.  
  73.  
  74.           Conversions:
  75.  
  76.           ascii
  77.                Convert EBCDIC to ASCII.
  78.  
  79.           ebcdic
  80.                Convert ASCII to EBCDIC.
  81.  
  82.           ibm  Convert ASCII to alternate EBCDIC.
  83.  
  84.           block
  85.                Pad newline-terminated records to size of cbs,
  86.                replacing newline with trailing spaces.
  87.  
  88.           unblock
  89.                Replace trailing spaces in cbs-sized block with
  90.                newline.
  91.  
  92.           lcase
  93.                Change uppercase characters to lowercase.
  94.  
  95.           ucase
  96.                Change lowercase characters to uppercase.
  97.  
  98.           swab Swap every pair of input bytes.  Unlike the Unix
  99.                dd, this works when an odd number of bytes are
  100.                read.  If the input file contains an odd number of
  101.                bytes, the last byte is simply copied (since there
  102.                is nothing to swap it with).
  103.  
  104.           noerror
  105.                Continue after read errors.
  106.  
  107.           sync Pad every input block to size of ibs with trailing
  108.                NULs.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2
  130.  
  131.  
  132.  
  133.