HP-UX Reference (11i v1 05/09) - 1M System Administration Commands N-Z (vol 4)

n
nettlconf(1M) nettlconf(1M)
-class logclass (abbrev: -c) logclass is the default log class mask assigned to the subsystem at
start-up of NetTL or KL facility. This is an optional field.
There is an important difference between the interpretation of the logclass by NetTL
and KL facilities.
Interpretation By NetTL
For multiple classes, the masks must be combined into a single decimal number. For
example, to initially log DISASTER and ERROR
events use 12 as the logclass.
Default is an empty field in
nettlgen.conf
. nettl substitutes 12 (disaster
and error) for an empty class field.
Interpretation By KL
For KL, the following rule applies for the messages to log: if level x is specified then
all messages whose severity is greater or equal to the severity of class x will be logged.
For example, if the logclass is 2, all warning, error and disaster messages will be
logged by KL. Default is an empty field in
nettlgen.conf.
kl substitutes 8
(disaster) for an empty class field.
Class Abbreviation
informative 1
warning 2
error 4
disaster 8
-kernel (abbrev: -k) flags the given subsystem as a kernel subsystem. nettl
uses this
information to control certain tracing and logging properties of the subsystem. If a
subsystem is serviced by NetTL facility, then it is defaulted to non-kernel unless this
option is specified, whereas any subsystem serviced by KL facility is defaulted as a
kernel unless otherwise specified. This is an optional field.
-streams (abbrev: -st) flags the given subsystem as a streams based kernel subsystem.
nettl uses this information to control certain tracing and logging properties of the
subsystem. A subsystem is defaulted to non-kernel unless this option is used. This is
an optional field.
-lib sslib (abbrev: -l) sslib is the name of the shared library where the subsystem formatter
resides. This should be an absolute path name unless the library resides in
/usr/lib. Multiple subsystems can reference the same library. This is a required
field.
-msg ssmsgcat (abbrev: -m) ssmsgcat is the name of the subsystem formatter message catalog. If
the pathname and .cat filename extension are excluded, /usr/lib/nls/%L/%N.cat
is used to locate ssmsgcat. Otherwise, ssmsgcat must be formatted similarly to the
NLSPATH environment variable (see environ(5)). Multiple subsystems can refer to
the same message catalog. This is a required field.
-fmtfn fmtfunc (abbrev: -f) fmtfunc specifies the function to call when formatting data from the
given subsystem. Multiple subsystems can reference the same formatting function.
Default is to form the function name from the subsystem ID as follows:
subsys_N_format
where N is the subsystem ID number. If a null function is needed for this subsystem,
specify
-f NULL
This is an optional field.
-optfn optfunc (abbrev: -o) optfunc specifies the function used to process options in the netfmt
filter configuration file (see netfmt(1M)). Multiple subsystems can reference the same
options processing function. The default is an empty field in nettlgen.conf.
netfmt assumes a NULL function for an empty optfunc field. This is an optional
field.
-group ssgrpname
(abbrev: -g) ssgrpname is a group name associated with the subsystem. It is
HP-UX 11i Version 1: September 2005 − 3 − Hewlett-Packard Company Section 1M−−579