HP-UX Reference (11i v1 05/09) - 4 File Formats (vol 8)

n
nettlgen.conf(4) nettlgen.conf(4)
If more information is desired than the special terse form used for console logging, turn off console logging
and start a formatter with an options file specifying the filters to use (see netfmt(1M)).
The Log Port Size defines the number of outstanding messages possible in the log queue. For logging,
256-byte buffers are used. The number chosen here indicates how much space to allocate in kilobytes. The
default size is 8192 bytes (specified by 8), which is split into thirty-two 256-byte blocks. The first block is
reserved by the system, leaving 31 blocks for log messages. Each log message starts on a new block, taking
64 bytes of overhead. In addition, each block takes 8 bytes of overhead. The largest message that can be
stored using the default size is 7624 bytes ((31 ∗ 256) - (31 ∗ 8) - 64). Most log network messages are fairly
small, so choosing 8K of buffer is sufficient for the network logging facility to keep up with a large volume
of messages.
The Maximum Log File Space determines the maximum logging file space to be allowed. Log files are
split into two parts. When an individual log file reaches one-half of the maximum specified here, the net-
work logging system deletes any existing old file, renames the current file to the old file, and starts a new
file. The default specification allows for 1 Megabyte of total network log file storage (each file does not
exceed 500K bytes). Since logging is usually infrequent and network log messages are fairly small, this
should be more than adequate for all needs. The rate at which the file space fills up depends on what level
of network logging is turned on for each subsystem, the volume of network traffic, frequency of connections,
etc; and is very difficult to predict.
The Console Filter File specifies the name of the file containing formatter filters used for console logging.
This file contains filters that control the logged information displayed on the console. The syntax of this file
is the same as the filter configuration files that are used with the
netfmt command. See netfmt(1M) for
more details on filter configuration files.
If the console filter file does not exist, the specified file is created with a default set of filters which will
display
DISASTER messages on the console. If the console filter file does exist and contains a time_from
filter, the time_of_day and day_of_year fields in the filter will be updated every time
nettl is started.
The Console Filter File field is optional. If omitted the default file
/var/adm/conslog.opts
will
be used.
KL Record
KL record fields are as follows:
Field
Number Name Description
1 Tag Contains KL tag string
Minimum (initial) amount of messages
that could simultaneously reside in
the memory. Valid range is 100 -
10000. The default is 1000.
2 KL Minimum (initial) Queue Size
Maximum amount of messages that
could simultaneously reside in the
memory. Valid range is 100 - 10000.
The default is 1000.
3 KL Maximum Queue Size
Determines the maximum logging file
space to be allowed. This value is the
size of the ping-ponged log file. Valid
range is 8K - 1024M. The default is
1M.
4 Maximum KL File Space
Path and name of the log file, without
the type and age extension (.KLOG0x,
where x is 0 or 1).
5 Log File Prefix
Set to 1 if writing messages to disk is
to be enabled when KL facility is
started, 0 if not.
6 Write To Disk Flag
HP-UX 11i Version 1: September 2005 − 2 − Hewlett-Packard Company Section 4−−181