evmfiltercreate.3 (2010 09)

e
EvmFilterCreate(3) EvmFilterCreate(3)
EvmFALSE The event does not match the filter_string .
The indirect filter syntax,
@filename
, is supported by the EvmFilterIsFile()
and EvmFilter-
ReadFile() routines. Programs which support indirect filters may use
EvmFilterIsFile()
to
determine whether a user-supplied filter string is indirect. If so, then use
EvmFilterReadFile()
to
expand the file to a regular filter string.
EvmFilterIsFile()
returns EvmTRUE if the supplied filter_string uses indirect filter notation, and
returns
EvmFALSE otherwise.
EvmFilterReadFile()
interprets the supplied filter_string , and attempts to open and read the refer-
enced file.
EvmFilterReadFile()
returns a pointer to heap space memory containing the expanded
filter string. The caller is responsible for freeing the memory when it is no longer needed. NULL is
returned if an error occurs while reading the file. Note that
EvmFilterReadFile()
does not attempt
to validate the filter string contained in the file.
The
EvmFilterDestroy()
routine destroys the filter_evaluator, freeing all associated resources.
RETURN VALUE
EvmERROR_NONE
The operation completed without error.
EvmERROR_FILTER_NOT_VALID
A filter string that is syntactically invalid passed to the filter
evaluator.
EvmERROR_INVALID_ARGUMENT
One of the arguments to the function is invalid.
EvmERROR_INVALID_VALUE
A value in a structure member is invalid.
EvmERROR_NO_MEMORY
An operation failed because an attempt to acquire heap memory
failed.
EvmERROR_NOT_INITIALIZED
An attempt was made to use a filter evaluator without first calling
EvmFilterSet() which provides an initial filter string.
NULL An attempt to read a filter file failed.
ERRORS
The value of
errno is not set.
SEE ALSO
Event Management
EVM(5).
EVM Events
EvmEvent(5).
Event Filter
EvmFilter(5).
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010