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

See also:

MsgReceive(), MsgReceivev(), MsgReply(), MsgSend(), MsgSendv(), MsgWrite(), MsgWritev(), sigevent

Message Passing chapter of Getting Started with QNX Neutrino