|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands csplit(1)
NAME
csplit - split files based on context
SYNOPSIS
csplit [-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,
..., prefixn. The default is xx00 ... xxn.
If the prefix argument would create a file
name exceeding 14 bytes, an error results.
In that case, csplit exits with a diagnostic
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 fol-
lowing:
/rexp/[offset] Create a file using the content of the lines
from the current line up to, but not includ-
ing, the line that results from the
SunOS 5.10 Last change: 4 Dec 2003 1
User Commands csplit(1)
evaluation of the regular expression with
offset, if any, applied. The regular expres-
sion rexp must follow the rules for basic
regular expressions. Regular expressions can
include the use of '\/' and '\%'. These
forms must be properly quoted with single
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 number 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 operands described previously. If it
follows a rexp type operand, that operand
will be applied num more times. If it fol-
lows 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
SunOS 5.10 Last change: 4 Dec 2003 2
User Commands csplit(1)
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 charac-
ter 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.
SunOS 5.10 Last change: 4 Dec 2003 3
User Commands csplit(1)
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWesu |
|_____________________________|_____________________________|
| CSI | Enabled |
|_____________________________|_____________________________|
| Interface Stability | Standard |
|_____________________________|_____________________________|
SEE ALSO
sed(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 Last change: 4 Dec 2003 4
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:24:32 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
CPAN man page (4290 hits)
(Suse Linux 10.1)
ssh man page (4160 hits)
(Suse Linux 10.1)
adv_cap_autoneg man page (3471 hits)
(Solaris 10 11_06)
sqlite3 man page (3371 hits)
(openSUSE 10.2)
svn man page (3036 hits)
(FreeBSD 6.2)
startproc man page (1856 hits)
(Suse Linux 10.1)
pprosetup man page (1576 hits)
(Solaris 10 11_06)
signal man page (1541 hits)
(Suse Linux 10.1)
netcat man page (1508 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (1450 hits)
(Solaris 10 11_06)
|
Man Pages 
