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