csplit(1) — Linux manual page

NAME | SYNOPSIS | DESCRIPTION | AUTHOR | REPORTING BUGS | COPYRIGHT | SEE ALSO | COLOPHON

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 too.

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-b\-b, --suffix-format=FORMAT]8;;\
              use sprintf FORMAT instead of %02d

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-f\-f, --prefix=PREFIX]8;;\
              use PREFIX instead of 'xx'

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-k\-k, --keep-files]8;;\
              do not remove output files on errors

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit--suppress-matched\--suppress-matched]8;;\
              suppress the lines matching PATTERN

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-n\-n, --digits=DIGITS]8;;\
              use specified number of digits instead of 2

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-s\-s, --quiet, --silent]8;;\
              do not print counts of output file sizes

       ]8;;https://www.gnu.org/software/coreutils/manual/coreutils.html#csplit-z\-z, --elide-empty-files]8;;\
              suppress empty output files

       ]8;;https://www.gnu.org/software/coreutils/csplit#csplit--help\--help]8;;\ display this help and exit

       ]8;;https://www.gnu.org/software/coreutils/csplit#csplit--version\--version]8;;\
              output version information and exit

   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 an integer optionally preceded by '+' or '-'

AUTHOR         top

       Written by Stuart Kemp and David MacKenzie.

REPORTING BUGS         top

       Report bugs to: bug-coreutils@gnu.org
       GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
       General help using GNU software: <https://www.gnu.org/gethelp/>
       Report any translation bugs to
       <https://translationproject.org/team/>

COPYRIGHT         top

       Copyright © 2026 Free Software Foundation, Inc.  License GPLv3+:
       GNU GPL version 3 or later <https://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         top

       Full documentation <https://www.gnu.org/software/coreutils/csplit>
       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 ⟨http://www.gnu.org/software/coreutils/⟩.  If you
       have a bug report for this manual page, see
       ⟨http://www.gnu.org/software/coreutils/⟩.  This page was obtained
       from the tarball coreutils-9.11.tar.xz fetched from
       ⟨http://ftp.gnu.org/gnu/coreutils/⟩ on 2026-05-24.  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 to man-pages@man7.org

GNU coreutils 9.11              April 2026                      CSPLIT(1)