HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

n
nettlconf(1M) nettlconf(1M)
NAME
nettlconf - configure network tracing and logging command subsystem database
SYNOPSIS
/usr/sbin/nettlconf
[ -KL ] -status
/usr/sbin/nettlconf -L
[ -console conlog ][
-portsize logportsize ]
[
-space maxlogspace ][-filename
logfilename ][-option logoptfile ]
/usr/sbin/nettlconf
[ -KL ][-qmin
minimumklqueuesize ]
[
-qmax maximumklqueuesize ][
-space
maxlogspace ]
[
-filename logfilename ][
-write writelog ]
/usr/sbin/nettlconf
[ -S ] -id ssid
-name ssname [ -class
logclass ]
[
-kernel|-st[reams]
] -lib sslib
-msg ssmsgcat [ -fmtfn
fmtfunc ]
[
-optfn optfunc ] -group ssgrpname
/usr/sbin/nettlconf -delete
ssid
DESCRIPTION
nettlconf maintains the database file /etc/nettlgen.conf
which contains information required
by the
nettl, kl, and
netfmt commands (see nettl (1M),kl(1M), and netfmt(1M)). This database con-
tains system logging information along with a description of each subsystem that uses either NetTL or KL
facility to log messages.
nettlconf can be used to update the network or kernel logging parameters or to add, update and
delete subsystem descriptions. If a subsystem already exists with the same ssid, the values given are
substituted for those in the database; otherwise a new entry is created.
System administrators may use the
nettlconf command to customize the network or kernel logging
parameters stored in the database such as console logging behavior, the system log file name, the max-
imum system log file size, and the amount of memory required by NetTL and KL facilities.
nettlconf is also called during system startup to change the database to reflect the values of any
relevant environment variables in the /etc/rc.config.d/nettl
file.
Products use the
nettlconf command during product installation to configure subsystems into the
NetTL and KL facilities. The installation will execute the nettlconf command for each subsystem it
installs in order to provide the information necessary for the subsystem to use the NetTL and KL facili-
ties.
Only users with appropriate privileges can invoke
nettlconf to modify the configuration file.
Options
The following options can be used to view the network or kernel logging parameters and all subsystem
descriptions from the
nettlgen.conf database.
-status (abbrev: -s) display the contents of the database relevant to the network logging
facility only.
-KL -status display the contents of the database relevant to the kernel logging facility only.
The following options can be used to update configuration information about network logging.
-L This indicates that subsequent options apply to updating network logging informa-
tion. Changes to logging information will not take effect until nettl has been
stopped and restarted. This is a required field.
-console conlog (abbrev: -c) conlog is set to 1 if console logging is to be enabled when nettl is
started, 0 if not. (Console logging is used to report interesting events on the system
console.) This is an optional field.
NOTE: during system startup conlog will be changed to match the value of the
NETTL_CONSOLE variable in the
/etc/rc.config.d/nettl file.
-portsize logportsize
(abbrev: -p) logportsize determines the number of outstanding messages possible
in the log queue. The value is in multiples of 1024 bytes. Valid range is 1 through
64. The default is 8. This is an optional field.
Section 1M−−524 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003