NAME

dumpnet.info.conf - the host-specific dumpnet.host.info configuration file


DESCRIPTION

A dumpnet.info.conf file is used to configure the module dumpnet.host.info for a specific target host. It should be placed in a host configuration directory (a subdirectory of $DUMPNET_HOME/conf/) - see the CONFIGURATION section in dumpnet(8) for details.

The general format of this configuration file is specified in the section CONFIGURATION FILE FORMAT in dumpnet(8).

This config file primarily contains a list of commands to execute on the target host to get some information about it. If a command is prefixed by an `@' sign the command will be run locally and not on the target host. Lines starting with `#' are not part of the list. You can certainly use the ``option'' and ``extends'' statements - see the CONFIGURATION FILE FORMAT section in dumpnet(8). Options you might want to set are:

cleanup_policy
The cleanup policy to apply for the created files. Please see the CLEANUP section in dumpnet(8) for details.

dosudo
If set to ``true'' all commands will be run using sudo on the target host. The default is ``false''. The location of the sudo command can be configured using the option sudo in dumpnet.HOST.conf(8).

infoDir
The name of the sub-directory where the output files are to be stored: $backupDir/$host/$infoDir. It is recommended to go with the default configured in the default host configuration file: ``info''.

read_options
Options to be passed to the bash builtin read to read in the configuration file. In some cases you will want to use the -r option which causes the backslash not to act as an escape character. The backslash is considered to be part of the line. In particular, a backslash-newline pair may not be used as a line continuation. If read_options is not set (or set to an empty string) a backslash-newline pair can be used as a line continuation but all literal backslashes will have to be escaped.


EXAMPLES

An example file could look like this:

 # option cleanup_policy=keepFor_1_month,keepWeekly
 route -n
 df -h
 fdisk -l
 cat /etc/fstab
 ps aux
 @nmap $host


SEE ALSO

 dumpnet.host(8)
 dumpnet.host.info(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.