NAME

nettlconf − configure network tracing and logging command subsystem database

SYNOPSIS

nettlconf [−fmtfn fmtfunc] [−optfn optfunc] [−class logclass] −id ssid −name ssname −group ssgrpname −lib sslib −msg ssmsgcat

nettlconf −delete ssid

DESCRIPTION

nettlconf maintains the database file /etc/conf/nettlgen.conf which contains information necessary for each subsystem that uses network tracing and logging.  This database contains one entry for each subsystem.  If a subsystem already exists with the same ID, the values given are substituted for those in the database; otherwise a new entry is created.  The first form of the command shown above adds or updates a new subsystem to the database.  The second form, /etc/conf/nettlconf −d ssid, removes a subsystem entry from the database.

nettlconf and nettlgen(1M) are used primarily during product installation or product update. The nettlconf command should be executed from within the customize script at the end of an install or update.  The customize script should execute the nettlconf command for each subsystem it installs.  After all subsystems are entered in the /etc/conf/nettlgen.conf database via nettlconf, the nettlgen(1M) command is executed to build the /etc/netfmt and /etc/nettl commands, integrating the newly added subsystems. 

Options

−fmtfn fmtfunc:
(abbrev: −f) fmtfunc specifies the function to call when formatting data from the given subsystem.  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 /etc/netfmt configuration file.  The default is an empty field in nettlgen.conf.  nettlgen enters a NULL function for an empty optfunc field.  This is an optional field. 

−class logclass:
(abbrev: −c) logclass is the default log class assigned to the subsystem at start-up of the tracing/logging facility.  Default is an empty field in nettlgen.conf.  nettlgen substitutes 8 (disaster) for an empty class field.  This is an optional field. 

−id ssid:
(abbrev: −i) ssid (subsystem ID number) is used as the key field in the nettlgen.conf database.  This is a required field. 

−name ssname:
(abbrev: −n) ssname is the subsystem-name mnemonic.  This string is used to identify the subsystem on the nettl command line and also in the header output from the formatter.  This is a required field. 

−group ssgrpname:
(abbrev: −g) ssgrpname is a group name associated with the subsystem.  Several subsystems can be grouped together so that a common banner is printed in the formatted header.  This is a required field. 

−lib sslib:
(abbrev: −l) sslib is the name of a 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) msg is the name of the message catalog excluding the pathname or .cat filename extension.  Multiple subsystems can refer to the same message catalog.  This is a required field. 

−delete ssid:
(abbrev: −d) Deletes the ssid (subsystem ID) from the database. 

CAVEATS

The nettlconf utility is intended primarily for use by HP subsystems to configure themselves into the tracing and logging facility at installation time.  System administrators 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.  Only an editor such as vi(1) should be used to change the default logging information kept in the /etc/conf/nettlgen.conf file. 

AUTHOR

nettlconf was developed by HP. 

FILES

/etc/conf/nettlgen.conf configuration file maintained by nettlconf

SEE ALSO

netfmt(1M), nettl(1M), nettlgen(1M), nettlgen.conf(4). 

Hewlett-Packard Company  —  HP-UX Release 8.05: June 1991