Open System Services System Calls Reference Manual (G06.28+, H06.05+)

spt_recvmsg(2) OSS System Calls Reference Manual
NAME
spt_recvmsg - Initiates thread-aware recvmsg(2) function
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
ssize_t spt_recvmsg(
int socket,
struct msghdr *message,
int flags);
PARAMETERS
See the recvmsg(2) reference page.
DESCRIPTION
This is a thread-aware version of the recvmsg() function. The socket must be nonblocking for
this function to be thread-aware.
The following macro maps spt_recvmsg() to recvmsg() and has been defined in spthread.h:
#define recvmsg(socket, message, flags)\
spt_recvmsg(socket, message, flags)
This macro is available only when SPT_THREAD_AWARE has been defined before including
spthread.h, as follows:
#define SPT_THREAD_AWARE
RETURN VALUES
See the recvmsg(2) reference page. The following information also applies:
— The value of errno is never set to [EWOULDBLOCK].
— If the socket becomes invalid (is closed by another thread), -1 is returned with an
errno value of [EBADF].
— If a signal is received via the pthread_kill() function and is not blocked,
ignored, or handled, -1 is returned with an errno value of [EINTR].
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this
reference page conform to the following industry standards:
— IEEE Std 1003.1c-1995, POSIX System Application Program Interface
The use of the header file spthread.h is an HP exception to the POSIX standard.
7−274 Hewlett-Packard Company 527186-007