HP-UX Reference (11i v3 07/02) - 1 User Commands A-M (vol 1)

e
evmshow(1) evmshow(1)
The -f option can be used to specify an EVM filter string, to limit the events that are passed through
evmshow. If this option is used, only events that match the filter_expr are output. See the EvmFilter(5)
manpage for the filter syntax.
The
-r option can be used in combination with the
-f, -k, and -n options to make evmshow act as a
filter, reading a stream of events and writing only those that meet the selection criteria specified by the
other options. Events are output as raw EVM events, so output cannot be directed to a terminal if this
option is used.
The
-b option can be used to extract one or more data items or variable values from an event stream in
their native binary formats. This option is particularly useful for producing a data file from events that
contain the required data in variables.
Binary values are written to the output file in the size appropriate to their types -- for example, if a vari-
able named in the item_list is present in an event and has a type of
UINT64, 8 bytes of binary data are
output. String values are output as arbitrary-length character strings, terminated by a single null byte. If
a data item or variable specified in the item_list is not present in an event, nothing is written to the output,
and no error is reported. Output cannot be directed to a terminal if the
-b option is used.
Options
-c config_file Uses config_file as the channel configuration file instead of the default file,
/etc/evmchannel.conf
. The channel configuration file is read when the -d or
the
-x option is used.
-d Outputs each event as a full multiline detailed display, using the details function
(
fn_details ) defined for the event in the channel configuration file
/etc/evmchannel.conf
.
-D Outputs each event as a multiline dump of the contents of the event. This format
does not include explanation text or any additional details about the event.
-r Does not format events, but outputs each event as a raw (binary) event. This option
results in an error if
stdout is directed to a terminal device.
-b item_list Outputs the specified data items or variable values in their native form, ASCII or
binary, as appropriate. The item_list must specify one or more standard data items
(for example, @timestamp ) or variables (for example, $my_variable), separated by
commas or tab characters. The list must be enclosed in single quotes if $ or tab char-
acters are used, to protect them from interpretation by the shell. See the DESCRIP-
TION section for details of the output produced by this option.
-x Outputs the explanation text for the event. The explanation is obtained using the
explanation function ((fn_explain ) defined for the event in the channel
configuration file /etc/evmchannel.conf
.
-t show_template Outputs each event as a formatted line using the specified show_template. If this
option is used in conjunction with
-d, -D,or-x, the formatted line is output first fol-
lowed by the multiline output resulting from the other option.
-T timespec Outputs the event’s timestamp value at the start of each formatted text line using
timespec as a template for the timestamp format. See the DESCRIPTION section for
details of timespec.
-f filter_expr Outputs only events that match the filter_expr. See the EvmFilter(5) manpage for the
filter syntax.
-F Echoes any specified filter string to stdout, and terminates. If the filter specified
with the -f option refers to a stored filter, the filter is expanded before being
displayed. This feature is useful for retrieving filter strings from a file. This option
cannot be used in conjunction with any other output format control option.
-k skip_count Skips the first skip_count events from the input stream before beginning output. If
skip_count exceeds the number of events in the input stream, no output is produced.
-n show_count Stops producing output after show_count events have been output. If show_count
exceeds the number of events in the input stream, evmshow outputs all events.
HP-UX 11i Version 3: February 2007 − 2 − Hewlett-Packard Company 309