OS Manuals

/usr/bin/split

Cross-platform Rust rewrite of the GNU coreutils.

From uutils 0.12.0-r6 (os), captured 2026-11-07 by running split --help (exit 0). permalink

Create output files containing consecutive or interleaved sections of input

Usage: split [OPTION]... [INPUT [PREFIX]]

Arguments:
  [input]   [default: -]
  [prefix]  [default: x]

Options:
  -b, --bytes <SIZE>                put SIZE bytes per output file
  -C, --line-bytes <SIZE>           put at most SIZE bytes of lines per output file
  -l, --lines <NUMBER>              put NUMBER lines/records per output file [default: 1000]
  -n, --number <CHUNKS>             generate CHUNKS output files; see explanation below
      --additional-suffix <SUFFIX>  additional SUFFIX to append to output file names [default: ""]
      --filter <COMMAND>            write to shell COMMAND; file name is $FILE (Currently not
                                    implemented for Windows)
  -e, --elide-empty-files           do not generate empty output files with '-n'
  -d                                use numeric suffixes starting at 0, not alphabetic
      --numeric-suffixes[=<FROM>]   same as -d, but allow setting the start value
  -x                                use hex suffixes starting at 0, not alphabetic
      --hex-suffixes[=<FROM>]       same as -x, but allow setting the start value
  -a, --suffix-length <N>           generate suffixes of length N (default 2)
      --verbose                     print a diagnostic just before each output file is opened
  -t, --separator <SEP>             use SEP instead of newline as the record separator; '\\0' (zero)
                                    specifies the NUL character
  -h, --help                        Print help
  -V, --version                     Print version

Output fixed-size pieces of INPUT to PREFIXaa, PREFIXab, ...; default size is 1000, and default
PREFIX is 'x'. With no INPUT, or when INPUT is -, read standard input.

The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000).
Binary prefixes can be used, too: KiB=K, MiB=M, and so on.

CHUNKS may be:

  - N split into N files based on size of input
  - K/N output Kth of N to stdout
  - l/N split into N files without splitting lines/records
  - l/K/N output Kth of N to stdout without splitting lines/records
  - r/N like 'l' but use round robin distribution
  - r/K/N likewise but only output Kth of N to stdout
Options (16)
OptionDescriptionSource
-b, --bytes SIZEput SIZE bytes per output filehelp + man
-C, --line-bytes SIZEput at most SIZE bytes of lines per output filehelp + man
-l, --lines NUMBERput NUMBER lines/records per output file [default: 1000]help
-n, --number CHUNKSgenerate CHUNKS output files;help + man
--additional-suffix SUFFIXadditional SUFFIX to append to output file names [default: ""]help
--filter COMMANDwrite to shell COMMAND;help + man
-e, --elide-empty-filesdo not generate empty output files with '-n'help + man
-duse numeric suffixes starting at 0, not alphabetichelp + man
--numeric-suffixes FROMsame as -d, but allow setting the start valuehelp
-xuse hex suffixes starting at 0, not alphabetichelp + man
--hex-suffixes FROMsame as -x, but allow setting the start valuehelp
-a, --suffix-length Ngenerate suffixes of length N (default 2)help + man
--verboseprint a diagnostic just before each output file is openedhelp + man
-t, --separator SEPuse SEP instead of newline as the record separator;help + man
-h, --helpPrint helphelp + man
-V, --versionPrint versionhelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.