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

System Functions (s and S) sendmsg64_(2)
NAME
sendmsg64_ - Sends a message on a socket using a message structure
LIBRARY
G-series native OSS processes: system library
H-series and J-series OSS processes: implicit libraries
32-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes that use the POSIX User Thread Model library:
/G/system/zdllnnn/yputdll
SYNOPSIS
#define _XOPEN_SOURCE_EXTENDED 1
#include <sys/socket.h>
long long sendmsg64_(
int socket,
const struct msghdr64 _ptr64 *message,
int flags);
PARAMETERS
socket Specifies the file descriptor of the socket.
message Points to a msghdr64 structure containing both the destination address for the
outgoing message and the buffers for the outgoing message. The length and for-
mat 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 msghdr64 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 purposes.)
MSG_OOB Sends out-of-band data on sockets that support out-of-band com-
munications.
DESCRIPTION
The sendmsg64_() 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
msghdr64 structure. If the socket is connection-oriented, the destination address in the
msghdr64 structure is ignored.
Successful completion of a call to sendmsg64_( ) does not imply successful delivery of the mes-
sage. A return value of -1 indicates only locally detected errors.
527186-023 Hewlett-Packard Company 7−39