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, ...,  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  fol-
     lowing:

     /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. The optional offset must be a positive or nega-
           tive 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 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 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.

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.