Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   20652 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

socketpair(3SOCKET)	   Sockets Library Functions	   socketpair(3SOCKET)

NAME
       socketpair - create a pair of connected sockets

SYNOPSIS
       cc [ flag ... ] file ... -lsocket -lnsl [ library ... ]
       #include <sys/types.h>
       #include <sys/socket.h>

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

DESCRIPTION
       The  socketpair()  library  call	 creates  an unnamed pair of connected
       sockets in the specified address family domain, of the specified	 type,
       that  uses  the optionally specified protocol. The descriptors that are
       used in referencing the new sockets are returned in  sv[0]  and	sv[1].
       The two sockets are indistinguishable.

RETURN VALUES
       socketpair() returns −1 on failure and 0 on success.

ERRORS
       The call succeeds unless:

       EAFNOSUPPORT		       The  specified  address	family	is not
				       supported on this machine.

       EMFILE			       Too many descriptors are in use by this
				       process.

       ENOMEM			       There  was insufficient user memory for
				       the operation to complete.

       ENOSR			       There   were    insufficient    STREAMS
				       resources  for  the  operation  to com‐
				       plete.

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

       EPROTONOSUPPORT		       The specified protocol is not supported
				       on this machine.

       EACCES			       The process does not  have  appropriate
				       privileges.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      ATTRIBUTE TYPE	     │	    ATTRIBUTE VALUE	   │
       ├─────────────────────────────┼─────────────────────────────┤
       │MT-Level		     │Safe			   │
       └─────────────────────────────┴─────────────────────────────┘

SEE ALSO
       pipe(2), read(2), write(2), socket.h(3HEAD), attributes(5)

NOTES
       This call is currently implemented only for the AF_UNIX address family.

SunOS 5.10			  10 Jan 2001		   socketpair(3SOCKET)

Vote for polarhome