2.11BSD/man/cat2/socketpair.0

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 11/26/99	  May 15, 1985				1