nettlconf(1M)nettlconf(1M)NAMEnettlconf - configure network tracing and logging command subsystem
database
SYNOPSIS
conlog] logportsize]
maxlogspace] logfilename] logoptfile]
logclass]
fmtfunc]
optfunc]
ssid
DESCRIPTION
maintains the database file which contains information required by the
and 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.
can be used to update the network 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 data‐
base; otherwise a new entry is created.
System administrators may use the command to customize the network log‐
ging parameters stored in the database such as console logging behav‐
ior, the system log file name, the maximum system log file size, and
the amount of memory required by NetTL facility.
is also called during system startup to change the database to reflect
the values of any relevant environment variables in the file.
Products use the command during product installation to configure sub‐
systems into the NetTL facility. The installation will execute the
command for each subsystem it installs in order to provide the informa‐
tion necessary for the subsystem to use the NetTL facility.
Only users with appropriate privileges can invoke to modify the config‐
uration file.
Options
The following option can be used to view the network logging parameters
and all subsystem descriptions from the database.
(abbrev: 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.
This indicates that subsequent options apply to updating network log‐
ging
information. Changes to logging information will
not take effect until has been stopped and
restarted. This is a required field.
(abbrev: conlog is set to 1 if console logging is to be
enabled when is started, 0 if not. (Console log‐
ging 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 file.
(abbrev: 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.
(abbrev: maxlogspace is the maximum logging file 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.
(abbrev: logfilename is the path and file name to be used as
the system log file, without the ping-pong exten‐
sion (.LOGx). The default system log file is This
is an optional field.
(abbrev: logoptfile is the path and file name to be used as
the console log options file. The information in
this file will be used to select logged events that
will be reported to the system console. The
default console logging options file is This is an
optional field.
The following options are used to add or update a subsystem description
to the database.
Indicates that subsequent options apply to adding or updating a
subsystem entry. This is an optional field.
(abbrev: ssid (subsystem ID number) is used as the key field
in the database. It uniquely identifies a subsys‐
tem to the NetTL facility. This is a required
field.
(abbrev: ssname is the subsystem-name mnemonic. This string
is used to identify the subsystem on the command
lines and also in the subsystem header displayed by
the formatter (see nettl(1M), and netfmt(1M)).
This is a required field.
(abbrev: logclass is the default log class mask assigned to
the subsystem at start-up of NetTL facility. This
is an optional field.
For multiple classes, the masks must be combined
into a single decimal number. For example, to ini‐
tially log and events use as the logclass. Default
is an empty field in substitutes (disaster and
error) for an empty class field.
Class Abbreviation
─────────────────────────────
informative 1
warning 2
error 4
disaster 8
(abbrev: flags the given subsystem as a kernel subsystem.
uses this information to control certain tracing
and logging properties of the subsystem. This is
defaulted to non-kernel unless this option is spec‐
ified.
(abbrev: flags the given subsystem as a streams based kernel
subsystem. uses this information to control cer‐
tain tracing and logging properties of the subsys‐
tem. A subsystem is defaulted to non-kernel unless
this option is used. This is an optional field.
(abbrev: 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
Multiple subsystems can reference the same library.
This is a required field.
(abbrev: ssmsgcat is the name of the subsystem formatter
message catalog. If the pathname and filename
extension are excluded, /usr/lib/nls/%L/%N.cat is
used to locate ssmsgcat. Otherwise, ssmsgcat must
be formatted similarly to the environment variable
(see environ(5)). Multiple subsystems can refer to
the same message catalog. This is a required
field.
(abbrev: fmtfunc specifies the function to call when format‐
ting data from the given subsystem. Multiple sub‐
systems can reference the same formatting function.
Default is to form the function name from the sub‐
system ID as follows:
where N is the subsystem ID number. If a null
function is needed for this subsystem, specify
This is an optional field.
(abbrev: optfunc specifies the function used to process
options in the filter configuration file (see
netfmt(1M)). Multiple subsystems can reference the
same options processing function. The default is
an empty field in assumes a NULL function for an
empty optfunc field. This is an optional field.
(abbrev: ssgrpname is a group name associated with the sub‐
system. It is typically the product name of the
subsystem. Several subsystems can be grouped
together so that a common banner is printed in the
formatted header. This is a required field.
The following option is used to remove a subsystem description from the
database.
(abbrev: Deletes all information associated with the ssid
(subsystem ID) from the database.
WARNINGS
The utility is intended primarily for use by HP subsystems to configure
themselves into the NetTL facility at installation time. System admin‐
istrators may wish to use this command to alter the default logging
class each subsystem starts up with, but no other information about the
subsystem should be changed.
The and commands read the file each time they are executed. If the
file becomes corrupted these commands cannot function.
Some changes to the file do not take effect until and are stopped and
restarted.
AUTHOR
was developed by HP.
FILES
subsystem configuration file maintained by
configuration file controlling during system startup
SEE ALSOnetfmt(1M), nettl(1M), nettlgen.conf(4), environ(5).
nettlconf(1M)