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

n
nettl(1M) nettl(1M)
Used with the first -traceon
option only.
Set the amount of memory (in kilobytes) used to hold the trace messages until they are
written to the file. init_mem is the memory allocated with the first
-traceon operation.
If not specified, the default value of init_mem is 7% of the free memory avaiable (can be
found using
vmstat command) when tracing is first enabled. The minimum value that
can be specified for init_mem is 8KB and the maximum value is 50% of the free memory
available.
If the memory allocated when tracing is first enabled proves to be insufficient, that is,
when trace buffers cannot accomodate more messages, additional memory may be allo-
cated up to a maximum limit given by max_mem. If not specified, the default value of
max_mem is init_mem itself. Hence, if the volume of trace messages is high, max_mem
must be set in order to avoid loss of trace messages. The maximum value that can be
specified for max_mem is 70% of free memory available. The minimum value for
max_mem should be greater than or equal to the init_mem value. Please note that speci-
fying a max_mem value for
-mem
option is optional.
Setting these values too low increases the possibility of dropped messages. See the Trace
Memory Management section below to determine the size of the trace buffer and for more
details.
Note: The default unit for init_mem and max_mem is Kilobytes. Use
m or M suffix to
specify the values in Megabytes. Refer to examples 9 and 10 for the usage.
-size portsize
(Abbr.: -s)
Note: This option is being maintained for backward compatibility and is currently
ignored. This option will be obsoleted in the next major release. Use
-mem option to
configure memory used for trace buffers.
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.
-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 1000 KB. The possible range
for maxsize is 100 to 99999.
Note: maxsize/2 should be greater than or equal to the the size of a trace buffer. If this
condition is satisfied, the default value for maxsize is 1000. If not, the file size will be
HP-UX 11i Version 2: August 2003 − 4 − Hewlett-Packard Company Section 1M−−517