evmpost(1)evmpost(1)NAMEevmpost - post events to the EVM daemon
SYNOPSIS
msg priority]] | [filename|
DESCRIPTION
The command takes a file or stream of text event sources as input and
converts them to binary EVM events. By default, the command then posts
them to the EVM daemon for distribution.
If the option is specified, writes the EVM events to its stream instead
of posting them to the daemon. By default, attempts to retrieve event
template information from the EVM daemon and merges the template items
and environmental items such as and into the output events. If the
option is used, the output events contain only the items specified in
the source.
An event source may contain any number of events. Each event is speci‐
fied in the manner shown. See the EvmEvent(5) manpage for a more
detailed explanation.
The command recognizes the following data items in an event source:
·
·
·
·
·
·
·
·
·
·
All EVM variable types may be specified except for Refer to EvmEvent(5)
for details on data items and variables.
In the event source, each keyword must be accompanied by a correspond‐
ing value. The value must be enclosed in double quotes ("") if it con‐
tains white space. The data item keywords that are specified outside
the event body are taken as global values. The data item keywords are
included in each of the following events which do not have an explicit
value defined for that keyword.
Comments are indicated by a leading character. Blank lines are
ignored.
The command builds an EVM event containing the items that are explic‐
itly specified in the source. If the event is posted or if the option
is specified without additional environmental items such as the and
template items are inserted into the event automatically.
The rules for posting an event are more stringent than those for an
event simply to exist. Therefore, may display an error when trying to
post an an event that cannot be posted, even though the same source is
accepted when using the option.
For example, do not post an event if it does not contain a name with at
least three components because the daemon rejects it. However, such an
event can exist, and can create it and pass it to The following example
fails because it does not contain a name:
The following example is successful, even though it does not display
any useful information:
The option can verify event source and template files by piping the
output into See evmshow(1).
Options
Does not post the events, but instead passes them directly to
as raw EVM events.
An error occurs if is directed to a terminal device.
When used with the
option, causes event template items and environmental values
to be merged with the items included in the source. This is
the default mode.
When used with the
option, inhibits the merging of template items and environ‐
mental values.
Posts an administrator's quick message event with the name
and the string msg in a variable data item. If a message
contains spaces, the message must be enclosed in quotation
marks (""). The event is used to add a message entry in the
event log. This option may be used only by privileged users.
Posts a user's quick message event with the name
and the string msg in a variable data item. If a message
contains spaces, the message must be enclosed in quotation
marks (""). The event is used to add a message entry in the
event log.
Assigns priority as the for an administrator's or user's quick mes‐
sage. The priority value must be an integer in the range
0-700. If the priority is not specified, the default of 200
is used.
Operands
filename Read event sources from filename. If filename is omitted, or
is specified as event sources are read from
RETURN VALUES
The following exit values are returned:
Successful completion.
An error occurred.
EXAMPLES
· The following example posts an event, provided that a template file
containing an event with a matching name has been registered with
the EVM daemon.
· The following example interprets an event template file, and dis‐
plays a dump of the contents of each event. Environmental items,
such as a timestamp, are not merged into the event. This command
checks the syntax and contents of the file.
· The following example shows how is used in a shell script to signal
completion of some operation:
· The following example must be run as to post an administrator's mes‐
sage event.
· The following example posts a quick user's message.
· This example posts an event that includes a variable.
If the template for this event contains the following format data
item:
then displays this event as:
WARNINGS
The command rejects attempts to output raw events to a terminal device.
Post only events for which you have posting authorization, and for
which a template exists.
FILES
Definition of the sockets and protocols used for Internet services
Location of the EVM authorization file
SEE ALSO
Commands
evmget(1), evminfo(1), evmshow(1), evmsort(1), evmwatch(1).
Routines
EvmEventPost(3).
Files
evmdaemon.conf(4), evmtemplate(4), services(4).
Event Management
EVM(5).
EVM Events
EvmEvent(5).
evmpost(1)