hpux man page for socketpair

socketpair(2)							System Calls Manual						     socketpair(2)

NAME
       socketpair() - create a pair of connected sockets

SYNOPSIS
DESCRIPTION
       The  system  call  creates  an  unnamed pair of connected sockets and returns two file descriptors in sv[0] and sv[1].  The two sockets are
       indistinguishable.  af specifies the address family.  See socket(2).  type specifies the semantics of communication for the socket.  proto-
       col  specifies  a  particular protocol to be used.  protocol can be specified as zero, which causes the system to choose a protocol type to
       use.

   X/Open Sockets Compilation Environment
       See xopen_networking(7).

RETURN VALUE
       returns the following values:

	      Successful completion.
	      Failure.
		     is set to indicate the error.

ERRORS
       If fails, is set to one of the following values.

	      The specified address family
				  is not supported in this version of the system.

	      The		  sv parameter is not valid.

	      The per-process file descriptor table is full.

	      The system file table is temporarily full.

	      No buffer space is available for the operation to complete.

	      The specified protocol does not support creation of socket pairs.

	      The specified protocol is not supported in this version of the system.

DEPENDENCIES
       is supported only for AF_UNIX.

WARNINGS
       Linking binary objects compiled to specification and binary objects compiled to specification to the same executable may  result  in  unex-
       pected behavior, including application abnormal termination and unexpected socket errors.  See xopen_networking(7) for details and remedy.

FUTURE DIRECTION
       Currently,  the default behavior is the however, it might be changed to in a future release.  At that time, any behavior that is incompati-
       ble with might be obsoleted.  Applications that conform to the X/Open specification now will avoid migration problems  (see  xopen_network-
       ing(7)).

AUTHOR
       was developed by HP and the University of California, Berkeley.

SEE ALSO
       read(2), socket(2), write(2), privileges(5), thread_safety(5), xopen_networking(7).

STANDARDS CONFORMANCE
																     socketpair(2)