manual/GNU_coreutils/original/man1/split.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
   2 .TH SPLIT "1" "May 2014" "GNU coreutils 8.22" "User Commands"
   3 .SH NAME
   4 split \- split a file into pieces
   5 .SH SYNOPSIS
   6 .B split
   7 [\fIOPTION\fR]... [\fIINPUT \fR[\fIPREFIX\fR]]
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Output fixed\-size pieces of INPUT to PREFIXaa, PREFIXab, ...; default
  12 size is 1000 lines, and default PREFIX is 'x'.  With no INPUT, or when INPUT
  13 is \-, read standard input.
  14 .PP
  15 Mandatory arguments to long options are mandatory for short options too.
  16 .TP
  17 \fB\-a\fR, \fB\-\-suffix\-length\fR=\fIN\fR
  18 generate suffixes of length N (default 2)
  19 .TP
  20 \fB\-\-additional\-suffix\fR=\fISUFFIX\fR
  21 append an additional SUFFIX to file names
  22 .TP
  23 \fB\-b\fR, \fB\-\-bytes\fR=\fISIZE\fR
  24 put SIZE bytes per output file
  25 .TP
  26 \fB\-C\fR, \fB\-\-line\-bytes\fR=\fISIZE\fR
  27 put at most SIZE bytes of lines per output file
  28 .TP
  29 \fB\-d\fR, \fB\-\-numeric\-suffixes\fR[=\fIFROM\fR]
  30 use numeric suffixes instead of alphabetic;
  31 FROM changes the start value (default 0)
  32 .TP
  33 \fB\-e\fR, \fB\-\-elide\-empty\-files\fR
  34 do not generate empty output files with '\-n'
  35 .TP
  36 \fB\-\-filter\fR=\fICOMMAND\fR
  37 write to shell COMMAND; file name is $FILE
  38 .TP
  39 \fB\-l\fR, \fB\-\-lines\fR=\fINUMBER\fR
  40 put NUMBER lines per output file
  41 .TP
  42 \fB\-n\fR, \fB\-\-number\fR=\fICHUNKS\fR
  43 generate CHUNKS output files; see explanation below
  44 .TP
  45 \fB\-u\fR, \fB\-\-unbuffered\fR
  46 immediately copy input to output with '\-n r/...'
  47 .TP
  48 \fB\-\-verbose\fR
  49 print a diagnostic just before each
  50 output file is opened
  51 .TP
  52 \fB\-\-help\fR
  53 display this help and exit
  54 .TP
  55 \fB\-\-version\fR
  56 output version information and exit
  57 .PP
  58 SIZE is an integer and optional unit (example: 10M is 10*1024*1024).  Units
  59 are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
  60 .PP
  61 CHUNKS may be:
  62 N       split into N files based on size of input
  63 K/N     output Kth of N to stdout
  64 l/N     split into N files without splitting lines
  65 l/K/N   output Kth of N to stdout without splitting lines
  66 r/N     like 'l' but use round robin distribution
  67 r/K/N   likewise but only output Kth of N to stdout
  68 .PP
  69 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
  70 Report split translation bugs to <http://translationproject.org/team/>
  71 .SH AUTHOR
  72 Written by Torbjorn Granlund and Richard M. Stallman.
  73 .SH COPYRIGHT
  74 Copyright \(co 2013 Free Software Foundation, Inc.
  75 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
  76 .br
  77 This is free software: you are free to change and redistribute it.
  78 There is NO WARRANTY, to the extent permitted by law.
  79 .SH "SEE ALSO"
  80 The full documentation for
  81 .B split
  82 is maintained as a Texinfo manual.  If the
  83 .B info
  84 and
  85 .B split
  86 programs are properly installed at your site, the command
  87 .IP
  88 .B info coreutils \(aqsplit invocation\(aq
  89 .PP
  90 should give you access to the complete manual.