NAME

       join  -  For  each  pair  of input lines with identical join fields, write a line to standard output. The
       default join field is the first, delimited by blanks.

       When `FILE1` or `FILE2` (not both) is `-`, read standard input.

SYNOPSIS

       join [-a ] [-v ] [-e ] [-i|--ignore-case] [-j ] [-o ] [-t ] [-1 ] [-2 ] [--check-order] [--nocheck-order]
       [--header] [-z|--zero-terminated] [-h|--help] [-V|--version] <FILE1> <FILE2>

DESCRIPTION

       For each pair of input lines with identical join fields, write a line to  standard  output.  The  default
       join field is the first, delimited by blanks.

       When `FILE1` or `FILE2` (not both) is `-`, read standard input.

OPTIONS

       -a=FILENUM
              also  print unpairable lines from file FILENUM, where FILENUM is 1 or 2, corresponding to FILE1 or
              FILE2

              [possible values: 1, 2]

       -v=FILENUM
              like -a FILENUM, but suppress joined output lines

              [possible values: 1, 2]

       -e=EMPTY
              replace missing input fields with EMPTY

       -i, --ignore-case
              ignore differences in 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

       -1=FIELD
              join on this FIELD of file 1

       -2=FIELD
              join on this FIELD of file 2

       --check-order
              check that the input is correctly sorted, even if all input lines are pairable

       --nocheck-order
              do not check that the input is correctly sorted

       --header
              treat the first line in each file as field headers, print them without trying to pair them

       -z, --zero-terminated
              line delimiter is NUL, not newline

       -h, --help
              Print help

       -V, --version
              Print version

VERSION

       v0.0.30

                                                   join 0.0.30                                           join(1)