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

n
nettl(1M) nettl(1M)
NAME
nettl - control network tracing and logging
SYNOPSIS
/usr/sbin/nettl -start
/usr/sbin/nettl -stop
/usr/sbin/nettl -firmlog 0
12 -card dev_name ...
/usr/sbin/nettl -log
class ... -entity subsystem ...
/usr/sbin/nettl -status
[log trace all]
/usr/sbin/nettl -traceon
kind ... -entity subsystem ... [-card
dev_name ...]
[
-file tracename ][-m
bytes][-size portsize ][-tracemax maxsize][-n num_files]
[
-mem init_mem [max_mem]] [-bind
cpu_id]
/usr/sbin/nettl -bind
cpu_id
/usr/sbin/nettl -traceoff -entity
subsystem ...
DESCRIPTION
The
nettl command is a tool used to capture network events or packets. Logging is a means of captur-
ing network activities such as state changes, errors, and connection establishment. Tracing is used to
capture or take a snapshot of inbound and outbound packets going through the network, as well as loop-
back or header information. A subsystem is a particular network module that can be acted upon, such as
ns_ls_driver,orSX25L2. nettl is used to control the network tracing and logging facility.
Except for the
-status option, nettl can be used only by users who have an effective user ID of 0.
Options
nettl recognizes the following options, which can be used only in the combinations indicated in
SYNOPSIS. Some option and argument keywords can be abbreviated as described below. All keywords
are case-insensitive.
-start (Abbr.: -st)
Used alone without other options.
Initialize the tracing and logging facility, start up default logging, and optionally start up
console logging. Logging is enabled for all subsystems as determined by the
/etc/nettlgen.conf
file. Log messages are sent to a log file whose name is deter-
mined by adding the suffix
.LOG000 to the log file name specified in the
/etc/nettlgen.conf
configuration file. Console logging is started if console logging
has been configured in the
/etc/nettlgen.conf
file. See nettlconf (1M) and
nettlgen.conf (4) for an explanation of the configuration file. If the log file (with suffix)
already exists, it is opened in append mode; that is, new data is added to the file. The
default name is
/var/adm/nettl (thus logging starts to file
/var/adm/nettl.LOG000). See Data File Management below for more information
on how the log file is handled.
A
nettl -start command is performed during system startup if the NETTL variable
in the /etc/rc.config.d/nettl file has a value of 1.
Note: It is strongly recommended that the tracing and logging facility be turned on
before any networking is started and remain on as long as networking is being used.
Otherwise, information about disasters will be lost. To minimize the impact on the sys-
tem, all subsystems can be set with the
-log option to capture only disaster-class log
messages.
-stop (Abbr.: -sp)
Used alone without other options.
Terminate the trace/log facility. Once this command is issued, the trace/log facility is no
longer able to accept the corresponding trace/log calls from the network subsystems.
Note: See note for the
-start option.
-bind (Abbr.: -b)
Used with first -traceon option or alone after tracing has been turned on.
Section 1M−−514 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003