evmsort(1)evmsort(1)NAMEevmsort - Sorts events
SYNOPSISevmsort [-A] [-s sort_spec] [-t show_template] [filename | -]
OPTIONS
Automatically starts evmshow to produce a formatted display of the
sorted events. The specification to be used in sorting events. See the
DESCRIPTION section for the syntax of the sort_spec, and for details of
the default sort order. Template string to be passed to evmshow if the
-A option is also specified. If the -A option is not specified, this
argument is ignored. See the evmshow(1) reference page for a descrip‐
tion of the template string.
OPERANDS
Reads event sources from filename. If filename is omitted, or is speci‐
fied as -, event sources are read from stdin.
DESCRIPTION
The evmsort command reads and sorts a stream of EVM events. By default,
events are read from stdin, and are sorted into ascending timestamp
order. Sorted events are written to the command's stdout stream in the
form of raw EVM events.
The sort order can be specified by supplying a sort_spec, either
through the -s option or by setting the environment variable
EVM_SORT_SPEC to the required specification. The specification is a
character string of the form:
@key_item[+|-] [ :@key_item[+|-] ]
The key_item is the name of any EVM standard data item and the @ char‐
acter is optional. If the special key_item @@ is specified, the event's
format data item is expanded as described in the evmshow(1) reference
page, 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 can be specified in the string by separating them with
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 name data items, and one
event does not contain a name, that event will appear first in the out‐
put stream.
If the -A option is specified, evmsort automatically starts evmshow and
pipes the sorted event stream into it, producing a sorted and formatted
display of events. If a show_template argument is supplied, the speci‐
fied template string is passed to evmshow through its own -t option.
See the evmshow(1) reference page for more information.
RESTRICTIONS
The evmsort command rejects attempts to output raw events to a terminal
device.
EXIT STATUS
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
first) and then ascending order of time (oldest first), and automati‐
cally runs evmshow to display them. evmget -f '[priority >= 300]' |
evmsort-s "@priority-:@timestamp" |
evmshow -t "@priority @timestamp @@" The following example
yields a list of all events, sorted latest first within name. evmget |
evmsort-s "@name:@timestamp-" |
evmshow -t "@name @timestamp @@" The following example yields a
list of all events, sorted first in order of their formatted messages
and then in ascending order of time. Events are passed to evmshow for
display, and subsequently to the more command for viewing. evmget |
evmsort-A -s "@@:@timestamp" -t "@timestamp @@" | more
ENVIRONMENT VARIABLES
The following environment variables affect the execution of evmsort:
This variable contains a string formatted as described for a sort_spec.
If the -s option is omitted, the string is used as the sort_spec.
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)