removed some debugs
[citadel.git] / citadel / config.c
index 2507abfee037e042aee267c0ca7fc7a4c0277738..86077a0c634c3fa7d79947d68ee6b53a905f4dc6 100644 (file)
@@ -1,22 +1,17 @@
-/*
- * Read and write the citadel.config file
- *
- * Copyright (c) 1987-2017 by the citadel.org team
- *
- * This program is open source software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License version 3.
- *
- * 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.
- */
+// Read and write the system configuration database
+//
+// Copyright (c) 1987-2022 by the citadel.org team
+//
+// This program is open source software.  Use, duplication, or disclosure
+// is subject to the terms of the GNU General Public License, version 3.
+// The program is distributed without any warranty, expressed or implied.
 
 #include "sysdep.h"
 #include <stdlib.h>
 #include <unistd.h>
 #include <stdio.h>
 #include <netdb.h>
+#include <crypt.h>
 #include <sys/utsname.h>
 #include <libcitadel.h>
 #include <assert.h>
@@ -27,21 +22,17 @@ long config_msgnum = 0;
 HashList *ctdlconfig = NULL;   // new configuration
 
 
-void config_warn_if_port_unset(char *key, int default_port)
-{
+void config_warn_if_port_unset(char *key, int default_port) {
        int p = CtdlGetConfigInt(key);
-       if ((p < -1) || (p == 0) || (p > UINT16_MAX))
-       {
+       if ((p < -1) || (p == 0) || (p > UINT16_MAX)) {
                syslog(LOG_ERR, "config: setting %s is not -1 (disabled) or a valid TCP port - setting to default %d", key, default_port);
                CtdlSetConfigInt(key, default_port);
        }
 }
 
 
-void config_warn_if_empty(char *key)
-{
-       if (IsEmptyStr(CtdlGetConfigStr(key)))
-       {
+void config_warn_if_empty(char *key) {
+       if (IsEmptyStr(CtdlGetConfigStr(key))) {
                syslog(LOG_ERR, "config: setting %s is empty, but must not - check your config!", key);
        }
 }
@@ -49,18 +40,14 @@ void config_warn_if_empty(char *key)
 
 void validate_config(void) {
 
-       /*
-        * these shouldn't be empty
-        */
+       // these shouldn't be empty
        config_warn_if_empty("c_fqdn");
        config_warn_if_empty("c_baseroom");
        config_warn_if_empty("c_aideroom");
        config_warn_if_empty("c_twitroom");
        config_warn_if_empty("c_nodename");
 
-       /*
-        * Sanity check for port bindings
-        */
+       // Sanity check for port bindings
        config_warn_if_port_unset("c_smtp_port",        25);
        config_warn_if_port_unset("c_pop3_port",        110);
        config_warn_if_port_unset("c_imap_port",        143);
@@ -70,7 +57,6 @@ void validate_config(void) {
        config_warn_if_port_unset("c_pop3s_port",       995);
        config_warn_if_port_unset("c_imaps_port",       993);
        config_warn_if_port_unset("c_pftcpdict_port",   -1);
-       config_warn_if_port_unset("c_managesieve_port", 2020);
        config_warn_if_port_unset("c_xmpp_c2s_port",    5222);
        config_warn_if_port_unset("c_xmpp_s2s_port",    5269);
        config_warn_if_port_unset("c_nntp_port",        119);
@@ -82,19 +68,34 @@ void validate_config(void) {
 }
 
 
-/*
- * Put some sane default values into our configuration.  Some will be overridden when we run setup.
- */
+// The "host key" is a 100-byte random string that is used to do some persistent hashing.
+// It must remain consistent throughout the lifetime of this Citadel installation
+void generate_host_key(void) {
+       syslog(LOG_INFO, "config: generating a host key");
+       int len = 0;
+       char host_key[128];
+
+       while (len < 100) {
+               do {
+                       host_key[len] = random() % 0x7F;
+               } while (!isalnum(host_key[len]));
+               host_key[++len] = 0;
+       }
+       CtdlSetConfigStr("host_key", host_key);
+}
+
+
+// Put some sane default values into our configuration.  Some will be overridden when we run setup.
 void brand_new_installation_set_defaults(void) {
 
        struct utsname my_utsname;
        struct hostent *he;
        char detected_hostname[256];
 
-       /* Determine our host name, in case we need to use it as a default */
+       // Determine our host name, in case we need to use it as a default
        uname(&my_utsname);
 
-       /* set some sample/default values in place of blanks... */
+       // set some sample/default values in place of blanks...
        extract_token(detected_hostname, my_utsname.nodename, 0, '.', sizeof detected_hostname);
        CtdlSetConfigStr("c_nodename", detected_hostname);
 
@@ -117,9 +118,7 @@ void brand_new_installation_set_defaults(void) {
                CtdlSetConfigInt("c_createax", 3);
        }
 
-       /*
-        * Default port numbers for various services
-        */
+       // Default port numbers for various services
        CtdlSetConfigInt("c_port_number",       504);
        CtdlSetConfigInt("c_smtp_port",         25);
        CtdlSetConfigInt("c_pop3_port",         110);
@@ -129,25 +128,19 @@ void brand_new_installation_set_defaults(void) {
        CtdlSetConfigInt("c_pop3s_port",        995);
        CtdlSetConfigInt("c_imaps_port",        993);
        CtdlSetConfigInt("c_pftcpdict_port",    -1);
-       CtdlSetConfigInt("c_managesieve_port",  2020);
        CtdlSetConfigInt("c_xmpp_c2s_port",     5222);
        CtdlSetConfigInt("c_xmpp_s2s_port",     5269);
        CtdlSetConfigInt("c_nntp_port",         119);
        CtdlSetConfigInt("c_nntps_port",        563);
 
-       /*
-        * Prevent the "new installation, set defaults" behavior from occurring again
-        */
+       // Prevent the "new installation, set defaults" behavior from occurring again
        CtdlSetConfigLong("c_config_created_or_migrated", (long)time(NULL));
 }
 
 
-/*
- * Migrate a supplied legacy configuration to the new in-db format.
- * No individual site should ever have to do this more than once.
- */
-void migrate_legacy_config(struct legacy_config *lconfig)
-{
+// Migrate a supplied legacy configuration to the new in-db format.
+// No individual site should ever have to do this more than once.
+void migrate_legacy_config(struct legacy_config *lconfig) {
        CtdlSetConfigStr(       "c_nodename"            ,       lconfig->c_nodename             );
        CtdlSetConfigStr(       "c_fqdn"                ,       lconfig->c_fqdn                 );
        CtdlSetConfigStr(       "c_humannode"           ,       lconfig->c_humannode            );
@@ -202,7 +195,6 @@ void migrate_legacy_config(struct legacy_config *lconfig)
        CtdlSetConfigStr(       "c_journal_dest"        ,       lconfig->c_journal_dest         );
        CtdlSetConfigStr(       "c_default_cal_zone"    ,       lconfig->c_default_cal_zone     );
        CtdlSetConfigInt(       "c_pftcpdict_port"      ,       lconfig->c_pftcpdict_port       );
-       CtdlSetConfigInt(       "c_managesieve_port"    ,       lconfig->c_managesieve_port     );
        CtdlSetConfigInt(       "c_auth_mode"           ,       lconfig->c_auth_mode            );
        CtdlSetConfigInt(       "c_rbl_at_greeting"     ,       lconfig->c_rbl_at_greeting      );
        CtdlSetConfigStr(       "c_pager_program"       ,       lconfig->c_pager_program        );
@@ -218,32 +210,21 @@ void migrate_legacy_config(struct legacy_config *lconfig)
 }
 
 
-/*
- * Called during the initialization of Citadel server.
- * It verifies the system's integrity and reads citadel.config into memory.
- */
+// Called during the initialization of Citadel server.
+// It verifies the system's integrity and reads citadel.config into memory.
 void initialize_config_system(void) {
        FILE *cfp;
        int rv;
        struct legacy_config lconfig;   // legacy configuration
        ctdlconfig = NewHash(1, NULL);  // set up the real config system
 
-       /* Ensure that we are linked to the correct version of libcitadel */
+       // Ensure that we are linked to the correct version of libcitadel
        if (libcitadel_version_number() < LIBCITADEL_VERSION_NUMBER) {
                fprintf(stderr, "You are running libcitadel version %d\n", libcitadel_version_number());
                fprintf(stderr, "citserver was compiled against version %d\n", LIBCITADEL_VERSION_NUMBER);
                exit(CTDLEXIT_LIBCITADEL);
        }
 
-       if (chdir(ctdl_bbsbase_dir) != 0) {
-               fprintf(stderr,
-                       "This program could not be started.\nUnable to change directory to %s\nError: %s\n",
-                       ctdl_bbsbase_dir,
-                       strerror(errno)
-               );
-               exit(CTDLEXIT_HOME);
-       }
-
        memset(&lconfig, 0, sizeof(struct legacy_config));
        cfp = fopen(file_citadel_config, "rb");
        if (cfp != NULL) {
@@ -253,8 +234,7 @@ void initialize_config_system(void) {
                        exit(CTDLEXIT_CONFIG);
                }
                rv = fread((char *) &lconfig, sizeof(struct legacy_config), 1, cfp);
-               if (rv != 1)
-               {
+               if (rv != 1) {
                        fprintf(stderr, 
                                "Warning: Found a legacy config file %s has unexpected size. \n",
                                file_citadel_config
@@ -270,85 +250,70 @@ void initialize_config_system(void) {
                        exit(CTDLEXIT_CONFIG);
                }
 
-               /*
-                * Prevent migration/initialization from happening again.
-                */
+               // Prevent migration/initialization from happening again.
                CtdlSetConfigLong("c_config_created_or_migrated", (long)time(NULL));
 
        }
 
-       /* New installation?  Set up configuration */
+       // New installation?  Set up configuration
        if (CtdlGetConfigLong("c_config_created_or_migrated") <= 0) {
                brand_new_installation_set_defaults();
        }
 
-       /* Only allow LDAP auth mode if we actually have LDAP support */
-#ifndef HAVE_LDAP
-       if ((CtdlGetConfigInt("c_auth_mode") == AUTHMODE_LDAP) || (CtdlGetConfigInt("c_auth_mode") == AUTHMODE_LDAP_AD)) {
-               fprintf(stderr, "Your system is configured for LDAP authentication,\n"
-                               "but you are running a server built without OpenLDAP support.\n");
-               exit(CTDL_EXIT_UNSUP_AUTH);
-       }
-#endif
-
-        /* Default maximum message length is 10 megabytes.  This is site
-        * configurable.  Also check to make sure the limit has not been
-        * set below 8192 bytes.
-         */
+        // Default maximum message length is 10 megabytes.  This is site
+       // configurable.  Also check to make sure the limit has not been
+       // set below 8192 bytes.
         if (CtdlGetConfigLong("c_maxmsglen") <= 0)     CtdlSetConfigLong("c_maxmsglen", 10485760);
         if (CtdlGetConfigLong("c_maxmsglen") < 8192)   CtdlSetConfigLong("c_maxmsglen", 8192);
 
-        /*
-        * Default lower and upper limits on number of worker threads
-        */
+       // Default lower and upper limits on number of worker threads
        if (CtdlGetConfigInt("c_min_workers") < 5)      CtdlSetConfigInt("c_min_workers", 5);   // min
        if (CtdlGetConfigInt("c_max_workers") == 0)     CtdlSetConfigInt("c_max_workers", 256); // default max
        if (CtdlGetConfigInt("c_max_workers") < CtdlGetConfigInt("c_min_workers")) {
                CtdlSetConfigInt("c_max_workers", CtdlGetConfigInt("c_min_workers"));           // max >= min
        }
 
-       /* Networking more than once every five minutes just isn't sane */
+       // Networking more than once every five minutes just isn't sane
        if (CtdlGetConfigLong("c_net_freq") == 0)       CtdlSetConfigLong("c_net_freq", 3600);  // once per hour default
        if (CtdlGetConfigLong("c_net_freq") < 300)      CtdlSetConfigLong("c_net_freq", 300);   // minimum 5 minutes
 
-       /* Same goes for POP3 */
+       // Same goes for POP3
        if (CtdlGetConfigLong("c_pop3_fetch") == 0)     CtdlSetConfigLong("c_pop3_fetch", 3600);        // once per hour default
        if (CtdlGetConfigLong("c_pop3_fetch") < 300)    CtdlSetConfigLong("c_pop3_fetch", 300);         // 5 minutes min
        if (CtdlGetConfigLong("c_pop3_fastest") == 0)   CtdlSetConfigLong("c_pop3_fastest", 3600);      // once per hour default
        if (CtdlGetConfigLong("c_pop3_fastest") < 300)  CtdlSetConfigLong("c_pop3_fastest", 300);       // 5 minutes min
 
-       /* LDAP sync frequency */
+       // LDAP sync frequency
        if (CtdlGetConfigLong("c_ldap_sync_freq") == 0) CtdlSetConfigLong("c_ldap_sync_freq", 300);     // every 5 minutes default
 
-       /* "create new user" only works with native authentication mode */
+       // "create new user" only works with native authentication mode
        if (CtdlGetConfigInt("c_auth_mode") != AUTHMODE_NATIVE) {
                CtdlSetConfigInt("c_disable_newu", 1);
        }
+
+       // If we do not have a host key, generate one now, and save it.
+       if (IsEmptyStr(CtdlGetConfigStr("host_key"))) {
+               generate_host_key();
+       }
 }
 
 
-/*
- * Called when Citadel server is shutting down.
- * Clears out the config hash table.
- */
-void shutdown_config_system(void) 
-{
+// Called when Citadel server is shutting down.
+// Clears out the config hash table.
+void shutdown_config_system(void) {
        DeleteHash(&ctdlconfig);
 }
 
 
-/*
- * Set a system config value.  Simple key/value here.
- */
-void CtdlSetConfigStr(char *key, char *value)
-{
+// Set a system config value.  Simple key/value here.
+void CtdlSetConfigStr(char *key, char *value) {
        int key_len = strlen(key);
        int value_len = strlen(value);
 
-       /* Save it in memory */
+       // Save it in memory
        Put(ctdlconfig, key, key_len, strdup(value), NULL);
 
-       /* Also write it to the config database */
+       // Also write it to the config database
 
        int dbv_size = key_len + value_len + 2;
        char *dbv = malloc(dbv_size);
@@ -359,41 +324,32 @@ void CtdlSetConfigStr(char *key, char *value)
 }
 
 
-/*
- * Set a numeric system config value (long integer)
- */
-void CtdlSetConfigLong(char *key, long value)
-{
+// Set a numeric system config value (long integer)
+void CtdlSetConfigLong(char *key, long value) {
        char longstr[256];
        sprintf(longstr, "%ld", value);
        CtdlSetConfigStr(key, longstr);
 }
 
 
-/*
- * Set a numeric system config value (integer)
- */
-void CtdlSetConfigInt(char *key, int value)
-{
+// Set a numeric system config value (integer)
+void CtdlSetConfigInt(char *key, int value) {
        char intstr[256];
        sprintf(intstr, "%d", value);
        CtdlSetConfigStr(key, intstr);
 }
 
 
-/*
- * Delete a system config value.
- */
-void CtdlDelConfig(char *key)
-{
+// Delete a system config value.
+void CtdlDelConfig(char *key) {
        int key_len = strlen(key);
 
        if (IsEmptyStr(key)) return;
 
-       /* Delete from the database. */
+       // Delete from the database.
        cdb_delete(CDB_CONFIG, key, key_len);
 
-       /* Delete from the in-memory cache */
+       // Delete from the in-memory cache
        HashPos *Pos = GetNewHashPos(ctdlconfig, 1);
        if (GetHashPosFromKey(ctdlconfig, key, key_len, Pos)) {
                DeleteEntryFromHash(ctdlconfig, Pos);
@@ -404,55 +360,43 @@ void CtdlDelConfig(char *key)
 }
 
 
-/*
- * Fetch a system config value.  Caller does *not* own the returned value and may not alter it.
- */
-char *CtdlGetConfigStr(char *key)
-{
+// Fetch a system config value.  Caller does *not* own the returned value and may not alter it.
+char *CtdlGetConfigStr(char *key) {
        char *value = NULL;
        struct cdbdata *cdb;
        int key_len = strlen(key);
 
        if (IsEmptyStr(key)) return(NULL);
 
-       /* First look in memory */
-       if (GetHash(ctdlconfig, key, key_len, (void *)&value))
-       {
+       // First look in memory
+       if (GetHash(ctdlconfig, key, key_len, (void *)&value)) {
                return value;
        }
 
-       /* Then look in the database. */
-
+       // Then look in the database.
        cdb = cdb_fetch(CDB_CONFIG, key, key_len);
-
-       if (cdb == NULL) {      /* nope, not there either. */
+       if (cdb == NULL) {      // nope, not there either.
                return(NULL);
        }
 
-       /* Got it.  Save it in memory for the next fetch. */
-       value = strdup(cdb->ptr + key_len + 1);         /* The key was stored there too; skip past it */
+       // Got it.  Save it in memory for the next fetch.
+       value = strdup(cdb->ptr + key_len + 1);         // The key was stored there too; skip past it
        cdb_free(cdb);
        Put(ctdlconfig, key, key_len, value, NULL);
        return value;
 }
 
 
-/*
- * Fetch a system config value - integer
- */
-int CtdlGetConfigInt(char *key)
-{
+// Fetch a system config value - integer
+int CtdlGetConfigInt(char *key) {
        char *s = CtdlGetConfigStr(key);
        if (s) return atoi(s);
        return 0;
 }
 
 
-/*
- * Fetch a system config value - long integer
- */
-long CtdlGetConfigLong(char *key)
-{
+// Fetch a system config value - long integer
+long CtdlGetConfigLong(char *key) {
        char *s = CtdlGetConfigStr(key);
        if (s) return atol(s);
        return 0;
@@ -464,9 +408,10 @@ void CtdlGetSysConfigBackend(long msgnum, void *userdata) {
 }
 
 
+// This is for fetching longer configuration sets which are stored in the message base.
 char *CtdlGetSysConfig(char *sysconfname) {
        char hold_rm[ROOMNAMELEN];
-       long msgnum;
+       long msgnum = -1;
        char *conf;
        struct CtdlMessage *msg;
        char buf[SIZ];
@@ -477,18 +422,26 @@ char *CtdlGetSysConfig(char *sysconfname) {
                return NULL;
        }
 
-       /* We want the last (and probably only) config in this room */
-       begin_critical_section(S_CONFIG);
-       config_msgnum = (-1L);
-       CtdlForEachMessage(MSGS_LAST, 1, NULL, sysconfname, NULL, CtdlGetSysConfigBackend, NULL);
-       msgnum = config_msgnum;
-       end_critical_section(S_CONFIG);
+       // The new way: hunt for the message number in the config database
+       msgnum = CtdlGetConfigLong(sysconfname);
+
+       // Legacy format: hunt through the local system configuration room for a message with a matching MIME type
+       if (msgnum <= 0) {
+               begin_critical_section(S_CONFIG);
+               config_msgnum = -1;
+               CtdlForEachMessage(MSGS_LAST, 1, NULL, sysconfname, NULL, CtdlGetSysConfigBackend, NULL);
+               msgnum = config_msgnum;
+               end_critical_section(S_CONFIG);
+               if (msgnum > 0) {
+                       CtdlSetConfigLong(sysconfname, msgnum);         // store it the new way so we don't have to do this again
+               }
+       }
 
-       if (msgnum < 0L) {
+       if (msgnum <= 0) {
                conf = NULL;
        }
        else {
-               msg = CtdlFetchMessage(msgnum, 1, 1);
+               msg = CtdlFetchMessage(msgnum, 1);
                if (msg != NULL) {
                        conf = strdup(msg->cm_fields[eMesageText]);
                        CM_Free(msg);
@@ -500,7 +453,7 @@ char *CtdlGetSysConfig(char *sysconfname) {
 
        CtdlGetRoom(&CC->room, hold_rm);
 
-       if (conf != NULL) {
+       if (conf != NULL) {             // Strip the MIME headers, leaving only the content
                do {
                        extract_token(buf, conf, 0, '\n', sizeof buf);
                        strcpy(conf, &conf[strlen(buf)+1]);
@@ -511,6 +464,22 @@ char *CtdlGetSysConfig(char *sysconfname) {
 }
 
 
+// This is for storing longer configuration sets which are stored in the message base.
 void CtdlPutSysConfig(char *sysconfname, char *sysconfdata) {
-       CtdlWriteObject(SYSCONFIGROOM, sysconfname, sysconfdata, (strlen(sysconfdata)+1), NULL, 0, 1, 0);
+       long old_msgnum = -1;
+       long new_msgnum = -1;
+
+       // Search for the previous copy of this config item, so we can delete it
+       old_msgnum = CtdlGetConfigLong(sysconfname);
+
+       // Go ahead and save it, and write the new msgnum to the config database so we can find it again
+       new_msgnum = CtdlWriteObject(SYSCONFIGROOM, sysconfname, sysconfdata, (strlen(sysconfdata)+1), NULL, 0, 0);
+       if (new_msgnum > 0) {
+               CtdlSetConfigLong(sysconfname, new_msgnum);
+
+               // Now delete the old copy
+               if (old_msgnum > 0) {
+                       CtdlDeleteMessages(SYSCONFIGROOM, &old_msgnum, 1, "");
+               }
+       }
 }