home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Professional / OS2PRO194.ISO / os2 / prgramer / unix / doc / split.man < prev    next >
Text File  |  1993-06-13  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4. SPLIT(1L)                                               SPLIT(1L)
  5.  
  6.  
  7. NAME
  8.        split - split a file into pieces
  9.  
  10. SYNOPSIS
  11.        split  [-lines] [-l lines] [-b bytes[bkm]] [-C bytes[bkm]]
  12.        [--lines=lines]       [--bytes=bytes[bkm]]        [--line-
  13.        bytes=bytes[bkm]]  [--help]  [--version] [infile [outfile-
  14.        prefix]]
  15.  
  16. DESCRIPTION
  17.        This manual page  documents  the  GNU  version  of  split.
  18.        split  creates one or more output files (as many as neces-
  19.        sary) containing consecutive sections of  the  infile,  or
  20.        the  standard  input  if  none is given or the name `-' is
  21.        given.  By default, split puts 1000  lines  of  the  input
  22.        file,  or  whatever  is left if it is less than that, into
  23.        each output file.
  24.  
  25.        The output file names consist of a prefix  followed  by  a
  26.        group  of letters, chosen so that concatenating the output
  27.        files in sorted order by file name produces  the  original
  28.        input file, in order.  The default output file name prefix
  29.        is `x'.  If the outfile-prefix argument is  given,  it  is
  30.        used as the output file name prefix instead.
  31.  
  32.    OPTIONS
  33.        -lines, -l lines, --lines=lines
  34.               Put  lines lines of the input file into each output
  35.               file.
  36.  
  37.        -b bytes[bkm], --bytes=bytes[bkm]
  38.               Put bytes bytes of the input file into each  output
  39.               file.   bytes is a nonzero integer, optionally fol-
  40.               lowed by one of the following characters to specify
  41.               a different unit.
  42.  
  43.               b      512-byte blocks.
  44.  
  45.               k      1-kilobyte blocks.
  46.  
  47.               m      1-megabyte blocks.
  48.  
  49.        -C bytes[bkm], --line-bytes=bytes[bkm]
  50.               Put into each output file as many complete lines of
  51.               the input file as  is  possible  without  exceeding
  52.               bytes  bytes.   If a line that is longer than bytes
  53.               bytes occurs, put bytes bytes of it into each  out-
  54.               put  file  until  less than bytes bytes of the line
  55.               are left, then continue normally.   bytes  has  the
  56.               same format as for the --bytes option.
  57.  
  58.        --help Print a usage message and exit with a non-zero sta-
  59.               tus.
  60.  
  61.  
  62.  
  63.  
  64. FSF                     GNU Text Utilities                      1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SPLIT(1L)                                               SPLIT(1L)
  71.  
  72.  
  73.        --version
  74.               Print version information on  standard  error  then
  75.               exit.
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. FSF                     GNU Text Utilities                      2
  131.  
  132.  
  133.