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

sendto64_(2) OSS System Calls Reference Manual
dest_len Specifies the length of the sockaddr structure pointed to by the dest_addr
parameter.
DESCRIPTION
The sendto64_() 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
sockaddr structure pointed to by the dest_addr parameter. If the socket is connection-oriented,
the dest_addr parameter is ignored.
Successful completion of a call to sendto64_() does not imply successful delivery of the mes-
sage. A return value of -1 indicates only locally detected errors.
If the sending socket has no space to hold the message to be transmitted and the socket’s file
descriptor is blocking (O_NONBLOCK is not set), the sendto64_() function blocks until space
is available. If the sending socket has no space to hold the message to be transmitted and the
socket’s file descriptor is marked nonblocking (O_NONBLOCK is set), the sendto64_() func-
tion fails and sets errno to [EWOULDBLOCK].
To pass a 32-bit pointer from a 32-bit Guardian or OSS client, sendto() or sendto64_() may be
called.
To pass a 64-bit pointer from a 32-bit Guardian or OSS client, sendto64_() must be called.
32-bit Guardian and 64-bit OSS clients can pass 32-bit pointers and 64-bit pointers to
sendto64_().
NOTES
This function requires that the feature-test macro _XOPEN_SOURCE_EXTENDED be specified
when you compile the module.
When data can be sent, a call to the select() function indicates that the file descriptor for the
socket is ready for writing.
Sockets created in compatibility mode can communicate with each other but cannot communi-
cate with sockets in portability mode.
Sockets created in portability mode can communicate with each other but cannot communicate
with sockets created in compatibility mode.
For detailed information about writing multi-threaded and 64-bit applications for the Open Sys-
tem Services environment, see the Open System Services Programmer’s Guide.
RETURN VALUES
Upon successful completion, the sendto64_() function returns the number of bytes sent. Other-
wise, the value -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the sendto64_() function sets errno to the correspond-
ing value:
[EACCES] The socket is in the AF_UNIX domain and either search permission is denied for
a component of the pathname in the sockaddr structure, or write access to the
specified socket is denied.
[EAFNOSUPPORT]
Addresses in the specified address family cannot be used with this socket.
7−50 Hewlett-Packard Company 527186-023