libdill: Structured Concurrency for C

NAME

ipc_connect - create a connection to remote IPC endpoint

SYNOPSIS

#include <libdill.h>

int ipc_connect(const char *addr, int64_t deadline);

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.

Creates a connection to a peer listening on the file specified by addr argument.

deadline is a point in time when the operation should time out. Use the now() function to get your current point in time. 0 means immediate 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.

RETURN VALUE

Newly created socket handle. On error, it returns -1 and sets errno to one of the values below.

ERRORS

EXAMPLE

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