Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SOCKETPAIR(2)		   Linux Programmer's Manual		 SOCKETPAIR(2)

NAME
       socketpair - create a pair of connected sockets

SYNOPSIS
       #include	<sys/types.h>
       #include	<sys/socket.h>

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

DESCRIPTION
       The socketpair call creates an unnamed pair of connected	sockets	in the
       specified domain	d, of the specified type,  and	using  the  optionally
       specified  protocol.  The descriptors used in referencing the new sock-
       ets are returned	in sv[0] and sv[1].  The  two  sockets	are  indistin-
       guishable.

RETURN VALUE
       On  success,  zero is returned.	On error, -1 is	returned, and errno is
       set appropriately.

ERRORS
       EMFILE Too many descriptors are in use by this process.

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

       EPROTONOSUPPORT
	      The specified protocol is	not supported on this machine.

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

       EFAULT The  address  sv	does  not  specify a valid part	of the process
	      address space.

CONFORMING TO
       4.4BSD (the socketpair function call  appeared  in  4.2BSD).  Generally
       portable	 to/from  non-BSD  systems supporting clones of	the BSD	socket
       layer (including	System V variants).

NOTES
       On Linux, the only supported domain for this call is AF_UNIX  (or  syn-
       onymously,  AF_LOCAL).	(Most  implementations	have the same restric-
       tion.)

SEE ALSO
       read(2),	write(2), pipe(2), socket(2), unix(7)

BSD Man	Page			  1993-07-24			 SOCKETPAIR(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | CONFORMING TO | NOTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=socketpair&sektion=2&manpath=Red+Hat+Linux%2fi386+9>

home | help