=pod

=head1 NAME

B<rwsetunion> - Merge the union of multiple IPset files into a single file

=head1 SYNOPSIS

  rwsetunion [--compression-method=COMP_METHOD] IPSET_OUT
        IPSET_IN1 [[IPSET_IN2] ...]


=head1 DESCRIPTION 

B<rwsetunion> takes multiple binary IPset files and performs the union
operation, writing the union of the contents of these files to the
specified output file.

B<rwsetunion> requires at leasts file arguments; it will exit with an
error if it does not receive at least two arguments.  Note the name of
the output file I<precedes> the name of the input file(s).

For the output, B<rwsetunion> accepts C<stdout> to write the binary
IPset to the standard output; likewise, C<stdin> used as an input name
cause B<rwsetunion> to read the binary IPset from the standard input.
B<rwsetunion> will write an error message and fail when reading or
writing a binary IPset on a terminal.


=head1 OPTIONS

Option names may be abbreviated if the abbreviation is unique or is an
exact match for an option.  A parameter to an option may be specified
as B<--arg>=I<param> or B<--arg> I<param>, though the first form is
required for options that take optional parameters.

=over 4

=item B<--compression-method>=I<COMP_METHOD>

Set the compression method of the output to I<COMP_METHOD>.  Some SiLK
tools can use an external library to compress their binary output.
The list of available compression methods and the default method are
set when SiLK is compiled (the B<--help> and B<--version> switches
print the available and default compression methods) and depend on
which supported libraries are found.  SiLK can support:

=over 4

=item none

Do not compress the output using an external library

=item zlib

Use the B<zlib(3)> library for compressing the output

=item lzo1x

Use the I<lzo1x> algorithm from the LZO real time compression library
for compression

=item best

Use whichever available method gives the C<best> compression in
general, though not necessarily the C<best> for this particular
output.

=back

=back


=head1 NOTES

B<rwsettool> supersedes B<rwsetunion>.


=head1 SEE ALSO

B<rwsettool(1)>, B<rwset(1)>, B<rwsetbuild(1)>, B<rwsetcat(1)>

=cut

$SiLK: rwsetunion.pod 6651 2007-03-14 13:03:31Z mthomas $

Local Variables:
mode:text
indent-tabs-mode:nil
End: