CSPLIT(1)                            SysV                            CSPLIT(1)



NAME
     csplit - context split

SYNOPSIS
     csplit [-s] [-k] [-f prefix] file arg1 [... argn]

DESCRIPTION
     csplit reads file and separates it into n+1 sections, defined by the
     arguments arg1...  argn.  By default the sections are placed in xx00 ...
     xxn (n may not be greater than 99).  These sections get the following
     pieces of file:

           00:   From the start of file up to (but not including) the line
                 referenced by arg1.
           01:   From the line referenced by arg1 up to the line referenced by
                 arg2.
                 .
                 .
           n+1:  From the line referenced by argn to the end of file.

     If the file argument is a - then standard input is used.

OPTIONS
     -s        Suppresses the printing of all character counts.  csplit
               normally prints the character counts for each file created.

     -k        Leaves previously created files intact.  csplit normally
               removes created files if an error occurs.

     -f prefix If the -f Names created files prefix00 ... prefixn.  The
               default is xx00 ...  xxn.

     file ( arg1 ... argn )

          / rexp /       A file is to be created for the section from the
                         current line up to (but not including) the line
                         containing the regular expression rexp.  The current
                         line becomes the line containing rexp.  This argument
                         may be followed by an optional + or - some number of
                         lines (e.g., /Page/-5).

          % rexp %       This argument is the same as /rexp/, except that no
                         file is created for the section.

          lnno           A file is to be created from the current line up to
                         (but not including) lnno.  The current line becomes
                         lnno.

          { num }        Repeat argument.  This argument may follow any of the
                         above arguments.  If it follows a rexp type argument,
                         that argument is applied num more times.  If it
                         follows lnno, the file is split every lnno lines (
                         num times) from that point.  Enclose all rexp type
                         arguments that contain blanks or other characters
                         meaningful to the shell in the appropriate quotes.
                         Regular expressions may not contain embedded new-
                         lines.  csplit does not affect the original file; it
                         is your responsibility to remove it.

EXAMPLES
          csplit -f cobol file  '/procedure division/'  /par5./  /par16./

     This example creates four files, cobol00 ... cobol03.  After editing the
     "split" files, they can be recombined as follows:

          cat cobol0[0-3] > file

     Note that this example overwrites the original file.

          csplit -k file  100  {99}

     This example would split 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.

          csplit -k prog.c  '%main(%'  '/^}/+1'  {20}

     Assuming that prog.c follows the normal C coding convention of ending
     routines with a } at the beginning of the line, this example will create
     a file containing each separate C routine (up to 21) in prog.c.

DIAGNOSTICS
     Self-explanatory except for:

     arg - out of range

     which means that the given argument did not reference a line between the
     current position and the end of the file.

SEE ALSO
     ed(1), sh(1).
     regexp(5) in the SysV Programmer's Reference.