xtcommon(1)

NAME
xtcommon - select lines using reference file

SYNOPSIS
xtcommon -k a list of attributes of an input file (mandatory) [-K a list of attributes of a reference file.] -m reference file name [-u output filename] [-r] [-H hashing is used for selection] [-i input filename] [-o output filename] [-z] [-t] [-T directory of work file]

DESCRIPTION
 Comparing an input file and a reference file, this command selects the lines of an input file such that the value of the attribute specified by -k matches one of those of values of the attribute specified by -K in the reference file.

PARAMETERS

-k a list of attributes of an input file (mandatory)

-K a list of attributes of a reference file.
    a list of attributes of a reference file. It is used when the attribute names are different from those by -k.

-m reference file name
    soecify the reference file name

-u output filename
    output filename for the data unmatched to the condition specified on the other parameter

-H hashing is used for selection
    This will improve the performance if the input file is large and the reference file is small.

-i input filename
    Specify the input filename for this command. If a suffix of the filename is '.gz', the command automatically unzip it beforehand. When this parameter is omitted, standard input (usulally keyboard) is regarded as input file.

-o output filename
    Specify the output filename for this command. If a suffix of the filename is '.gz', the command automatically zip the output data. When this parameter is omitted, standard output (usulally display) is regarded as output file.

-T directory of work file
    Specify the directory name for temporal files used in this command.

OPTIONS

-r  reverse the selection condition: select the lines which do not satisfy the selection condition.

-z  compress the standard output by gz: When -o is omitted and this option is specified, the command output the result zipped.

-t  plain text: When this option is specified, the command treat the input and output data as plain text format.

EXAMPLE

 xtcommon -k customerID -m ref.xt -i dat.xt -o rsl.xt

 xtcommon -k customerID -K customer -m ref.xt -i dat.xt -o rsl.xt

SEE ALSO
xtselstr(1), xtsel(1), xtjoin(1), xtnjoin(1)

WEB PAGE
http://musashi.adm.osaka-sandai.ac.jp

BUG REPORT
musashi@adm.osaka-sandai.ac.jp

AUTHORS
Yukinobu Hamuro,Naoki Katoh,Katsutoshi Yada