1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
.\" Adapted for BNU from the GNU Coreutils 9.11 manual page; see doc/README.md.
.TH CSPLIT "1" "2026-07-28" "BNU 9.11" "BNU Commands"
.SH NAME
csplit \- split a file into sections determined by context lines
.SH SYNOPSIS
.B csplit
[\fI\,OPTION\/\fR]... \fI\,FILE PATTERN\/\fR...
.SH DESCRIPTION
.\" This page is derived from GNU Coreutils documentation.
This page documents BNU, an independent Bun implementation compatible with
GNU Coreutils 9.11.
.PP
Output pieces of FILE separated by PATTERN(s) to files 'xx00', 'xx01', ...,
and output byte counts of each piece to standard output.
.PP
Read standard input if FILE is \-
.PP
Mandatory arguments to long options are mandatory for short options too.
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-b'\fB\-b, \-\-suffix\-format=\,FORMAT\fP\X'tty: link'\/\fR
use sprintf FORMAT instead of %02d
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-f'\fB\-f, \-\-prefix=\,PREFIX\fP\X'tty: link'\/\fR
use PREFIX instead of 'xx'
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-k'\fB\-k, \-\-keep\-files\fP\X'tty: link'
do not remove output files on errors
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit--suppress-matched'\fB\-\-suppress\-matched\fP\X'tty: link'
suppress the lines matching PATTERN
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-n'\fB\-n, \-\-digits=\,DIGITS\fP\X'tty: link'\/\fR
use specified number of digits instead of 2
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-s'\fB\-s, \-\-quiet, \-\-silent\fP\X'tty: link'
do not print counts of output file sizes
.TP
\X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-z'\fB\-z, \-\-elide\-empty\-files\fP\X'tty: link'
suppress empty output files
.TP
\X'tty: link https://www.gnu.org/software/coreutils/csplit#csplit--help'\fB\-\-help\fP\X'tty: link'
display this help and exit
.TP
\X'tty: link https://www.gnu.org/software/coreutils/csplit#csplit--version'\fB\-\-version\fP\X'tty: link'
output version information and exit
.SS "Each PATTERN may be:"
.TP
INTEGER
copy up to but not including specified line number
.TP
/REGEXP/[OFFSET]
copy up to but not including a matching line
.TP
%REGEXP%[OFFSET]
skip to, but not including a matching line
.TP
{INTEGER}
repeat the previous pattern specified number of times
.TP
{*}
repeat the previous pattern as many times as possible
.PP
A line OFFSET is an integer optionally preceded by '+' or '\-'
.SH AUTHORS
Upstream GNU Coreutils documentation authors:
Written by Stuart Kemp and David MacKenzie.
.br
Adapted for BNU; the BNU implementation is independent.
.SH "REPORTING BUGS"
Report BNU bugs at <https://github.com/Soccera1/bnu/issues>.
.br
For upstream GNU Coreutils, see <https://www.gnu.org/software/coreutils/>.
.SH COPYRIGHT
Copyright \(co 2026 Free Software Foundation, Inc.
.br
This manual page was adapted for BNU in 2026.
License GPLv3+: GNU GPL version 3 or later <https://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.
.SH "SEE ALSO"
Upstream documentation <https://www.gnu.org/software/coreutils/csplit>
.br
BNU documentation is available locally via: info \(aq(bnu) csplit invocation\(aq
|