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

n
netfmt(1M) netfmt(1M)
-v Enables output of verbose information. This includes additional cause and action text
with formatted output. This information describes the possible cause of the message
and any actions that may be required by the subsystem.
After the contents of the input file have been formatted a summary of the file is
displayed. When this option is used with the
-t option, only a summary of the last
records is reported. No summary is produced when this option is used in 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 ter-
minal 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).
-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 determine
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 subsys-
tems. There are two types of Global filters that
netfmt supports. The global filtering can start
with either the word formatter, which means it is global to all the NetTL’s subsystems and the
second type starts with the word
kl_formatter , which is used to filter KL’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 charac-
ters) 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 exclama-
tion point, (!*) to indicate NOT ALL. This operator is not available for timestamp, log instance,
and ID filtering.
Section 1M558 Hewlett-Packard Company 2 HP-UX 11i Version 1: September 2005