evmsort.1 (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

evmsort(1) evmsort(1)

NAME

evmsort - sort events

SYNOPSIS

evmsort [-A [-t show_template]] [

-s sport_spec ][ﬁlename |

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 speciﬁed by supplying a sort_spec , either through the

-s option or by setting the

environment variable

EVM_SORT_SPEC

to the required speciﬁcation. The speciﬁcation 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 speciﬁed, the event’s

format data item is expanded as described in the

evmshow(1) manpage, 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 in the string are separated by colon characters (

:). The left-most key_item in the

speciﬁcation is the most signiﬁcant key.

If a key_item that is included in the sort speciﬁcation 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 appears ﬁrst in the output stream.

If the

-A option is speciﬁed, evmsort automatically starts

evmshow and pipes the sorted event stream

into it, producing a sorted and formatted display of events. If a

-t show_template argument is also

speciﬁed with

-A, the speciﬁed template string is passed to evmshow

through its own -t option.

See the evmshow (1) manpage for more information.

Options

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

-s sort_spec

The speciﬁcation 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 speciﬁed. If the -A option is

not speciﬁed, this argument is ignored. See the evmshow (1) manpage for a description of the

template string.

Operands

filename Reads event sources from ﬁlename .Ifﬁlename is omitted, or is speciﬁed as

-, event sources

are read from stdin.

EXTERNAL INFLUENCES

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

option is omitted, the string is used as the sort_spec .

RETURN VALUES

The following exit values are returned:

0 Successful completion.

not 0 An error occurred.

HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1

Summary of content (2 pages)

PAGE 1
evmsort(1) evmsort(1) NAME evmsort - sort events SYNOPSIS evmsort [-A [-t show_template]] [-s sport_spec ] [filename | -] 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.
PAGE 2
evmsort(1) evmsort(1) EXAMPLES • The following example retrieves all events with a priority of 300 or greater, sorts them into descending order of priority (most urgent event first) and then ascending order of time (oldest event 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 with the latest event first within name.