[0m


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



[1mNAME
     [0msocketpair - create a pair of connected sockets

[1mSYNOPSIS
     #include <sys/types.h>
     #include <sys/socket.h>

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

DESCRIPTION
     [0mThe _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.

[1mDIAGNOSTICS
     [0mA 0 is returned if the call succeeds, -1 if it fails.

[1mERRORS
     [0mThe 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.

[1mSEE ALSO
     [0mread(2), write(2), pipe(2)

[1mBUGS
     [0mThis call is currently implemented only for the UNIX domain.











Printed 12/11/92    Revision 1.2 of 19/10/88			1



[0m