|
|
socketpair
|
|
socketpair(2) System Calls Manual socketpair(2) NAME
socketpair() - create a pair of connected sockets SYNOPSIS
DESCRIPTION
The system call creates an unnamed pair of connected sockets and returns two file descriptors in sv[0] and sv[1]. The two sockets are indistinguishable. af specifies the address family. See socket(2). type specifies the semantics of communication for the socket. proto- col specifies a particular protocol to be used. protocol can be specified as zero, which causes the system to choose a protocol type to use. X/Open Sockets Compilation Environment See xopen_networking(7). RETURN VALUE
returns the following values: Successful completion. Failure. is set to indicate the error. ERRORS
If fails, is set to one of the following values. The specified address family is not supported in this version of the system. The sv parameter is not valid. The per-process file descriptor table is full. The system file table is temporarily full. No buffer space is available for the operation to complete. The specified protocol does not support creation of socket pairs. The specified protocol is not supported in this version of the system. DEPENDENCIES
is supported only for AF_UNIX. WARNINGS
Linking binary objects compiled to specification and binary objects compiled to specification to the same executable may result in unex- pected behavior, including application abnormal termination and unexpected socket errors. See xopen_networking(7) for details and remedy. FUTURE DIRECTION
Currently, the default behavior is the however, it might be changed to in a future release. At that time, any behavior that is incompati- ble with might be obsoleted. Applications that conform to the X/Open specification now will avoid migration problems (see xopen_network- ing(7)). AUTHOR
was developed by HP and the University of California, Berkeley. SEE ALSO
read(2), socket(2), write(2), privileges(5), thread_safety(5), xopen_networking(7). STANDARDS CONFORMANCE
socketpair(2)
