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

n
nettl(1M) nettl(1M)
-nubufs to configure the trace buffers in user space.
-status log
-status trace
-status
[all]
(Abbr.: -ss) Used alone without other options.
Report the tracing and logging facility status. The facility must be operational, that is,
nettl -start has been completed. The additional options define the type of trace or
log information that is to be displayed. The default value is
all.
log Log status information
trace Trace status information
all Trace and log status information
-tracemax maxsize
(Abbr.: -tm) Used with first
-traceon option only.
Tracing uses a circular file method such that when one file fills up, another file is used. The
number of trace files that can exist on a system at any given time can be specified using the
-n option. See "Data File Management" below for more information on file behavior.
maxsize specifies the maximum size in kilobytes (KB) of any two trace files combined.
Therefore, the maximum size of each trace file will be approximately half of maxsize kilo-
bytes (KB). The default value for the combined file sizes is 1024 KB. The possible range for
maxsize is 128 to 1048576.
Note: The maximum size of each trace file (about maxsize/2) should be a multiple of
user_buffersize and if it is not, it will be approximated to the closest multiple of
user_buffersize. See Buffer Management below for more information.
-n num_files Used with first -traceon option only.
Specifies the number of trace files that can exist on a system at any given time. However,
nettl can reduce the number of trace files depending on the available disk space. If the
option is not specified, the default value is two trace files.
-traceoff (Abbr.: -tf) Requires the -entity option.
Disable tracing of subsystems specified by the -entity option. If all is specified as an
argument to the
-entity option, all tracing is disabled. The trace file remains, and can
be formatted by using the netfmt command to view the trace messages it contains (see
netfmt(1M)).
-traceon all
-traceon
kind ...
(Abbr.: -tn) Requires the -entity option. The -card option is required for X.25 sub-
systems. Other options are not required.
Start tracing on the specified subsystems. The tracing and logging facility must have been
initialized by nettl -start for this command to have any effect. The default trace file
is standard output; it can be overridden by the -file option. If standard output is a ter-
minal device, then an informative message is displayed and no trace data is produced.
When tracing is enabled, every operation through the subsystems is recorded if the kind
mask is matched.
kind defines the trace masks used by the tracing facility before recording a message. If
-traceon all is specified, all trace masks are enabled. kind can be entered as one or
several of the following keywords or masks:
Section 1M−−570 Hewlett-Packard Company − 4 − HP-UX 11i Version 1: September 2005