home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / dd.man < prev    next >
Text File  |  1993-06-13  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. DD(1L)                                                     DD(1L)
  5.  
  6.  
  7. NAME
  8.        dd - convert a file while copying it
  9.  
  10. SYNOPSIS
  11.        dd  [--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. DESCRIPTION
  18.        This  manual  page  documents  the  GNU version of dd.  dd
  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.    OPTIONS
  24.        Numbers can be followed by a multiplier:
  25.        b=512, k=1024, w=2, xm=number m
  26.  
  27.        --help Print a usage message and exit with a non-zero sta-
  28.               tus.
  29.  
  30.        --version
  31.               Print  version  information  on standard error then
  32.               exit.
  33.  
  34.        if=file
  35.               Read from file instead of the standard input.
  36.  
  37.        of=file
  38.               Write to  file  instead  of  the  standard  output.
  39.               Unless  conv=notrunc is given, truncate file to the
  40.               size specified by seek= (0 bytes if  seek=  is  not
  41.               given).
  42.  
  43.        ibs=bytes
  44.               Read bytes bytes at a time.
  45.  
  46.        obs=bytes
  47.               Write bytes bytes at a time.
  48.  
  49.        bs=bytes
  50.               Read  and write bytes bytes at atime.  Override ibs
  51.               and obs.
  52.  
  53.        cbs=bytes
  54.               Convert bytes bytes at a time.
  55.  
  56.        skip=blocks
  57.               Skip blocks ibs-sized blocks at start of input.
  58.  
  59.        seek=blocks
  60.               Skip blocks 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.        count=blocks
  74.               Copy only blocks ibs-sized input blocks.
  75.  
  76.        conv=conversion[,conversion...]
  77.               Convert the file as  specified  by  the  conversion
  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.