tntnet.properties - configuration-file for tntnet (8)
tntnet(8) uses cxxtools for logging and is configured in the configuration-file
Because cxxtools is a meta-logging-library, which can be compiled to use
different logging-libraries, the content of tntnet.properties
dependend of the underlying logging-library. Cxxtool has a built-in
logging-library as default, which is documented here.
The format of tntnet.properties is line-based. A line consists of a
variable-name followed by a equals-symbol and a value. Lines, which does not
follow this format and lines, which start with a hash (#), are ignored. It is
recomended to prefix non-empty comments with a hash to make clear, that it is
The logging-library has 5 levels for logging: fatal
has the highers
priority and "debug" the lowest.
Each log-message has a category. Categories are hierarchical. Names of
subcategories are devided by a dot.
Each log-message has a level and a category. If the level of the message is
higher or equal to the level of the category, the message is logged. To assign
a level to a category put a line with the word "logger", a dot, the
category, the symbol "=" and the category into tntnet.properties.
Only the first letter of the value is checked and case is ignored, so e.g.
info can be specified with INFO
. If no level is specified for the current category, the upper
category is checked. If nothing is found, the default level is used. The
default level is specified by the variable " rootLogger
is specified, the level error is used.
If nothing else is specified, log-messages are printed to standard-output. To
redirect output to a file, specify the filename with the variable file
The cxxtools-logger can limit the size of the log-file by rolling log-files. If
the limit is reached, the current file is renamed by appending ".1"
to it. If there is already a file with that name, this file is renamed to
"*.2" and so on, until the maximum backupfile limit is reached. The
oldest file is deleted then. To specify the maximum file size, set the
. The value specified here can be postfixed with
'k' or 'M' to specify kBytes or MBytes. The maximum fileindex backed up is set
Log-messages can be sent to another host in the network with udp. This is done
by specifying a hostname and a port with the variable host
. The value
must be a hostname, followed by a ':' and a port. Each log-message is sent in
a single udp-message.
This manual page was written by Tommi Mäkitalo <firstname.lastname@example.org>.