NAME

dumpnet.host.diff - run userdefined commands and compare their old to their new output

SYNOPSIS

dumpnet.host.diff [-s SESSIONID] [-d DUMPNET_CONFIG] [-C DIFF_CONFIG] HOST_CONFIG

DESCRIPTION

dumpnet.host.diff runs the commands specified in the configuration file dumpnet.diff.conf placed in a host configuration directory. For each command it will call dumpnet.host.diff.cmd to do most of the job. dumpnet.host.diff gives you the ability to track runtime configuration changes. An error will be reported if a previously recorded run time configuration does not match the new one. The autoritive file is the last one not postfixed by ``_MODIFIED''. The commands can be run on the target host (default) or locally on the dumpnet host. Please see dumpnet.diff.conf(8) for details.

OPTIONS

-s SESSIONID

Set sessionId to SESSIONID. If you don't know if you need this option, you don't! Read the SESSIONID section in dumpnet(8) before using it!

-d DUMPNET_CONFIG

Use DUMPNET_CONFIG instead of the default $DUMPNET_HOME/conf/dumpnet.conf.

-C DIFF_CONFIG

Use DIFF_CONFIG as the configuration file (the default is ``dumpnet.diff.conf''). DIFF_CONFIG can be the path to the configuration file or `-' to read the configuration from STDIN.

HOST_CONFIG

The host configuration file. For the target host 192.168.1.10 it could be conf/192.168.1.10/dumpnet.HOST.conf.

EXAMPLES

Run the commands for 192.168.1.10 configured in /usr/local/dumpnet/conf/192.168.1.10/dumpnet.HOST.conf with the default config file dumpnet.diff.conf - if you don't know what you want, you want something like this:

        dumpnet.host.diff /usr/local/dumpnet/conf/192.168.1.10/dumpnet.HOST.conf

Run the commands for 192.168.1.11 configured in conf/192.168.1.11/dumpnet.HOST.conf with a config of conf/192.168.1.11/dumpnet.diff2.conf

        dumpnet.host.diff -C conf/192.168.1.11/dumpnet.diff2.conf conf/192.168.1.11/dumpnet.HOST.conf

Run only the route command, that is configured in conf/192.168.1.11/dumpnet.diff.conf. Keep in mind that this way, none of the ``option'' and ``extends'' statements in dumpnet.diff.conf will make it to the STDIN of dumpnet.host.diff.

        grep route conf/192.168.1.11/dumpnet.diff.conf | dumpnet.host.diff -C - conf/192.168.1.11/dumpnet.HOST.conf

EXIT STATUS

dumpnet.host.diff will return a zero exit status if all calls to dumpnet.host.diff.cmd exit with 0. In any other case it will return 1.

FILES

 $DUMPNET_HOME/conf/$host/dumpnet.diff.conf

SEE ALSO

 dumpnet(8)
 dumpnet.host(8)
 dumpnet.host.diff.cmd(8)
 dumpnet.diff.conf(8)

AUTHOR

 Lukas Feiler <lukas.feiler@lukasfeiler.com>

COPYRIGHT AND LICENSE

dumpnet is published under the LGPL (GNU LESSER GENERAL PUBLIC LICENSE). Please see the LICENSE file contained in the installation tarball for details. The official web site is http://dumpnet.sourceforge.net.