evmconnsubscribe.3 (2010 09)

EvmConnSubscribe(3) EvmConnSubscribe(3)

EvmREASON_TEMPLATE_INFO_DELIVERED

The ﬁrst time the function is called, a single event template is returned, if one is available. On subse-

quent calls that have the ﬁlter_string parameter set to NULL, the next matching template is returned.

The next matching template continues to be returned until all templates that match the original

ﬁlter_string have been returned.

If it is necessary to match individual callback responses with their original requests, the caller must sup-

ply a different user_arg for each request in the cycle. The caller must also verify that each incoming tem-

plate relates to the expected request.

Notes

The daemon does not return templates for which the user does not have access authorization.

To avoid missing incoming templates, do not issue a stream of

EvmConnRegistrationGet()

EvmConnTemplateScan()

requests before taking any callbacks. Work in a request/callback/request

cycle.

RETURN VALUE

EvmERROR_NONE

The operation completed without error.

EvmERROR_INVALID_ARGUMENT

One of the arguments to the function was 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_PRESENT

For the EvmConnRegistrationGet() routine, the requested event

template is not registered.

For the

EvmConnTemplateScan()

routine, there is no match for

the speciﬁed ﬁlter_string , or the template list is exhausted.

EvmERROR_READ A read error occurred while reading from the EVM daemon connection.

EvmERROR_WRITE A write error occurred while writing to the EVM daemon connection.

ERRORS

The value of

errno is not set.