endpoint: server: Add server creation logic

Signed-off-by: Ian Moffett <ian@mirocom.org>

endpoint/core/server_subr.c

@@ -0,0 +1,70 @@
+/*
+ * Copyright (c) 2026, Chloe Moffett
+ * Provided under the BSD-3 clause
+ */
+
+#include <sys/socket.h>
+#include <netinet/in.h>
+#include <stdint.h>
+#include <stdio.h>
+#include <strings.h>
+#include <errno.h>
+#include <unistd.h>
+#include "endpoint/server.h"
+#include "endpoint/common.h"
+
+int
+endpoint_server_init(struct endpoint_server *svp)
+{
+    struct sockaddr_in saddr;
+    int error;
+
+    if (svp == NULL) {
+        errno = EINVAL;
+        return -1;
+    }
+
+    svp->sockfd = socket(AF_INET, SOCK_STREAM, 0);
+    if (svp->sockfd < 0) {
+        perror("socket");
+        return -1;
+    }
+
+    /* Assign the address */
+    bzero(&saddr, sizeof(saddr));
+    saddr.sin_family = AF_INET;
+    saddr.sin_port = htons(SERVER_PORT);
+    saddr.sin_addr.s_addr = INADDR_ANY;
+
+    /* Try to bind it */
+    error = bind(svp->sockfd, (struct sockaddr *)&saddr, sizeof(saddr));
+    if (error < 0) {
+        perror("bind");
+        close(svp->sockfd);
+        svp->sockfd = -1;
+        return -1;
+    }
+
+    /* Now mark it is active and listening */
+    error = listen(svp->sockfd, SERVER_BACKLOG);
+    if (error < 0) {
+        perror("listen");
+        close(svp->sockfd);
+        svp->sockfd = -1;
+        return -1;
+    }
+
+    return 0;
+}
+
+int
+endpoint_server_close(struct endpoint_server *svp)
+{
+    if (svp == NULL) {
+        errno = EINVAL;
+        return -1;
+    }
+
+    close(svp->sockfd);
+    return 0;
+}

endpoint/inc/endpoint/common.h

@@ -9,4 +9,10 @@
 /* Server software version */
 #define SERVER_VERSION "0.0.1"
 
+/* Server listen port */
+#define SERVER_PORT 717
+
+/* Server listen backlog */
+#define SERVER_BACKLOG 16
+
 #endif  /* !ENDPOINT_COMMON_H */

endpoint/inc/endpoint/server.h

@@ -0,0 +1,39 @@
+/*
+ * Copyright (c) 2026, Chloe Moffett
+ * Provided under the BSD-3 clause
+ */
+
+#ifndef ENDPOINT_SERVER_H
+#define ENDPOINT_SERVER_H 1
+
+#include <stdint.h>
+#include <stddef.h>
+
+/*
+ * Represents the endpoint server state
+ *
+ * @sockfd: Socket file descriptor
+ */
+struct endpoint_server {
+    int sockfd;
+};
+
+/*
+ * Initialize a new server
+ *
+ * @svp: Server pointer
+ *
+ * Returns zero on success
+ */
+int endpoint_server_init(struct endpoint_server *svp);
+
+/*
+ * Close the endpoint server
+ *
+ * @svp: Server to close
+ *
+ * Returns zero on success
+ */
+int endpoint_server_close(struct endpoint_server *svp);
+
+#endif  /* !ENDPOINT_SERVER_H */

libremail/common/mailbox.c

@@ -0,0 +1,29 @@
+/*
+ * Copyright (c) 2026, Chloe Moffett
+ * Provided under the BSD-3 clause
+ */
+
+#include <stdint.h>
+#include <stdio.h>
+#include <stddef.h>
+#include <errno.h>
+#include "libremail/mailbox.h"
+
+int
+mailbox_create(const char *path, mode_t mode)
+{
+    int error;
+
+    if (path == NULL) {
+        errno = EINVAL;
+        return -1;
+    }
+
+    error = mkdir(path, mode);
+    if (error < 0) {
+        perror("mkdir");
+        return -1;
+    }
+
+    return 0;
+}

libremail/inc/libremail/common.h

@@ -9,4 +9,10 @@
 /* Length of SHA256 hash in bytes */
 #define SHA256_N_BYTES 32
 
+/* Mailbox directory prefix */
+#define MAILBOX_PREFIX "/var/mail"
+
+/* Mailbox creation mode */
+#define DEFAULT_MAILBOX_MODE 0600
+
 #endif  /* !LIBREMAIL_COMMON_H */

libremail/inc/libremail/mailbox.h

@@ -0,0 +1,21 @@
+/*
+ * Copyright (c) 2026, Chloe Moffett
+ * Provided under the BSD-3 clause
+ */
+
+#ifndef LIBREMAIL_MAILBOX_H
+#define LIBREMAIL_MAILBOX_H 1
+
+#include <sys/stat.h>
+
+/*
+ * Create a mailbox directory
+ *
+ * @path:  Path to mailbox to create
+ * @mode:  Mode to assign to directory
+ *
+ * Returns zero on success
+ */
+int mailbox_create(const char *path, mode_t mode);
+
+#endif  /* !LIBREMAIL_MAILBOX_H */

tools/mailutil/core/mailutil.c

@@ -7,7 +7,10 @@
 #include <unistd.h>
 #include <string.h>
 #include <unistd.h>
+#include <dirent.h>
 #include "libremail/file.h"
+#include "libremail/common.h"
+#include "libremail/mailbox.h"
 
 /* Maximum command components */
 #define CMD_MAX_CNP 6
@@ -15,8 +18,6 @@
 /* Mailutil version */
 #define MAILUTIL_VERSION "0.0.1"
 
-#define DEFAULT_MAILBOX_MODE 0600
-
 /*
  * Macro used to assert that the command list count is not
  * zero to avoid code duplication.
@@ -50,6 +51,57 @@ version(void)
     printf("Version v%s\n", MAILUTIL_VERSION);
 }
 
+static int
+cmd_mailbox_list(void)
+{
+    DIR *dir;
+    struct dirent *dirent;
+
+    if ((dir = opendir(MAILBOX_PREFIX)) == NULL) {
+        perror("opendir");
+        return -1;
+    }
+
+    while ((dirent = readdir(dir)) != NULL) {
+        if (dirent->d_name[0] == '.') {
+            continue;
+        }
+
+        printf("[mailbox] :: %s\n", dirent->d_name);
+    }
+
+    closedir(dir);
+    return 0;
+}
+
+/*
+ * Parse a "mailbox rm" command
+ *
+ * @cmdlist: Command list to parse
+ * @count:   Number of entries inside command list
+ *
+ * Returns zero on success
+ */
+static int
+cmd_mailbox_rm(const char *cmdlist[CMD_MAX_CNP], size_t count)
+{
+    char pathbuf[64];
+
+    ASSERT_COUNT_N(count, 3);
+
+    snprintf(pathbuf, sizeof(pathbuf), "%s/%s",
+        MAILBOX_PREFIX, cmdlist[2]);
+
+    /* Destroy the mailbox */
+    if (rmdir(pathbuf) < 0) {
+        perror("rmdir");
+        return -1;
+    }
+
+    printf("deleted mailbox '%s'\n", cmdlist[2]);
+    return 0;
+}
+
 /*
  * Parse a "mailbox create" command
  *
@@ -65,18 +117,17 @@ cmd_mailbox_create(const char *cmdlist[CMD_MAX_CNP], size_t count)
 
     ASSERT_COUNT_N(count, 3);
 
-    snprintf(pathbuf, sizeof(pathbuf), "/var/mail/%s", cmdlist[2]);
+    snprintf(pathbuf, sizeof(pathbuf), "%s/%s",
+        MAILBOX_PREFIX, cmdlist[2]);
 
     /* Create the mailbox */
-    if (try_mkdir(pathbuf, DEFAULT_MAILBOX_MODE) < 0) {
+    if (mailbox_create(pathbuf, DEFAULT_MAILBOX_MODE) < 0) {
         printf("fatal: failed to create mailbox\n");
         perror("try_mkdir");
         return -1;
     }
 
-    printf("created mailbox '%s' @ %s\n",
+    printf("created mailbox '%s' @ %s\n", cmdlist[2], pathbuf);
-        cmdlist[2], pathbuf);
-
     return 0;
 }
 
@@ -97,6 +148,14 @@ cmd_mailbox(const char *cmdlist[CMD_MAX_CNP], size_t count)
         return cmd_mailbox_create(cmdlist, count);
     }
 
+    if (strcmp(cmdlist[1], "list") == 0) {
+        return cmd_mailbox_list();
+    }
+
+    if (strcmp(cmdlist[1], "rm") == 0) {
+        return cmd_mailbox_rm(cmdlist, count);
+    }
+
     printf("error: bad parameter\n");
     return -1;
 }