2.11BSD#431 - /usr/man/cat2/socketpair.0

SOCKETPAIR(2)	    UNIX Programmer's Manual	    SOCKETPAIR(2)


NAME
     socketpair - create a pair of connected sockets

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

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

DESCRIPTION
     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 descrip-
     tors used in referencing the new sockets are returned in
     sv[0] and sv[1].  The two sockets are indistinguishable.

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

ERRORS
     The call succeeds unless:

     [EMFILE]		 Too many descriptors are in use by this
			 process.

     [EAFNOSUPPORT]	 The specified address family is not sup-
			 ported 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
     read(2), write(2), pipe(2)

BUGS
     This call is currently implemented only for the UNIX domain.


Printed 11/26/99	  May 15, 1985				1