SOCKETPAIR(2)							 SOCKETPAIR(2)

NAME    [Toc]    [Back]

     socketpair	- create a pair	of connected sockets

SYNOPSIS    [Toc]    [Back]

     #include <sys/types.h>
     #include <sys/socket.h>

     int socketpair (int d, int	type, int protocol, int	sv[2]);

DESCRIPTION    [Toc]    [Back]

     The socketpair 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.

DIAGNOSTICS    [Toc]    [Back]

     A 0 is returned if	the call succeeds, -1 if it fails.

ERRORS    [Toc]    [Back]

     The call succeeds unless:

     [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.

SEE ALSO    [Toc]    [Back]

     read(2), write(2),	pipe(2)

NOTES    [Toc]    [Back]

     ABI-compliant versions of the above call can be obtained from
     libsocket.so.

     This call is currently implemented	only for the UNIX domain.


									PPPPaaaaggggeeee 1111