* make readloop long-controlled
[citadel.git] / webcit / webcit.h
1
2 /* $Id$ */
3
4 #include "sysdep.h"
5
6
7 #include <sys/select.h>
8
9 #include <ctype.h>
10 #include <stdlib.h>
11 #ifdef HAVE_UNISTD_H
12 #include <unistd.h>
13 #endif
14 #include <stdio.h>
15 #ifdef HAVE_FCNTL_H
16 #include <fcntl.h>
17 #endif
18 #include <signal.h>
19 #include <sys/types.h>
20 #include <sys/wait.h>
21 #include <sys/socket.h>
22 #ifdef HAVE_SYS_TIME_H
23 #include <sys/time.h>
24 #endif
25 #include <sys/stat.h>
26 #ifdef HAVE_LIMITS_H
27 #include <limits.h>
28 #endif
29 #include <netinet/in.h>
30 #include <arpa/inet.h>
31 #include <sys/un.h>
32 #include <netdb.h>
33 #include <sys/poll.h>
34 #include <string.h>
35 #include <pwd.h>
36 #include <errno.h>
37 #include <stdarg.h>
38 #include <pthread.h>
39 #include <signal.h>
40 #include <sys/utsname.h>
41
42 #include <libcitadel.h>
43
44 #ifndef INADDR_NONE
45 #define INADDR_NONE 0xffffffff
46 #endif
47
48 #ifdef HAVE_ICONV
49 #include <iconv.h>
50 #endif
51
52 #ifdef ENABLE_NLS
53 #ifdef HAVE_XLOCALE_H
54 #include <xlocale.h>
55 #endif
56 #include <libintl.h>
57 #include <locale.h>
58 #ifdef HAVE_USELOCALE
59 extern locale_t wc_locales[];
60 #endif
61 #define _(string)       gettext(string)
62 #else
63 #define _(string)       (string)
64 #endif
65
66 #define IsEmptyStr(a) ((a)[0] == '\0')
67 /*
68  * Uncomment to dump an HTTP trace to stderr
69 #define HTTP_TRACING 1
70  */
71
72 #ifdef HTTP_TRACING
73 #undef HAVE_ZLIB_H
74 #undef HAVE_ZLIB
75 #endif
76
77 #ifdef HAVE_ZLIB_H
78 #include <zlib.h>
79 #endif
80
81 #include <libical/ical.h>
82
83 #undef PACKAGE
84 #undef VERSION
85 #undef PACKAGE_NAME
86 #undef PACKAGE_STRING
87 #undef PACKAGE_TARNAME
88 #undef PACKAGE_VERSION
89 #undef PACKAGE_BUGREPORT
90 #include "sysdep.h"
91
92 ////////#include "hash.h"
93
94 #ifdef HAVE_OPENSSL
95 /* Work around RedHat's b0rken OpenSSL includes */
96 #define OPENSSL_NO_KRB5
97 #include <openssl/ssl.h>
98 #include <openssl/err.h>
99 #include <openssl/rand.h>
100 #endif
101
102 #define CALENDAR_ROOM_NAME      "Calendar"
103 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
104
105 #define SIZ                     4096            /* generic buffer size */
106
107 #define TRACE fprintf(stderr, "Checkpoint: %s, %d\n", __FILE__, __LINE__)
108
109 #define SLEEPING                180             /* TCP connection timeout */
110 #define WEBCIT_TIMEOUT          900             /* WebCit session timeout */
111 #define PORT_NUM                2000            /* port number to listen on */
112 #define DEVELOPER_ID            0
113 #define CLIENT_ID               4
114 #define CLIENT_VERSION          739             /* This version of WebCit */
115 #define MINIMUM_CIT_VERSION     739             /* min required Citadel ver */
116 #define LIBCITADEL_MIN          739             /* min required libcitadel ver */
117 #define DEFAULT_HOST            "localhost"     /* Default Citadel server */
118 #define DEFAULT_PORT            "504"
119 #define TARGET                  "webcit01"      /* Target for inline URL's */
120 #define HOUSEKEEPING            15              /* Housekeeping frequency */
121 #define MIN_WORKER_THREADS      5
122 #define MAX_WORKER_THREADS      250
123 #define LISTEN_QUEUE_LENGTH     100             /* listen() backlog queue */
124
125 #define USERCONFIGROOM          "My Citadel Config"
126 #define DEFAULT_MAXMSGS         20
127
128
129 #ifdef LIBCITADEL_VERSION_NUMBER
130 #if LIBCITADEL_VERSION_NUMBER < LIBCITADEL_MIN
131 #error libcitadel is too old.  Please upgrade it before continuing.
132 #endif
133 #endif
134
135
136 /*
137  * Room flags (from Citadel)
138  *
139  * bucket one...
140  */
141 #define QR_PERMANENT    1               /* Room does not purge          */
142 #define QR_INUSE        2               /* Set if in use, clear if avail        */
143 #define QR_PRIVATE      4               /* Set for any type of private room     */
144 #define QR_PASSWORDED   8               /* Set if there's a password too        */
145 #define QR_GUESSNAME    16              /* Set if it's a guessname room */
146 #define QR_DIRECTORY    32              /* Directory room                       */
147 #define QR_UPLOAD       64              /* Allowed to upload                    */
148 #define QR_DOWNLOAD     128             /* Allowed to download          */
149 #define QR_VISDIR       256             /* Visible directory                    */
150 #define QR_ANONONLY     512             /* Anonymous-Only room          */
151 #define QR_ANONOPT      1024            /* Anonymous-Option room                */
152 #define QR_NETWORK      2048            /* Shared network room          */
153 #define QR_PREFONLY     4096            /* Preferred status needed to enter     */
154 #define QR_READONLY     8192            /* Aide status required to post */
155 #define QR_MAILBOX      16384           /* Set if this is a private mailbox     */
156
157 /*
158  * bucket two...
159  */
160 #define QR2_SYSTEM      1               /* System room; hide by default */
161 #define QR2_SELFLIST    2               /* Self-service mailing list mgmt       */
162 #define QR2_COLLABDEL   4               /* Anyone who can post can also delete*/
163 #define QR2_SUBJECTREQ  8               /* Subject strongly recommended */
164 #define QR2_SMTP_PUBLIC 16              /* smtp public postable room */
165 #define QR2_MODERATED   32              /* Listservice aide has to permit posts  */
166
167 /*
168  * user/room access
169  */
170 #define UA_KNOWN        2
171 #define UA_GOTOALLOWED  4
172 #define UA_HASNEWMSGS   8
173 #define UA_ZAPPED       16
174
175
176 /*
177  * User flags (from Citadel)
178  */
179 #define US_NEEDVALID    1               /* User needs to be validated           */
180 #define US_PERM         4               /* Permanent user                       */
181 #define US_LASTOLD      16              /* Print last old message with new      */
182 #define US_EXPERT       32              /* Experienced user                     */
183 #define US_UNLISTED     64              /* Unlisted userlog entry               */
184 #define US_NOPROMPT     128             /* Don't prompt after each message      */
185 #define US_PROMPTCTL    256             /* <N>ext & <S>top work at prompt       */
186 #define US_DISAPPEAR    512             /* Use "disappearing msg prompts"       */
187 #define US_REGIS        1024            /* Registered user                      */
188 #define US_PAGINATOR    2048            /* Pause after each screen of text      */
189 #define US_INTERNET     4096            /* Internet mail privileges             */
190 #define US_FLOORS       8192            /* User wants to see floors             */
191 #define US_COLOR        16384           /* User wants ANSI color support        */
192 #define US_USER_SET     (US_LASTOLD | US_EXPERT | US_UNLISTED | \
193                         US_NOPROMPT | US_DISAPPEAR | US_PAGINATOR | \
194                         US_FLOORS | US_COLOR | US_PROMPTCTL )
195
196 /*
197  * NLI is the string that shows up in a who's online listing for sessions
198  * that are active, but for which no user has yet authenticated.
199  */
200 #define NLI     "(not logged in)"
201
202
203 /*
204  * \brief       Linked list of session variables encoded in an x-www-urlencoded content type
205  */
206 typedef struct urlcontent urlcontent;
207 struct urlcontent {
208         char url_key[32];          /* the variable name */
209         StrBuf *url_data;            /* its value */
210 };
211
212 /*
213  * \brief information about us ???
214  */ 
215 struct serv_info {
216         int serv_pid;                   /* Process ID of the Citadel server */
217         char serv_nodename[32];         /* Node name of the Citadel server */
218         char serv_humannode[64];        /* human readable node name of the Citadel server */
219         char serv_fqdn[64];             /* fully quallified Domain Name (such as uncensored.citadel.org) */
220         char serv_software[64];         /* What version does our connected citadel server use */
221         int serv_rev_level;             /* Whats the citadel server revision */
222         char serv_bbs_city[64];         /* Geographic location of the Citadel server */
223         char serv_sysadm[64];           /* Name of system administrator */
224         char serv_moreprompt[256];      /* Whats the commandline textprompt */
225         int serv_ok_floors;             /* nonzero == server supports floors */
226         int serv_supports_ldap;         /* is the server linked against an ldap tree for adresses? */
227         int serv_newuser_disabled;      /* Has the server disabled self-service new user creation? */
228         char serv_default_cal_zone[128];/* Default timezone for unspecified calendar items */
229         int serv_supports_sieve;        /* Does the server support Sieve mail filtering? */
230         int serv_fulltext_enabled;      /* Does the server have the full text index enabled? */
231         char serv_svn_revision[256];    /* SVN revision of the server */
232         int serv_supports_openid;       /* Does the server support authentication via OpenID? */
233 };
234
235
236
237 /*
238  * \brief This struct holds a list of rooms for \\\<G\\\>oto operations.
239  */
240 struct march {
241         struct march *next;       /* pointer to next in linked list */
242         char march_name[128];     /* name of room */
243         int march_floor;          /* floor number of room */
244         int march_order;          /* sequence in which we are to visit this room */
245 };
246
247 /* *
248  * \brief       This struct holds a list of rooms for client display.
249  *              It is a binary tree.
250  */
251 struct roomlisting {
252         struct roomlisting *lnext;      /* pointer to 'left' tree node */
253         struct roomlisting *rnext;      /* pointer to 'right' tree node */
254         char rlname[128];               /* name of room */
255         unsigned rlflags;               /* room flags */
256         int rlfloor;                    /* the floor it resides on */
257         int rlorder;                    /* room listing order */
258 };
259
260
261 #define TYPE_STR   1
262 #define TYPE_LONG  2
263 #define TYPE_PREFSTR 3
264 #define TYPE_PREFINT 4
265 #define TYPE_GETTEXT 5
266 #define TYPE_BSTR 6
267 #define MAXPARAM  20
268
269
270 typedef struct _TemplateParam {
271         const char *Start;
272         int Type;
273         long len;
274         long lvalue;
275 } TemplateParam;
276
277 typedef struct _TemplateToken {
278         const StrBuf *FileName; /* Reference to print error messages; not to be freed */
279         StrBuf *FlatToken;
280         long Line;
281         const char *pTokenStart;
282         size_t TokenStart;
283         size_t TokenEnd;
284         const char *pTokenEnd;
285         int Flags;
286         void *PreEval;
287
288         const char *pName;
289         size_t NameEnd;
290
291         int HaveParameters;
292         int nParameters;
293         TemplateParam *Params[MAXPARAM];
294 } WCTemplateToken;
295
296 typedef void (*WCHandlerFunc)();
297
298
299 /*
300  * \brief Dynamic content for variable substitution in templates
301  */
302 typedef struct _wcsubst {
303         int wcs_type;                       /* which type of Substitution are we */
304         char wcs_key[32];                   /* copy of our hashkey for debugging */
305         StrBuf *wcs_value;                  /* if we're a string, keep it here */
306         long lvalue;                        /* type long? keep data here */
307         int ContextRequired;                /* do we require a context type? */
308         WCHandlerFunc wcs_function; /* funcion hook ???*/
309 } wcsubst;
310
311 #define CTX_NONE 0
312 #define CTX_SITECFG 1
313 #define CTX_SESSION 2
314 #define CTX_INETCFG 3
315 #define CTX_VNOTE 4
316 #define CTX_WHO 5
317 #define CTX_PREF 6
318 #define CTX_NODECONF 7
319 #define CTX_USERLIST 8
320 #define CTX_MAILSUM 9
321 #define CTX_MIME_ATACH 10
322 #define CTX_ATT 11
323 #define CTX_STRBUF 12
324 #define CTX_LONGVECTOR 13
325
326
327 void RegisterNS(const char *NSName, long len, 
328                 int nMinArgs, 
329                 int nMaxArgs, 
330                 WCHandlerFunc HandlerFunc,
331                 int ContextRequired);
332 #define RegisterNamespace(a, b, c, d, e) RegisterNS(a, sizeof(a)-1, b, c, d, e)
333
334 typedef int (*WCConditionalFunc)(WCTemplateToken *Token, void *Context, int ContextType);
335 typedef struct _ConditionalStruct {
336         const char *PlainName;
337         int nParams;
338         int ContextRequired;
339         WCConditionalFunc CondF;
340 } ConditionalStruct;
341 void RegisterConditional(const char *Name, long len, 
342                          int nParams,
343                          WCConditionalFunc CondF, 
344                          int ContextRequired);
345
346
347
348 typedef void (*SubTemplFunc)(StrBuf *TemplBuffer, void *Context, WCTemplateToken *Token);
349 typedef HashList *(*RetrieveHashlistFunc)(StrBuf *Target, int nArgs, WCTemplateToken *Tokens, void *Context, int ContextType);
350 typedef void (*HashDestructorFunc) (HashList **KillMe);
351 void RegisterITERATOR(const char *Name, long len, /* Our identifier */
352                       int AdditionalParams,       /* doe we use more parameters? */
353                       HashList *StaticList,       /* pointer to webcit lifetime hashlists */
354                       RetrieveHashlistFunc GetHash, /* else retrieve the hashlist by calling this function */
355                       SubTemplFunc DoSubTempl,       /* call this function on each iteration for svput & friends */
356                       HashDestructorFunc Destructor, /* use this function to shut down the hash; NULL if its a reference */
357                       int ContextType,               /* which context do we provide to the subtemplate? */
358                       int XPectContextType);         /* which context do we expct to be called in? */
359 #define RegisterIterator(a, b, c, d, e, f, g, h) RegisterITERATOR(a, sizeof(a)-1, b, c, d, e, f, g, h)
360
361 void GetTemplateTokenString(WCTemplateToken *Tokens,
362                             int N, 
363                             const char **Value, 
364                             long *len);
365
366
367 void SVPut(char *keyname, size_t keylen, int keytype, char *Data);
368 #define svput(a, b, c) SVPut(a, sizeof(a) - 1, b, c)
369 void SVPutLong(char *keyname, size_t keylen, long Data);
370 #define svputlong(a, b) SVPutLong(a, sizeof(a) - 1, b)
371 void svprintf(char *keyname, size_t keylen, int keytype, const char *format,...) __attribute__((__format__(__printf__,4,5)));
372 void SVPRINTF(char *keyname, int keytype, const char *format,...) __attribute__((__format__(__printf__,3,4)));
373 void SVCALLBACK(char *keyname, WCHandlerFunc fcn_ptr);
374 void SVCallback(char *keyname, size_t keylen,  WCHandlerFunc fcn_ptr);
375 #define svcallback(a, b) SVCallback(a, sizeof(a) - 1, b)
376
377 void SVPUTBuf(const char *keyname, int keylen, const StrBuf *Buf, int ref);
378 #define SVPutBuf(a, b, c); SVPUTBuf(a, sizeof(a) - 1, b, c)
379
380 void DoTemplate(const char *templatename, long len, StrBuf *Target, void *Context, int ContextType);
381 #define do_template(a, b) DoTemplate(a, sizeof(a) -1, NULL, b, 0);
382 void url_do_template(void);
383
384 int CompareSubstToToken(TemplateParam *ParamToCompare, TemplateParam *ParamToLookup);
385 int CompareSubstToStrBuf(StrBuf *Compare, TemplateParam *ParamToLookup);
386
387 void StrBufAppendTemplate(StrBuf *Target, 
388                           int nArgs, 
389                           WCTemplateToken *Tokens,
390                           void *Context, int ContextType,
391                           const StrBuf *Source, int FormatTypeIndex);
392 CompareFunc RetrieveSort(long ContextType, const char *OtherPrefix, 
393                          const char *Default, long ldefault, long DefaultDirection);
394 void RegisterSortFunc(const char *name, long len, 
395                       const char *prepend, long preplen,
396                       CompareFunc Forward, 
397                       CompareFunc Reverse, 
398                       long ContextType);
399
400
401 /*
402  * \brief Values for wcs_type
403  */
404 enum {
405         WCS_STRING,       /* its a string */
406         WCS_FUNCTION,     /* its a function callback */
407         WCS_SERVCMD,      /* its a command to send to the citadel server */
408         WCS_STRBUF,       /* its a strbuf we own */
409         WCS_STRBUF_REF,   /* its a strbuf we mustn't free */
410         WCS_LONG          /* its an integer */
411 };
412
413 /*
414  * \brief mail attachment ???
415  */
416 typedef struct _wc_attachment {
417         size_t length;                     /* length of the contenttype */
418         StrBuf *content_type;      /* the content itself ???*/
419         StrBuf *filename;                  /* the filename hooked to this content ??? */
420         char *data;                /* the data pool; aka this content */
421         long lvalue;               /* if we put a long... */
422 } wc_attachment;
423 void free_attachment(void *vattach);
424
425
426 typedef struct wc_mime_attachment wc_mime_attachment;
427 typedef void (*RenderMimeFunc)(wc_mime_attachment *Mime, StrBuf *RawData, StrBuf *FoundCharset);
428 struct wc_mime_attachment {
429         int level;
430         StrBuf *Name;
431         StrBuf *FileName;
432         StrBuf *PartNum;
433         StrBuf *Disposition;
434         StrBuf *ContentType;
435         StrBuf *Charset;
436         StrBuf *Data;
437         size_t length;                     /* length of the mimeatachment */
438         long size_known;
439         char content_type[SIZ];    /* the content itself ???*/
440         char filename[SIZ];                /* the filename hooked to this content ??? */
441         char *data;                /* the data pool; aka this content */
442         long lvalue;               /* if we put a long... */
443         long msgnum;            /**< the message number on the citadel server derived from message_summary */
444         RenderMimeFunc Renderer;
445 };
446 void DestroyMime(void *vMime);
447
448
449 /*
450  * \brief message summary structure. ???
451  */
452 typedef struct _message_summary {
453         time_t date;        /**< its creation date */
454         long msgnum;            /**< the message number on the citadel server */
455         int nhdr;
456         int format_type;
457         StrBuf *from;           /**< the author */
458         StrBuf *to;             /**< the recipient */
459         StrBuf *subj;           /**< the title / subject */
460         StrBuf *reply_inreplyto;
461         StrBuf *reply_references;
462         StrBuf *reply_to;
463         StrBuf *cccc;
464         StrBuf *hnod;
465         StrBuf *AllRcpt;
466         StrBuf *Room;
467         StrBuf *Rfca;
468         StrBuf *OtherNode;
469         const StrBuf *PartNum;
470
471         HashList *Attachments;  /**< list of Accachments */
472         HashList *Submessages;
473         HashList *AttachLinks;
474
475         HashList *AllAttach;
476
477         int is_new;         /**< is it yet read? */
478         int hasattachments;     /* does it have atachments? */
479
480
481         /** The mime part of the message */
482         wc_mime_attachment *MsgBody;
483 } message_summary;
484 void DestroyMessageSummary(void *vMsg);
485 inline message_summary* GetMessagePtrAt(int n, HashList *Summ);
486
487 typedef void (*ExamineMsgHeaderFunc)(message_summary *Msg, StrBuf *HdrLine, StrBuf *FoundCharset);
488
489 void evaluate_mime_part(message_summary *Msg, wc_mime_attachment *Mime);
490
491
492
493 /**
494  * \brief  Data structure for roomlist-to-folderlist conversion 
495  */
496 struct folder {
497         int floor;      /* which floor is it on */
498         char room[SIZ]; /* which roomname ??? */
499         char name[SIZ]; /* which is its own name??? */
500         int hasnewmsgs; /* are there unread messages inside */
501         int is_mailbox; /* is it a mailbox?  */
502         int selectable; /* can we select it ??? */
503         int view;       /* whats its default view? inbox/calendar.... */
504         int num_rooms;  /* If this is a floor, how many rooms does it have */
505 };
506
507 typedef struct _disp_cal {                                      
508         icalcomponent *cal;             /* cal items for display */
509         long cal_msgnum;                /* cal msgids for display */
510         char *from;                     /* owner of this component */
511         int unread;                     /* already seen by the user? */
512
513         time_t event_start;
514         time_t event_end;
515
516         int multi_day_event;
517         int is_repeat;
518 } disp_cal;                                             
519
520
521
522 /*
523  * Address book entry (keep it short and sweet, it's just a quickie lookup
524  * which we can use to get to the real meat and bones later)
525  */
526 typedef struct _addrbookent {
527         char ab_name[64]; /**< name string */
528         long ab_msgnum;   /**< message number of address book entry */
529 } addrbookent;
530
531
532 typedef struct _headereval {
533         ExamineMsgHeaderFunc evaluator;
534         int Type;
535 } headereval;
536
537
538 struct attach_link {
539         char partnum[32];
540         char html[1024];
541 };
542
543
544 enum {
545         eUp,
546         eDown,
547         eNone
548 };
549
550 /*
551  * One of these is kept for each active Citadel session.
552  * HTTP transactions are bound to one at a time.
553  */
554 struct wcsession {
555         struct wcsession *next;                 /**< Linked list */
556         int wc_session;                         /**< WebCit session ID */
557         char wc_username[128];                  /**< login name of current user */
558         char wc_fullname[128];                  /**< Screen name of current user */
559         char wc_password[128];                  /**< Password of current user */
560         char wc_roomname[256];                  /**< Room we are currently in */
561         int connected;                          /**< nonzero == we are connected to Citadel */
562         int logged_in;                          /**< nonzero == we are logged in  */
563         int axlevel;                            /**< this user's access level */
564         int is_aide;                            /**< nonzero == this user is an Aide */
565         int is_room_aide;                       /**< nonzero == this user is a Room Aide in this room */
566         int http_sock;                          /**< HTTP server socket */
567         int serv_sock;                          /**< Client socket to Citadel server */
568         int chat_sock;                          /**< Client socket to Citadel server - for chat */
569         unsigned room_flags;                    /**< flags associated with the current room */
570         unsigned room_flags2;                   /**< flags associated with the current room */
571         int wc_view;                            /**< view for the current room */
572         int wc_default_view;                    /**< default view for the current room */
573         int wc_is_trash;                        /**< nonzero == current room is a Trash folder */
574         int wc_floor;                           /**< floor number of current room */
575         char ugname[128];                       /**< where does 'ungoto' take us */
576         long uglsn;                             /**< last seen message number for ungoto */
577         int upload_length;                      /**< content length of http-uploaded data */
578         char *upload;                           /**< pointer to http-uploaded data */
579         char upload_filename[PATH_MAX];         /**< filename of http-uploaded data */
580         char upload_content_type[256];          /**< content type of http-uploaded data */
581         int new_mail;                           /**< user has new mail waiting */
582         int remember_new_mail;                  /**< last count of new mail messages */
583         int need_regi;                          /**< This user needs to register. */
584         int need_vali;                          /**< New users require validation. */
585         char cs_inet_email[256];                /**< User's preferred Internet addr. */
586         pthread_mutex_t SessionMutex;           /**< mutex for exclusive access */
587         time_t lastreq;                         /**< Timestamp of most recent HTTP */
588         int killthis;                           /**< Nonzero == purge this session */
589         struct march *march;                    /**< march mode room list */
590         char reply_to[512];                     /**< reply-to address */
591         HashList *summ;                         /**< list of messages for mailbox summary view */
592         int is_mobile;                  /**< Client is a handheld browser */
593         HashList *urlstrings;                   /**< variables passed to webcit in a URL */
594         HashList *vars;                         /**< HTTP variable substitutions for this page */
595         char this_page[512];                    /**< URL of current page */
596         char http_host[512];                    /**< HTTP Host: header */
597         HashList *hash_prefs;                   /**< WebCit preferences for this user */
598         HashList *disp_cal_items;               /**< sorted list of calendar items; startdate is the sort criteria. */
599         HashList *attachments;                  /**< list of attachments for 'enter message' */
600         char last_chat_user[256];               /**< ??? todo */
601         char ImportantMessage[SIZ];             /**< ??? todo */
602         int ctdl_pid;                           /**< Session ID on the Citadel server */
603         char httpauth_user[256];                /**< only for GroupDAV sessions */
604         char httpauth_pass[256];                /**< only for GroupDAV sessions */
605         int gzip_ok;                            /**< Nonzero if Accept-encoding: gzip */
606         int is_mailbox;                         /**< the current room is a private mailbox */
607         struct folder *cache_fold;              /**< cache the iconbar room list */
608         int cache_max_folders;                  /**< ??? todo */
609         int cache_num_floors;                   /**< ??? todo */
610         time_t cache_timestamp;                 /**< ??? todo */
611         HashList *IconBarSetttings;             /**< which icons should be shown / not shown? */
612         long current_iconbar;                   /**< What is currently in the iconbar? */
613         const StrBuf *floordiv_expanded;        /**< which floordiv currently expanded */
614         int selected_language;                  /**< Language selected by user */
615         time_t last_pager_check;                /**< last time we polled for instant msgs */
616         int nonce;                              /**< session nonce (to prevent session riding) */
617         int time_format_cache;                  /**< which timeformat does our user like? */
618         StrBuf *UrlFragment1;                   /**< first urlfragment, if NEED_URL is specified by the handler*/
619         StrBuf *UrlFragment2;                   /**< second urlfragment, if NEED_URL is specified by the handler*/
620         StrBuf *WBuf;                           /**< Our output buffer */
621         StrBuf *HBuf;                           /**< Our HeaderBuffer */
622         StrBuf *CLineBuf;                       /**< linebuffering client stuff */
623         StrBuf *DefaultCharset;                 /**< Charset the user preferes */
624         HashList *ServCfg;                      /**< cache our server config for editing */
625         HashList *InetCfg;                      /**< Our inet server config for editing */
626
627         StrBuf *trailing_javascript;            /**< extra javascript to be appended to page */
628 };
629
630 /* values for WC->current_iconbar */
631 enum {
632         current_iconbar_menu,     /* view the icon menue */
633         current_iconbar_roomlist  /* view the roomtree */
634 };
635 enum {
636         S_SELECT,
637         S_SHUTDOWN,
638         MAX_SEMAPHORES
639 };
640
641
642 /*
643  * calview contains data passed back and forth between the message fetching loop
644  * and the calendar view renderer.
645  */
646 enum {
647         calview_month,
648         calview_day,
649         calview_week,
650         calview_brief
651 };
652
653 struct calview {
654         int view;
655         int year;
656         int month;
657         int day;
658         time_t lower_bound;
659         time_t upper_bound;
660 };
661
662 #ifndef num_parms
663 #define num_parms(source)               num_tokens(source, '|') 
664 #endif
665
666 /* Per-session data */
667 #define WC ((struct wcsession *)pthread_getspecific(MyConKey))
668 extern pthread_key_t MyConKey;
669
670 /* Per-thread SSL context */
671 #ifdef HAVE_OPENSSL
672 #define THREADSSL ((SSL *)pthread_getspecific(ThreadSSL))
673 extern pthread_key_t ThreadSSL;
674 extern char ctdl_key_dir[PATH_MAX];
675 extern char file_crpt_file_key[PATH_MAX];
676 extern char file_crpt_file_csr[PATH_MAX];
677 extern char file_crpt_file_cer[PATH_MAX];
678 #endif
679
680 struct serv_info serv_info;
681 extern char floorlist[128][SIZ];
682 extern char *axdefs[];
683 extern char *ctdlhost, *ctdlport;
684 extern int http_port;
685 extern char *server_cookie;
686 extern int is_https;
687 extern int setup_wizard;
688 extern char wizard_filename[];
689 extern time_t if_modified_since;
690 extern int follow_xff;
691 extern HashList *HandlerHash;
692 extern HashList *PreferenceHooks;
693 extern HashList *WirelessTemplateCache;
694 extern HashList *WirelessLocalTemplateCache;
695 extern HashList *TemplateCache;
696 extern HashList *LocalTemplateCache;
697 extern HashList *GlobalNS;
698 extern HashList *Iterators;
699 extern HashList *ZoneHash;
700 extern HashList *Conditionals;
701 extern HashList *MsgHeaderHandler;
702 extern HashList *MimeRenderHandler;
703 extern HashList *SortHash;
704
705 void InitialiseSemaphores(void);
706 void begin_critical_section(int which_one);
707 void end_critical_section(int which_one);
708
709
710 void stuff_to_cookie(char *cookie, size_t clen, int session,
711                         char *user, char *pass, char *room);
712 void cookie_to_stuff(StrBuf *cookie, int *session,
713                 char *user, size_t user_len,
714                 char *pass, size_t pass_len,
715                 char *room, size_t room_len);
716 void locate_host(char *, int);
717 void become_logged_in(char *, char *, char *);
718 void openid_manual_create(void);
719 void display_login();
720 void display_openids(void);
721 void do_welcome(void);
722 void do_logout(void);
723 void display_main_menu(void);
724 void display_aide_menu(void);
725 void display_advanced_menu(void);
726 void slrp_highest(void);
727 void get_serv_info(char *, char *);
728 int uds_connectsock(char *);
729 int tcp_connectsock(char *, char *);
730 int serv_getln(char *strbuf, int bufsize);
731 int StrBuf_ServGetln(StrBuf *buf);
732 int GetServerStatus(StrBuf *Line, long* FullState);
733 void serv_puts(const char *string);
734 void who(void);
735 void who_inner_div(void);
736 void ajax_mini_calendar(void);
737 void fmout(char *align);
738 void _fmout(StrBuf *Targt, char *align);
739 void FmOut(StrBuf *Target, char *align, StrBuf *Source);
740 void pullquote_fmout(void);
741 void wDumpContent(int);
742
743 int Flathash(const char *str, long len);
744
745
746 /* These may return NULL if not foud */
747 #define sbstr(a) SBstr(a, sizeof(a) - 1)
748 const StrBuf *SBSTR(const char *key);
749 const StrBuf *SBstr(const char *key, size_t keylen);
750
751 #define xbstr(a, b) (char*) XBstr(a, sizeof(a) - 1, b)
752 const char *XBstr(const char *key, size_t keylen, size_t *len);
753 const char *XBSTR(const char *key, size_t *len);
754
755 #define lbstr(a) LBstr(a, sizeof(a) - 1)
756 long LBstr(const char *key, size_t keylen);
757 long LBSTR(const char *key);
758
759 #define ibstr(a) IBstr(a, sizeof(a) - 1)
760 int IBstr(const char *key, size_t keylen);
761 int IBSTR(const char *key);
762
763 #define havebstr(a) HaveBstr(a, sizeof(a) - 1)
764 int HaveBstr(const char *key, size_t keylen);
765 int HAVEBSTR(const char *key);
766
767 #define yesbstr(a) YesBstr(a, sizeof(a) - 1)
768 int YesBstr(const char *key, size_t keylen);
769 int YESBSTR(const char *key);
770
771 /* TODO: get rid of the non-const-typecast */
772 #define bstr(a) (char*) Bstr(a, sizeof(a) - 1)
773 const char *BSTR(const char *key);
774 const char *Bstr(const char *key, size_t keylen);
775
776
777
778 void UrlescPutStrBuf(const StrBuf *strbuf);
779 void StrEscPuts(const StrBuf *strbuf);
780 void StrEscputs1(const StrBuf *strbuf, int nbsp, int nolinebreaks);
781
782 void urlescputs(const char *);
783 void hurlescputs(const char *);
784 void jsesc(char *, size_t, char *);
785 void jsescputs(char *);
786 void output_headers(    int do_httpheaders,
787                         int do_htmlhead,
788                         int do_room_banner,
789                         int unset_cookies,
790                         int suppress_check,
791                         int cache);
792 void wprintf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
793 void hprintf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
794 void output_static(char *what);
795 void display_mime_icon(void);
796 void print_menu_box(char* Title, char *Class, int nLines, ...);
797 long stresc(char *target, long tSize, char *strbuf, int nbsp, int nolinebreaks);
798 void escputs(char *strbuf);
799 void url(char *buf, size_t bufsize);
800 void UrlizeText(StrBuf* Target, StrBuf *Source, StrBuf *WrkBuf);
801 void escputs1(char *strbuf, int nbsp, int nolinebreaks);
802 void msgesc(char *target, size_t tlen, char *strbuf);
803 void msgescputs(char *strbuf);
804 void msgescputs1(char *strbuf);
805 void stripout(char *str, char leftboundary, char rightboundary);
806 void dump_vars(void);
807 void embed_main_menu(void);
808 void serv_read(char *buf, int bytes);
809
810 enum {
811         do_search,
812         headers,
813         readfwd,
814         readnew,
815         readold
816 };
817
818 typedef void (*readloop_servcmd)(char *buf, long bufsize);
819
820 typedef struct _readloopstruct {
821         ConstStr name;
822         readloop_servcmd cmd;
823 } readloop_struct;
824 void readloop(long oper);
825 int  read_message(StrBuf *Target, const char *tmpl, long tmpllen, long msgnum, int printable_view, const StrBuf *section);
826 void do_addrbook_view(addrbookent *addrbook, int num_ab);
827 void display_vcard(StrBuf *Target, const char *vcard_source, char alpha, int full, char *storename, long msgnum);
828 void text_to_server(char *ptr);
829 void text_to_server_qp(char *ptr);
830 void confirm_delete_msg(void);
831 void display_success(char *);
832 void authorization_required(const char *message);
833 void server_to_text(void);
834 void save_edit(char *description, char *enter_cmd, int regoto);
835 void display_edit(char *description, char *check_cmd,
836                   char *read_cmd, char *save_cmd, int with_room_banner);
837 int gotoroom(char *gname);
838 void confirm_delete_room(void);
839 void validate(void);
840 void display_graphics_upload(char *, char *, char *);
841 void do_graphics_upload(char *upl_cmd);
842 void serv_read(char *buf, int bytes);
843 void serv_gets(char *strbuf);
844 void serv_write(const char *buf, int nbytes);
845 void serv_puts(const char *string);
846 void serv_putbuf(const StrBuf *string);
847 void serv_printf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
848 void load_floorlist(void);
849 void shutdown_sessions(void);
850 void do_housekeeping(void);
851 void smart_goto(char *);
852 void worker_entry(void);
853 void session_loop(HashList *HTTPHeaders, StrBuf *ReqLine, StrBuf *ReqType, StrBuf *ReadBuf);
854 size_t wc_strftime(char *s, size_t max, const char *format, const struct tm *tm);
855 void fmt_time(char *buf, time_t thetime);
856 void httpdate(char *buf, time_t thetime);
857 time_t httpdate_to_timestamp(StrBuf *buf);
858 void end_webcit_session(void);
859 void page_popup(void);
860 void http_redirect(const char *);
861 void clear_substs(struct wcsession *wc);
862 void clear_local_substs(void);
863
864
865
866 int lingering_close(int fd);
867 char *memreadline(char *start, char *buf, int maxlen);
868 char *memreadlinelen(char *start, char *buf, int maxlen, int *retlen);
869 long extract_token(char *dest, const char *source, int parmnum, char separator, int maxlen);
870 void remove_token(char *source, int parmnum, char separator);
871 char *load_mimepart(long msgnum, char *partnum);
872 void MimeLoadData(wc_mime_attachment *Mime);
873 int pattern2(char *search, char *patn);
874 void do_edit_vcard(long, char *, char *, char *);
875 void striplt(char *);
876 void stripltlen(char *, int *);
877 void select_user_to_edit(char *message, char *preselect);
878 void delete_user(char *);
879 void do_change_view(int);
880 void folders(void);
881
882
883 void load_preferences(void);
884 void save_preferences(void);
885 #define get_preference(a, b) get_PREFERENCE(a, sizeof(a) - 1, b)
886 #define get_pref(a, b)       get_PREFERENCE(ChrPtr(a), StrLength(a), b)
887 int get_PREFERENCE(const char *key, size_t keylen, StrBuf **value);
888 #define set_preference(a, b, c) set_PREFERENCE(a, sizeof(a) - 1, b, c)
889 #define set_pref(a, b, c)       set_PREFERENCE(ChrPtr(a), StrLength(a), b, c)
890 void set_PREFERENCE(const char *key, size_t keylen, StrBuf *value, int save_to_server);
891
892 #define get_pref_long(a, b, c) get_PREF_LONG(a, sizeof(a) - 1, b, c)
893 int get_PREF_LONG(const char *key, size_t keylen, long *value, long Default);
894 #define set_pref_long(a, b, c) set_PREF_LONG(a, sizeof(a) - 1, b, c)
895 void set_PREF_LONG(const char *key, size_t keylen, long value, int save_to_server);
896
897 #define get_pref_yesno(a, b, c) get_PREF_YESNO(a, sizeof(a) - 1, b, c)
898 int get_PREF_YESNO(const char *key, size_t keylen, int *value, int Default);
899 #define set_pref_yesno(a, b, c) set_PREF_YESNO(a, sizeof(a) - 1, b, c)
900 void set_PREF_YESNO(const char *key, size_t keylen, int value, int save_to_server);
901
902 #define get_room_pref(a) get_ROOM_PREFS(a, sizeof(a) - 1)
903 StrBuf *get_ROOM_PREFS(const char *key, size_t keylen);
904
905 #define set_room_pref(a, b, c) set_ROOM_PREFS(a, sizeof(a) - 1, b, c)
906 void set_ROOM_PREFS(const char *key, size_t keylen, StrBuf *value, int save_to_server);
907
908 int is_msg_in_mset(char *mset, long msgnum);
909 void display_addressbook(long msgnum, char alpha);
910 void offer_start_page(StrBuf *Target, int nArgs, WCTemplateToken *Token, void *Context, int ContextType);
911 void convenience_page(char *titlebarcolor, char *titlebarmsg, char *messagetext);
912 void output_html(const char *, int, int, StrBuf *, StrBuf *);
913 void do_listsub(void);
914 void toggle_self_service(void);
915 ssize_t write(int fd, const void *buf, size_t count);
916 void cal_process_attachment(wc_mime_attachment *Mime);
917 void load_calendar_item(message_summary *Msg, int unread, struct calview *c);
918 void display_calendar(message_summary *Msg, int unread);
919 void display_task(message_summary *Msg, int unread);
920 void display_note(message_summary *Msg, int unread);
921 void updatenote(void);
922 void parse_calendar_view_request(struct calview *c);
923 void render_calendar_view(struct calview *c);
924 void do_tasks_view(void);
925 void calendar_summary_view(void);
926 int load_msg_ptrs(char *servcmd, int with_headers);
927 void free_attachments(struct wcsession *sess);
928 void free_march_list(struct wcsession *wcf);
929 void display_rules_editor_inner_div(void);
930 void generate_uuid(char *);
931 void CtdlMakeTempFileName(char *, int);
932 void address_book_popup(void);
933 void begin_ajax_response(void);
934 void end_ajax_response(void);
935 void initialize_viewdefs(void);
936 void initialize_axdefs(void);
937 void burn_folder_cache(time_t age);
938 void list_all_rooms_by_floor(const char *viewpref);
939 void display_pictureview(void);
940
941 void display_edit_task(void);
942 void display_edit_event(void);
943 icaltimezone *get_default_icaltimezone(void);
944 void display_icaltimetype_as_webform(struct icaltimetype *, char *, int);
945 void icaltime_from_webform(struct icaltimetype *result, char *prefix);
946 void icaltime_from_webform_dateonly(struct icaltimetype *result, char *prefix);
947 void display_edit_individual_event(icalcomponent *supplied_vtodo, long msgnum, char *from,
948         int unread, struct calview *calv);
949 void save_individual_event(icalcomponent *supplied_vtodo, long msgnum, char *from,
950         int unread, struct calview *calv);
951 void ical_dezonify(icalcomponent *cal);
952 void partstat_as_string(char *buf, icalproperty *attendee);
953 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp);
954 void check_attendee_availability(icalcomponent *supplied_vevent);
955 void do_freebusy(const char *req);
956 int ical_ctdl_is_overlap(
957                         struct icaltimetype t1start,
958                         struct icaltimetype t1end,
959                         struct icaltimetype t2start,
960                         struct icaltimetype t2end
961 );
962
963 #ifdef ENABLE_NLS
964 void initialize_locales(void);
965 void ShutdownLocale(void);
966 #endif
967 void TmplGettext(StrBuf *Target, int nTokens, WCTemplateToken *Token);
968
969 extern char *months[];
970 extern char *days[];
971 int read_server_binary(StrBuf *Ret, size_t total_len);
972 int StrBuf_ServGetBLOB(StrBuf *buf, long BlobSize);
973 int read_server_text(StrBuf *Buf, long *nLines);;
974 int goto_config_room(void);
975 long locate_user_vcard(char *username, long usernum);
976 void sleeeeeeeeeep(int);
977 void http_transmit_thing(const char *content_type, int is_static);
978 long unescape_input(char *buf);
979 void do_selected_iconbar(void);
980 void spawn_another_worker_thread(void);
981 void display_rss(char *roomname, StrBuf *request_method);
982 void offer_languages(StrBuf *Target, int nArgs, WCTemplateToken *Token, void *Context, int ContextType);
983 void set_selected_language(const char *);
984 void go_selected_language(void);
985 void stop_selected_language(void);
986 void preset_locale(void);
987 void httplang_to_locale(StrBuf *LocaleString);
988 void StrEndTab(StrBuf *Target, int tabnum, int num_tabs);
989 void StrBeginTab(StrBuf *Target, int tabnum, int num_tabs);
990 void StrTabbedDialog(StrBuf *Target, int num_tabs, StrBuf *tabnames[]);
991 void tabbed_dialog(int num_tabs, char *tabnames[]);
992 void begin_tab(int tabnum, int num_tabs);
993 void end_tab(int tabnum, int num_tabs);
994 void str_wiki_index(char *s);
995 int get_time_format_cached (void);
996 int xtoi(const char *in, size_t len);
997 const char *get_selected_language(void);
998 void webcit_fmt_date(char *buf, time_t thetime, int brief);
999 int fetch_http(char *url, char *target_buf, int maxbytes);
1000
1001 int is_mobile_ua(char *user_agent);
1002
1003 void embed_room_banner(char *, int);
1004
1005 /* navbar types that can be passed to embed_room_banner */
1006 enum {
1007         navbar_none,
1008         navbar_default
1009 };
1010
1011
1012 #ifdef HAVE_OPENSSL
1013 void init_ssl(void);
1014 void endtls(void);
1015 void ssl_lock(int mode, int n, const char *file, int line);
1016 int starttls(int sock);
1017 extern SSL_CTX *ssl_ctx;  
1018 int client_read_sslbuffer(StrBuf *buf, int timeout);
1019 void client_write_ssl(const StrBuf *Buf);
1020 #endif
1021
1022 #ifdef HAVE_ZLIB
1023 #include <zlib.h>
1024 int ZEXPORT compress_gzip(Bytef * dest, size_t * destLen,
1025                           const Bytef * source, uLong sourceLen, int level);
1026 #endif
1027
1028 void utf8ify_rfc822_string(char *buf);
1029
1030 void begin_burst(void);
1031 long end_burst(void);
1032
1033 extern char *hourname[];        /* Names of hours (12am, 1am, etc.) */
1034
1035 void http_datestring(char *buf, size_t n, time_t xtime);
1036
1037
1038 typedef void (*WebcitHandlerFunc)(void);
1039 typedef struct  _WebcitHandler{
1040         WebcitHandlerFunc F;
1041         long Flags;
1042 } WebcitHandler;
1043 void WebcitAddUrlHandler(const char * UrlString, long UrlSLen, WebcitHandlerFunc F, long Flags);
1044
1045 #define AJAX (1<<0)
1046 #define ANONYMOUS (1<<1)
1047 #define NEED_URL (1<<2)
1048
1049
1050 /* These should be empty, but we have them for testing */
1051 #define DEFAULT_HTTPAUTH_USER   ""
1052 #define DEFAULT_HTTPAUTH_PASS   ""
1053
1054
1055 /* Exit codes 101 through 109 are initialization failures so we don't want to
1056  * just keep respawning indefinitely.
1057  */
1058 #define WC_EXIT_BIND            101     /* Can't bind to the port */
1059 #define WC_EXIT_SSL             102     /* Can't initialize SSL */
1060
1061
1062 #define WC_TIMEFORMAT_NONE 0
1063 #define WC_TIMEFORMAT_AMPM 1
1064 #define WC_TIMEFORMAT_24 2
1065
1066