Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

spt_sendmsgx(2) OSS System Calls Reference Manual
NAME
spt_sendmsgx - Sends a message on a socket using a message structure (thread-aware version)
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series and J series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
[#include <sys/socket.h>]
#include <spthread.h>
ssize_t spt_sendmsgx(
int socket,
const struct msghdr *message,
int flags
);
PARAMETERS
socket Specifies the file descriptor of the socket.
message Points to a msghdr structure containing both the destination address for the out-
going message and the buffers for the outgoing message. The length and format
of the address depend on the address family for the socket. The msg_flags
member of the structure is ignored. For:
AF_INET sockets
A pointer in msghdr to the address structure sockaddr_in must
be cast as a struct sockaddr.
AF_INET6 sockets
A pointer to the address structure sockaddr_in6 must be cast as
a struct sockaddr.
AF_UNIX sockets
A pointer to the address structure sockaddr_un must be cast as a
struct sockaddr.
flags Is a value that controls message transmission. The value of the flags parameter
is formed by bitwise ORing zero or more of these values:
MSG_DONTROUTE
Sends without using routing tables. (Not recommended; use
only for debugging.)
MSG_OOB Sends out-of-band data on sockets that support out-of-band com-
munications.
DESCRIPTION
The spt_sendmsgx() function is a thread-aware version of the sendmsg() function.
The spt_sendmsgx() function sends a message through a connection-oriented or connectionless
socket. If the socket is connectionless, the message is sent to the address specified in the
msghdr structure. If the socket is connection-oriented, the destination address in the msghdr
structure is ignored.
Successful completion of a call to spt_sendmsgx() does not imply successful delivery of the
message. A return value of -1 indicates only locally detected errors.
7−396 Hewlett-Packard Company 527186-023