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

n
nettl(1M) nettl(1M)
Note: kernel_buffersize should be less than or equal to user_buffersize. Also, the maximum
size of a trace message is limited by kernel_buffersize. See Buffer Management below for
more information on this option.
-usize user_buffersize
(Abbr.: -us) Used with the first
-traceon option only.
Set the size in kilobytes (KB) of the trace buffer used to hold trace messages in user space
(shared memory) until they are written to the file. The default size of this buffer is 128 KB.
The possible range for user_buffersize is 32 to 524288. Setting this value too low increases
the possibility of dropped trace messages from fast subsytems.
Note: user_buffersize should be greater than or equal to kernel_buffersize. See Buffer
Management below for more information on this option.
-log class ... (Abbr.:
-l) Requires the -entity option.
Control the class of log messages that are enabled for the subsystems specified by the
-entity option.
class specifies the logging class. Available classes are:
Full Abbr. Mask
informative i 1
warning w 2
error e 4
disaster d 8
informative Describes routine operations and current system values.
warning Indicates abnormal events possibly caused by subsystem prob-
lems.
error Signals an event or condition which was not affecting the overall
subsystem or network operation, but may have caused an appli-
cation program to fail.
disaster Signals an event or condition which did affect the overall subsys-
tem or network operation, caused several programs to fail or the
entire node to shut down.
Classes can be specified as keywords or as a single numeric mask depicting which classes to
log. The mask is formed by adding the individual masks of the log classes. If you choose to
indicate several classes at once, be sure to separate each log class with a space.
disaster logging is always on. The default logging classes for each subsystem are
configured into the configuration file, /etc/nettlgen.conf
. When the tracing/logging
facility is started, the information in the configuration file is read and subsystems are
enabled for logging with the specified classes. To change the log class, use the
"
nettl -log class -entity subsystem" command with a new log class value. If
desired, the command can be run for different log classes and different entities.
-m bytes Specify the number of bytes (bytes) of each trace record to trace. This option allows you to
specify the number of bytes to be captured in the trace packet. You may prefer not to cap-
ture an entire PDU trace, such as when the you are only interested in the header.
The maximum value for bytes is 2000. By default, the entire packet is traced. A value of 0
will also cause the entire packet to be traced. This option currently applies only to kernel
subsystems.
-size portsize
(Abbr.: -s) Used with first -traceon option only.
Set the size in kilobytes (KB) of the trace buffer used to hold trace messages until they are
written to the file. The default size for this buffer is 68 KB. The possible range for portsize
is 1 to 1024. Setting this value too low increases the possibility of dropped trace messages
from fast subsystems.
Note: This option is being maintained for backward compatibility. It is currently ignored
and will be obsoleted in the next major release. Instead, use the options -usize and
HP-UX 11i Version 1: September 2005 − 3 − Hewlett-Packard Company Section 1M−−569