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   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SOCKETPAIR(3SOCKET)					   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 complete.

       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.

				 Jan 10, 2001		   SOCKETPAIR(3SOCKET)

Vote for polarhome