evmwatch(1)evmwatch(1)NAMEevmwatch - monitor EVM events
SYNOPSIS
show_template]] filter_expr] channel-list] timeout] reconnect-timeout]
DESCRIPTION
The command subscribes to the events specified by the option and passes
all events to its stream as they arrive. Output is in the form of raw
EVM events.
If the option is specified, automatically starts and pipes the event
stream into it, producing a formatted display of events. If a
show_template argument is supplied, the specified template string is
passed to through its own option. See evmshow(1) for more information.
If cannot connect to the EVM daemon, it terminates immediately with an
error message. If it succeeds in connecting but subsequently loses the
connection, it attempts to reconnect periodically until the reconnect-
timeout period expires. The retry period is one second for the first
minute, and five seconds thereafter.
Options
Automatically starts
to produce a formatted display of the received events.
Subscribes for notification of events matching
filter_expr. See EvmFilter(5) for the syntax of filter_expr.
By default, the command subscribes for all events.
Template string to be passed to
if the option is also specified. If the option is not speci‐
fied, this argument is ignored. See evmshow(1) for a
description of the template string.
Terminates if no event is processed in the time specified by
timeout. The format of timeout is [[[dayshoursminutessec‐
onds, where days, hours, and minutes can be any integer up to
9999, and seconds can be any integer up to 9999999. Omitted
values are interpreted as zero. If the converted value
exceeds 100,000,000 seconds, it is automatically reduced to
that value with no error being reported. The timer is
restarted each time an event is received.
Retrieves copies of all of the registered event templates from the EVM
daemon that match the supplied filter string and for which
the user has access authorization. It writes the templates
to as EVM events and terminates.
Terminates with a zero exit value as soon as the first event matching
filter_expr is processed.
Specifies the period for which
should continue to attempt to reconnect if the connection to
the EVM daemon is lost. The format of reconnect-timeout is
[[[dayshoursminutesseconds, where days, hours, and minutes
can be any integer up to 9999, and seconds can be any integer
up to 9999999. Omitted values are interpreted as zero. If
the converted value exceeds 100,000,000 seconds, it is auto‐
matically reduced to that value with no error being reported.
If reconnect-timeout is zero, terminates immediately if a
disconnection occurs. If this option is not specified, the
reconnection timeout is set to five minutes.
RETURN VALUES
The following exit values are returned:
Successful completion
An error occurred, including timeout.
EXAMPLES
· The following example watches for all events with a priority of at
least 200 and displays them on Events are piped automatically
through to produce a formatted event display.
· The following example shows how waits until another process posts a
particular event and then continues. Redirection of output to
implies that the content of the event is of no concern.
The following script builds on the prior example. It waits for
five minutes (300 seconds) for the event to occur or exits as
soon as the event happens.
· The following shell script waits for up to five minutes (300 sec‐
onds) for a pulse event to be received. Each time the pulse
arrives, the timer is reset and waits for the next pulse. If the
timer expires, terminates with an error code, a warning is dis‐
played, a high priority event is posted, and the script exits.
· The following example lists the names of all registered events that
the user is authorized to access.
WARNINGS
The command rejects attempts to output raw events to a terminal device.
The command receives events only for which the user has access autho‐
rization. See evm.auth(4) for details of access authorization.
FILES
Definition of the sockets and protocols used for Internet Services
SEE ALSO
Commands
evmget(1), evmpost(1), evmshow(1), evmsort(1).
Files
evmfilterfile(4), services(4).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
Event Filter
EvmFilter(5).
evmwatch(1)