csplit(1)                                               csplit(1)



NAME
     csplit - splits files into sections

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

ARGUMENTS
     arg1 [... argn]
          Specifies the sections that the file is split into.
          Replace arg1 with the first argument, and replace argn
          with the last argument.

     -f prefix
          Causes the created files to be named
          prefix00... prefixn.  The default is xx00... xxn.

     file Specifies the file to be split.  If the file argument
          is a - then standard input is used.

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

     -s   Suppresses the printing of all character counts.
          Normally prints the character counts for each file
          created.

DESCRIPTION
     csplit reads file and separates it into n+1 sections,
     defined by the arguments arg1...  argn.  By default, the
     sections are placed in files named 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.







January 1992                                                    1

csplit(1)                                               csplit(1)



     The arguments (arg1... argn) to csplit can be a combination
     of the following:

          /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 will be 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
     newlines.  csplit does not affect the original file; it is
     the user's responsibility to remove it.

EXAMPLES
     The command:

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

     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}

     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.




2                                                    January 1992

csplit(1)                                               csplit(1)



        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.

STATUS MESSAGES AND VALUES
     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.

FILES
     /usr/bin/csplit
          Executable file

SEE ALSO
     ed(1), fsplit(1), sh(1), split(1)

     regexp(5) in A/UX Programmer's Reference
































January 1992                                                    3