Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CSPLIT(1)		  BSD General Commands Manual		     CSPLIT(1)

NAME
     csplit -- split files based on context

SYNOPSIS
     csplit [-ks] [-f prefix] [-n number] file args ...

DESCRIPTION
     The csplit	utility	splits file into pieces	using the patterns args.  If
     file is a dash (`-'), csplit reads	from standard input.

     The options are as	follows:

     -f	prefix
	     Give created files	names beginning	with prefix.  The default is
	     "xx".

     -k	     Do	not remove output files	if an error occurs or a	HUP, INT or
	     TERM signal is received.

     -n	number
	     Use number	of decimal digits after	the prefix to form the file
	     name.  The	default	is 2.

     -s	     Do	not write the size of each output file to standard output as
	     it	is created.

     The args operands may be a	combination of the following patterns:

     /regexp/[[+|-]offset]
	     Create a file containing the input	from the current line to (but
	     not including) the	next line matching the given basic regular ex-
	     pression.	An optional offset from	the line that matched may be
	     specified.

     %regexp%[[+|-]offset]
	     Same as above but a file is not created for the output.

     line_no
	     Create containing the input from the current line to (but not in-
	     cluding) the specified line number.

     {num}   Repeat the	previous pattern the specified number of times.	 If it
	     follows a line number pattern, a new file will be created for
	     each line_no lines, num times.  The first line of the file	is
	     line number 1 for historic	reasons.

     After all the patterns have been processed, the remaining input data (if
     there is any) will	be written to a	new file.

     Requesting	to split at a line before the current line number or past the
     end of the	file will result in an error.

ENVIRONMENT
     The LANG, LC_ALL, LC_COLLATE and LC_CTYPE environment variables affect
     the execution of csplit as	described in environ(7).

EXAMPLES
     Split the mdoc(7) file foo.1 into one file	for each section (up to	20):

	   csplit -k foo.1 '%^\.Sh%' '/^\.Sh/' '{20}'

     Split standard input after	the first 99 lines and every 100 lines there-
     after:

	   csplit -k - 100 '{19}'

DIAGNOSTICS
     The csplit	utility	exits 0	on success, and	>0 if an error occurs.

SEE ALSO
     sed(1), split(1), re_format(7)

HISTORY
     A csplit command appeared in PWB UNIX.

STANDARDS
     The csplit	utility	conforms to IEEE Std 1003.1-2001 ("POSIX.1").

BSD				April 28, 2002				   BSD

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | EXAMPLES | DIAGNOSTICS | SEE ALSO | HISTORY | STANDARDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=csplit&manpath=FreeBSD+5.2-RELEASE+and+Ports>

home | help