CSPLIT(1)                       User Commands                      CSPLIT(1)

NAME         top

       csplit - split a file into sections determined by context lines

SYNOPSIS         top

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

DESCRIPTION         top

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

       Read standard input if FILE is -

       Mandatory arguments to long options are mandatory for short options

       -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

              suppress the lines matching PATTERN

       -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

              output version information and exit

   Each PATTERN may be:
              copy up to but not including specified line number

              copy up to but not including a matching line

              skip to, but not including a matching line

              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

AUTHOR         top

       Written by Stuart Kemp and David MacKenzie.

REPORTING BUGS         top

       GNU coreutils online help: <>
       Report csplit translation bugs to

COPYRIGHT         top

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

SEE ALSO         top

       Full documentation at:
       or available locally via: info '(coreutils) csplit invocation'

COLOPHON         top

       This page is part of the coreutils (basic file, shell and text
       manipulation utilities) project.  Information about the project can
       be found at ⟨⟩.  If you have a
       bug report for this manual page, see
       ⟨⟩.  This page was obtained
       from the tarball coreutils-8.29.tar.xz fetched from
       ⟨⟩ on 2018-02-02.  If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page, or
       you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page), send a mail

GNU coreutils 8.29              December 2017                      CSPLIT(1)