MsgVerifyEvent(), MsgVerifyEvent_r()

Check the validity of a receive ID and an event configuration

Synopsis:

#include <sys/neutrino.h>

int MsgVerifyEvent( int rcvid,
                    const struct sigevent event );

int MsgVerifyEvent_r( int rcvid,
                      const struct sigevent event );

Description:

The MsgVerifyEvent() and MsgVerifyEvent_r() functions are identical except in the way they indicate errors. See the Returns section for details.

These kernel calls check the validity of the receive ID rcvid, and the event configuration. They can be used to verify that an event is well-formed by a client (pass a rcvid of 0), and by a server (pass a rcvid of the target thread).

Blocking states

These calls don't block.

Returns:

The only difference between the MsgVerifyEvent() and MsgVerifyEvent_r() functions is the way they indicate errors:

MsgVerifyEvent(): If an error occurs, -1 is returned and errno is set.
MsgVerifyEvent_r(): This function does NOT set errno. If an error occurs, the negative of a value from the Errors section is returned.

Errors:

EBADF: The channel for the pulse delivery doesn't exist.
EINVAL: Invalid event structure.
ESRCH: The connection for the pulse doesn't exist.

Classification:

QNX 6

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes