libipc-old/src/communication.c

#include <sys/select.h>
#include <unistd.h>

#include <stdio.h>
#include <errno.h>		// error numbers

#include <poll.h>

#include <stdlib.h>
#include <string.h>

#include "ipc.h"
#include "utils.h"

// print structures
#include "message.h"

struct ipc_error
service_path (char *path, const char *sname)
{
	T_R ((path == NULL), IPC_ERROR_SERVICE_PATH__NO_PATH);
	T_R ((sname == NULL), IPC_ERROR_SERVICE_PATH__NO_SERVICE_NAME);

	memset (path, 0, PATH_MAX);

	char *rundir = getenv ("IPC_RUNDIR");
	if (rundir == NULL)
		rundir = RUNDIR;

	snprintf (path, PATH_MAX - 1, "%s/%s", rundir, sname);

	IPC_RETURN_NO_ERROR;
}

struct ipc_error ipc_ctx_init (struct ipc_ctx **ctx)
{
	T_R ((ctx == NULL),  IPC_ERROR_CTX_INIT__NO_CONTEXT_PARAM);
	T_R ((*ctx != NULL), IPC_ERROR_CTX_INIT__CONTEXT_ALREADY_INIT);

	*ctx = malloc(sizeof(struct ipc_ctx));
	T_R ((*ctx == NULL), IPC_ERROR_CTX_INIT__MALLOC_CTX);
	memset (ctx, 0, sizeof(struct ipc_ctx));

	IPC_RETURN_NO_ERROR;
}

/**
 * PERFORMANCE POINT:
 *   Realloc is performed at each new user. There is plenty of room for improvement,
 *   for example by managing allocations of thousands of structures at once.
 * WARNING: Store and remove only pointers on allocated structures.
 */
struct ipc_error
ipc_ctx_new_alloc (struct ipc_ctx *ctx)
{
	ctx->size++;

	// Memory could be not allocated, yet.
	if (ctx->size == 1 && ctx->cinfos == NULL && ctx->pollfd == NULL) {
		SECURE_BUFFER_HEAP_ALLOCATION_R (ctx->cinfos, sizeof (struct ipc_connection_info),,
						IPC_ERROR_ADD__MALLOC);
		SECURE_BUFFER_HEAP_ALLOCATION_R (ctx->pollfd, sizeof (struct pollfd),,
						IPC_ERROR_ADD__MALLOC_POLLFD);
	} else {
		ctx->cinfos = realloc (ctx->cinfos, sizeof (struct ipc_connection_info) * ctx->size);
		ctx->pollfd = realloc (ctx->pollfd, sizeof (struct pollfd             ) * ctx->size);
	}

	T_R ((ctx->cinfos == NULL), IPC_ERROR_ADD__EMPTY_LIST);
	T_R ((ctx->pollfd == NULL), IPC_ERROR_ADD__EMPTY_LIST);

	// Clean the last entry.
	memset (ctx->cinfos[ctx-size -1], 0, sizeof (struct ipc_connection_info));
	memset (ctx->pollfd[ctx-size -1], 0, sizeof (struct pollfd));

	IPC_RETURN_ERROR;
}

struct ipc_error
ipc_server_init (char **env, struct ipc_ctx **ctx, const char *sname)
{
	T_R ((env == NULL),   IPC_ERROR_SERVER_INIT__NO_ENVIRONMENT_PARAM);
	T_R ((sname == NULL), IPC_ERROR_SERVER_INIT__NO_SERVER_NAME_PARAM);

	ipc_ctx_init(ctx);

	// gets the service path
	SECURE_BUFFER_DECLARATION (char, buf, PATH_MAX);
	TEST_IPC_RR (service_path (buf, sname), "cannot get server path");

	size_t s = strlen (buf);

	SECURE_DECLARATION (struct ipc_connection_info, srv);
	srv.type = IPC_CONNECTION_TYPE_SERVER;
	SECURE_DECLARATION(struct pollfd, pollfd);
	pollfd.events = POLLIN;

	SECURE_BUFFER_HEAP_ALLOCATION_R (srv.spath, s + 1,, IPC_ERROR_SERVER_INIT__MALLOC);
	memcpy (srv.spath, buf, s);
	srv.spath[s] = '\0';	// to be sure

	TEST_IPC_RETURN_ON_ERROR (usock_init (&pollfd.fd, srv.spath));

	// Add the server to the listened file descriptors.
	TEST_IPC_RR (ipc_add (*ctx, &srv, &pollfd), "cannot add the server in the context");

	IPC_RETURN_NO_ERROR;
}

struct ipc_error ipc_write_fd (int fd, const struct ipc_message *m);

// when networkd is not working properly (or do not retrieve the service): srv->fd = 0
struct ipc_error ipc_contact_networkd (int *pfd, const char *sname)
{
	T_R ((pfd == NULL),   IPC_ERROR_CONTACT_NETWORKD__NO_FD_PARAM);
	T_R ((sname == NULL), IPC_ERROR_CONTACT_NETWORKD__NO_SERVICE_NAME_PARAM);

	char *networkvar = getenv ("IPC_NETWORK");
	if (networkvar == NULL) {
		*pfd = 0;
		IPC_RETURN_NO_ERROR;
	}
	// TODO: is there another, more interesting way to do this?
	// currently, IPC_NETWORK is shared with the network service
	// in order to route requests over any chosen protocol stack
	// ex: IPC_NETWORK="audio tor://some.example.com/audio ;pong tls://pong.example.com/pong"

	// printf ("IPC_NETWORK: %s\n", networkvar);

	SECURE_BUFFER_DECLARATION (char, columnthensname, BUFSIZ);
	columnthensname[0] = ';';
	memcpy (columnthensname + 1, sname, strlen (sname));

	if (strncmp (networkvar, sname, strlen (sname)) != 0 && strstr (networkvar, columnthensname) == NULL) {
		// printf ("sname %s not found\n", sname);
		*fd = 0;
		IPC_RETURN_NO_ERROR;
	}

	// Get the service path.
	SECURE_BUFFER_DECLARATION (char, buf, PATH_MAX);
	TEST_IPC_RR (service_path (buf, "network"), "cannot get network service path");

	int networkdfd = 0;

	TEST_IPC_RETURN_ON_ERROR (usock_connect (&networkdfd, buf));

	SECURE_DECLARATION (struct ipc_message, msg);
	msg.type = MSG_TYPE_NETWORK_LOOKUP;
	msg.user_type = MSG_TYPE_NETWORK_LOOKUP;

	SECURE_BUFFER_DECLARATION (char, content, BUFSIZ);
	snprintf (content, BUFSIZ, "%s;%s", sname, networkvar);

	msg.length = strlen (content);
	msg.payload = content;

	TEST_IPC_RR (ipc_write_fd (networkdfd, &msg), "cannot send a message to networkd");

	struct ipc_error ret = ipc_receive_fd (networkdfd, pfd);
	if (ret.error_code == IPC_ERROR_NONE) {
		usock_close (networkdfd);
	}

	return ret;
}

// Create context, contact networkd, connects to the service.
struct ipc_error ipc_connection (char **env, struct ipc_ctx **ctx, const char *sname)
{
	T_R ((env == NULL),   IPC_ERROR_CONNECTION__NO_ENVIRONMENT_PARAM);
	T_R ((ctx == NULL),   IPC_ERROR_CONNECTION__NO_CTX);
	T_R ((sname == NULL), IPC_ERROR_CONNECTION__NO_SERVICE_NAME);

	ipc_ctx_init(ctx);        // Allocate memory for the context.

	SECURE_DECLARATION(struct ipc_connection_info, srv);
	srv.type = IPC_CONNECTION_TYPE_IPC; // Data received on the socket = messages, not new clients.
	SECURE_DECLARATION(struct pollfd, pollfd);
	pollfd.events = POLLIN;

	TEST_IPC_P (ipc_contact_networkd (&pollfd.fd, sname), "error during networkd connection");

	// if networkd did not initiate the connection
	if (pollfd.fd <= 0) {
		// gets the service path
		SECURE_BUFFER_DECLARATION (char, buf, PATH_MAX);
		TEST_IPC_RR (service_path (buf, sname), "cannot get server path");
		TEST_IPC_RETURN_ON_ERROR (usock_connect (&pollfd.fd, buf));
	}

	// Add the server to the listened file descriptors.
	TEST_IPC_RR (ipc_add (*ctx, &srv, &pollfd), "cannot add the server in the context");

	IPC_RETURN_NO_ERROR;
}

struct ipc_error ipc_server_close (struct ipc_connection_info *srv)
{
	usock_close (srv->pollfd.fd);
	struct ipc_error ret = usock_remove (srv->spath);
	if (srv->spath != NULL) {
		free (srv->spath);
		srv->spath = NULL;
	}
	return ret;
}

struct ipc_error ipc_close (struct ipc_connection_info *p)
{
	return usock_close (p->pollfd.fd);
}

struct ipc_error ipc_accept (
	  struct ipc_connection_info *srv
	, struct ipc_connection_info *p)
{
	T_R ((srv == NULL), IPC_ERROR_ACCEPT__NO_SERVICE_PARAM);
	T_R ((p == NULL), IPC_ERROR_ACCEPT__NO_CLIENT_PARAM);

	TEST_IPC_RR (usock_accept (srv->pollfd.fd, &p->pollfd.fd), "cannot accept IPC connection");
	p->pollfd.events = POLLIN; // Tell to poll(2) to watch for incoming data from this fd.
	p->type = IPC_CONNECTION_TYPE_IPC;

	IPC_RETURN_NO_ERROR;
}

// receive then format in an ipc_message structure
struct ipc_error ipc_read (const struct ipc_connection_info *p, struct ipc_message *m)
{
	T_R ((m == NULL), IPC_ERROR_READ__NO_MESSAGE_PARAM);

	char *buf = NULL;
	size_t msize = IPC_MAX_MESSAGE_SIZE;

	// on error or closed recipient, the buffer already freed
	TEST_IPC_RETURN_ON_ERROR (usock_recv (p->pollfd.fd, &buf, &msize));
	TEST_IPC_RETURN_ON_ERROR_FREE (ipc_message_format_read (m, buf, msize), buf);

	free (buf);

	IPC_RETURN_NO_ERROR;	// propagates ipc_message_format return
}

struct ipc_error ipc_write_fd (int fd, const struct ipc_message *m)
{
	T_R ((m == NULL), IPC_ERROR_WRITE__NO_MESSAGE_PARAM);

	char *buf = NULL;
	size_t msize = 0;
	ipc_message_format_write (m, &buf, &msize);

	size_t nbytes_sent = 0;
	TEST_IPC_RETURN_ON_ERROR_FREE (usock_send (fd, buf, msize, &nbytes_sent), buf);

	if (buf != NULL) {
		free (buf);
	}
	// what was sent != what should have been sent
	T_R ((nbytes_sent != msize), IPC_ERROR_WRITE__NOT_ENOUGH_DATA);

	IPC_RETURN_NO_ERROR;
}

struct ipc_error ipc_write (const struct ipc_connection_info *p, const struct ipc_message *m)
{
	return ipc_write_fd (p->pollfd.fd, m);
}

// New connection from a client.
struct ipc_error
ipc_accept_add (struct ipc_event *event, struct ipc_ctx *ctx, uint32_t i)
{
	T_R ((ctx == NULL), IPC_ERROR_HANDLE_NEW_CONNECTION__NO_CINFOS_PARAM);
	T_R ((i >= ctx->size),  IPC_ERROR_HANDLE_NEW_CONNECTION__INCONSISTENT_INDEX);

	// Memory reallocation.
	ipc_ctx_new_alloc (ctx);

	TEST_IPC_RR (usock_accept (ctx->pollfd[i].fd, &ctx->pollfd[ctx->size -1].fd), "cannot accept IPC connection");
	ctx->pollfd[ctx->size -1].events = POLLIN; // Tell to poll(2) to watch for incoming data from this fd.
	ctx->cinfos[ctx->size -1].type = IPC_CONNECTION_TYPE_IPC;

	struct ipc_connection_info *new_client = &ctx->cinfos[ctx->size];
	ctx->size++;

	IPC_EVENT_SET (event, IPC_EVENT_TYPE_CONNECTION, NULL, new_client);
	IPC_RETURN_NO_ERROR;
}

// new message
struct ipc_error handle_message (
	  struct ipc_event *event
	, struct ipc_ctx *ctx
	, struct ipc_connection_info *pc, struct ipc_switchings *switchdb)
{
	// if the socket is associated to another one for networkd
	// read and write automatically and provide a new IPC_EVENT_TYPE indicating the switch
	if (switchdb != NULL) {
		int talkingfd = pc->pollfd.fd;
		int correspondingfd = ipc_switching_get (switchdb, talkingfd);
		if (correspondingfd != -1) {
			char *buf = NULL;
			size_t msize = 0;

			TEST_IPC_T_P_I_R (
						/* function to test */ usock_recv (talkingfd, &buf, &msize)
						, /* error condition */ ret.error_code != IPC_ERROR_NONE
						&& ret.error_code != IPC_ERROR_CLOSED_RECIPIENT
						, /* to do on error */ if (buf != NULL) free (buf);
						IPC_EVENT_SET (event, IPC_EVENT_TYPE_ERROR, NULL, pc)
						, /* return function */ return (ret)) ;

			/** TODO: there is a message, send it to the corresponding fd **/
			if (msize > 0) {
				size_t nbytes_sent = 0;
				TEST_IPC_RETURN_ON_ERROR_FREE (usock_send (correspondingfd, buf, msize, &nbytes_sent), buf);

				if (nbytes_sent != msize) {
					// LOG_ERROR ("wrote not enough data from %d to fd %d", talkingfd, correspondingfd);
					IPC_EVENT_SET (event, IPC_EVENT_TYPE_ERROR, NULL, pc);
					IPC_RETURN_NO_ERROR;	// FIXME: return something else, maybe?
				}
				// LOG_DEBUG ("received a message on fd %d => switch to fd %d", talkingfd, correspondingfd);

				if (buf != NULL)
					free (buf);

				// everything is OK: inform networkd of a successful transfer
				IPC_EVENT_SET (event, IPC_EVENT_TYPE_SWITCH, NULL, pc);
				IPC_RETURN_NO_ERROR;
			} else if (msize == 0) {
				int delfd;

				delfd = ipc_switching_del (switchdb, talkingfd);
				if (delfd >= 0) {
					close (delfd);
					ipc_del_fd (ctx, delfd);
				}

				close (talkingfd);
				ipc_del_fd (ctx, talkingfd);

#if 0
				if (delfd >= 0) {
					LOG_DEBUG ("disconnection of %d (and related fd %d)", talkingfd, delfd);
				} else {
					LOG_DEBUG ("disconnection of %d", talkingfd);
				}
#endif

				IPC_EVENT_SET (event, IPC_EVENT_TYPE_DISCONNECTION, NULL, pc);
				IPC_RETURN_ERROR (IPC_ERROR_CLOSED_RECIPIENT);
			}
		}
	}
	// no treatment of the socket if external socket
	if (pc->type == IPC_CONNECTION_TYPE_EXTERNAL) {
		IPC_EVENT_SET (event, IPC_EVENT_TYPE_EXTRA_SOCKET, NULL, pc);
		IPC_RETURN_NO_ERROR;
	}
	// listen to what they have to say (disconnection or message)
	// then add a client to `event`, the ipc_event structure
	SECURE_DECLARATION (struct ipc_error, ret);
	struct ipc_message *m = NULL;

	SECURE_BUFFER_HEAP_ALLOCATION_R (m, sizeof (struct ipc_message),, IPC_ERROR_HANDLE_MESSAGE__NOT_ENOUGH_MEMORY);

	// current talking client
	ret = ipc_read (pc, m);
	if (ret.error_code != IPC_ERROR_NONE && ret.error_code != IPC_ERROR_CLOSED_RECIPIENT) {
		struct ipc_error rvalue = ret;	// store the final return value
		ipc_message_empty (m);
		free (m);

		// if there is a problem, just remove the client
		TEST_IPC_P (ipc_close (pc), "cannot close a connection in handle_message");
		TEST_IPC_P (ipc_del (ctx, pc), "cannot delete a connection in handle_message");

		IPC_EVENT_SET (event, IPC_EVENT_TYPE_ERROR, NULL, pc);
		return rvalue;
	}
	// disconnection: close the client then delete it from ctx
	if (ret.error_code == IPC_ERROR_CLOSED_RECIPIENT) {
		TEST_IPC_P (ipc_close (pc), "cannot close a connection on closed recipient in handle_message");
		TEST_IPC_P (ipc_del (ctx, pc), "cannot delete a connection on closed recipient in handle_message");

		ipc_message_empty (m);
		free (m);

		IPC_EVENT_SET (event, IPC_EVENT_TYPE_DISCONNECTION, NULL, pc);

		// warning: do not forget to free the ipc_client structure
		IPC_RETURN_NO_ERROR;
	}

	IPC_EVENT_SET (event, IPC_EVENT_TYPE_MESSAGE, m, pc);
	IPC_RETURN_NO_ERROR;
}

// TODO
struct ipc_error
handle_writing_message (struct ipc_event *events, struct ipc_ctx *ctx, uint32_t i);
struct ipc_error
handle_writing_message (struct ipc_event *events, struct ipc_ctx *ctx, uint32_t i)
{
	IPC_RETURN_NO_ERROR;
}

struct ipc_error
ipc_events_loop (
	  struct ipc_ctx  *ctx
	, struct ipc_connection_info   *cinfo // NULL for clients
	, struct ipc_event             *event
	, struct ipc_switchings        *switchdb
	, struct ipc_messages          *messages_to_send
	, int                          *timer /* in ms */)
{
	T_R ((ctx == NULL), IPC_ERROR_WAIT_EVENT__NO_CLIENTS_PARAM);
	T_R ((event  == NULL), IPC_ERROR_WAIT_EVENT__NO_EVENT_PARAM);

	IPC_EVENT_CLEAN (event);

	int				i, n, listenfd, client_fd, nread;
	uid_t			uid;

	// Generate the array of pollfd structure once, then use it each time.
	// TODO: ça ailleurs: if ( (ctx->pollfd = malloc(sizeof(struct pollfd))) == NULL)
	// TODO: ça ailleurs: 	err_sys("malloc error");
	// TODO: ça ailleurs: client_add(listenfd, 0);	/* we use [0] for listenfd */
	// TODO: ça ailleurs: ctx->pollfd[0].fd = listenfd;
	// TODO: ça ailleurs: ctx->pollfd[0].events = POLLIN;

	if ((n = poll(ctx->pollfd, ctx->size, *timer)) < 0)
	{
		log_sys("select error");
	}
	
	// Timeout.
	if (n == 0) {
		// TODO: timeout
	}

	for (i = 0; i <= ctx->size; i++) {
		// Something to read or connection.
		if (ctx->pollfd[i].revents & POLLIN)
		{
			// In case there is something to read for the server socket: new client.
			if (ctx->cinfos[i].type == IPC_CONNECTION_TYPE_SERVER) {
				return ipc_accept_add (event, ctx, i);
			}

			return handle_message (event, ctx, i, switchdb);
		}

		if (ctx->pollfd[i].revents & POLLOUT)
		{
			return handle_writing_message (event, ctx, i);
		}

		// TODO: in case there is an error that way??
		//if (ctx->cinfos[i].fd < 0)
		//	continue;

		// Disconnection.
		if (ctx->pollfd[i].revents & POLLHUP)
			goto hungup;
		else if (ctx->pollfd[i].revents & POLLIN) {
			return handle_disconnection (event, ctx, i, switchdb);
			/* read argument buffer from client */
			if ( (nread = read(client_fd, buf, MAXLINE)) < 0)
				log_sys("read error on fd %d", client_fd);
			else if (nread == 0) {
hungup:
				log_msg("closed: uid %d, fd %d", client[i].uid, client_fd);
				client_del(client_fd);	/* client has closed conn */
				ctx->pollfd[i].fd = -1;
				close(client_fd);
			} else			/* process client's rquest */
				request(buf, nread, client_fd, client[i].uid);
		}

	} /** for loop: end of the message handling */

	// from 0 to ctx->size
		// if something to read
			// if this is the server
				// return handle_connection
			// else
				// from 0 to ctx->size
					// if this is the right index in ctx->cinfos
						// return handle_message (event, ctx, i, switchdb);

	IPC_RETURN_NO_ERROR;
}

#if 0
struct ipc_error ipc_wait_event_networkd (
	  struct ipc_ctx *ctx
	, struct ipc_connection_info  *cinfo	// NULL for clients
	, struct ipc_event            *event
	, struct ipc_switchings       *switchdb
	, int *timer)
{
	T_R ((ctx == NULL),    IPC_ERROR_WAIT_EVENT__NO_CLIENTS_PARAM);
	T_R ((event  == NULL), IPC_ERROR_WAIT_EVENT__NO_EVENT_PARAM);

	IPC_EVENT_CLEAN (event);

	size_t i, j;
	/* master file descriptor list */
	fd_set master;
	fd_set readf;

	/* clear the master and temp sets */
	FD_ZERO (&master);
	FD_ZERO (&readf);

	/* maximum file descriptor number */
	/* keep track of the biggest file descriptor */
	int32_t fdmax = get_max_fd (ctx);

	/* listening socket descriptor */
	int32_t listener;
	if (cinfo != NULL) {
		listener = cinfo->pollfd.fd;

		/* add the listener to the master set */
		FD_SET (listener, &master);

		/* if listener is max fd */
		if (fdmax < listener)
			fdmax = listener;
	}

	for (i = 0; i < ctx->size; i++) {
		FD_SET (ctx->cinfos[i]->pollfd.fd, &master);
	}

	readf = master;

	struct timeval *ptimeout = NULL;
	SECURE_DECLARATION (struct timeval, timeout);

	if (timer != NULL && *timer > 0.0) {
		timeout.tv_sec  = (long) *timer;
		timeout.tv_usec = (long) ((long)((*timer) * 1000000) % 1000000);
		ptimeout = &timeout;
	}

	T_PERROR_RIPC ((select (fdmax + 1, &readf, NULL, NULL, ptimeout) == -1), "select", IPC_ERROR_WAIT_EVENT__SELECT);

	if (ptimeout != NULL) {
		*timer = timeout.tv_sec + (timeout.tv_usec / 1000000.0);
		if (*timer == 0) {
			IPC_EVENT_SET (event, IPC_EVENT_TYPE_TIMER, NULL, NULL);
			IPC_RETURN_NO_ERROR;
		}
	}

	for (i = 0; i <= (size_t) fdmax; i++) {
		if (FD_ISSET (i, &readf)) {
			if (cinfo != NULL && i == (size_t) listener) {
				return handle_connection (event, ctx, cinfo);
			} else {
				for (j = 0; j < ctx->size; j++) {
					if (i == (size_t) ctx->cinfos[j]->pollfd.fd) {
						return handle_message (event, ctx, ctx->cinfos[j], switchdb);
					}
				}
			}
		}
	}

	IPC_RETURN_NO_ERROR;
}
#endif

struct ipc_error ipc_wait_event (
	  struct ipc_ctx             *ctx
	, struct ipc_connection_info *cinfo	// NULL for clients
	, struct ipc_event           *event
	, int                        *timer)
{
	return ipc_wait_event_networkd (ctx, cinfo, event, NULL, timer);
}

/**
 * Allocate memory then add a new connection to the context.
 */
struct ipc_error
ipc_add (
	  struct ipc_ctx *ctx
	, struct ipc_connection_info *p
	, struct pollfd              *pollfd)
{
	T_R ((ctx == NULL), IPC_ERROR_ADD__NO_PARAM_CLIENTS);
	T_R ((p == NULL),   IPC_ERROR_ADD__NO_PARAM_CLIENT);

	// Memory reallocation.
	ipc_ctx_new_alloc (ctx);

	memcpy (ctx->cinfos[ctx->size - 1], p     , sizeof (struct ipc_connection_info));
	memcpy (ctx->pollfd[ctx->size - 1], pollfd, sizeof (struct pollfd));

	IPC_RETURN_NO_ERROR;
}

struct ipc_error ipc_del (
	  struct ipc_ctx *ctx
	, struct ipc_connection_info *p)
{
	T_R ((ctx == NULL),         IPC_ERROR_DEL__NO_CLIENTS_PARAM);
	T_R ((p == NULL),              IPC_ERROR_DEL__NO_CLIENT_PARAM);
	T_R ((ctx->cinfos == NULL), IPC_ERROR_DEL__EMPTY_LIST);

	size_t i;
	for (i = 0; i < ctx->size; i++) {
		// WARNING: The test is performed on the pointers of both structures,
		// this is efficient but it doesn't work if the p structure is a copy.
		if (ctx->cinfos[i] == p) {
			// TODO: possible memory leak if the ipc_connection_info is not deeply free'ed.
			ctx->cinfos[i] = ctx->cinfos[ctx->size - 1];
			ctx->size--;
			if (ctx->size == 0) {
				ipc_connections_free (ctx);
			} else {
				ctx->cinfos = realloc (ctx->cinfos, sizeof (struct ipc_connection_info) * ctx->size);

				if (ctx->cinfos == NULL) {
					IPC_RETURN_ERROR (IPC_ERROR_DEL__EMPTIED_LIST);
				}
			}

			IPC_RETURN_NO_ERROR;
		}
	}

	IPC_RETURN_ERROR (IPC_ERROR_DEL__CANNOT_FIND_CLIENT);
}

void ipc_connections_close (struct ipc_ctx *ctx)
{
	if (ctx->cinfos != NULL) {
		for (size_t i = 0; i < ctx->size; i++) {
			ipc_close (ctx->cinfos[i]);
			free (ctx->cinfos[i]);
		}
		free (ctx->cinfos);
		ctx->cinfos = NULL;
	}
	ctx->size = 0;
}

void ipc_connections_free (struct ipc_ctx *ctx)
{
	if (ctx->cinfos != NULL) {
		for (size_t i = 0; i < ctx->size; i++) {
			free (ctx->cinfos[i]);
		}
		free (ctx->cinfos);
		ctx->cinfos = NULL;
	}
	ctx->size = 0;
}

// add an arbitrary file descriptor to read
struct ipc_error ipc_add_fd (struct ipc_ctx *ctx, int fd)
{
	T_R ((ctx == NULL), IPC_ERROR_ADD_FD__NO_PARAM_CINFOS);

	SECURE_DECLARATION (struct ipc_connection_info, cinfo);
	cinfo.type = IPC_CONNECTION_TYPE_EXTERNAL;

	SECURE_DECLARATION (struct pollfd, pollfd);
	pollfd.fd = fd;
	pollfd.events = POLLIN;

	return ipc_add (ctx, &cinfo, &pollfd);
}

// remove a connection from its file descriptor
struct ipc_error ipc_del_fd (struct ipc_ctx *ctx, int fd)
{
	T_R ((ctx == NULL), IPC_ERROR_DEL_FD__NO_PARAM_CINFOS);
	T_R ((ctx->cinfos == NULL), IPC_ERROR_DEL_FD__EMPTY_LIST);

	for (size_t i = 0; i < ctx->size; i++) {

		if (ctx->cinfos[i]->pollfd.fd == fd) {

			ctx->cinfos[i]->pollfd.fd = -1;
			free (ctx->cinfos[i]);
			ctx->pollfd[i] = NULL;
			ctx->size--;

			if (ctx->size == 0) {
				// free ctx->cinfos
				ipc_connections_free (ctx);
			} else {
				ctx->cinfos[i] = ctx->cinfos[ctx->size];
				ctx->pollfd[i] = ctx->pollfd[ctx->size];

				ctx->cinfos = realloc (ctx->cinfos, sizeof (struct ipc_connection_info) * ctx->size);
				ctx->pollfd = realloc (ctx->pollfd, sizeof (struct pollfd             ) * ctx->size);

				if (ctx->cinfos == NULL || ctx->pollfd == NULL) {
					IPC_RETURN_ERROR (IPC_ERROR_DEL_FD__EMPTIED_LIST);
				}
			}

			IPC_RETURN_NO_ERROR;
		}
	}

	IPC_RETURN_ERROR (IPC_ERROR_DEL_FD__CANNOT_FIND_CLIENT);
}