Read a message from a client
#include <sys/iofunc.h> #include <sys/resmgr.h> ssize_t resmgr_msgread( resmgr_context_t * ctp, void * msg, size_t size, size_t offset );
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
The resmgr_msgread() function is a convenience function that you should use in a resource manager instead of MsgRead().
You'll use resmgr_msgread() when you handle combine messages, where the offset of the rest of the message that's to be read is additionally offset by previous combine message elements. For more information, see Layers in a resource manager in the Bones of a Resource Manager chapter of Writing a Resource Manager.
The same values as MsgRead(): the number of bytes read, or -1 if an error occurs (errno is set).
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | No |
Signal handler | Yes |
Thread | Yes |