aboutsummaryrefslogtreecommitdiff
path: root/src/util/secmod_common.h
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2021-11-17 13:07:36 +0100
committerChristian Grothoff <christian@grothoff.org>2021-11-17 13:07:36 +0100
commitcc74bf311d863eef3e7af5b9b59fb311af5f50d6 (patch)
tree29ff892951f224f52109690c98b5d3108f6c84c7 /src/util/secmod_common.h
parent3da97b291e03f45c269c9ef2dfbb38aa6a2ca740 (diff)
sms merge wip
Diffstat (limited to 'src/util/secmod_common.h')
-rw-r--r--src/util/secmod_common.h199
1 files changed, 199 insertions, 0 deletions
diff --git a/src/util/secmod_common.h b/src/util/secmod_common.h
index ca1270fa8..a212c9d49 100644
--- a/src/util/secmod_common.h
+++ b/src/util/secmod_common.h
@@ -24,6 +24,8 @@
#include <gnunet/gnunet_util_lib.h>
#include <gnunet/gnunet_network_lib.h>
+#include <pthread.h>
+
/**
* Create the listen socket for a secmod daemon.
@@ -36,4 +38,201 @@
struct GNUNET_NETWORK_Handle *
TES_open_socket (const char *unixpath);
+
+/**
+ * Send a message starting with @a hdr to @a sock.
+ *
+ * @param sock where to send the message
+ * @param hdr beginning of the message, length indicated in size field
+ * @return #GNUNET_OK on success
+ */
+enum GNUNET_GenericReturnValue
+TES_transmit (int sock,
+ const struct GNUNET_MessageHeader *hdr);
+
+
+/**
+ * Information we keep for a client connected to us.
+ */
+struct TES_Client;
+
+/**
+ * Function that handles message @a hdr from @a client.
+ *
+ * @param client sender of the message
+ * @param hdr message we received
+ * @return #GNUNET_OK on success
+ */
+typedef enum GNUNET_GenericReturnValue
+(*TES_MessageDispatch)(struct TES_Client *client,
+ const struct GNUNET_MessageHeader *hdr);
+
+
+/**
+ * Function that updates the keys for @a client.
+ *
+ * @param client sender of the message
+ * @return #GNUNET_OK on success
+ */
+typedef enum GNUNET_GenericReturnValue
+(*TES_KeyUpdater)(struct TES_Client *client);
+
+
+/**
+ * Module-specific functions to be used.
+ */
+struct TES_Callbacks
+{
+ /**
+ * Function to handle inbound messages.
+ */
+ TES_MessageDispatch dispatch;
+
+ /**
+ * Function to update key material initially.
+ */
+ TES_KeyUpdater init;
+
+ /**
+ * Function to update key material.
+ */
+ TES_KeyUpdater updater;
+
+};
+
+
+/**
+ * Information we keep for a client connected to us.
+ */
+struct TES_Client
+{
+
+ /**
+ * Kept in a DLL.
+ */
+ struct TES_Client *next;
+
+ /**
+ * Kept in a DLL.
+ */
+ struct TES_Client *prev;
+
+ /**
+ * Callbacks to use for work.
+ */
+ struct TES_Callbacks cb;
+
+ /**
+ * Worker thread for this client.
+ */
+ pthread_t worker;
+
+ /**
+ * Key generation this client is on.
+ */
+ uint64_t key_gen;
+
+ /**
+ * IO-buffer used by @a purpose.
+ */
+ char iobuf[65536];
+
+ /**
+ * Client socket.
+ */
+ int csock;
+
+ /**
+ * Event socket.
+ */
+ int esock;
+};
+
+
+/**
+ * Head of DLL of clients connected to us.
+ */
+extern struct TES_Client *TES_clients_head;
+
+/**
+ * Tail of DLL of clients connected to us.
+ */
+extern struct TES_Client *TES_clients_tail;
+
+/**
+ * Lock for the client queue.
+ */
+extern pthread_mutex_t TES_clients_lock;
+
+/**
+ * Private key of this security module. Used to sign denomination key
+ * announcements.
+ */
+extern struct TALER_SecurityModulePrivateKeyP TES_smpriv;
+
+/**
+ * Public key of this security module.
+ */
+extern struct TALER_SecurityModulePublicKeyP TES_smpub;
+
+
+/**
+ * Send a signal to all clients to notify them about a key generation change.
+ */
+void
+TES_wake_clients (void);
+
+
+/**
+ * Read work request from the client.
+ *
+ * @param cls a `struct TES_Client *`
+ * @param dispatch function to call with work requests received
+ * @return #GNUNET_OK on success
+ */
+enum GNUNET_GenericReturnValue
+TES_read_work (void *cls,
+ TES_MessageDispatch dispatch);
+
+
+/**
+ * Wait until the socket is ready to read.
+ *
+ * @param client the client to wait for
+ * @return true if we received an event
+ */
+bool
+TES_await_ready (struct TES_Client *client);
+
+
+/**
+ * Free resources occupied by @a client.
+ *
+ * @param[in] client resources to release
+ */
+void
+TES_free_client (struct TES_Client *client);
+
+
+/**
+ * Start listen task.
+ *
+ * @param cfg configuration to use
+ * @param section configuration section to use
+ * @param cb callback functions to use
+ * @return 0 on success, otherwise return value to return from main()
+ */
+int
+TES_listen_start (const struct GNUNET_CONFIGURATION_Handle *cfg,
+ const char *section,
+ const struct TES_Callbacks *cb);
+
+
+/**
+ * Stop listen task.
+ */
+void
+TES_listen_stop (void);
+
+
#endif