nettlgen.co.4 (2010 09)

n
nettlgen.conf(4) nettlgen.conf(4)
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 mes-
sage 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 con-
nections, etc; and is very difficult to predict.
The Console Filter File specifies the name of the file containing formatter filters used for console log-
ging. 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.
Subsystem Record
The subsystem record defines the information for that subsystem, and has ten fields including the tag
field. The fields are separated by colons (
: ); thus no field can contain a colon. An empty field can be
represented by the string NULL. NOTE: the information in the subsystem records should only be changed
by the subsystem using the nettlconf command during system installation. Users should not change
this information unless directed by a Hewlett-Packard support representative.
Subsystem record fields are as follows:
Field
Number Name Description
1 tag Contains SS tag string.
Network tracing/logging facility supports
subsystems in the range 0 - 511. This
number is set by the HP factory and must
not be changed.
2 Subsystem ID
A text string consisting of letters,
numbers, and the underscore character.
The string is set at the factory and must
not be changed.
3 Subsystem Mnemonic
Logging level for the subsystem when the
network tracing and logging facility is ini-
tialized.
4 Initial Log Level
Set to s if the subsystem is streams based
and exists in the kernel, k if the subsys-
tem exists in the kernel and non-streams
based, u if neither.
5 Subsystem Type
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010