unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

SOCKETPAIR(2)                 System Calls Manual                SOCKETPAIR(2)



NAME
       socketpair - create a pair of connected sockets

SYNOPSIS
       #include <&lt;sys/types.h>&gt;
       #include <&lt;sys/socket.h>&gt;

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

DESCRIPTION
       The socketpair() system call creates an unnamed pair of connected sock-
       ets 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 VALUES
       socketpair() returns:

       0      on success.

       -1     on failure and sets errno to indicate the error.

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

       EFAULT              The address sv does not specify a valid part of the
                           process address space.

       EMFILE              Too many descriptors are in use by this process.

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

       EPROTONOSUPPORT     The specified protocol is  not  supported  on  this
                           machine.

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

BUGS
       This call is currently implemented only for the AF_UNIX address family.



                                21 January 1990                  SOCKETPAIR(2)