SOCKETPAIR(2) BSD System Calls Manual SOCKETPAIR(2)

NAME
     ssoocckkeettppaaiirr - create a pair of connected sockets

SYNOPSIS
     ##iinncclluuddee <>

     int
     ssoocckkeettppaaiirr(int domain, int type, int protocol, int socketvector[2]);

DESCRIPTION
     The ssoocckkeettppaaiirr() call creates an unnamed pair of connected sockets in the
     specified domain domain, of the specified type, and using the optionally
     specified protocol.  The descriptors used in referencing the new sockets
     are returned in socketvector[0] and socketvector[1].  The two sockets
     are indistinguishable.

RETURN VALUES
     The ssoocckkeettppaaiirr() function returns the value 0 if successful; otherwise
     the value -1 is returned and the global variable errno is set to indicate
     the error.

EERRRROORRSS
     The call succeeds unless:

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

     [EFAULT]           The address socketvector does not specify a valid
                        part of the process address space.

     [EMFILE]           No more file descriptors are available for this
                        process.

     [ENFILE]           No more file descriptors are available for the system.

     [ENOBUFS]          Insufficient resources were available in the system to
                        perform the operation.

     [ENOMEM]           Insufficient memory was available to fulfill the
                        request.

     [EOPNOTSUPP]       The specified protocol does not support creation of
                        socket pairs.

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

     [EPROTOTYPE]       The socket type is not supported by the protocol.

LEGACY SYNOPSIS
     ##iinncclluuddee <>
     ##iinncclluuddee <>

     The include file  is necessary.

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

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

HISTORY     The ssoocckkeettppaaiirr() function call appeared in 4.2BSD.

4.2 Berkeley Distribution        June 4, 1993        4.2 Berkeley Distribution