HP-UX Reference (11i v1 05/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 com-
mands (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 customize logging resource
usage parameters and file names. Changes to this file should only be made using the
nettlconf com-
mand.
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 particular
needs using the nettlconf command. For the network log information changes to take effect, the sys-
tem administrator must stop and restart the network tracing/logging facility using the
nettl command.
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 com-
bined 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 extension (.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.
Section 4−−180 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005