👤
Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:
Select Section of Man Page:
Select Man Page Repository:

OpenSolaris 2009.06 - man page for csplit (opensolaris section 1)

csplit(1)				  User Commands 				csplit(1)

NAME
       csplit - split  files based on context

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

DESCRIPTION
       The  csplit  utility  reads the file named by the file operand, writes all or part of that
       file into other files as directed by the arg operands, and writes the sizes of the files.

OPTIONS
       The following options are supported:

       -f prefix    Names the created files prefix00, prefix01, ..., prefixn. The default is xx00
		    ...  xxn. If the prefix argument would create a file name exceeding 14 bytes,
		    an error results. In that case, csplit exits with a diagnostic message and no
		    files are created.

       -k	    Leaves  previously	created  files intact. By default, csplit removes created
		    files if an error occurs.

       -n number    Uses number decimal digits to form filenames for the file pieces. The default
		    is 2.

       -s	    Suppresses the output of file size messages.

OPERANDS
       The following operands are supported:

       file    The path name of a text file to be split. If file is -, the standard input will be
	       used.

       The operands arg1 ... argn can be a combination of the following:

       /rexp/[offset]	 Create a file using the content of the lines from the	current  line  up
			 to,  but not including, the line that results from the evaluation of the
			 regular expression with offset, if any, applied. The regular  expression
			 rexp  must  follow  the  rules  for  basic  regular expressions. Regular
			 expressions can include the use of '\/' and '\%'. These  forms  must  be
			 properly  quoted  with single quotes, since "\" is special to the shell.
			 The optional offset must be a positive or negative integer value  repre-
			 senting a number of lines. The integer value must be preceded by + or -.
			 If the selection of lines from an offset expression of this  type  would
			 create  a  file  with zero lines, or one with greater than the number of
			 lines left in the input file, the results  are  unspecified.  After  the
			 section  is  created,	the  current  line  will  be set to the line that
			 results from the evaluation of the regular expression	with  any  offset
			 applied.  The	pattern  match of rexp always is applied from the current
			 line to the end of the file.

       %rexp%[offset]	 This operand is the same as /rexp/[offset], except that no file will  be
			 created for the selected section of the input file.

       line_no		 Create  a  file from the current line up to (but not including) the line
			 number line_no. Lines in the file will be numbered starting at one.  The
			 current line becomes line_no.

       {num}		 Repeat  operand.  This  operand can follow any of the operands described
			 previously. If it follows a rexp type	operand,  that	operand  will  be
			 applied  num  more times. If it follows a line_no operand, the file will
			 be split every line_no lines, num times, from that point.

       An error will be reported if an operand does not reference  a  line  between  the  current
       position and the end of the file.

USAGE
       See  largefile(5)  for  the  description of the behavior of csplit when encountering files
       greater than or equal to 2 Gbyte (2^31 bytes).

EXAMPLES
       Example 1 Splitting and combining files

       This example creates four files, cobol00...cobol03.

	 example% csplit -f cobol filename \
	    '/procedure division/' /par5./ /par16./

       After editing the split files, they can be recombined as follows:

	 example% cat cobol0[0-3] > filename

       This example overwrites the original file.

       Example 2 Splitting a file into equal parts

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

	 example% csplit -k filename 100 {99}

       Example 3 Creating a file for separate C routines

       If prog.c follows the normal C coding convention (the last line of a routine consists only
       of  a  } in the first character position), this example creates a file for each separate C
       routine (up to 21) in prog.c.

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

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following environment  variables	that  affect  the
       execution of csplit: LANG, LC_ALL, LC_COLLATE, LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0     Successful completion.

       >0    An error occurred.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWesu			   |
       +-----------------------------+-----------------------------+
       |CSI			     |Enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       sed(1), split(1), attributes(5), environ(5), largefile(5), standards(5)

DIAGNOSTICS
       The diagnostic messages are self-explanatory, except for the following:

       arg - out of range	The  given  argument did not reference a line between the current
				position and the end of the file.

SunOS 5.11				    4 Dec 2003					csplit(1)


All times are GMT -4. The time now is 05:09 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
×
UNIX.COM Login
Username:
Password:  
Show Password