libdill: Structured Concurrency for C

NAME

ipc_listen - start listening for incoming IPC connections

SYNOPSIS

#include <libdill.h>

int ipc_listen(const char *addr, int backlog);

DESCRIPTION

IPC protocol is a bytestream protocol (i.e. data can be sent via bsend() and received via brecv()) for transporting data among processes on the same machine. It is an equivalent to POSIX AF_LOCAL sockets.

This function starts listening for incoming connection on file specified in addr argument. backlog is the maximum number of connections that can be held open without user accepting them.

The socket can be cleanly shut down using ipc_close() function.

RETURN VALUE

The function returns the handle of the listening socket. On error, it returns -1 and sets errno to one of the values below.

ERRORS

EXAMPLE

int s = ipc_listen("/tmp/test.ipc", -1);