Sockets Library Functions                     socketpair(3SOCKET)



NAME
     socketpair - create a pair of connected sockets

SYNOPSIS
     cc [ flag ... ] file ... -lsocket  -lnsl  [ library ... ]
     #include 
     #include 

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


DESCRIPTION
     The socketpair() library call creates  an  unnamed  pair  of
     connected sockets in the specified address family domain, of
     the specified type, that uses the optionally specified  pro-
     tocol.  The descriptors that are used in referencing the new
     sockets are returned in sv[0] and sv[1]. The two sockets are
     indistinguishable.

RETURN VALUES
     socketpair() returns -1 on failure and 0 on success.

ERORS
     The call succeeds unless:

     EAFNOSUPORT       The specified address family is not  sup-
                        ported on this machine.


     EMFILE             Too many descriptors are in use  by  this
                        process.


     ENOMEM             There was insufficient  user  memory  for
                        the operation to complete.


     ENOSR              There were insufficient STREAMS resources
                        for the operation to complete.


     EOPNOTSUP         The specified protocol does  not  support
                        creation of socket pairs.


     EPROTONOSUPORT    The specified protocol is  not  supported
                        on this machine.


     EACES             The process  does  not  have  appropriate
                        privileges.




SunOS 5.11          Last change: 10 Jan 2001                    1






Sockets Library Functions                     socketpair(3SOCKET)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Safe                        
    


SEE ALSO
     pipe(2), read(2), write(2), socket.h(3HEAD), attributes(5)

NOTES
     This call is currently  implemented  only  for  the  AFUNIX
     address family.




































SunOS 5.11          Last change: 10 Jan 2001                    2