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

FreeBSD Manual Pages

  
 
  

home | help
IPC_PAIR_MEM(3)		   libdill Library Functions	       IPC_PAIR_MEM(3)

NAME
       ipc_pair_mem - creates a	pair of	mutually connected IPC sockets

SYNOPSIS
	      #include <libdill.h>

	      int ipc_pair_mem(
		  struct ipc_pair_storage* mem,
		  int s[2]);

DESCRIPTION
       This function creates a pair of mutually	connected IPC sockets.

       This  function allows to	avoid one dynamic memory allocation by storing
       the object in user-supplied memory.  Unless  you	 are  hyper-optimizing
       use ipc_pair instead.

       mem:  The  structure to store the newly created object in.  It must not
       be deallocated before the object	is closed.

       s: Out parameter.  Two handles to the opposite ends of the connection.

       The sockets can be cleanly shut down using ipc_close function.

RETURN VALUE
       In case of success the function returns 0.  In case of error it returns
       -1 and sets errno to one	of the values below.

ERRORS
       o ECANCELED: Current coroutine was canceled.

       o EMFILE: The maximum number of file descriptors	in the process are al-
	 ready open.

       o ENFILE: The maximum number of file descriptors	in the system are  al-
	 ready open.

       o ENOMEM: Not enough memory.

EXAMPLE
	      int s[2];
	      int rc = ipc_pair(s);

SEE ALSO
       hclose(3)  ipc_accept(3)	 ipc_accept_mem(3) ipc_close(3)	ipc_connect(3)
       ipc_connect_mem(3) ipc_done(3) ipc_fromfd(3) ipc_fromfd_mem(3) ipc_lis-
       ten(3)	  ipc_listen_mem(3)	ipc_listener_fromfd(3)	   ipc_listen-
       er_fromfd_mem(3)	ipc_pair(3)

libdill							       IPC_PAIR_MEM(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=ipc_pair_mem&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help