csplit(1)						      General Commands Manual							 csplit(1)

NAME

       csplit - context split

SYNOPSIS

       prefix] number] file arg1 [...argn]

DESCRIPTION

       reads file, separates it into n+1 sections as defined by the arguments arg1 ...	argn, and places the results in separate files.  The maxi-
       mum number of arguments (arg1 through argn) allowed is 99 unless the option is used to allow for more output file names.  If the option	is
       specified, the resulting filenames are through prefixNN where NN is the two-digit value of n using a leading zero if n is less than 10.	If
       the option is not specified, the default filenames through are used.  file is divided as follows:

	      Default	 Prefixed
	      Filename	 Filename	       Contents
	      -----------------------------------------------------
		xx00	 prefix00   From start of file up to  (but
				    not including) the line refer-
				    enced by arg1.
		xx01	 prefix01   From the  line  referenced	by
				    arg1 up to the line referenced
				    by arg2.
					 .
					 .
					 .
		xxNN	 prefixNN   From the  line  referenced	by
				    argn to end of file.

       If the file argument is standard input is used.

       supports the Basic Regular Expression syntax (see regexp(5)).

   Options
       recognizes the following options:

	      Suppress printing of all character counts
			     normally prints the character counts for each file created).

	      Leave previously created files intact
			     normally removes created files if an error occurs).

	      Name created files
			     through prefixNN (default is through

	      The output file name suffix will use
			     number digits instead of the default This allows creation of more than 100 output files.

       Arguments (arg1 through argn) to can be any combination of the following:

	      Create a file containing the section from the current line
			     up  to  (but  not	including) the line matching the regular expression regexp.  The new current line becomes the line
			     matching regexp.

	      Create a file containing the section from the current line
			     up to (but not including) the nth before or after the line matching the regular expression regexp.   (e.g.,  The  new
			     current line becomes the line matching plus or minus n lines.

	      equivalent to  except that no file is created for the section.

	      line_number    Create a file from the current line up to (but not including) line_number.  The new current line becomes line_number.

	      Repeat argument.
			     This  argument can follow any of the above argument forms.  If it follows a regexp argument, that argument is applied
			     num more times.  If it follows line_number, the file is split every line_number lines for num times from  that  point
			     until end-of-file is reached or num expires.

	      Repeats previous operand as many times as necessary to
			     finish input.

       Enclose in appropriate quotes all regexp arguments containing blanks or other characters meaningful to the shell.  Regular expressions must
       not contain embedded new-lines.	does not alter or remove the original file; it is the user's responsibility to remove it when appropriate.

EXTERNAL INFLUENCES

   Environment Variables
       determines the collating sequence used in evaluating regular expressions.

       determines the characters matched by character class expressions in regular expressions.

       determines the language in which messages are displayed.

       If or or is not specified in the environment or is set to the empty string, the value of is used as a default for each unspecified or empty
       variable.  If is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of If any internationalization
       variable contains an invalid setting, behaves as if all internationalization variables are set to "C".  See environ(5).

   International Code Set Support
       Single- and multi-byte character code sets are supported.

DIAGNOSTICS

       Messages are self explanatory except for:

       which means that the given argument did not reference a line between the current position and the end  of  the  file.   This  warning  also
       occurs if the file is exhausted before the repeat count is.

EXAMPLES

       Create four files, through After editing the ``split'' files, recombine them back into the original file, destroying its previous contents.

       Perform editing operations

       Split  a  file  at  every 100 lines, up to 10,000 lines (100 files).  The option causes the created files to be retained if there are fewer
       than 10,000 lines (an error message is still printed).

       Assuming that follows the normal C coding convention of terminating routines with a at the beginning of the line, create a file	containing
       each separate C routine (up to 21) in

SEE ALSO

       sh(1), split(1), environ(5), lang(5), regexp(5).

STANDARDS CONFORMANCE

																	 csplit(1)