HP-UX Reference (11i v2 04/09) - 4 File Formats (vol 8)
n
nettlgen.conf(4) nettlgen.conf(4)
NAME
nettlgen.conf - network tracing/logging and kernel logging configuration file
SYNOPSIS
/etc/nettlgen.conf
DESCRIPTION
/etc/nettlgen.conf
, the configuration file for Common Network Tracing/Logging and Kernel Log-
ging commands commands, contains configuration information used by the
nettl, kl, and netfmt
commands (see nettl (1M),kl(1M), and netfmt(1M)). The
nettlconf command (see nettlconf (1M))
maintains network and kernel log and subsystem data in this file, allowing subsystems to safely add,
modify, or delete existing entries in the file.
nettlconf also allows system administrators to custom-
ize logging resource usage parameters and file names. Changes to this file should only be made using the
nettlconf command.
The file is composed of records containing fields which are separated by colons (
:). Each line is a unique
record containing either global network or kernel logging information or subsystem information. The first
field in each record is the tag field which identifies the type of information contained in that record. A
LOG tag identifies global network log information; a
KL tag identifies global kernel log information; a SS
tag identifies subsystem information. Blank lines or lines beginning with
# are ignored.
Log Record
The log record defines static information used to configure logging defaults such as the name of the log
file and whether to turn console logging on or off. Note that only the last log record encountered in the
file is used; prior log records are ignored. Users can alter the network log information to suit their partic-
ular needs using the
nettlconf command. For the network log information changes to take effect, the
system administrator must stop and restart the network tracing/logging facility using the
nettl com-
mand.
Log record fields are as follows:
Field
Number Name Description
1 tag Contains LOG tag string.
Set to 1 if console logging is to be
enabled, 0 if not.
2 Console Logging Flag
Amount of memory to reserve for
internal log message buffers.
Specified in Kbyte units. Valid
range is 1 - 32. The default is 8.
3 Log Port Size
Determines the maximum logging
file space to be allowed. Specified
in Kbyte units. This value is the
combined size of the 2 ping-
ponged log files. Valid range is 1 -
10240. The default is 1000.
4 Maximum Log File Space
Path and name of the log file,
without the type and age exten-
sion (.LOG0x, where x is 0 or 1).
5 Log File prefix
Name of filter configuration file
used for console logging.
6 Console Filter File
The Console Logging Flag determines if console logging is to be enabled when the network
tracing/logging facility is started. Console logging is used to display log messages on the system console
using criteria specified in the file named by Console Filter File. If there is no console present or console
logging is not desired this feature can be turned off using the
nettlconf command. During system
bootup, the Console Logging Flag is always updated to reflect the value of the NETTL_CONSOLE vari-
able in the /etc/rc.config.d/nettl file.
HP-UX 11i Version 2: September 2004 − 1 − Hewlett-Packard Company Section 4−−209