evmsort(1)evmsort(1)NAMEevmsort - sort events
SYNOPSIS
show_template]] sport_spec] [filename |
DESCRIPTION
The command reads and sorts a stream of EVM events. By default, events
are read from and are sorted into ascending timestamp order. Sorted
events are written to the command's stream in the form of raw EVM
events.
The sort order can be specified by supplying a sort_spec, either
through the option or by setting the environment variable to the
required specification. The specification is a character string of the
form:
key_item[
The key_item is the name of any EVM standard data item and the charac‐
ter is optional.
If the special key_item is specified, the event's data item is expanded
as described in the evmshow(1) manpage, and the resulting string is
used as the sort key.
The optional trailing or character indicates ascending or descending
sort. By default, items are sorted in ascending order.
Multiple items in the string are separated by colon characters The
left-most key_item in the specification is the most significant key.
If a key_item that is included in the sort specification is not present
in an event read from the input stream, the item is considered to have
a low value for that event. For example, if input events are being
sorted in ascending order according to their data items, and one event
does not contain a name, that event appears first in the output stream.
If the option is specified, automatically starts and pipes the sorted
event stream into it, producing a sorted and formatted display of
events. If a argument is also specified with the specified template
string is passed to through its own option.
See the evmshow(1) manpage for more information.
Options
Automatically starts
to produce a formatted display of the sorted events.
The specification to be used in sorting events.
See the section for the syntax of the sort_spec, and for
details of the default sort order.
Template string to be passed to
if the option is also specified. If the option is not speci‐
fied, this argument is ignored. See the evmshow(1) manpage
for a description of the template string.
Operands
filename Reads event sources from filename. If filename is omitted,
or is specified as event sources are read from
EXTERNAL INFLUENCES
Environment Variables
The following environment variables affect the execution of
This variable contains a string formatted as described for a
sort_spec. If the option is omitted, the string is
used as the sort_spec.
RETURN VALUES
The following exit values are returned:
Successful completion.
An error occurred.
EXAMPLES
· The following example retrieves all events with a priority of 300 or
greater, sorts them into descending order of priority (most urgent
event first) and then ascending order of time (oldest event first),
and automatically runs to display them.
· The following example yields a list of all events, sorted with the
latest event first within
· The following example yields a list of all events, sorted first in
order of their formatted messages and then sorted in ascending order
of time. Events are passed to for display and subsequently to the
command for viewing.
WARNINGS
The command rejects attempts to output raw events to a terminal device.
SEE ALSO
Commands
evmget(1), evmpost(1), evmshow(1), evmwatch(1).
Files
evmchannel.conf(4).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
Event Filter
EvmFilter(5).
evmsort(1)