Split libradsec.h in -base.h and -libevent.h.

1 files changed, 92 insertions, 0 deletions

diff --git a/lib/libradsec-base.h b/lib/libradsec-base.h
new file mode 100644
index 0000000..5a80ab8
--- /dev/null
+++ b/lib/libradsec-base.h
@@ -0,0 +1,92 @@
+/** @file libradsec-minimal.h
+    @brief Low level API for libradsec.  */
+
+/* FIXME: License blurb goes here.  */
+
+#include "libevent.h"
+
+/* Example usage.  */
+#if 0
+{
+  fd = rs_connect (address, psk);
+  if (!fd)
+    /* check errno */ ;
+  n = read (fd, buf, buflen);
+  struct rs_packet *p = rs_packet_new (buf, buflen, &count);
+  if (!p)
+    {
+      if (count < 0)
+	/* check errno */ ;
+      else
+	/* need another COUNT octets */ ;
+    }
+  else
+    /* next unused octet is at buf+count */
+
+  n = rs_packet_serialize (p, buf, buflen);
+  if (n < 0)
+    /* invalid packet */ ;
+  else if (n == 0)
+    /* out of buffer space */ ;
+  else
+    write (fd, buf, n);
+
+  if (p)
+    rs_packet_free(p);
+  if (fd)
+    rs_disconnect(fd);
+}
+#endif
+
+
+/* Function prototypes.  */
+
+/** Establish a connection.
+
+    @param type Connection type.
+    @param addr Network address to connect to.
+    @param cred Credentials, or NULL.
+
+    @return A file descriptor or -1 if an error occurred, in which
+    case errno is set appropriately.  */
+int rs_connect(enum rs_conn_type type,
+	       const struct sockaddr_storage *addr,
+	       const struct rs_credentials *cred);
+
+/** Disconnect.
+
+    @param fd File descriptor to close.
+
+    @return 0 on success or -1 if an error occurred, in which case
+    errno is set appropriately.  */
+int rs_disconnect(int fd);
+
+/** Allocate and initialize a packet object from a buffer containing a
+    packet as seen on the wire.  Free the packet using @a
+    rs_packet_free().
+
+    @param buf
+    @param buflen
+    @param count
+
+    @return Packet or NULL on error or not enough data in @a buf.  If
+    return value is NULL and @a count is < 0, an error has occurred
+    and errno is set appropriately.  If return value is NULL and @a
+    count is > 0 it shows the number of bytes needed to complete the
+    packet.
+*/
+struct rs_packet *rs_packet_new(const uint8_t *buf,
+				size_t buflen,
+				ssize_t *count);
+
+/** Free a packet object that has been allocated by @a
+    rs_packet_new().
+
+
+*/
+void rs_packet_free(struct rs_packet *packet);
+
+/** Serialize a packet.  */
+ssize_t rs_packet_serialize(const struct rs_packet *packet,
+			    uint8_t *buf,
+			    size_t buflen);