original/man1/split.1

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