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

FreeBSD Manual Pages

  
 
  

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

NAME
       ipc_listen_mem -	starts listening for incoming IPC connections

SYNOPSIS
	      #include <libdill.h>

	      int ipc_listen_mem(
		  const	char* addr,
		  int backlog,
		  struct ipc_listener_storage* mem);

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 starts listening for incoming IPC	connections.  The con-
       nections	can be accepted	using ipc_accept function.

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

       addr: The filename to listen on.

       backlog:	Maximum	number of connections that can be  kept	 open  without
       accepting them.

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

       The socket can be closed	either by hclose or ipc_close.	Both ways  are
       equivalent.

       This  function  is  not	available  if  libdill is compiled with	--dis-
       able-sockets option.

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

ERRORS
       o EACCES: The process does not have appropriate privileges.

       o EADDRINUSE: The specified address is already in use.

       o EINVAL: Invalid argument.

       o ELOOP:	 A loop	exists in symbolic links encountered during resolution
	 of the	pathname in address.

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

       o ENAMETOOLONG: A component of a	pathname exceeded NAME_MAX characters,
	 or an entire pathname exceeded	PATH_MAX characters.

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

       o ENOENT: A component of	the pathname does not name an existing file or
	 the pathname is an empty string.

       o ENOMEM: Not enough memory.

       o ENOTDIR: A component of the path prefix of the	pathname in address is
	 not a directory.

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_ac-
       cept_mem(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_listener_fromfd(3)
       ipc_listener_fromfd_mem(3) ipc_pair(3) ipc_pair_mem(3)

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

home | help