*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> evmsort (1)              



NAME    [Toc]    [Back]

       evmsort - Sorts events

SYNOPSIS    [Toc]    [Back]

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

OPTIONS    [Toc]    [Back]

       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 description of the template string.

OPERANDS    [Toc]    [Back]

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

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

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

EXIT STATUS    [Toc]    [Back]

       The following exit values are returned: Successful completion
 An error occurred

EXAMPLES    [Toc]    [Back]

       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


       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    [Toc]    [Back]

       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)

[ Back ]
 Similar pages
Name OS Title
qsort Linux sorts an array
sort Tru64 Sorts or merges files
scandir Tru64 Scan or sorts directory contents
dmPMSortByName IRIX sorts the list of plugins stored in
alphasort Tru64 Scan or sorts directory contents
tsort Tru64 Sorts an unordered list of ordered pairs (topological sort)
asort Tru64 Sorts or merges files and supports multiple collating weight sequences
evmwatch Tru64 Monitors EVM events
evmviewer Tru64 View events
msleep FreeBSD wait for events
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service