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

  
 
  

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
     * ECANCELED: Current coroutine was canceled.

     * EMFILE: The maximum number of file descriptors in the process are already
       open.

     * ENFILE:	The maximum number of file descriptors in the system are already
       open.

     * 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_listener_fromfd_mem(3)
     ipc_pair(3)

libdill 							 IPC_PAIR_MEM(3)

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

home | help