resmgr_msgread()

Read a message from a client

Synopsis:

#include <sys/resmgr.h>

int resmgr_msgread( resmgr_context_t * ctp,
                    void * msg,
                    int size,
                    int offset );

Library:

libc

Description:

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

Returns:

The same values as MsgRead(): 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 its connection is detached.

ESRVRFAULT

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

Classification:

QNX 6