socketpair(3N)                                               socketpair(3N)

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 socketpair() library call creates an unnamed pair of connected
     sockets in the specified address family 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
     socketpair() returns a -1 on failure, otherwise it returns the number
     of the second file descriptor it creates.

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

     ENOMEM              The user memory was not sufficient to complete the
                         operation.

     ENOSR               The STREAMS resources were not sufficient to com-
                         plete the operation.

NOTE
     This call is currently implemented only for the AFUNIX address fam-
     ily.

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









Page 1                       Reliant UNIX 5.44                Printed 11/98