manual/gnumaniak/original/man1/split.1

   1 .\" You may copy, distribute and modify under the terms of the LDP General
   2 .\" Public License as specified in the LICENSE file that comes with the
   3 .\" gnumaniak distribution
   4 .\"
   5 .\" The author kindly requests that no comments regarding the "better"
   6 .\" suitability or up-to-date notices of any info documentation alternative
   7 .\" is added without contacting him first.
   8 .\"
   9 .\" (C) 2002 Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>
  10 .\"
  11 .\"     GNU split man page
  12 .\"     man pages are NOT obsolete!
  13 .\"     <ragnar@ragnar-hojland.com>
  14 .TH SPLIT 1 "7 October 2002" "GNU textutils 2.1"
  15 .SH NAME
  16 \fBsplit\fR \- split a file into fixed-size pieces
  17 .SH SYNOPSIS
  18 .B split
  19 [\fB\-\fILINES\fR] [\fB-a \fILENGTH\fR] [\fB\-b \fIBYTES\fR] [\fB\-l \fILINES\fR]
  20 [\fB\-C \fIBYTES\fR] [\fB\-\-bytes=\fIBYTES\fR] [\fB\-\-lines=\fILINES\fR]
  21 [\fB\-\-line\-bytes=\fIBYTES\fR] [\fB\-\-verbose\fR] [\fIFILE\fR]
  22
  23 .BR split " [" \-\-help "] [" \-\-version ]
  24 .SH DESCRIPTION
  25 .B split
  26 creates output files containing consecutive sections of \fIFILE\fR. If
  27 .I FILE
  28 is omitted or if it is a
  29 .RB ` \- ',
  30 standard input is used for reading.
  31
  32 By default, \fBsplit\fR puts 1000 lines of \fIFILE\fR (or whatever is left
  33 over for the last section), into each output file.
  34
  35 The output files' names consist of \fIPREFIX\fR (`\fBx\fR' by default) followed
  36 by a group of letters `aa', `ab', and so on, such that concatenating
  37 the output files in sorted order by file name produces the original
  38 input file.  (If more than 676 output files are required, \fBsplit\fR uses
  39 `zaa', `zab', etc.)  The length of this group can be changed by
  40 \fB\-\-suffix\-length\fR).
  41 .SH OPTIONS
  42 .TP
  43 .B \-\fILINES\fB, \-l \fILINES\fB, \-\-lines=\fILINES
  44 Put \fILINES\fR lines of \fIFILE\fR into each output file, instead of the
  45 default 1000 lines.  Short option form \fB\-\fILINES\fR is deprecated.
  46 .TP
  47 .B \-a \fILENGTH\fB, \-\-suffix\-length=\fILENGTH
  48 Use suffixes of \fILENGTH\fR characters.  (Default: 2)
  49 .TP
  50 .B \-b \fIBYTES\fB, \-\-bytes=\fIBYTES
  51 Put the first \fIBYTES\fR bytes of \fIFILE\fR into each output file.
  52 Appending
  53 .RB ` b '
  54 multiplies \fIBYTES\fR by 512,
  55 .RB ` k '
  56 by 1024, and
  57 .RB ` m '
  58 by 1048576.
  59 .TP
  60 .B \-C \fIBYTES\fB, \-\-line\-bytes=\fIBYTES
  61 Put into each output file as many complete lines of \fIFILE\fR as
  62 possible without exceeding \fIBYTES\fR bytes.  For lines longer than
  63 \fIBYTES\fR bytes, put \fIBYTES\fR bytes into each output file until less than
  64 \fIBYTES\fR bytes of the line are left, then continue normally.  \fIBYTES\fR
  65 has the same format as for the \fB\-\-bytes\fR option.
  66 .TP
  67 .B \-v, \-\-verbose
  68 Always print file name headers.
  69 .TP
  70 .B "\-\-help"
  71 Print a usage message on standard output and exit successfully.
  72 .TP
  73 .B "\-\-version"
  74 Print version information on standard output then exit successfully.
  75 .SH NOTES
  76 Report bugs to bug-textutils@gnu.org.
  77 .br
  78 Man page by Ragnar Hojland Espinosa <ragnar@ragnar-hojland.com>