nettlgen.co.4 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nettlgen.conf(4) nettlgen.conf(4)

NAME

nettlgen.conf - network tracing and logging conﬁguration ﬁle

SYNOPSIS

/etc/nettlgen.conf

DESCRIPTION

/etc/nettlgen.conf

, the conﬁguration ﬁle for Common Network Tracing and Logging commands

commands, contains conﬁguration information used by the

nettl, and netfmt commands (see

nettl (1M), and netfmt (1M)). The

nettlconf command (see nettlconf (1M)) maintains network log and

subsystem data in this ﬁle, allowing subsystems to safely add, modify, or delete existing entries in the ﬁle.

nettlconf also allows system administrators to customize logging resource usage parameters and ﬁle

names. Changes to this ﬁle should only be made using the

nettlconf command.

The ﬁle is composed of records containing ﬁelds which are separated by colons (

:). Each line is a unique

record containing either global network information or subsystem information. The ﬁrst ﬁeld in each

record is the tag ﬁeld which identiﬁes the type of information contained in that record. A

LOG tag

identiﬁes global network log information; a

SS tag identiﬁes subsystem information. Blank lines or lines

beginning with

# are ignored.

Log Record

The log record deﬁnes static information used to conﬁgure logging defaults such as the name of the log

ﬁle and whether to turn console logging on or off. Note that only the last log record encountered in the

ﬁle 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 ﬁelds 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. Speciﬁed in Kbyte

units. Valid range is 1 - 32. The default is

3 Log Port Size

Determines the maximum logging ﬁle

space to be allowed. Speciﬁed in Kbyte

units. This value is the combined size of

the 2 ping-ponged log ﬁles. Valid range is

1 - 10240. The default is 1000.

4 Maximum Log File Space

Path and name of the log ﬁle, without the

type and age extension (.LOG0x, where x

is 0 or 1).

5 Log File preﬁx

Name of ﬁlter conﬁguration ﬁle 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 speciﬁed in the ﬁle 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 reﬂect the value of the NETTL_CONSOLE vari-

able in the /etc/rc.config.d/nettl ﬁle.

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 ﬁle specifying the ﬁlters to use (see netfmt (1M)).

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (4 pages)

PAGE 1
nettlgen.conf(4) nettlgen.conf(4) NAME nettlgen.conf - network tracing and logging configuration file SYNOPSIS /etc/nettlgen.conf DESCRIPTION /etc/nettlgen.conf, the configuration file for Common Network Tracing and Logging commands commands, contains configuration information used by the nettl, and netfmt commands (see nettl (1M), and netfmt (1M)).
PAGE 2
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.
PAGE 3
nettlgen.conf(4) nettlgen.conf(4) 6 Subformatter Shared Library Name of the shared library file containing the subformatter functions listed below. 7 Subformatter Message Catalog Basename of the message catalog to use when formatting data for this subsystem. 8 Subformatter Function C function in the subformatter library to call when formatting data for this subsystem. 9 Subformatter Options C function in the subformatter library to call to get filter options for this subsystem.
PAGE 4
nettlgen.conf(4) nettlgen.conf(4) The following entry must always be included in the configuration file. This defines the subsystem for the formatter itself; if it is not in the file, the formatter netfmt will not operate properly. # # FORMATTER SUBSYSTEMS # SS:127:FORMATTER:12:u:libfmtutil.sl:netfmt: \ subsys_GENERIC_format:subsys_127_get_options:FORMATTER FILES /etc/nettlgen.conf SEE ALSO netfmt(1M), nettl(1M), nettlconf(1M).