csplit(1)

csplit1

Split a file into sections determined by context lines

Usage

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

Overview

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.

-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-matched

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

suppress empty output files

--help

display this help and exit

--version

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 '-'

Releases

19 releases since Debian 1.1 (Buzz); the text changed 15 times.

  1. 1.1
  2. 1.2–2.1
  3. 2.2
  4. 3.0
  5. 3.1
  6. 4.0
  7. 5.0
  8. 6.0
  9. 7
  10. 8
  11. 9
  12. 10
  13. 11
  14. 12
  15. 13
  16. Arch

--digits since Debian 3.0 (Woody); --elide-empty-files since Debian 3.0 (Woody); --keep-files since Debian 3.0 (Woody); --prefix since Debian 3.0 (Woody); --quiet since Debian 3.0 (Woody); --silent since Debian 3.0 (Woody); --suffix-format since Debian 5.0 (Lenny); --suppress-matched since Debian 8 (Jessie); -b since Debian 5.0 (Lenny); -f since Debian 3.0 (Woody); -k since Debian 3.0 (Woody); -n since Debian 3.0 (Woody); -s since Debian 3.0 (Woody); -z since Debian 3.0 (Woody).

-m until Debian 8 (Jessie); -q until Debian 2.1 (Slink).

Author

Written by Stuart Kemp and David MacKenzie.

Reporting bugs

Report bugs to: <[email protected]>.
Report any translation bugs to: <https://translationproject.org/team/>.
GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
General help using GNU software: <https://www.gnu.org/gethelp/>

From coreutils 9.12-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.