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

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]);

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.

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

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  vari-
       ants).

SEE ALSO
       read(2), write(2), pipe(2)

BSD Man Page               24 July 1993                         1