Debian Codegraph @

upstream/debian-trixie/man1/split.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH SPLIT "1" "June 2025" "GNU coreutils 9.7" "User Commands"
3 .SH NAME
4 split \- split a file into pieces
5 .SH SYNOPSIS
6 .B split
7 [\fI\,OPTION\/\fR]... [\fI\,FILE \/\fR[\fI\,PREFIX\/\fR]]
8 .SH DESCRIPTION
9 .\" Add any additional description here
10 .PP
11 Output pieces of FILE to PREFIXaa, PREFIXab, ...;
12 default size is 1000 lines, and default PREFIX is 'x'.
13 .PP
14 With no FILE, or when FILE is \-, read standard input.
15 .PP
16 Mandatory arguments to long options are mandatory for short options too.
17 .TP
18 \fB\-a\fR, \fB\-\-suffix\-length\fR=\fI\,N\/\fR
19 generate suffixes of length N (default 2)
20 .TP
21 \fB\-\-additional\-suffix\fR=\fI\,SUFFIX\/\fR
22 append an additional SUFFIX to file names
23 .TP
24 \fB\-b\fR, \fB\-\-bytes\fR=\fI\,SIZE\/\fR
25 put SIZE bytes per output file
26 .TP
27 \fB\-C\fR, \fB\-\-line\-bytes\fR=\fI\,SIZE\/\fR
28 put at most SIZE bytes of records per output file
29 .TP
30 \fB\-d\fR
31 use numeric suffixes starting at 0, not alphabetic
32 .TP
33 \fB\-\-numeric\-suffixes\fR[=\fI\,FROM\/\fR]
34 same as \fB\-d\fR, but allow setting the start value
35 .TP
36 \fB\-x\fR
37 use hex suffixes starting at 0, not alphabetic
38 .TP
39 \fB\-\-hex\-suffixes\fR[=\fI\,FROM\/\fR]
40 same as \fB\-x\fR, but allow setting the start value
41 .TP
42 \fB\-e\fR, \fB\-\-elide\-empty\-files\fR
43 do not generate empty output files with '\-n'
44 .TP
45 \fB\-\-filter\fR=\fI\,COMMAND\/\fR
46 write to shell COMMAND; file name is $FILE
47 .TP
48 \fB\-l\fR, \fB\-\-lines\fR=\fI\,NUMBER\/\fR
49 put NUMBER lines/records per output file
50 .TP
51 \fB\-n\fR, \fB\-\-number\fR=\fI\,CHUNKS\/\fR
52 generate CHUNKS output files; see explanation below
53 .TP
54 \fB\-t\fR, \fB\-\-separator\fR=\fI\,SEP\/\fR
55 use SEP instead of newline as the record separator;
56 \&'\e0' (zero) specifies the NUL character
57 .TP
58 \fB\-u\fR, \fB\-\-unbuffered\fR
59 immediately copy input to output with '\-n r/...'
60 .TP
61 \fB\-\-verbose\fR
62 print a diagnostic just before each
63 output file is opened
64 .TP
65 \fB\-\-help\fR
66 display this help and exit
67 .TP
68 \fB\-\-version\fR
69 output version information and exit
70 .PP
71 The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
72 Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000).
73 Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
74 .SS "CHUNKS may be:"
75 .TP
76 N
77 split into N files based on size of input
78 .TP
79 K/N
80 output Kth of N to stdout
81 .TP
82 l/N
83 split into N files without splitting lines/records
84 .TP
85 l/K/N
86 output Kth of N to stdout without splitting lines/records
87 .TP
88 r/N
89 like 'l' but use round robin distribution
90 .TP
91 r/K/N
92 likewise but only output Kth of N to stdout
93 .SH AUTHOR
94 Written by Torbjorn Granlund and Richard M. Stallman.
95 .SH "REPORTING BUGS"
96 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
97 .br
98 Report any translation bugs to <https://translationproject.org/team/>
99 .SH "SEE ALSO"
100 Full documentation <https://www.gnu.org/software/coreutils/split>
101 .br
102 or available locally via: info \(aq(coreutils) split invocation\(aq
103 .PP
104 .br
105 Packaged by Debian (9.7\-3)
106 .br
107 Copyright \(co 2025 Free Software Foundation, Inc.
108 .br
109 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
110 .br
111 This is free software: you are free to change and redistribute it.
112 .br
113 There is NO WARRANTY, to the extent permitted by law.