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

  
 
  

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

NAME
     ipc_accept_mem - accepts an incoming IPC connection

SYNOPSIS
	    #include <libdill.h>

	    int ipc_accept_mem(
		int s,
		struct ipc_storage* mem,
		int64_t deadline);

DESCRIPTION
     IPC protocol is a bytestream protocol for transporting data among processes
     on the same machine.  It is an equivalent to POSIX AF_LOCAL sockets.

     This function accepts an incoming IPC connection.

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

     s: Socket created by ipc_listen.

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

     deadline: A point in time when the operation should time out, in  millisec-
     onds.  Use the now function to get your current point in time.  0 means im-
     mediate  timeout, i.e., perform the operation if possible or return without
     blocking if not.  -1 means no deadline, i.e., the call will  block  forever
     if the operation cannot be performed.

     The socket can be cleanly shut down using ipc_close function.

     This  function is not available if libdill is compiled with --disable-sock-
     ets option.

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

ERRORS
     * EBADF: Invalid handle.

     * 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.

     * ENOTSUP: The handle does not support this operation.

     * ETIMEDOUT: Deadline was reached.

EXAMPLE
	    int ls = ipc_listen("/tmp/test.ipc", 10);
	    int s = ipc_accept(ls, -1);
	    bsend(s, "ABC", 3, -1);
	    char buf[3];
	    brecv(s, buf, sizeof(buf), -1);
	    ipc_close(s);
	    ipc_close(ls);

SEE ALSO
     brecv(3) brecvl(3) bsend(3) bsendl(3) hclose(3) ipc_accept(3)  ipc_close(3)
     ipc_connect(3)	  ipc_connect_mem(3)	  ipc_done(3)	   ipc_fromfd(3)
     ipc_fromfd_mem(3)	ipc_listen(3)  ipc_listen_mem(3)  ipc_listener_fromfd(3)
     ipc_listener_fromfd_mem(3) ipc_pair(3) ipc_pair_mem(3) now(3)

libdill 						       IPC_ACCEPT_MEM(3)

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

home | help