JOIN(1) User Commands JOIN(1)
NAME
join(1,n) - join(1,n) lines of two files on a common field
SYNOPSIS
join(1,n) [OPTION]... FILE1 FILE2
DESCRIPTION
For each pair of input lines with identical join(1,n) fields, write(1,2) a line
to standard output. The default join(1,n) field is the first, delimited by
whitespace. When FILE1 or FILE2 (not both) is -, read(2,n,1 builtins) standard input.
-a FILENUM
print unpairable lines coming from file(1,n) FILENUM, where FILENUM
is 1 or 2, corresponding to FILE1 or FILE2
-e EMPTY
replace missing input fields with EMPTY
-i, --ignore-case ignore differences in(1,8) case when comparing fields
-j FIELD
equivalent to `-1 FIELD -2 FIELD'
-o FORMAT
obey FORMAT while constructing output line
-t CHAR
use CHAR as input and output field separator
-v FILENUM
like -a FILENUM, but suppress joined output lines
-1 FIELD
join(1,n) on this FIELD of file(1,n) 1
-2 FIELD
join(1,n) on this FIELD of file(1,n) 2
--help display this help and exit(3,n,1 builtins)
--version
output version(1,3,5) information and exit(3,n,1 builtins)
Unless -t CHAR is given, leading blanks separate fields and are
ignored, else fields are separated by CHAR. Any FIELD is a field num-
ber counted from 1. FORMAT is one or more comma or blank separated
specifications, each being `FILENUM.FIELD' or `0'. Default FORMAT out-
puts(3,n) the join(1,n) field, the remaining fields from FILE1, the remaining
fields from FILE2, all separated by CHAR.
Important: FILE1 and FILE2 must be sorted on the join(1,n) fields.
AUTHOR
Written by Mike Haertel.
REPORTING BUGS
Report bugs to <bug-coreutils@gnu.org>.
COPYRIGHT
Copyright 2004 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
SEE ALSO
The full documentation for join(1,n) is maintained as a Texinfo manual. If
the info(1,5,n) and join(1,n) programs are properly installed at your site, the
command
info(1,5,n) coreutils join(1,n)
should give you access(2,5) to the complete manual.
join(1,n) (coreutils) 5.2.1 March 2004 JOIN(1)