evmfiltercreate.3 (2010 09)

e
EvmFilterCreate(3) EvmFilterCreate(3)
NAME
EvmFilterCreate(), EvmFilterDestroy(), EvmFilterIsFile(), EvmFilterReadFile(), EvmFilterSet(), EvmFil-
terTest() - event filter evaluator routines
SYNOPSIS
#include <evm/evm.h>
EvmStatus_t EvmFilterCreate(
EvmFilter_t *filter_evaluator
);
EvmStatus_t EvmFilterDestroy(:
EvmFilter_t filter_evaluator
);
EvmBoolean_t EvmFilterIsFile(
const char *filter_string );
char * EvmFilterReadFile(
const char *filter_string );
EvmStatus_t EvmFilterSet(
EvmFilter_t filter_evaluator
,
const EvmString_t filter_string );
EvmStatus_t EvmFilterTest(
EvmFilter_t filter_evaluator,
EvmEvent_t event ,
EvmBoolean_t *matchFlag );
Library
EVM Support Library (libevm.so).
Parameters
filter_evaluator For
EvmFilterCreate(), filter_evaluator is the return handle of an established
filter evaluator.
For
EvmFilterSet()
filter_evaluator , identifies the filter evaluator that uses the
filter_string in subsequent matches.
For
EvmFilterTest()
, filter_evaluator identifies the filter evaluator that compares
the supplied event with the filter string.
For
EvmFilterDestroy()
, filter_evaluator identifies the filter evaluator to be des-
troyed.
filter_string The filter string used by the filter evaluator in subsequent matches. See the
EvmFilter (5) manpage for the syntax.
event The event to be compared with the filter string currently associated with the filter
evaluator.
matchFlag The result obtained when the supplied event is compared with the filter string
currently associated with the filter evaluator. Possible return values are as follows:
EvmTRUE The event matches the filter_string .
EvmFALSE The event does not match the filter_string .
DESCRIPTION
The filter evaluation routines check whether an event matches a given event filter. These functions are
useful to clients that pass a complex filter to the EVM daemon. Then the clients test incoming events
against subcomponents of the filter to determine the appropriate action.
The EvmFilterCreate() routine establishes an instance of a filter evaluator, returning a handle in
filter_evaluator.
The
EvmFilterSet() routine passes a filter_string to the filter_evaluator for subsequent matches.
The
EvmFilterTest() routine compares the supplied event with the filter_string currently associated
with the filter_evaluator. The result is returned in matchFlag . Possible return values are as follows:
EvmTRUE The event matches the filter_string .
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1