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

121 lines
3.6 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of CSPLIT</TITLE>
</HEAD><BODY>
<H1>CSPLIT</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>
csplit - split a file into sections determined by context lines
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>csplit</B>
[<I>,OPTION/</I>]... <I>,FILE PATTERN/</I>...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
Output pieces of FILE separated by PATTERN(s) to files 'xx00', 'xx01', ...,
and output byte counts of each piece to standard output.
<P>
Read standard input if FILE is -
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1"><B>-b</B>, <B>--suffix-format</B>=<I>,FORMAT/</I><DD>
use sprintf FORMAT instead of %02d
<DT id="2"><B>-f</B>, <B>--prefix</B>=<I>,PREFIX/</I><DD>
use PREFIX instead of 'xx'
<DT id="3"><B>-k</B>, <B>--keep-files</B><DD>
do not remove output files on errors
<DT id="4"><B>--suppress-matched</B><DD>
suppress the lines matching PATTERN
<DT id="5"><B>-n</B>, <B>--digits</B>=<I>,DIGITS/</I><DD>
use specified number of digits instead of 2
<DT id="6"><B>-s</B>, <B>--quiet</B>, <B>--silent</B><DD>
do not print counts of output file sizes
<DT id="7"><B>-z</B>, <B>--elide-empty-files</B><DD>
remove empty output files
<DT id="8"><B>--help</B><DD>
display this help and exit
<DT id="9"><B>--version</B><DD>
output version information and exit
</DL>
<A NAME="lbAE">&nbsp;</A>
<H3>Each PATTERN may be:</H3>
<DL COMPACT>
<DT id="10">INTEGER<DD>
copy up to but not including specified line number
<DT id="11">/REGEXP/[OFFSET]<DD>
copy up to but not including a matching line
<DT id="12">%REGEXP%[OFFSET]<DD>
skip to, but not including a matching line
<DT id="13">{INTEGER}<DD>
repeat the previous pattern specified number of times
<DT id="14">{*}<DD>
repeat the previous pattern as many times as possible
</DL>
<P>
A line OFFSET is a required '+' or '-' followed by a positive integer.
<A NAME="lbAF">&nbsp;</A>
<H2>AUTHOR</H2>
Written by Stuart Kemp and David MacKenzie.
<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 csplit 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/csplit">https://www.gnu.org/software/coreutils/csplit</A>&gt;
<BR>
or available locally via: info '(coreutils) csplit invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DL>
<DT id="18"><A HREF="#lbAE">Each PATTERN may be:</A><DD>
</DL>
<DT id="19"><A HREF="#lbAF">AUTHOR</A><DD>
<DT id="20"><A HREF="#lbAG">REPORTING BUGS</A><DD>
<DT id="21"><A HREF="#lbAH">COPYRIGHT</A><DD>
<DT id="22"><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:09 GMT, March 31, 2021
</BODY>
</HTML>