home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat1 / dd.0 < prev    next >
Text File  |  1993-12-07  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. DD(1L)                                                     DD(1L)
  5.  
  6.  
  7. NNAAMMEE
  8.        dd - convert a file while copying it
  9.  
  10. SSYYNNOOPPSSIISS
  11.        dddd  [--help]  [--version]  [if=file] [of=file] [ibs=bytes]
  12.        [obs=bytes]    [bs=bytes]    [cbs=bytes]     [skip=blocks]
  13.        [seek=blocks]                               [count=blocks]
  14.        [conv={ascii,ebcdic,ibm,block,unblock,lcase,ucase,swab,noerror,notrunc,
  15.        sync}]
  16.  
  17. DDEESSCCRRIIPPTTIIOONN
  18.        This  manual  page  documents  the  GNU version of dddd.  dddd
  19.        copies a file (from the standard  input  to  the  standard
  20.        output,  by  default)  with  a  user-selectable blocksize,
  21.        while optionally performing conversions on it.
  22.  
  23.    OOPPTTIIOONNSS
  24.        Numbers can be followed by a multiplier:
  25.        b=512, k=1024, w=2, xm=number m
  26.  
  27.        _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
  28.               tus.
  29.  
  30.        _-_-_v_e_r_s_i_o_n
  31.               Print  version  information  on standard error then
  32.               exit.
  33.  
  34.        _i_f_=_f_i_l_e
  35.               Read from _f_i_l_e instead of the standard input.
  36.  
  37.        _o_f_=_f_i_l_e
  38.               Write to  _f_i_l_e  instead  of  the  standard  output.
  39.               Unless  _c_o_n_v_=_n_o_t_r_u_n_c is given, truncate _f_i_l_e to the
  40.               size specified by _s_e_e_k_= (0 bytes if  _s_e_e_k_=  is  not
  41.               given).
  42.  
  43.        _i_b_s_=_b_y_t_e_s
  44.               Read _b_y_t_e_s bytes at a time.
  45.  
  46.        _o_b_s_=_b_y_t_e_s
  47.               Write _b_y_t_e_s bytes at a time.
  48.  
  49.        _b_s_=_b_y_t_e_s
  50.               Read  and write _b_y_t_e_s bytes at atime.  Override ibs
  51.               and obs.
  52.  
  53.        _c_b_s_=_b_y_t_e_s
  54.               Convert _b_y_t_e_s bytes at a time.
  55.  
  56.        _s_k_i_p_=_b_l_o_c_k_s
  57.               Skip _b_l_o_c_k_s ibs-sized blocks at start of input.
  58.  
  59.        _s_e_e_k_=_b_l_o_c_k_s
  60.               Skip _b_l_o_c_k_s obs-sized blocks at start of output.
  61.  
  62.  
  63.  
  64. FSF                     GNU File Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DD(1L)                                                     DD(1L)
  71.  
  72.  
  73.        _c_o_u_n_t_=_b_l_o_c_k_s
  74.               Copy only _b_l_o_c_k_s ibs-sized input blocks.
  75.  
  76.        _c_o_n_v_=_c_o_n_v_e_r_s_i_o_n_[_,_c_o_n_v_e_r_s_i_o_n_._._._]
  77.               Convert the file as  specified  by  the  _c_o_n_v_e_r_s_i_o_n
  78.               arguments.
  79.               Conversions:
  80.  
  81.               ascii  Convert EBCDIC to ASCII.
  82.  
  83.               ebcdic Convert ASCII to EBCDIC.
  84.  
  85.               ibm    Convert ASCII to alternate EBCDIC.
  86.  
  87.               block  Pad  newline-terminated  records  to size of
  88.                      cbs, replacing newline with trailing spaces.
  89.  
  90.               unblock
  91.                      Replace  trailing  spaces in cbs-sized block
  92.                      with newline.
  93.  
  94.               lcase  Change uppercase characters to lowercase.
  95.  
  96.               ucase  Change lowercase characters to uppercase.
  97.  
  98.               swab   Swap every pair of input bytes.  Unlike  the
  99.                      Unix  dd,  this  works when an odd number of
  100.                      bytes are read.  If the input file  contains
  101.                      an  odd  number  of  bytes, the last byte is
  102.                      simply copied (since  there  is  nothing  to
  103.                      swap it with).
  104.  
  105.               noerror
  106.                      Continue after read errors.
  107.  
  108.               notrunc
  109.                      Do not truncate the output file.
  110.  
  111.               sync   Pad  every  input  block to size of ibs with
  112.                      trailing NULs.
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU File Utilities                      2
  131.  
  132.  
  133.