NAME    [Toc]    [Back]

       socketpair - Create a pair of connected sockets

SYNOPSIS    [Toc]    [Back]

       #include <sys/socket.h>

       int socketpair(
               int domain,
               int type,
               int protocol,
               int socket_vector[2] );

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       socketpair(): XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       Specifies  the  communications domain in which the sockets
       are created. This function does not create sockets in  the
       Internet domain.  Specifies the communications method that
       sockets use, for example SOCK_DGRAM or SOCK_STREAM.  Specifies
 an optional identifier used to define the communications
 protocols used in  the  transport  layer  interface.
       Specifies  a  two-integer  array  used  to  hold  the file
       descriptors of the socket pair created with  the  call  to
       this function.

DESCRIPTION    [Toc]    [Back]

       The  socketpair() function creates an unnamed pair of connected
 sockets in a specified domain, of a specified type,
       under  the  protocol  optionally specified by the protocol
       parameter.  The  two  sockets  are  identical.  The   file
       descriptors  used  in  referencing the created sockets are
       returned to  socket_vector[0]  and  socket_vector[1].  The
       sys/socket.h  include file contains definitions for socket
       domains, types, and protocols.

       Not all protocol families support the  socketpair()  function.

RETURN VALUES    [Toc]    [Back]

       Upon  successful completion, this function returns a value
       of 0 (zero).  Otherwise, -1 is returned and errno is specified
 to indicate the error.

ERRORS    [Toc]    [Back]

       If  the  socketpair()  function fails, errno may be set to
       one of the following values: The  process  have  not  have
       appropriate  privileges.   The  addresses in the specified
       address family cannot be used to create this socket  pair.
       [Tru64  UNIX]  The socket_vector array is not located in a
       writable part of user address space.  The current  process
       has too many open file descriptors.  No more file descriptors
 are available for the system.  Insufficient resources
       were  available  in  the system to complete the call.  The
       system was unable to allocate kernel  memory  to  increase
       the  process  descriptor  table.   The  available  STREAMS
       resources were insufficient for the operation to complete.
       The  specified protocol does not permit creation of socket
       pairs.  The specified protocol cannot be used in this system.
  The socket type is not supported by the protocol.

SEE ALSO    [Toc]    [Back]

       Functions: socket(2)

       Standards: standards(5)

       Network Programmer's Guide



                                                    socketpair(2)