man-pages/man1/split.1.html
2021-03-31 01:06:50 +01:00

142 lines
4.5 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of SPLIT</TITLE>
</HEAD><BODY>
<H1>SPLIT</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
split - split a file into pieces
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>split</B>
[<I>,OPTION/</I>]... [<I>,FILE /</I>[<I>,PREFIX/</I>]]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Output pieces of FILE to PREFIXaa, PREFIXab, ...;
default size is 1000 lines, and default PREFIX is 'x'.
<P>
With no FILE, or when FILE is -, read standard input.
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1"><B>-a</B>, <B>--suffix-length</B>=<I>,N/</I><DD>
generate suffixes of length N (default 2)
<DT id="2"><B>--additional-suffix</B>=<I>,SUFFIX/</I><DD>
append an additional SUFFIX to file names
<DT id="3"><B>-b</B>, <B>--bytes</B>=<I>,SIZE/</I><DD>
put SIZE bytes per output file
<DT id="4"><B>-C</B>, <B>--line-bytes</B>=<I>,SIZE/</I><DD>
put at most SIZE bytes of records per output file
<DT id="5"><B>-d</B><DD>
use numeric suffixes starting at 0, not alphabetic
<DT id="6"><B>--numeric-suffixes</B>[=<I>,FROM/</I>]<DD>
same as <B>-d</B>, but allow setting the start value
<DT id="7"><B>-x</B><DD>
use hex suffixes starting at 0, not alphabetic
<DT id="8"><B>--hex-suffixes</B>[=<I>,FROM/</I>]<DD>
same as <B>-x</B>, but allow setting the start value
<DT id="9"><B>-e</B>, <B>--elide-empty-files</B><DD>
do not generate empty output files with '-n'
<DT id="10"><B>--filter</B>=<I>,COMMAND/</I><DD>
write to shell COMMAND; file name is $FILE
<DT id="11"><B>-l</B>, <B>--lines</B>=<I>,NUMBER/</I><DD>
put NUMBER lines/records per output file
<DT id="12"><B>-n</B>, <B>--number</B>=<I>,CHUNKS/</I><DD>
generate CHUNKS output files; see explanation below
<DT id="13"><B>-t</B>, <B>--separator</B>=<I>,SEP/</I><DD>
use SEP instead of newline as the record separator;
'\0' (zero) specifies the NUL character
<DT id="14"><B>-u</B>, <B>--unbuffered</B><DD>
immediately copy input to output with '-n r/...'
<DT id="15"><B>--verbose</B><DD>
print a diagnostic just before each
output file is opened
<DT id="16"><B>--help</B><DD>
display this help and exit
<DT id="17"><B>--version</B><DD>
output version information and exit
</DL>
<P>
The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000).
<A NAME="lbAE">&nbsp;</A>
<H3>CHUNKS may be:</H3>
<DL COMPACT>
<DT id="18">N<DD>
split into N files based on size of input
<DT id="19">K/N<DD>
output Kth of N to stdout
<DT id="20">l/N<DD>
split into N files without splitting lines/records
<DT id="21">l/K/N<DD>
output Kth of N to stdout without splitting lines/records
<DT id="22">r/N<DD>
like 'l' but use round robin distribution
<DT id="23">r/K/N<DD>
likewise but only output Kth of N to stdout
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Written by Torbjorn Granlund and Richard M. Stallman.
<A NAME="lbAG">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report split translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAH">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/split">https://www.gnu.org/software/coreutils/split</A>&gt;
<BR>
or available locally via: info '(coreutils) split invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="24"><A HREF="#lbAB">NAME</A><DD>
<DT id="25"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="26"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="27"><A HREF="#lbAE">CHUNKS may be:</A><DD>
</DL>
<DT id="28"><A HREF="#lbAF">AUTHOR</A><DD>
<DT id="29"><A HREF="#lbAG">REPORTING BUGS</A><DD>
<DT id="30"><A HREF="#lbAH">COPYRIGHT</A><DD>
<DT id="31"><A HREF="#lbAI">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:27 GMT, March 31, 2021
</BODY>
</HTML>