summaryrefslogtreecommitdiffstats
path: root/man/sort.1
blob: b5ec47665c2244af96c54001c127aa179f6e2bcf (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
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.48.5.
.TH SORT "1" "April 2022" "GNU coreutils 9.1" "User Commands"
.SH NAME
sort \- sort lines of text files
.SH SYNOPSIS
.B sort
[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
.br
.B sort
[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR
.SH DESCRIPTION
.\" Add any additional description here
.PP
Write sorted concatenation of all FILE(s) to standard output.
.PP
With no FILE, or when FILE is \-, read standard input.
.PP
Mandatory arguments to long options are mandatory for short options too.
Ordering options:
.TP
\fB\-b\fR, \fB\-\-ignore\-leading\-blanks\fR
ignore leading blanks
.TP
\fB\-d\fR, \fB\-\-dictionary\-order\fR
consider only blanks and alphanumeric characters
.TP
\fB\-f\fR, \fB\-\-ignore\-case\fR
fold lower case to upper case characters
.TP
\fB\-g\fR, \fB\-\-general\-numeric\-sort\fR
compare according to general numerical value
.TP
\fB\-i\fR, \fB\-\-ignore\-nonprinting\fR
consider only printable characters
.TP
\fB\-M\fR, \fB\-\-month\-sort\fR
compare (unknown) < 'JAN' < ... < 'DEC'
.TP
\fB\-h\fR, \fB\-\-human\-numeric\-sort\fR
compare human readable numbers (e.g., 2K 1G)
.TP
\fB\-n\fR, \fB\-\-numeric\-sort\fR
compare according to string numerical value
.TP
\fB\-R\fR, \fB\-\-random\-sort\fR
shuffle, but group identical keys.  See \fBshuf\fP(1)
.TP
\fB\-\-random\-source\fR=\fI\,FILE\/\fR
get random bytes from FILE
.TP
\fB\-r\fR, \fB\-\-reverse\fR
reverse the result of comparisons
.TP
\fB\-\-sort\fR=\fI\,WORD\/\fR
sort according to WORD:
general\-numeric \fB\-g\fR, human\-numeric \fB\-h\fR, month \fB\-M\fR,
numeric \fB\-n\fR, random \fB\-R\fR, version \fB\-V\fR
.TP
\fB\-V\fR, \fB\-\-version\-sort\fR
natural sort of (version) numbers within text
.PP
Other options:
.TP
\fB\-\-batch\-size\fR=\fI\,NMERGE\/\fR
merge at most NMERGE inputs at once;
for more use temp files
.TP
\fB\-c\fR, \fB\-\-check\fR, \fB\-\-check\fR=\fI\,diagnose\-first\/\fR
check for sorted input; do not sort
.TP
\fB\-C\fR, \fB\-\-check\fR=\fI\,quiet\/\fR, \fB\-\-check\fR=\fI\,silent\/\fR
like \fB\-c\fR, but do not report first bad line
.TP
\fB\-\-compress\-program\fR=\fI\,PROG\/\fR
compress temporaries with PROG;
decompress them with PROG \fB\-d\fR
.TP
\fB\-\-debug\fR
annotate the part of the line used to sort,
and warn about questionable usage to stderr
.TP
\fB\-\-files0\-from\fR=\fI\,F\/\fR
read input from the files specified by
NUL\-terminated names in file F;
If F is \- then read names from standard input
.TP
\fB\-k\fR, \fB\-\-key\fR=\fI\,KEYDEF\/\fR
sort via a key; KEYDEF gives location and type
.TP
\fB\-m\fR, \fB\-\-merge\fR
merge already sorted files; do not sort
.TP
\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR
write result to FILE instead of standard output
.TP
\fB\-s\fR, \fB\-\-stable\fR
stabilize sort by disabling last\-resort comparison
.TP
\fB\-S\fR, \fB\-\-buffer\-size\fR=\fI\,SIZE\/\fR
use SIZE for main memory buffer
.TP
\fB\-t\fR, \fB\-\-field\-separator\fR=\fI\,SEP\/\fR
use SEP instead of non\-blank to blank transition
.TP
\fB\-T\fR, \fB\-\-temporary\-directory\fR=\fI\,DIR\/\fR
use DIR for temporaries, not $TMPDIR or \fI\,/tmp\/\fP;
multiple options specify multiple directories
.TP
\fB\-\-parallel\fR=\fI\,N\/\fR
change the number of sorts run concurrently to N
.TP
\fB\-u\fR, \fB\-\-unique\fR
with \fB\-c\fR, check for strict ordering;
without \fB\-c\fR, output only the first of an equal run
.TP
\fB\-z\fR, \fB\-\-zero\-terminated\fR
line delimiter is NUL, not newline
.TP
\fB\-\-help\fR
display this help and exit
.TP
\fB\-\-version\fR
output version information and exit
.PP
KEYDEF is F[.C][OPTS][,F[.C][OPTS]] for start and stop position, where F is a
field number and C a character position in the field; both are origin 1, and
the stop position defaults to the line's end.  If neither \fB\-t\fR nor \fB\-b\fR is in
effect, characters in a field are counted from the beginning of the preceding
whitespace.  OPTS is one or more single\-letter ordering options [bdfgiMhnRrV],
which override global ordering options for that key.  If no key is given, use
the entire line as the key.  Use \fB\-\-debug\fR to diagnose incorrect key usage.
.PP
SIZE may be followed by the following multiplicative suffixes:
% 1% of memory, b 1, K 1024 (default), and so on for M, G, T, P, E, Z, Y.
.PP
*** WARNING ***
The locale specified by the environment affects sort order.
Set LC_ALL=C to get the traditional sort order that uses
native byte values.
.SH AUTHOR
Written by Mike Haertel and Paul Eggert.
.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 2022 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"
\fBshuf\fP(1), \fBuniq\fP(1)
.PP
.br
Full documentation <https://www.gnu.org/software/coreutils/sort>
.br
or available locally via: info \(aq(coreutils) sort invocation\(aq