4.3BSD-UWisc/man/cat2/socketpair.2

Compare this file to the similar file:
Show the results in this format:



SOCKETPAIR(2)       UNIX Programmer's Manual        SOCKETPAIR(2)



NAME
     socketpair - create a pair of connected sockets

SYNOPSIS
     #include <sys/types.h>
     #include <sys/socket.h>

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

DESCRIPTION
     The _s_o_c_k_e_t_p_a_i_r call creates an unnamed pair of connected
     sockets in the specified domain _d, of the specified _t_y_p_e,
     and using the optionally specified _p_r_o_t_o_c_o_l.  The descrip-
     tors used in referencing the new sockets are returned in
     _s_v[0] and _s_v[1].  The two sockets are indistinguishable.

DIAGNOSTICS
     A 0 is returned if the call succeeds, -1 if it fails.

ERRORS
     The call succeeds unless:

     [EMFILE]            Too many descriptors are in use by this
                         process.

     [EAFNOSUPPORT]      The specified address family is not sup-
                         ported on this machine.

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

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

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

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

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











Printed 12/27/86          May 15, 1985                          1