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

FreeBSD Manual Pages

  
 
  

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 pro-
       cesses 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  mil-
       liseconds.   Use	the now	function to get	your current point in time.  0
       means immediate timeout,	i.e., perform the operation if possible	or re-
       turn  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	--dis-
       able-sockets 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  be-
       low.

ERRORS
       o EBADF:	Invalid	handle.

       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.

       o ENOTSUP: The handle does not support this operation.

       o 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)

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_accept_mem&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help