Index for Section 1

Alphabetical listing for E

Bottom of page

evmsort(1)
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
  filename
	Reads 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:

  0   Successful completion

  not 0
      An 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)

Index for Section 1

Alphabetical listing for E

Top of page