netfmt.1m (2011 03)

n
netfmt(1M) netfmt(1M)
conjunction with the -F option or if formatting is interrupted.
-l (ell ) Turn off inverse video highlighting of certain traced fields. Use this flag when
sending formatted trace data to a line printer. By default, certain fields in the trace
file are highlighted in inverse video when viewing the formatted trace format at a
terminal that supports highlighting.
-n Shows port numbers and network addresses(such as IP and x121) as numbers (nor-
mally, netfmt interprets numbers and attempts to display them symbolically).
-x Enables formatting TCP payload for XoT (X.25 over TCP) packets.
-N Enables "nice" formatting where Ethernet/IEEE802.3, SLIP, IP, ICMP, IGMP, TCP,
UDP, ARP, Probe, and RPC packets are displayed symbolically. All remaining user
data is formatted in hexadecimal and ASCII.
-1 (one) Attempts to tersely format each traced packet on a single line. If
-L and/or
-T options are used, the output lines will be more than 80 characters long.
-T Places a time stamp on terse tracing output. Used with the
-1 (minus one)option.
-L Prefixes local link address information to terse tracing output. Used with the
-1
(minus one)option.
Filter Configuration File
Note : Filter configuration file syntax converges the syntax used with the obsolete
nettrfmt network
trace formatter and
netlogfmt network log formatter commands with new netfmt syntax for control-
ling formatter options. The first section below describes the general use and syntax of the filter
configuration file. Specific options for subsystem Naming and Filtering are listed in the Subsystem Filter-
ing section below.
The filter configuration file allows specification of two types of information:
• Specify options in order to control how the input data is to be formatted. These options deter-
mine what the output looks like and allow a user to select the best format to suit their needs.
• Specify filters in order to precisely tailor what input data is to be discarded and what is to be for-
matted. Global filters control all subsystems; subsystem filters pertain only to specific sub-
systems. The global filtering can start with the word formatter, which means it is global to all
the NetTL’s subsystems.
A filter is compared against values in the input data. If the data matches a filter, the data is formatted;
otherwise, the input data is discarded. A filter can also specify NOT by using
! before the filter value in
the configuration file. If the input data matches a NOT filter, it is discarded. A filter can also be a "wild-
card" (matching any value) by specifying an asterisk
* before the filter value in the configuration file.
"Wild card" filters pass all values of the input data. Specifying !* as the filter means NOT ALL.
Filter Configuration File Syntax
• The formatter ignores white space, such as spaces or tabs. However, newlines (end of line char-
acters) are important, as they terminate comments and filter specifications.
• The formatter is not case sensitive. For example error and ERROR are treated as equivalent.
• To place comments in the file, begin each comment line with a
# character. The formatter
ignores all remaining characters on that line. There are no inline comments allowed.
• An exclamation point (
!) in front of an argument indicates NOT. This operator is not supported
for timestamp, log instance, and ID filtering.
• The asterisk (
*), when used as an argument, indicates ALL. Since the default for all formatting
options is ALL, it is unnecessary to use the asterisk alone. It can be used along with the excla-
mation point, (!*) to indicate NOT ALL. This operator is not available for timestamp, log
instance, and ID filtering.
Global Filtering: For NetTL’s Subsystems
This section explains global filtering options which apply only to
NetTL’s subsystems. NetTL’s global
filtering commands start with the word formatter, followed by the keywords verbosity, mode,
option,orfilter.
formatter verbosity value
value is one of the following:
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: March 2011