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 );

Arguments:

rcvid
The receive ID that you want to check.
event
A pointer to a sigevent structure that contains the event you want to check.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The MsgVerifyEvent() and MsgVerifyEvent_r() kernel calls check the validity of the receive ID rcvid, and the event configuration. You can use these functions 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).

These functions are identical except in the way they indicate errors. See the Returns section for details.

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 Neutrino

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

Last modified: 2013-12-23

comments powered by Disqus