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

System Functions (r) recv64_(2)
NOTES
This function requires that the feature-test macro _XOPEN_SOURCE_EXTENDED be specified
when you compile the module.
When data is available, a call to the select() function indicates that the file descriptor for the
socket is ready for reading.
Calling the recv64_() function with a flags parameter of 0 (zero) is identical to calling the
read64_() function.
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 recv64_() function returns the length of the received message
in bytes. If no data is available and the peer socket has performed an orderly shutdown, then 0
(zero) is returned.
If the recv64_() function call fails, the value -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the recv64_( ) function sets errno to the corresponding
value:
[EBADF] The socket parameter is not a valid file descriptor.
[ECONNRESET]
One of the following conditions occurred:
• The transport-provider process for this socket is no longer available.
• The TCP/IP subsystem for this socket is no longer available.
• The connection was forcibly closed by the peer socket.
The socket can only be closed.
[EFAULT] A user-supplied memory buffer cannot be accessed or written.
[EINTR] A signal interrupted the function before any data was available.
[EINVAL] The MSG_OOB value is specified in the flags parameter and no out-of-band
data is available.
[EIO] An input or output error occurred.
[ENOBUFS] There was not enough buffer space available to complete the call. A retry at a
later time might succeed.
[ENOMEM] There was insufficient memory available to complete the operation.
[ENOTCONN] A receive operation was attempted on a connection-oriented socket that is not
connected.
[ENOTSOCK] The socket parameter does not refer to a socket.
[EOPNOTSUPP]
The specified value for the flags parameter is not supported for this socket type
or protocol.
527186-023 Hewlett-Packard Company 6−25