Manual Pages for UNIX Operating System command usage for man socketpair

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.

ERRORS
     The call succeeds unless:

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


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


     EPROTONOSUPPORT    The specified protocol is  not  supported
                        on this machine.


     EACCES             The process  does  not  have  appropriate
                        privileges.




SunOS 5.11          Last change: 10 Jan 2001                    1






Sockets Library Functions                     socketpair(3SOCKET)



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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE 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  AF_UNIX
     address family.




































SunOS 5.11          Last change: 10 Jan 2001                    2