csplit(1) User Commands csplit(1)NAMEcsplit - split files based on context
SYNOPSIScsplit [-ks] [-f prefix] [-n number] file arg1... argn
DESCRIPTION
The csplit utility reads the file named by the file operand, writes all
or part of that file into other files as directed by the arg operands,
and writes the sizes of the files.
OPTIONS
The following options are supported:
-f prefix Names the created files prefix00, prefix01, ..., pre‐
fixn. The default is xx00 ... xxn. If the prefix argu‐
ment would create a file name exceeding 14 bytes, an
error results. In that case, csplit exits with a diag‐
nostic message and no files are created.
-k Leaves previously created files intact. By default,
csplit removes created files if an error occurs.
-n number Uses number decimal digits to form filenames for the
file pieces. The default is 2.
-s Suppresses the output of file size messages.
OPERANDS
The following operands are supported:
file The path name of a text file to be split. If file is -,
the standard input will be used.
The operands arg1 ... argn can be a combination of the following:
/rexp/[offset] Create a file using the content of the lines from the
current line up to, but not including, the line that
results from the evaluation of the regular expression
with offset, if any, applied. The regular expression
rexp must follow the rules for basic regular expres‐
sions. Regular expressions can include the use of '\/'
and '\%'. These forms must be properly quoted with sin‐
gle quotes, since "\" is special to the shell. The
optional offset must be a positive or negative integer
value representing a number of lines. The integer value
must be preceded by + or −. If the selection of lines
from an offset expression of this type would create a
file with zero lines, or one with greater than the num‐
ber of lines left in the input file, the results are
unspecified. After the section is created, the current
line will be set to the line that results from the
evaluation of the regular expression with any offset
applied. The pattern match of rexp always is applied
from the current line to the end of the file.
%rexp%[offset] This operand is the same as /rexp/[offset], except that
no file will be created for the selected section of the
input file.
line_no Create a file from the current line up to (but not
including) the line number line_no. Lines in the file
will be numbered starting at one. The current line
becomes line_no.
{num} Repeat operand. This operand can follow any of the op‐
erands described previously. If it follows a rexp type
operand, that operand will be applied num more times.
If it follows a line_no operand, the file will be split
every line_no lines, num times, from that point.
An error will be reported if an operand does not reference a line
between the current position and the end of the file.
USAGE
See largefile(5) for the description of the behavior of csplit when
encountering files greater than or equal to 2 Gbyte (2**31 bytes).
EXAMPLES
Example 1: Splitting and combining files
This example creates four files, cobol00...cobol03.
example% csplit-f cobol filename '/procedure division/' /par5./ /par16./
After editing the ``split'' files, they can be recombined as follows:
example% cat cobol0[0−3] > filename
Note: This example overwrites the original file.
Example 2: Splitting a file into equal parts
This example splits the file at every 100 lines, up to 10,000 lines.
The -k option causes the created files to be retained if there are less
than 10,000 lines; however, an error message would still be printed.
example% csplit-k filename 100 {99}
Example 3: Creating a file for separate C routines
If prog.c follows the normal C coding convention (the last line of a
routine consists only of a } in the first character position), this
example creates a file for each separate C routine (up to 21) in
prog.c.
example% csplit-k prog.c '%main(%' '/^}/+1' {20}
ENVIRONMENT VARIABLES
See environ(5) for descriptions of the following environment variables
that affect the execution of csplit: LANG, LC_ALL, LC_COLLATE,
LC_CTYPE, LC_MESSAGES, and NLSPATH.
EXIT STATUS
The following exit values are returned:
0 Successful completion.
>0 An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWesu │
├─────────────────────────────┼─────────────────────────────┤
│CSI │Enabled │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Standard │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsed(1), split(1), attributes(5), environ(5), largefile(5), standards(5)DIAGNOSTICS
The diagnostic messages are self-explanatory, except for the following:
arg − out of range The given argument did not reference a line
between the current position and the end of the
file.
SunOS 5.10 4 Dec 2003 csplit(1)
