Addition of the service, server, serv_protocol and session structure needed to tie the elements together.

Improvements to the protocol module support

Documentation improvements

Addition of make install target

core/session.c

@@ -0,0 +1,148 @@
+/*
+ * This file is distributed as part of the SkySQL Gateway.  It is free
+ * software: you can redistribute it and/or modify it under the terms of the
+ * GNU General Public License as published by the Free Software Foundation,
+ * version 2.
+ *
+ * This program is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program; if not, write to the Free Software Foundation, Inc., 51
+ * Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Copyright SkySQL Ab 2013
+ */
+
+/**
+ * @file session.c  - A representation of the session within the gateway.
+ *
+ * @verbatim
+ * Revision History
+ *
+ * Date		Who		Description
+ * 17/06/13	Mark Riddoch	Initial implementation
+ *
+ * @endverbatim
+ */
+#include <stdio.h>
+#include <stdlib.h>
+#include <unistd.h>
+#include <string.h>
+#include <session.h>
+#include <service.h>
+#include <router.h>
+#include <dcb.h>
+#include <spinlock.h>
+#include <atomic.h>
+
+static SPINLOCK	session_spin = SPINLOCK_INIT;
+static SESSION	*allSessions = NULL;
+
+/**
+ * Allocate a new session for a new client of the specified service.
+ *
+ * Create the link to the router session by calling the newSession
+ * entry point of the router using the router instance of the
+ * service this session is part of.
+ *
+ * @param service	The service this connection was established by
+ * @param client	The client side DCB
+ * @return		The newly created session or NULL if an error occured
+ */
+SESSION *
+session_alloc(SERVICE *service, DCB *client)
+{
+SESSION 	*session;
+
+	if ((session = (SESSION *)malloc(sizeof(SESSION))) == NULL)
+		return NULL;
+	session->service = service;
+	session->client = client;
+	memset(&session->stats, sizeof(SESSION_STATS), 0);
+	session->stats.connect = time(0);
+	session->state = SESSION_STATE_ALLOC;
+	client->session = session;
+
+	session->router_session = service->router->newSession(service->router_instance, session);
+
+	spinlock_acquire(&session_spin);
+	session->next = allSessions;
+	allSessions = session;
+	spinlock_release(&session_spin);
+
+	atomic_add(&service->stats.n_sessions, 1);
+	atomic_add(&service->stats.n_current, 1);
+
+	return session;
+}
+
+/**
+ * Deallocate the specified session
+ *
+ * @param session	The session to deallocate
+ */
+void
+session_free(SESSION *session)
+{
+SESSION *ptr;
+
+	/* First of all remove from the linked list */
+	spinlock_acquire(&session_spin);
+	if (allSessions == session)
+	{
+		allSessions = session->next;
+	}
+	else
+	{
+		ptr = allSessions;
+		while (ptr && ptr->next != session)
+		{
+			ptr = ptr->next;
+		}
+		if (ptr)
+			ptr->next = session->next;
+	}
+	spinlock_release(&session_spin);
+	atomic_add(&session->service->stats.n_current, -1);
+
+	/* Clean up session and free the memory */
+	free(session);
+}
+
+/**
+ * Print details of an individual session
+ *
+ * @param session	Session to print
+ */
+void
+printSession(SESSION *session)
+{
+	printf("Session %p\n", session);
+	printf("\tService:	%s (%p)\n", session->service->name, session->service);
+	printf("\tClient DCB:	%p\n", session->client);
+	printf("\tConnected:	%s", asctime(localtime(&session->stats.connect)));
+}
+
+/**
+ * Print all sessions
+ *
+ * Designed to be called within a debugger session in order
+ * to display all active sessions within the gateway
+ */
+void
+printAllSessions()
+{
+SESSION	*ptr;
+
+	spinlock_acquire(&session_spin);
+	ptr = allSessions;
+	while (ptr)
+	{
+		printSession(ptr);
+		ptr = ptr->next;
+	}
+	spinlock_release(&session_spin);
+}