socketpair - Create a pair of connected sockets
int socket_vector );
Interfaces documented on this reference page conform to
industry standards as follows:
socketpair(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information
about industry standards and associated tags.
Specifies the communications domain in which the sockets
are created. This function does not create sockets in the
Internet domain. Specifies the communications method that
sockets use, for example SOCK_DGRAM or SOCK_STREAM. Specifies
an optional identifier used to define the communications
protocols used in the transport layer interface.
Specifies a two-integer array used to hold the file
descriptors of the socket pair created with the call to
The socketpair() function creates an unnamed pair of connected
sockets in a specified domain, of a specified type,
under the protocol optionally specified by the protocol
parameter. The two sockets are identical. The file
descriptors used in referencing the created sockets are
returned to socket_vector and socket_vector. The
sys/socket.h include file contains definitions for socket
domains, types, and protocols.
Not all protocol families support the socketpair() function.
Upon successful completion, this function returns a value
of 0 (zero). Otherwise, -1 is returned and errno is specified
to indicate the error.
If the socketpair() function fails, errno may be set to
one of the following values: The process have not have
appropriate privileges. The addresses in the specified
address family cannot be used to create this socket pair.
[Tru64 UNIX] The socket_vector array is not located in a
writable part of user address space. The current process
has too many open file descriptors. No more file descriptors
are available for the system. Insufficient resources
were available in the system to complete the call. The
system was unable to allocate kernel memory to increase
the process descriptor table. The available STREAMS
resources were insufficient for the operation to complete.
The specified protocol does not permit creation of socket
pairs. The specified protocol cannot be used in this system.
The socket type is not supported by the protocol.
Network Programmer's Guide
[ Back ]