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

RETURN VALUE    [Toc]    [Back]

       On success, zero is returned.  On error, -1 is returned, and  errno  is
       set appropriately.

ERRORS    [Toc]    [Back]

       EMFILE Too many descriptors are in use by this process.

       EAFNOSUPPORT    [Toc]    [Back]
	      The specified address family is not supported on this machine.

       EPROTONOSUPPORT    [Toc]    [Back]
	      The specified protocol is not supported on this machine.

       EOPNOSUPPORT    [Toc]    [Back]
	      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    [Toc]    [Back]

       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    [Toc]    [Back]

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



BSD Man Page			  1993-07-24			 SOCKETPAIR(2)