socketpair(2)                                                 socketpair(2)




 NAME
      socketpair() - create a pair of connected sockets

 SYNOPSIS
      #include <sys/socket.h>

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

 DESCRIPTION
      The socketpair() 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.  protocol specifies a particular protocol to be used.
      protocol can be specified as zero, which causes the system to choose a
      protocol type to use.

 RETURN VALUE
      socketpair() returns the following values:

            0   Successful completion.
           -1   Failure.  errno is set to indicate the error.

 ERRORS
      If socketpair() fails, errno is set to one of the following values.

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

           [EFAULT]            The sv parameter is not valid.

           [EMFILE]            The per-process file descriptor table is
                               full.

           [ENFILE]            The system file table is temporarily full.

           [ENOBUFS]           No buffer space is available for the
                               operation to complete.

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

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

 DEPENDENCIES
      socketpair() is supported only for AF_UNIX.

 AUTHOR
      socketpair() was developed by the University of California, Berkeley.




 Hewlett-Packard Company            - 1 -    HP-UX Release 10.20:  July 1996






 socketpair(2)                                                 socketpair(2)




 FUTURE DIRECTION
      The default behavior in this release is still the classic HP-UX BSD
      Sockets, however it will be changed to X/Open Sockets in some future
      release.  At that time, any HP-UX BSD Sockets behavior which is
      incompatible with X/Open Sockets may be obsoleted.  HP customers are
      advised to migrate their applications to conform to X/Open
      specification( see xopen_networking(7) ).

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

 STANDARDS CONFORMANCE
      socketpair(): XPG4









































 Hewlett-Packard Company            - 2 -    HP-UX Release 10.20:  July 1996