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

n
nettl(1M) nettl(1M)
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 are 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 -file
,
-size, and -tracemax options are ignored and a message is issued.
If -entity all is specified, all recognized subsystems are traced except X.25-specific
subsystems. To turn on tracing for X.25, use the command
nettl -traceon kind -e x.25_subsys -card dev_name
where the value of x.25_subsys is SX25L2 or SX25L3.
-nkbufs num_kernelbuffers
(Abbr.: -nk) Used with first -traceon option only.
Set the number of trace buffers used to hold trace messages in kernel space until they are
read by NetTL’s user space daemon. The default number of buffers is 2. The possible range
for num_kernelbuffers is 2 to 256. See Buffer Management below for more information on
this option.
-nubufs num_userbuffers
(Abbr.: -nu) Used with first -traceon option only.
Set the number of trace buffers used to hold trace messages in user space (shared memory)
until they are written to the file. The default number of buffers is 2. The possible range for
num_userbuffers is 2 to 256. See Buffer Management below for more information on this
option.
Data File Management
Data files created by the tracing and logging facility require special handling by the facility that you must
be aware of. When files are created, they have the suffix .LOG000 or .TRC000 appended to them,
depending on whether they are log or trace files, respectively. This scheme is used to keep the files distinct
for cases where you specify the same name in both places. Also, the files implement a type of circular
buffer, with new data always going into the file appended with .LOG000 or .TRC000. When a
logname.LOG000 or tracename.TRC000 file is full, each log or trace is renamed to the next higher
number in its sequence; that is, a file with sequence number N is renamed as a file with sequence number
N+1 and a new file named logname.LOG000 or tracename.TRC000 is created. The number of files that
can exist simultaneously on the system can be specified by the -n option.
HP-UX 11i Version 1: September 2005 − 5 − Hewlett-Packard Company Section 1M−−571