Index for Section 1

Alphabetical listing for E

Bottom of page

evmsort(1)
NAME
  evmsort - Sorts events

SYNOPSIS
  evmsort [-A] [-s sort_spec] [-t show_template] [filename | -]

OPTIONS
  -A  Automatically starts evmshow to produce a formatted display of the
      sorted events.

  -s sort_spec
      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.

  -t show_template
      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 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 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 @ character
  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 output 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 specified
  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.

ENVIRONMENT VARIABLES
  The following environment variables affect the execution of evmsort:

  EVM_SORT_SPEC
	   This variable contains a string formatted as described for a
	   sort_spec.  If the -s flag is omitted, the string is used as the
	   sort_spec.

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 automatically 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

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