Differences between version 5 and predecessor to the previous major change of socketpair(2).
Other diffs: Previous Revision, Previous Author, or view the Annotated Edit History
| Newer page: | version 5 | Last edited on Saturday, May 31, 2003 3:17:45 am | by PerryLorier | Revert |
| Older page: | version 1 | Last edited on Tuesday, June 4, 2002 12:23:47 am | by perry | Revert |
@@ -1,86 +1,32 @@
-SOCKETPAIR
-!!!SOCKETPAIR
-NAME
-SYNOPSIS
-DESCRIPTION
-RETURN VALUE
-ERRORS
-CONFORMING TO
-SEE ALSO
-----
!!NAME
-
-
socketpair - create a pair of connected sockets
!!SYNOPSIS
+ __#include <sys/types.h>__
+ __#include <sys/socket.h>__
+__int socketpair(int__ ''d''__, int__ ''type''__, int__ ''protocol''__, int__ ''sv''__[[2]);__
-__#include __
-#include __
-
-
-__int socketpair(int__ ''d''__, int__
-''type''__, int__ ''protocol''__, int__
-''sv''__[[2]);__
!!DESCRIPTION
+The call creates an unnamed pair of connected sockets in the specified domain ''d'', of the specified ''type'', and using the optionally specified ''protocol''. The
+descriptors used in referencing the new sockets are returned in ''sv''[[0] and ''sv''[[1]. The two sockets are indistinguishable.
-
-call creates an unnamed pair of connected sockets in the
-specified
domain ''d''
, of
the specified ''
type''
, and
-using the optionally specified ''protocol''. The
-descriptors used in referencing the new sockets are returned
-in ''sv''[[] and ''sv''[[1]. The two sockets are
-indistinguishable
.
+The domain is a protocol family, such as AF_UNIX (see unix(7))
, the type is a type of socket
, such as SOCK_STREAM, SOCK_SEQPACKET or SOCK_DGRAM
.
!!RETURN VALUE
+On success, zero is returned. On error, -1 is returned, and ''errno'' is set appropriately.
-
-On success, zero is returned. On error, -1 is returned, and
-''errno'' is set appropriately.
!!ERRORS
+;[EMFILE]: Too many descriptors are in use by this process.
+;[ENFILE]: Not enough file descriptors available system wide.
+;[EAFNOSUPPORT]: The specified address family is not supported on this machine.
+;[EPROTONOSUPPORT]: The specified protocol is not supported on this machine.
+;[EOPNOSUPPORT]: The specified protocol does not support creation of socket pairs.
+;[EFAULT]: The address ''sv'' does not specify a valid part of the process address space.
+;[ENOMEM]: Insufficient memory was available to fulfill the request.
+;[ENOBUFS]: Insufficient resources were available in the system to perform the operation.
+;[EACCES]: Permission denied (Documented by [POSIX])
-
-__EMFILE__
-
-
-Too many descriptors are in use by this
-process.
-
-
-__EAFNOSUPPORT__
-
-
-The specified address family is not supported on this
-machine.
-
-
-__EPROTONOSUPPORT__
-
-
-The specified protocol is not supported on this
-machine.
-
-
-__EOPNOSUPPORT__
-
-
-The specified protocol does not support creation of socket
-pairs.
-
-
-__EFAULT__
-
-
-The address ''sv'' does not specify a valid part of the
-process address space.
!!CONFORMING TO
-
-
-
-
-
+4.4BSD (the __socketpair__ function call appeared in 4.2BSD). Generally portable to/from non-BSD systems supporting clones of the BSD socket layer (including System
V variants).
!!SEE ALSO
-
-
read(2), write(2), pipe(2)
-----
