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

n
nettl(1M) nettl(1M)
Note: The file name prefix (logname or tracename) specified by the user must not exceed eight charac-
ters so that the file name plus suffix does not exceed fourteen characters. Longer names are trun-
cated. To see the actual name of the trace or log file, use the
nettl -status all command.
Buffer Management
NetTL stores trace messages in intermediate buffers at two levels: in kernel and in user space. Trace mes-
sage loss is minimised if a large number of trace messages (both in kernel and user space) is processed
instead of one trace message at a time. This means a kernel buffer (containing one or more trace messages)
as a whole is copied to user space buffer which in turn is written to the trace file. This imposes the follow-
ing restrictions:
1. kernel_buffersize <= user_buffersize
Note: It is most optimized if user_buffersize is a multiple of kernel_buffersize.
2. maxsize/2 = n * user_buffersize (where n = 1, 2, 3...)
Note: If the above condition is not true, maxsize is approximated to meet the same.
To further minimise trace message loss, turn on tracing with larger trace buffer configuration and for
minimum required duration. See EXAMPLES section for specific examples.
NetTL handles failure to allocate the requested buffer configuration in the following way:
a) If NetTL is unable to allocate the requested number of kernel and user space buffers, it will proceed
with tracing if it has allocated at least minimum number of buffers.
b) If (a) is not true, it will attempt to allocate default/minimum number of buffers with default buffer
size.
c) If (b) is not successful, NetTL tracing will exit.
Console Logging
Console logging is used to display significant log events on the system console. The values in the
/etc/nettlgen.conf
file determine if console logging is to be started and the entries in the
/var/adm/conslog.opts
file determine what log messages will be reported to the console. The
nettlconf command can be used to configure and maintain the information in the
/etc/nettlgen.conf
file (see nettlconf(1M)). If changes are made to these files, nettl must be
stopped and restarted for the new information to take effect.
All log messages written to the console as a result of this configuration information are in a special short
form. If more information is desired on the console, the
netfmt formatter can be used to direct output to
the console device. This may be most useful in an X windows environment.
Console logging may be disabled if conservation of system resources is valued more than notification of log
events.
EXTERNAL INFLUENCES
International Code Set Support
Single- and multibyte character code sets are supported in data; single-byte character code sets are sup-
ported in file names.
EXAMPLES
1. Initialize the tracing/logging facility:
nettl -start
(See note for the -start option.)
2. Display the status of the tracing/logging facility.
nettl -status all
3. Change log class to error and warning for all the subsystems. disaster logging is always on
for all subsystems.
nettl -log e w -e all
4. Turn on inbound and outbound PDU tracing for the transport and session (OTS/9000) subsys-
tems and send binary trace messages to file /var/adm/trace.TRC000.
Section 1M−−572 Hewlett-Packard Company − 6 − HP-UX 11i Version 1: September 2005