HP-UX Reference (11i v3 07/02) - 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 -L
[ -console conlog ][
-portsize logportsize ]
[
-space maxlogspace ][-filename
logfilename ][-option logoptfile ]
/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, and netfmt commands (see nettl(1M), and netfmt(1M)). This database contains system
logging information along with a description of each subsystem that uses NetTL facility to log messages.
nettlconf can be used to update the network logging parameters or to add, update and delete subsys-
tem 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 logging parameters
stored in the database such as console logging behavior, the system log file name, the maximum system log
file size, and the amount of memory required by NetTL facility.
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 facility. 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 facility.
Only users with appropriate privileges can invoke nettlconf to modify the configuration file.
Options
The following option can be used to view the network 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.
The following options can be used to update configuration information
about network logging.
-L This indicates that subsequent options apply to updating network logging information.
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 eld.
-space maxlogspace
(abbrev: -s) maxlogspace is the maximum logging le space to be allowed. This is
the combined size of the 2 ping-ponged log files. Specify the size in multiples of 1024
bytes. Valid range is 1 through 10240. Default is 1000. This is an optional field.
-filename logfilename
(abbrev: -f) logfilename is the path and file name to be used as the system log file,
without the ping-pong extension (.LOGx). The default system log file is
/var/adm/nettl. This is an optional field.
HP-UX 11i Version 3: February 2007 1 Hewlett-Packard Company 61