man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

csplit (1g)

Name

csplit - split a file into sections determined by context lines

Synopsis

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

Description




User Commands                                           CSPLIT(1)



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



GNU coreutils 8.16   Last change: March 2012                    1






User Commands                                           CSPLIT(1)



     {*}  repeat the previous pattern as many times as possible

     A  line  OFFSET is a required '+' or '-' followed by a posi-
     tive 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/core-
     utils/>
     General  help  using GNU software: <http://www.gnu.org/geth-
     elp/>
     Report csplit translation  bugs  to  <http://translationpro-
     ject.org/team/>

COPYRIGHT
     Copyright  (C)  2012 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 redis-
     tribute it.  There is NO WARRANTY, to the  extent  permitted
     by law.


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

     +---------------+--------------------+
     |ATTRIBUTE TYPE |  ATTRIBUTE VALUE   |
     +---------------+--------------------+
     |Availability   | file/gnu-coreutils |
     +---------------+--------------------+
     |Stability      | Uncommitted        |
     +---------------+--------------------+
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 'csplit invocation'

     should give you access to the complete manual.



NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community       source       was       downloaded       from



GNU coreutils 8.16   Last change: March 2012                    2






User Commands                                           CSPLIT(1)



     http://ftp.gnu.org/gnu/coreutils/coreutils-8.16.tar.xz

     Further  information about this software can be found on the
     open source community  website  at  http://www.gnu.org/soft-
     ware/coreutils/.


















































GNU coreutils 8.16   Last change: March 2012                    3