CSPLIT

Section: User Commands (1)
Updated: December 2009
Index Return to Main Contents
 

NAME

csplit - split a file into sections determined by context lines  

SYNOPSIS

csplit [OPTION]... FILE PATTERN...  

DESCRIPTION

Output pieces of FILE separated by PATTERN(s) to files `xx00', `xx01', ..., and output byte counts of each piece to standard output.

Mandatory arguments to long options are mandatory for short options too.

-b, --suffix-format=FORMAT
use sprintf FORMAT instead of %02d
-f, --prefix=PREFIX
use PREFIX instead of `xx'
-k, --keep-files
do not remove output files on errors
-n, --digits=DIGITS
use specified number of digits instead of 2
-s, --quiet, --silent
do not print counts of output file sizes
-z, --elide-empty-files
remove empty output files
--help
display this help and exit
--version
output version information and exit

Read standard input if FILE is -. Each PATTERN may be:

INTEGER
copy up to but not including specified line number
/REGEXP/[OFFSET]
copy up to but not including a matching line
%REGEXP%[OFFSET]
skip to, but not including a matching line
{INTEGER}
repeat the previous pattern specified number of times
{*}
repeat the previous pattern as many times as possible

A line OFFSET is a required `+' or `-' followed by a positive integer.  

AUTHOR

Written by Stuart Kemp and David MacKenzie.  

REPORTING BUGS

Report csplit bugs to bug-coreutils@gnu.org
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
General help using GNU software: <http://www.gnu.org/gethelp/>  

COPYRIGHT

Copyright © 2009 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.  

SEE ALSO

The full documentation for csplit is maintained as a Texinfo manual. If the info and csplit programs are properly installed at your site, the command
info coreutils aqcsplit invocationaq

should give you access to the complete manual.