HP-UX Reference (11i v2 03/08) - 1M System Administration Commands N-Z (vol 4)

n
nettl(1M) nettl(1M)
automatically adjusted to meet the requirement and
nettl -status can be used to
see the actual trace file used. See Trace Memory Management 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 subsystem s 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 subsystems.
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 out-
put is a terminal 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:
keyword mask keyword mask
hdrin 0x80000000 state 0x04000000
hdrout 0x40000000 error 0x02000000
pduin 0x20000000 logging 0x01000000
pduout 0x10000000 loopback 0x00800000
proc 0x08000000
hdrin Inbound Protocol Header.
hdrout Outbound Protocol Header.
pduin Inbound Protocol Data Unit (including header and data).
pduout Outbound Protocol Data Unit (including header and data).
proc Procedure entry and exit.
state Protocol or connection states.
error Invalid events or condition.
logging Special kind of trace that contains a log message.
loopback Packets whose source and destination system is the same.
For multiple kinds, the masks can be specified separately or combined into a single
number. For example, to enable both
pduin and pduout (to trace all packets coming
into and out of the node) use either pduin pduout or 0x10000000 0x20000000
or the combination 0x30000000.
Not all subsystems support all trace kinds. No error is returned if a given subsystem
does not support a particular trace kind.
If a
-traceon is issued on a subsystem that is already being traced, the tracing mask
and optional values are changed to those specified by the new command, but the new
Section 1M−−518 Hewlett-Packard Company − 5 − HP-UX 11i Version 2: August 2003