Added the OPNA command for downloading attachments
[citadel.git] / citadel / server.h
1 /* $Id$ */
2 typedef pthread_t THREAD;
3
4 /* Uncomment this if you want to track memory leaks.
5  * This incurs some overhead, so don't use it unless you're debugging the code!
6  */
7 /* #define DEBUG_MEMORY_LEAKS */
8
9
10 /*
11  * Here's the big one... the Citadel context structure.
12  *
13  * This structure keeps track of all information relating to a running 
14  * session on the server.  We keep one of these for each session thread.
15  *
16  * Note that the first element is "*next" so that it may be used without
17  * modification in a linked list.
18  */
19 struct CitContext {
20         struct CitContext *next;        /* Link to next session in the list */
21
22         struct usersupp usersupp;       /* Database record buffers */
23         struct quickroom quickroom;
24         
25         long *msglist;
26         int num_msgs;
27
28         char curr_user[32];             /* name of current user */
29         int logged_in;                  /* logged in */
30         int internal_pgm;               /* authenticated as internal program */
31         char temp[32];                  /* temp file name */
32         int nologin;                    /* not allowed to log in */
33
34         char net_node[32];
35         THREAD mythread;
36         int client_socket;
37         char *ExpressMessages;
38         int cs_pid;                     /* session ID */
39         char cs_room[ROOMNAMELEN];      /* current room */
40         time_t cs_lastupdt;             /* time of last update */
41         time_t lastcmd;                 /* time of last command executed */
42         time_t lastidle;                /* For computing idle time */
43         char lastcmdname[5];            /* name of last command executed */
44         unsigned cs_flags;              /* miscellaneous flags */
45
46                                         /* feeping creaturisms... */
47         int cs_clientdev;               /* client developer ID */
48         int cs_clienttyp;               /* client type code */
49         int cs_clientver;               /* client version number */
50         char cs_clientname[32];         /* name of client software */
51         char cs_host[25];               /* host logged in from */
52
53         FILE *download_fp;              /* Fields relating to file transfer */
54         FILE *upload_fp;
55         char upl_file[256];
56         char upl_path[256];
57         char upl_comment[256];
58         char upl_filedir[256];
59         char chat_room[20];             /* The chat room */
60         char dl_is_net;
61         char upload_type;
62
63         char fake_username[32];         /* Fake username <bc>                */
64         char fake_postname[32];         /* Fake postname <bc>                */
65         char fake_hostname[25];         /* Name of the fake hostname <bc>    */
66         char fake_roomname[ROOMNAMELEN];/* Name of the fake room <bc>        */
67         char last_pager[32];            /* The username of the last pager    */
68
69         int FloorBeingSearched;         /* This is used by cmd_lrms() etc.   */
70         char desired_section[64];       /* This is used for MIME downloads   */
71         };
72
73 typedef struct CitContext t_context;
74
75 #define CS_STEALTH      1               /* stealth mode */
76 #define CS_CHAT         2               /* chat mode */
77 #define CS_POSTING      4               /* Posting */
78
79 struct CitContext *MyContext(void);
80 #define CC ((struct CitContext *)MyContext())
81
82 extern struct CitContext *ContextList;
83 extern int ScheduledShutdown;
84 extern struct CitControl CitControl;
85
86 struct ChatLine {
87         struct ChatLine *next;
88         int chat_seq;
89         time_t chat_time;
90         char chat_text[256];
91         char chat_room[20];
92         char chat_username[32];
93         };
94
95 /*
96  * Various things we need to lock and unlock
97  */
98 #define S_USERSUPP      0
99 #define S_USER_TRANS    1
100 #define S_QUICKROOM     2
101 #define S_MSGMAIN       3
102 #define S_CALLLOG       4
103 #define S_SESSION_TABLE 5
104 #define S_FLOORTAB      6
105 #define S_CHATQUEUE     7
106 #define S_CONTROL       8
107 #define S_HOUSEKEEPING  9
108 #define S_DATABASE      10
109 #define MAX_SEMAPHORES  11
110
111
112 /*
113  * Upload types
114  */
115 #define UPL_FILE        0
116 #define UPL_NET         1
117 #define UPL_IMAGE       2
118
119
120 /*
121  * message transfer formats
122  */
123 #define MT_CITADEL      0               /* Citadel proprietary */
124 #define MT_DATE         1               /* We're only looking for the date */
125 #define MT_RFC822       2               /* RFC822 */
126 #define MT_RAW          3               /* IGnet raw format */
127 #define MT_MIME         4               /* MIME-formatted message */
128 #define MT_DOWNLOAD     5               /* Download a component */
129
130
131 /*
132  * Citadel DataBases (define one for each cdb we need to open)
133  */
134 #define CDB_MSGMAIN     0       /* message base                  */
135 #define CDB_USERSUPP    1       /* user file                     */
136 #define CDB_QUICKROOM   2       /* room index                    */
137 #define CDB_FLOORTAB    3       /* floor index                   */
138 #define CDB_MSGLISTS    4       /* room message lists            */
139 #define CDB_VISIT       5       /* user/room relationships       */
140 #define MAXCDB          6       /* total number of CDB's defined */
141
142 struct cdbdata {
143         size_t len;
144         char *ptr;
145         };
146
147
148 /* Structures and declarations for function hooks of various types */
149
150 struct LogFunctionHook {
151         struct LogFunctionHook *next;
152         int loglevel;
153         void (*h_function_pointer) (char *);
154         };
155 extern struct LogFunctionHook *LogHookTable;
156
157 struct CleanupFunctionHook {
158         struct CleanupFunctionHook *next;
159         void (*h_function_pointer) (void);
160         };
161 extern struct CleanupFunctionHook *CleanupHookTable;
162
163
164 /*
165  * SessionFunctionHook extensions are used for any type of hook for which
166  * the context in which it's being called (which is determined by the event
167  * type) will make it obvious for the hook function to know where to look for
168  * pertinent data.
169  */
170 struct SessionFunctionHook {
171         struct SessionFunctionHook *next;
172         void (*h_function_pointer) (void);
173         int eventtype;
174         };
175 extern struct SessionFunctionHook *SessionHookTable;
176
177 #define EVT_STOP        0       /* Session is terminating */
178 #define EVT_START       1       /* Session is starting */
179 #define EVT_LOGIN       2       /* A user is logging in */
180 #define EVT_NEWROOM     3       /* Changing rooms */
181 #define EVT_LOGOUT      4       /* A user is logging out */
182 #define EVT_SETPASS     5       /* Setting or changing password */
183
184
185 /*
186  * UserFunctionHook extensions are used for any type of hook which implements
187  * an operation on a user or username (potentially) other than the one
188  * operating the current session.
189  */
190 struct UserFunctionHook {
191         struct UserFunctionHook *next;
192         void (*h_function_pointer) (char *username, long usernum);
193         int eventtype;
194         };
195 extern struct UserFunctionHook *UserHookTable;
196
197 #define EVT_PURGEUSER   100     /* Deleting a user */
198 #define EVT_OUTPUTMSG   101     /* Outputting a message */
199
200
201 /* Defines the relationship of a user to a particular room */
202 struct visit {
203         long v_roomnum;
204         long v_roomgen;
205         long v_usernum;
206         long v_lastseen;
207         unsigned int v_flags;
208         };
209
210 #define V_FORGET        1               /* User has zapped this room        */
211 #define V_LOCKOUT       2               /* User is locked out of this room  */
212 #define V_ACCESS        4               /* Access is granted to this room   */
213
214 #define UA_KNOWN                2
215 #define UA_GOTOALLOWED          4
216 #define UA_HASNEWMSGS           8
217 #define UA_ZAPPED               16
218
219
220
221 /* Built-in debuggable stuff for checking for memory leaks */
222 #ifdef DEBUG_MEMORY_LEAKS
223
224 #define mallok(howbig)  tracked_malloc(howbig, __FILE__, __LINE__)
225 #define phree(whichptr) tracked_free(whichptr)
226 #define reallok(whichptr,howbig)        tracked_realloc(whichptr,howbig)
227
228 void *tracked_malloc(size_t, char *, int);
229 void tracked_free(void *);
230 void *tracked_realloc(void *, size_t);
231 void dump_tracked(void);
232
233 struct TheHeap {
234         struct TheHeap *next;
235         char h_file[32];
236         int h_line;
237         void *h_ptr;
238         };
239
240 extern struct TheHeap *heap;
241
242 #else
243
244 #define mallok(howbig)  malloc(howbig)
245 #define phree(whichptr) free(whichptr)
246 #define reallok(whichptr,howbig)        realloc(whichptr,howbig)
247
248 #endif