BSD 4_3_Tahoe development
[unix-history] / usr / man / cat1 / sort.0
SORT(1) UNIX Programmer's Manual SORT(1)
N\bNA\bAM\bME\bE
sort - sort or merge files
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
s\bso\bor\brt\bt [ -_\bm_\bu_\bb_\bd_\bf_\bi_\bn_\br_\bt_\bx ] [ +\b+_\bp_\bo_\bs_\b1 [ -\b-_\bp_\bo_\bs_\b2 ] ] ... [ -\b-o\bo name ] [
-\b-T\bT directory ] [ name ] ...
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
_\bS_\bo_\br_\bt sorts lines of all the named files together and writes
the result on the standard output. The name `-' means the
standard input. If no input files are named, the standard
input is sorted.
The default sort key is an entire line. Default ordering is
lexicographic by bytes in machine collating sequence. The
ordering is affected globally by the following options, one
or more of which may appear.
b\bb Ignore leading blanks (spaces and tabs) in field com-
parisons.
d\bd `Dictionary' order: only letters, digits and blanks are
significant in comparisons.
f\bf Fold upper case letters onto lower case.
i\bi Ignore characters outside the ASCII range 040-0176 in
nonnumeric comparisons.
n\bn An initial numeric string, consisting of optional
blanks, optional minus sign, and zero or more digits
with optional decimal point, is sorted by arithmetic
value. (Note that -\b-0\b0 is considered equal to 0\b0.) Option
n\bn implies option b\bb.\b.
r\br Reverse the sense of comparisons.
t\bt_\bx `Tab character' separating fields is _\bx.
The notation +\b+_\bp_\bo_\bs_\b1 -\b-_\bp_\bo_\bs_\b2 restricts a sort key to a field
beginning at _\bp_\bo_\bs_\b1 and ending just before _\bp_\bo_\bs_\b2. _\bP_\bo_\bs_\b1 and
_\bp_\bo_\bs_\b2 each have the form _\bm.\b._\bn, optionally followed by one or
more of the flags b\bbd\bdf\bfi\bin\bnr\br,\b, where _\bm tells a number of fields
to skip from the beginning of the line and _\bn tells a number
of characters to skip further. If any flags are present
they override all the global ordering options for this key.
If the b\bb option is in effect _\bn is counted from the first
nonblank in the field; b\bb is attached independently to _\bp_\bo_\bs_\b2.
A missing .\b._\bn means .0; a missing -\b-_\bp_\bo_\bs_\b2 means the end of the
line. Under the -\b-t\bt_\bx option, fields are strings separated by
_\bx; otherwise fields are nonempty nonblank strings separated
by blanks.
Printed 7/9/88 September 30, 1987 1
SORT(1) UNIX Programmer's Manual SORT(1)
When there are multiple sort keys, later keys are compared
only after all earlier keys compare equal. Lines that oth-
erwise compare equal are ordered with all bytes significant.
These option arguments are also understood:
c\bc Check that the input file is sorted according to the
ordering rules; give no output unless the file is out
of sort.
m\bm Merge only, the input files are already sorted.
o\bo The next argument is the name of an output file to use
instead of the standard output. This file may be the
same as one of the inputs.
T\bT The next argument is the name of a directory in which
temporary files should be made.
u\bu Suppress all but one in each set of equal lines.
Ignored bytes and bytes outside keys do not participate
in this comparison.
E\bEX\bXA\bAM\bMP\bPL\bLE\bES\bS
Print in alphabetical order all the unique spellings in a
list of words. Capitalized words differ from uncapitalized.
sort -u +0f +0 list
Print the password file (_\bp_\ba_\bs_\bs_\bw_\bd(5)) sorted by user id number
(the 3rd colon-separated field).
sort -t: +2n /etc/passwd
Print the first instance of each month in an already sorted
file of (month day) entries. The options -\b-u\bum\bm with just one
input file make the choice of a unique representative from a
set of equal lines predictable.
sort -um +0 -1 dates
F\bFI\bIL\bLE\bES\bS
/usr/tmp/stm*, /tmp/* first and second tries for tem-
porary files
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
uniq(1), comm(1), rev(1), join(1)
D\bDI\bIA\bAG\bGN\bNO\bOS\bST\bTI\bIC\bCS\bS
Comments and exits with nonzero status for various trouble
conditions and for disorder discovered under option -\b-c\bc.
Printed 7/9/88 September 30, 1987 2
SORT(1) UNIX Programmer's Manual SORT(1)
B\bBU\bUG\bGS\bS
Very long lines are silently truncated.
Printed 7/9/88 September 30, 1987 3