'\" te
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
.TH SPLIT "1" "March 2012" "GNU coreutils 8.16" "User Commands"
.SH NAME
split \- split a file into pieces
.SH SYNOPSIS
.B split
[\fIOPTION\fR]... [\fIINPUT \fR[\fIPREFIX\fR]]
.SH DESCRIPTION
.\" Add any additional description here
.PP
Output fixed\-size pieces of INPUT to PREFIXaa, PREFIXab, ...; default
size is 1000 lines, and default PREFIX is 'x'.  With no INPUT, or when INPUT
is \-, read standard input.
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\fB\-a\fR, \fB\-\-suffix\-length\fR=\fIN\fR
generate suffixes of length N (default 2)
.TP
\fB\-\-additional\-suffix\fR=\fISUFFIX\fR
append an additional SUFFIX to file names.
.TP
\fB\-b\fR, \fB\-\-bytes\fR=\fISIZE\fR
put SIZE bytes per output file
.TP
\fB\-C\fR, \fB\-\-line\-bytes\fR=\fISIZE\fR
put at most SIZE bytes of lines per output file
.TP
\fB\-d\fR, \fB\-\-numeric\-suffixes\fR[=\fIFROM\fR]
use numeric suffixes instead of alphabetic.
FROM changes the start value (default 0).
.TP
\fB\-e\fR, \fB\-\-elide\-empty\-files\fR
do not generate empty output files with '\-n'
.TP
\fB\-\-filter\fR=\fICOMMAND\fR
write to shell COMMAND; file name is $FILE
.TP
\fB\-l\fR, \fB\-\-lines\fR=\fINUMBER\fR
put NUMBER lines per output file
.TP
\fB\-n\fR, \fB\-\-number\fR=\fICHUNKS\fR
generate CHUNKS output files.  See below
.TP
\fB\-u\fR, \fB\-\-unbuffered\fR
immediately copy input to output with '\-n r/...'
.TP
\fB\-\-verbose\fR
print a diagnostic just before each
output file is opened
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
SIZE is an integer and optional unit (example: 10M is 10*1024*1024).  Units
are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
.PP
CHUNKS may be:
N       split into N files based on size of input
K/N     output Kth of N to stdout
l/N     split into N files without splitting lines
l/K/N   output Kth of N to stdout without splitting lines
r/N     like 'l' but use round robin distribution
r/K/N   likewise but only output Kth of N to stdout
.SH AUTHOR
Written by Torbjorn Granlund and Richard M. Stallman.
.SH "REPORTING BUGS"
Report split bugs to bug\-coreutils@gnu.org
.br
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
.br
General help using GNU software: <http://www.gnu.org/gethelp/>
.br
Report split translation bugs to <http://translationproject.org/team/>
.SH COPYRIGHT
Copyright \(co 2012 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.

.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	file/gnu-coreutils
=
Stability	Uncommitted
.TE 
.PP
.SH "SEE ALSO"
The full documentation for
.B split
is maintained as a Texinfo manual.  If the
.B info
and
.B split
programs are properly installed at your site, the command
.IP
.B info coreutils \(aqsplit invocation\(aq
.PP
should give you access to the complete manual.


.SH NOTES

.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz

Further information about this software can be found on the open source community website at http://www.gnu.org/software/coreutils/.