resmgr_msgreadv()

Read a message from a client

Synopsis:

#include <sys/resmgr.h>

int resmgr_msgreadv( resmgr_context_t * ctp,
                     iov_t * rmsg,
                     int rparts,
                     int offset );

Library:

libc

Description:

This resmgr_msgreadv() function is a convenience function that should be used to replace the MsgReadv() function. It finds application in combine message handling, where the offset of the rest of the message that is to be read is additionally offset by previous combine message elements (see the section "Advanced Topics" in the Writing a Resource Manager chapter in Programmer's Guide for more information about combine messages).

Returns:

The same values as MsgReadv(): the number of bytes read, or -1 if an error occurs (errno is set).

Errors:

EFAULT

A fault occurred in a server's address space when it tried to access the caller's message buffers.

ESRCH

The thread indicated by ctp -> rcvid doesn't exist or has had its connection detached.

ESRVRFAULT

A fault occurred when the kernel tried to access the buffers provided.

Classification:

QNX 6