NAME

evmsort − Sorts events

SYNOPSIS

evmsort [-s sort_spec] [filename | -]

OPTIONS

-s sort_spec
The alternate sort specification.  By default events are sorted into ascending timestamp order.  See the DESCRIPTION section for the syntax of the sort_spec. 

OPERANDS

filenameReads event sources from filename.  If filename is omitted, or is specified as -, event sources are read from stdin. 

DESCRIPTION

The evmsort command reads a stream of events and sorts them according to the supplied criteria.  By default events are read from stdin, and are sorted into ascending timestamp order. 

The -s flag specifies sort_spec as an alternate sort specification.  The specification is a character string of the following form:

@key_item[+|-] [ :@key_item[+|-] ] The key_item is the name of any EVM standard data item and the @ character is optional.  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. 

RESTRICTIONS

The evmsort command rejects attempts to output raw events to a terminal device. 

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 displays 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  @@"

EXIT VALUES

The following exit values are returned:

0Successful completion

not 0An error occurred

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)