


CSPLIT(1L)                                             CSPLIT(1L)


NNAAMMEE
       csplit  - split a file into sections determined by context
       lines

SSYYNNOOPPSSIISS
       ccsspplliitt [-sqkz] [-f prefix] [-b suffix] [-n digits] [--pre-
       fix=prefix]  [--suffix=suffix] [--digits=digits] [--quiet]
       [--silent] [--keep-files]  [--elide-empty-files]  [--help]
       [--version] file pattern...

DDEESSCCRRIIPPTTIIOONN
       This  manual  page  documents  the  GNU version of ccsspplliitt.
       ccsspplliitt creates zero or more output files  containing  sec-
       tions  of  the  given input _f_i_l_e, or the standard input if
       the name `-' is given.  By default, ccsspplliitt prints the num-
       ber of bytes written to each output file after it has been
       created.

       The contents of the output files  are  determined  by  the
       _p_a_t_t_e_r_n  arguments.  An error occurs if a pattern argument
       refers to a nonexistent line of the input file, such as if
       no  remaining  line  matches  a  given regular expression.
       After all  the  given  patterns  have  been  matched,  any
       remaining output is copied into one last output file.  The
       types of pattern arguments are:

              _l_i_n_e
                     Create an output file containing the current
                     line  up to (but not including) line _l_i_n_e (a
                     positive integer) of  the  input  file.   If
                     followed  by  a repeat count, also create an
                     output file containing the next  _l_i_n_e  lines
                     of the input file once for each repeat.

              /_r_e_g_e_x_p/[_o_f_f_s_e_t]
                     Create an output file containing the current
                     line up to (but not including) the next line
                     of  the input file that contains a match for
                     _r_e_g_e_x_p.  The optional _o_f_f_s_e_t is a `+' or `-'
                     followed  by  a  positive integer.  If it is
                     given, the input up  to  the  matching  line
                     plus  or minus _o_f_f_s_e_t is put into the output
                     file, and the line  after  that  begins  the
                     next section of input.

              %_r_e_g_e_x_p%[_o_f_f_s_e_t]
                     Like  the previous type, except that it does
                     not create an output file, so  that  section
                     of the input file is effectively ignored.

              {_r_e_p_e_a_t_-_c_o_u_n_t}
                     Repeat  the previous pattern _r_e_p_e_a_t_-_c_o_u_n_t (a
                     positive  integer)  additional   times.   An
                     asterisk  may  be  given  in  place  of  the



FSF                     GNU Text Utilities                      1





CSPLIT(1L)                                             CSPLIT(1L)


                     (integer) repeat count, in  which  case  the
                     preceeding pattern is repeated as many times
                     as necessary until the input is exausted.

       The output file names consist of a prefix  followed  by  a
       suffix.   By  default,  the  suffix is merely an ascending
       linear sequence of two-digit decimal numbers starting with
       00 and ranging up to 99, however this default may be over-
       ridden by either the _-_-_d_i_g_i_t_s option or  by  the  _-_-_s_u_f_f_i_x
       option.  (See below.)  In any case, concatenating the out-
       put files in sorted order by file name produces the origi-
       nal  input  file,  in order.  The default output file name
       prefix is `xx'.

       By default, if ccsspplliitt encounters an error  or  receives  a
       hangup,  interrupt,  quit, or terminate signal, it removes
       any output files that it has  created  so  far  before  it
       exits.

   OOPPTTIIOONNSS
       _-_f_, _-_-_p_r_e_f_i_x_=_p_r_e_f_i_x
              Use _p_r_e_f_i_x as the output file name prefix string.

       _-_b_, _-_-_s_u_f_f_i_x_=_s_u_f_f_i_x
              Use  _s_u_f_f_i_x  as the output file name suffix string.
              When this option is specified,  the  suffix  string
              must include exactly one printf(3) style conversion
              specification (such as %d, possibly including  for-
              mat specification flags, a field width, a precision
              specifications, or all  of  these  kinds  of  modi-
              fiers).  The conversion specification must be suit-
              able for converting a binary  integer  argument  to
              readable form.  Thus, only `d', 'i', `u', `o', `x',
              and `X' format specifiers are allowed.  The  entire
              suffix  string  is  given  (with the current output
              file number) to sprintf(3) to form  the  file  name
              suffixes for each of the individual output files in
              turn.  Note that when  this  option  is  used,  the
              _-_-_d_i_g_i_t_s option is ignored.

       _-_n_, _-_-_d_i_g_i_t_s_=_d_i_g_i_t_s
              Use  output  file names containing numbers that are
              _d_i_g_i_t_s digits long instead of the default 2.

       _-_k_, _-_-_k_e_e_p_-_f_i_l_e_s
              Do not remove output files when errors are  encoun-
              tered.

       _-_z_, _-_-_e_l_i_d_e_-_e_m_p_t_y_-_f_i_l_e_s
              Suppress   the  generation  of  zero-length  output
              files.  (In cases where the section  delimiters  of
              the input file are supposed to mark the first lines
              of each of the sections, the first output file will
              generally be a zero-length file unless you use this



FSF                     GNU Text Utilities                      2





CSPLIT(1L)                                             CSPLIT(1L)


              option.)  Note that the output file  sequence  num-
              bers  will  always run consecutively, starting from
              0, even in cases where zero-length output  sections
              are suppressed due to the use of this option.

       _-_s_, _-_q_, _-_-_s_i_l_e_n_t_, _-_-_q_u_i_e_t
              Do not print counts of output file sizes.

       _-_-_h_e_l_p Print a usage message and exit with a non-zero sta-
              tus.

       _-_-_v_e_r_s_i_o_n
              Print version information on standard  output  then
              exit.











































FSF                     GNU Text Utilities                      3


.