]> code.citadel.org Git - citadel.git/blobdiff - citadel/server.h
preserve stringlengths when outputting stuff in the imap module
[citadel.git] / citadel / server.h
index 9aaf56047edf08fb54061a92222a9eefe84a3a11..6aedb546393124cce3a72d7e6259eea3740404c5 100644 (file)
-/* $Id$ */
-typedef pthread_t THREAD;
+#ifndef SERVER_H
+#define SERVER_H
 
-/* Uncomment this if you want to track memory leaks.
- * This incurs some overhead, so don't use it unless you're debugging the code!
+#ifdef __GNUC__
+#define INLINE __inline__
+#else
+#define INLINE
+#endif
+
+#include "citadel.h"
+#ifdef HAVE_OPENSSL
+#define OPENSSL_NO_KRB5                /* work around redhat b0rken ssl headers */
+#include <openssl/ssl.h>
+#endif
+
+/*
+ * New format for a message in memory
+ */
+struct CtdlMessage {
+       int cm_magic;                   /* Self-check (NOT SAVED TO DISK) */
+       char cm_anon_type;              /* Anonymous or author-visible */
+       char cm_format_type;            /* Format type */
+       char *cm_fields[256];           /* Data fields */
+       long cm_lengths[256];           /* size of datafields */
+       unsigned int cm_flags;          /* How to handle (NOT SAVED TO DISK) */
+};
+
+#define        CTDLMESSAGE_MAGIC               0x159d
+#define        CM_SKIP_HOOKS   0x01            /* Don't run server-side handlers */
+
+
+/* Data structure returned by validate_recipients() */
+typedef struct __recptypes {
+       int recptypes_magic;
+        int num_local;
+        int num_internet;
+        int num_ignet;
+       int num_room;
+        int num_error;
+       char *errormsg;
+       char *recp_local;
+       char *recp_internet;
+       char *recp_ignet;
+       char *recp_room;
+       char *recp_orgroom;
+       char *display_recp;
+       char *bounce_to;
+       char *envelope_from;
+       char *sending_room;
+} recptypes;
+
+#define RECPTYPES_MAGIC 0xfeeb
+
+
+#define CTDLEXIT_SHUTDOWN      0       /* Normal shutdown; do NOT auto-restart */
+
+/*
+ * Exit codes 101 through 109 are used for conditions in which
+ * we deliberately do NOT want the service to automatically
+ * restart.
+ */
+#define CTDLEXIT_CONFIG                101     /* Could not read citadel.config */
+#define CTDLEXIT_CONTROL       102     /* Could not acquire lock */
+#define CTDLEXIT_HOME          103     /* Citadel home directory not found */
+#define CTDLEXIT_OOD           104     /* Out Of Date config - rerun setup */
+#define CTDLEXIT_DB            105     /* Unable to initialize database */
+#define CTDLEXIT_LIBCITADEL    106     /* Incorrect version of libcitadel */
+#define CTDL_EXIT_UNSUP_AUTH   107     /* Unsupported auth mode configured */
+
+/*
+ * Reasons why a session would be terminated (set CC->kill_me to these values)
  */
-/* #define DEBUG_MEMORY_LEAKS */
+enum {
+       KILLME_NOT,
+       KILLME_UNKNOWN,
+       KILLME_CLIENT_LOGGED_OUT,
+       KILLME_IDLE,
+       KILLME_CLIENT_DISCONNECTED,
+       KILLME_AUTHFAILED,
+       KILLME_SERVER_SHUTTING_DOWN,
+       KILLME_MAX_SESSIONS_EXCEEDED,
+       KILLME_ADMIN_TERMINATE,
+       KILLME_SELECT_INTERRUPTED,
+       KILLME_SELECT_FAILED,
+       KILLME_WRITE_FAILED,
+       KILLME_SIMULATION_WORKER,
+       KILLME_NOLOGIN,
+       KILLME_NO_CRYPTO,
+       KILLME_READSTRING_FAILED,
+       KILLME_MALLOC_FAILED,
+       KILLME_QUOTA,
+       KILLME_READ_FAILED,
+       KILLME_ILLEGAL_MANAGESIEVE_COMMAND,
+       KILLME_SPAMMER,
+       KILLME_XML_PARSER
+};
+
+
+#define CS_STEALTH     1       /* stealth mode */
+#define CS_CHAT                2       /* chat mode */
+#define CS_POSTING     4       /* Posting */
 
 
 /*
- * Here's the big one... the Citadel context structure.
- *
- * This structure keeps track of all information relating to a running 
- * session on the server.  We keep one of these for each session thread.
- *
- * Note that the first element is "*next" so that it may be used without
- * modification in a linked list.
+ * This is the control record for the message base... 
  */
-struct CitContext {
-       struct CitContext *next;        /* Link to next session in the list */
-
-        struct usersupp usersupp;      /* Database record buffers */
-        struct quickroom quickroom;
-       
-       long *msglist;
-       int num_msgs;
-
-        char curr_user[32];            /* name of current user */
-        int logged_in;                 /* logged in */
-        int internal_pgm;              /* authenticated as internal program */
-        char temp[32];                 /* temp file name */
-        int nologin;                   /* not allowed to log in */
-
-        char net_node[32];
-       THREAD mythread;
-       int client_socket;
-       int cs_pid;                     /* session ID */
-       char cs_room[ROOMNAMELEN];      /* current room */
-       time_t cs_lastupdt;             /* time of last update */
-       time_t lastcmd;                 /* time of last command executed */
-       time_t lastidle;                /* For computing idle time */
-       char lastcmdname[5];            /* name of last command executed */
-       unsigned cs_flags;              /* miscellaneous flags */
-
-                                       /* feeping creaturisms... */
-       int cs_clientdev;               /* client developer ID */
-       int cs_clienttyp;               /* client type code */
-       int cs_clientver;               /* client version number */
-       char cs_clientname[32];         /* name of client software */
-       char cs_host[25];               /* host logged in from */
-
-        FILE *download_fp;             /* Fields relating to file transfer */
-        FILE *upload_fp;
-       char upl_file[256];
-       char upl_path[256];
-       char upl_comment[256];
-       char upl_filedir[256];
-       char chat_room[20];             /* The chat room */
-       char dl_is_net;
-       char upload_type;
-
-       struct ExpressMessage *FirstExpressMessage;
-
-       char fake_username[32];         /* Fake username <bc>                */
-       char fake_postname[32];         /* Fake postname <bc>                */
-       char fake_hostname[25];         /* Name of the fake hostname <bc>    */
-       char fake_roomname[ROOMNAMELEN];/* Name of the fake room <bc>        */
-
-       int FloorBeingSearched;         /* This is used by cmd_lrms() etc.   */
-       char desired_section[64];       /* This is used for MIME downloads   */
-       };
-
-typedef struct CitContext t_context;
-
-#define CS_STEALTH     1               /* stealth mode */
-#define CS_CHAT                2               /* chat mode */
-#define CS_POSTING     4               /* Posting */
-
-struct CitContext *MyContext(void);
-#define CC ((struct CitContext *)MyContext())
-
-extern struct CitContext *ContextList;
+struct CitControl {
+       long MMhighest;                 /* highest message number in file   */
+       unsigned MMflags;               /* Global system flags              */
+       long MMnextuser;                /* highest user number on system    */
+       long MMnextroom;                /* highest room number on system    */
+       int version;                    /* Server-hosted upgrade level      */
+       int fulltext_wordbreaker;       /* ID of wordbreaker in use         */
+       long MMfulltext;                /* highest message number indexed   */
+       int MMdbversion;                /* Version of Berkeley DB used on previous server run */
+};
+
 extern int ScheduledShutdown;
 extern struct CitControl CitControl;
 
-
 struct ExpressMessage {
        struct ExpressMessage *next;
-       time_t timestamp;               /* When this message was sent */
-       unsigned flags;                 /* Special instructions */
-       char sender[64];                /* Name of sending user */
-       char *text;                     /* Message text (if applicable) */
-       };
-
-#define EM_BROADCAST   1               /* Broadcast message */
-#define EM_GO_AWAY     2               /* Server requests client log off */
-#define EM_CHAT                4               /* Server requests client enter chat */
-
-struct ChatLine {
-       struct ChatLine *next;
-       int chat_seq;
-       time_t chat_time;
-       char chat_text[256];
-       char chat_room[20];
-       char chat_username[32];
-       };
+       time_t timestamp;       /* When this message was sent */
+       unsigned flags;         /* Special instructions */
+       char sender[256];       /* Name of sending user */
+       char sender_email[256]; /* Email or JID of sending user */
+       char *text;             /* Message text (if applicable) */
+};
+
+#define EM_BROADCAST   1       /* Broadcast message */
+#define EM_GO_AWAY     2       /* Server requests client log off */
+#define EM_CHAT                4       /* Server requests client enter chat */
 
 /*
  * Various things we need to lock and unlock
  */
-#define S_USERSUPP     0
-#define S_USER_TRANS   1
-#define S_QUICKROOM    2
-#define S_MSGMAIN      3
-#define S_CALLLOG      4
-#define S_SESSION_TABLE        5
-#define S_FLOORTAB     6
-#define S_CHATQUEUE    7
-#define S_CONTROL      8
-#define S_HOUSEKEEPING 9
-#define S_DATABASE     10
-#define S_NETDB                11
-#define MAX_SEMAPHORES 12
+enum {
+       S_USERS,
+       S_ROOMS,
+       S_SESSION_TABLE,
+       S_FLOORTAB,
+       S_CHATQUEUE,
+       S_CONTROL,
+       S_NETDB,
+       S_SUPPMSGMAIN,
+       S_CONFIG,
+       S_HOUSEKEEPING,
+       S_NTTLIST,
+       S_DIRECTORY,
+       S_NETCONFIGS,
+       S_PUBLIC_CLIENTS,
+       S_FLOORCACHE,
+       S_ATBF,
+       S_JOURNAL_QUEUE,
+       S_RPLIST,
+       S_SIEVELIST,
+       S_CHKPWD,
+       S_LOG,
+       S_NETSPOOL,
+       S_XMPP_QUEUE,
+       S_SCHEDULE_LIST,
+       S_SINGLE_USER,
+       S_LDAP,
+       S_IM_LOGS,
+       MAX_SEMAPHORES
+};
 
 
 /*
@@ -134,129 +177,179 @@ struct ChatLine {
 /*
  * message transfer formats
  */
-#define MT_CITADEL     0               /* Citadel proprietary */
-#define MT_DATE                1               /* We're only looking for the date */
-#define MT_RFC822      2               /* RFC822 */
-#define MT_RAW         3               /* IGnet raw format */
-#define MT_MIME                4               /* MIME-formatted message */
-#define MT_DOWNLOAD    5               /* Download a component */
+enum {
+       MT_CITADEL,             /* Citadel proprietary */
+       MT_RFC822,              /* RFC822 */
+       MT_MIME,                /* MIME-formatted message */
+       MT_DOWNLOAD,            /* Download a component */
+       MT_SPEW_SECTION         /* Download a component in a single operation */
+};
+
+/*
+ * Message format types in the database
+ */
+#define FMT_CITADEL    0       /* Citadel vari-format (proprietary) */
+#define FMT_FIXED      1       /* Fixed format (proprietary)        */
+#define FMT_RFC822     4       /* Standard (headers are in M field) */
 
 
 /*
  * Citadel DataBases (define one for each cdb we need to open)
  */
-#define CDB_MSGMAIN    0       /* message base                  */
-#define CDB_USERSUPP   1       /* user file                     */
-#define CDB_QUICKROOM  2       /* room index                    */
-#define CDB_FLOORTAB   3       /* floor index                   */
-#define CDB_MSGLISTS   4       /* room message lists            */
-#define CDB_VISIT      5       /* user/room relationships       */
-#define MAXCDB         6       /* total number of CDB's defined */
+enum {
+       CDB_MSGMAIN,            /* message base                  */
+       CDB_USERS,              /* user file                     */
+       CDB_ROOMS,              /* room index                    */
+       CDB_FLOORTAB,           /* floor index                   */
+       CDB_MSGLISTS,           /* room message lists            */
+       CDB_VISIT,              /* user/room relationships       */
+       CDB_DIRECTORY,          /* address book directory        */
+       CDB_USETABLE,           /* network use table             */
+       CDB_BIGMSGS,            /* larger message bodies         */
+       CDB_FULLTEXT,           /* full text search index        */
+       CDB_EUIDINDEX,          /* locate msgs by EUID           */
+       CDB_USERSBYNUMBER,      /* index of users by number      */
+       CDB_OPENID,             /* associates OpenIDs with users */
+       MAXCDB                  /* total number of CDB's defined */
+};
 
 struct cdbdata {
        size_t len;
        char *ptr;
-       };
-
-
-/* Structures and declarations for function hooks of various types */
-
-struct LogFunctionHook {
-       struct LogFunctionHook *next;
-       int loglevel;
-       void (*h_function_pointer) (char *);
-       };
-extern struct LogFunctionHook *LogHookTable;
-
-struct CleanupFunctionHook {
-       struct CleanupFunctionHook *next;
-       void (*h_function_pointer) (void);
-       };
-extern struct CleanupFunctionHook *CleanupHookTable;
+};
 
 
 /*
- * SessionFunctionHook extensions are used for any type of hook for which
- * the context in which it's being called (which is determined by the event
- * type) will make it obvious for the hook function to know where to look for
- * pertinent data.
+ * Event types can't be enum'ed, because they must remain consistent between
+ * builds (to allow for binary modules built somewhere else)
  */
-struct SessionFunctionHook {
-       struct SessionFunctionHook *next;
-       void (*h_function_pointer) (void);
-       int eventtype;
-       };
-extern struct SessionFunctionHook *SessionHookTable;
-
 #define EVT_STOP       0       /* Session is terminating */
 #define EVT_START      1       /* Session is starting */
 #define EVT_LOGIN      2       /* A user is logging in */
 #define EVT_NEWROOM    3       /* Changing rooms */
 #define EVT_LOGOUT     4       /* A user is logging out */
 #define EVT_SETPASS    5       /* Setting or changing password */
+#define EVT_CMD                6       /* Called after each server command */
+#define EVT_RWHO       7       /* An RWHO command is being executed */
+#define EVT_ASYNC      8       /* Doing asynchronous messages */
+#define EVT_STEALTH    9       /* Entering stealth mode */
+#define EVT_UNSTEALTH  10      /* Exiting stealth mode */
 
-
-/*
- * UserFunctionHook extensions are used for any type of hook which implements
- * an operation on a user or username (potentially) other than the one
- * operating the current session.
- */
-struct UserFunctionHook {
-       struct UserFunctionHook *next;
-       void (*h_function_pointer) (char *username, long usernum);
-       int eventtype;
-       };
-extern struct UserFunctionHook *UserHookTable;
+#define EVT_TIMER      50      /* Timer events are called once per minute
+                                  and are not tied to any session */
+#define EVT_HOUSE      51      /* as needed houskeeping stuff */
+#define EVT_SHUTDOWN   52      /* Server is shutting down */
 
 #define EVT_PURGEUSER  100     /* Deleting a user */
-#define EVT_OUTPUTMSG  101     /* Outputting a message */
+#define EVT_NEWUSER    102     /* Creating a user */
+
+#define EVT_BEFOREREAD 200
+#define EVT_BEFORESAVE 201
+#define EVT_AFTERSAVE  202
+#define EVT_SMTPSCAN   203     /* called before submitting a msg from SMTP */
+#define EVT_AFTERUSRMBOXSAVE 204 /* called afte a message was saved into a users inbox */
+/* Priority levels for paging functions (lower is better) */
+enum {
+       XMSG_PRI_LOCAL,         /* Other users on -this- server */
+       XMSG_PRI_REMOTE,        /* Other users on a Citadel network (future) */
+       XMSG_PRI_FOREIGN,       /* Contacts on foreign instant message hosts */
+       MAX_XMSG_PRI
+};
 
 
 /* Defines the relationship of a user to a particular room */
-struct visit {
+typedef struct __visit {
        long v_roomnum;
        long v_roomgen;
        long v_usernum;
        long v_lastseen;
        unsigned int v_flags;
-       };
-
-#define V_FORGET       1               /* User has zapped this room        */
-#define V_LOCKOUT      2               /* User is locked out of this room  */
-#define V_ACCESS       4               /* Access is granted to this room   */
-
-#define UA_KNOWN                2
-#define UA_GOTOALLOWED          4
-#define UA_HASNEWMSGS           8
-#define UA_ZAPPED              16
-
-
+       char v_seen[SIZ];
+       char v_answered[SIZ];
+       int v_view;
+} visit;
 
-/* Built-in debuggable stuff for checking for memory leaks */
-#ifdef DEBUG_MEMORY_LEAKS
+#define V_FORGET       1       /* User has zapped this room        */
+#define V_LOCKOUT      2       /* User is locked out of this room  */
+#define V_ACCESS       4       /* Access is granted to this room   */
 
-#define mallok(howbig) tracked_malloc(howbig, __FILE__, __LINE__)
-#define phree(whichptr)        tracked_free(whichptr)
-#define reallok(whichptr,howbig)       tracked_realloc(whichptr,howbig)
 
-void *tracked_malloc(size_t, char *, int);
-void tracked_free(void *);
-void *tracked_realloc(void *, size_t);
-void dump_tracked(void);
-
-struct TheHeap {
-        struct TheHeap *next;
-        char h_file[32];
-        int h_line;
-        void *h_ptr;
-        };
+/* Supplementary data for a message on disk
+ * These are kept separate from the message itself for one of two reasons:
+ * 1. Either their values may change at some point after initial save, or
+ * 2. They are merely caches of data which exist somewhere else, for speed.
+ */
+struct MetaData {
+       long meta_msgnum;               /* Message number in *local* message base */
+       int meta_refcount;              /* Number of rooms pointing to this msg */
+       char meta_content_type[64];     /* Cached MIME content-type */
+       long meta_rfc822_length;        /* Cache of RFC822-translated msg length */
+       char mimetype[64];              /* if we were able to guess the mimetype for the data */ 
+};
+
+/* Calls to AdjRefCount() are queued and deferred, so the user doesn't
+ * have to wait for various disk-intensive operations to complete synchronously.
+ * This is the record format.
+ */
+struct arcq {
+       long arcq_msgnum;               /* Message number being adjusted */
+       int arcq_delta;                 /* Adjustment ( usually 1 or -1 ) */
+};
 
-extern struct TheHeap *heap;
 
-#else
+/*
+ * Serialization routines use this struct to return a pointer and a length
+ */
+struct ser_ret {
+       size_t len;
+       unsigned char *ser;
+};
 
-#define mallok(howbig) malloc(howbig)
-#define phree(whichptr)        free(whichptr)
-#define reallok(whichptr,howbig)       realloc(whichptr,howbig)
 
-#endif
+/*
+ * The S_USETABLE database is used in several modules now, so we define its format here.
+ */
+struct UseTable {
+       char ut_msgid[SIZ];
+       time_t ut_timestamp;
+};
+
+
+
+/* Preferred field order                                                       */
+/*               **********                    Important fields                */
+/*                         ***************     Semi-important fields           */
+/*                                        **   internal only                   */
+/*                                          *  Message text (MUST be last)     */
+///#define FORDER      "IPTAFONHRDBCEWJGKLQSVXZYU12M"
+
+typedef enum _MsgField {
+       eAuthor       = 'A',
+       eBig_message  = 'B',
+       eRemoteRoom   = 'C',
+       eDestination  = 'D',
+       eExclusiveID  = 'E',
+       erFc822Addr   = 'F',
+       eHumanNode    = 'H',
+       emessageId    = 'I',
+       eJournal      = 'J',
+       eReplyTo      = 'K',
+       eListID       = 'L',
+       eMesageText   = 'M',
+       eNodeName     = 'N',
+       eOriginalRoom = 'O',
+       eMessagePath  = 'P',
+       eRecipient    = 'R',
+       eSpecialField = 'S',
+       eTimestamp    = 'T',
+       eMsgSubject   = 'U',
+       eenVelopeTo   = 'V',
+       eWeferences   = 'W',
+       eCarbonCopY   = 'Y',
+       eErrorMsg     = '0',
+       eSuppressIdx  = '1',
+       eExtnotify    = '2',
+       eVltMsgNum    = '3'
+}eMsgField;
+
+#endif /* SERVER_H */