Differences between version 3 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 3 | Last edited on Saturday, May 31, 2003 3:09:52 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,27 @@
-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.
-
-
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''[[] and ''sv''[[1]. The two sockets are
-indistinguishable.
+The domain is a protocol family
, such as AF_UNIX (see unix(7))
!!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.
-
-
-__
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.
+;[
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
+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)
-----