socketpair man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

socketpair(2)							 socketpair(2)

NAME
       socketpair - Create a pair of connected sockets

SYNOPSIS
       #include <sys/socket.h>

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

STANDARDS
       Interfaces  documented on this reference page conform to industry stan‐
       dards as follows:

       socketpair(): XNS4.0, XNS5.0

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

PARAMETERS
       Specifies  the  communications domain in which the sockets are created.
       This function does not create sockets in the Internet  domain.	Speci‐
       fies 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.	Speci‐
       fies a two-integer array used to	 hold  the  file  descriptors  of  the
       socket pair created with the call to this function.

DESCRIPTION
       The  socketpair() function creates an unnamed pair of connected sockets
       in a specified domain, of a specified type, under the protocol  option‐
       ally  specified	by the protocol parameter. The two sockets are identi‐
       cal. 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 proto‐
       cols.

       Not all protocol families support the socketpair() function.

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

ERRORS
       If the socketpair() function fails, errno may be set to one of the fol‐
       lowing  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  com‐
       plete  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 proto‐
       col 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
       Functions: socket(2)

       Standards: standards(5)

       Network Programmer's Guide

								 socketpair(2)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net