Updated version numbers.
[citadel.git] / webcit / webcit.h
1 /* $Id$ */
2
3 #include "sysdep.h"
4
5
6 #include <sys/select.h>
7
8 #include <ctype.h>
9 #include <stdlib.h>
10 #ifdef HAVE_UNISTD_H
11 #include <unistd.h>
12 #endif
13 #include <stdio.h>
14 #ifdef HAVE_FCNTL_H
15 #include <fcntl.h>
16 #endif
17 #include <signal.h>
18 #include <sys/types.h>
19 #include <sys/wait.h>
20 #include <sys/socket.h>
21 #ifdef HAVE_SYS_TIME_H
22 #include <sys/time.h>
23 #endif
24 #include <sys/stat.h>
25 #ifdef HAVE_LIMITS_H
26 #include <limits.h>
27 #endif
28 #include <netinet/in.h>
29 #include <arpa/inet.h>
30 #include <sys/un.h>
31 #include <netdb.h>
32 #include <sys/poll.h>
33 #include <string.h>
34 #include <pwd.h>
35 #include <errno.h>
36 #include <stdarg.h>
37 #include <pthread.h>
38 #include <signal.h>
39 #include <sys/utsname.h>
40
41 #include <libcitadel.h>
42
43 #ifndef INADDR_NONE
44 #define INADDR_NONE 0xffffffff
45 #endif
46
47 #ifdef HAVE_ICONV
48 #include <iconv.h>
49 #endif
50
51 #ifdef ENABLE_NLS
52 #include <libintl.h>
53 #include <locale.h>
54 #ifdef HAVE_USELOCALE
55 extern locale_t wc_locales[];
56 #endif
57 #define _(string)       gettext(string)
58 #else
59 #define _(string)       (string)
60 #endif
61
62 #define IsEmptyStr(a) ((a)[0] == '\0')
63 /*
64  * Uncomment to dump an HTTP trace to stderr
65 #define HTTP_TRACING 1
66  */
67
68 #ifdef HTTP_TRACING
69 #undef HAVE_ZLIB_H
70 #undef HAVE_ZLIB
71 #endif
72
73 #ifdef HAVE_ZLIB_H
74 #include <zlib.h>
75 #endif
76
77
78 /* Work around PACKAGE/VERSION defs that are (not supposed to be?) in ical.h */
79 #ifdef PACKAGE
80 # define CTDL_PACKAGE PACKAGE
81 # undef PACKAGE
82 #endif
83
84 #ifdef PACKAGE_STRING
85 # define CTDL_PACKAGE_STRING PACKAGE_STRING
86 //# undef PACKAGE_STRING
87 #endif
88
89 #ifdef VERSION
90 # define CTDL_VERSION VERSION
91 # undef VERSION
92 #endif
93
94 #include <ical.h>
95
96 #undef PACKAGE
97 #undef VERSION
98 #undef PACKAGE_NAME
99 #undef PACKAGE_STRING
100 #undef PACKAGE_TARNAME
101 #undef PACKAGE_VERSION
102 #undef PACKAGE_BUGREPORT
103 #include "sysdep.h"
104
105 ////////#include "hash.h"
106
107 #ifdef HAVE_OPENSSL
108 /* Work around RedHat's b0rken OpenSSL includes */
109 #define OPENSSL_NO_KRB5
110 #include <openssl/ssl.h>
111 #include <openssl/err.h>
112 #include <openssl/rand.h>
113 #endif
114
115 #define CALENDAR_ROOM_NAME      "Calendar"
116 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
117
118 #define SIZ                     4096            /* generic buffer size */
119
120 #define TRACE fprintf(stderr, "Checkpoint: %s, %d\n", __FILE__, __LINE__)
121
122 #define SLEEPING                180             /* TCP connection timeout */
123 #define WEBCIT_TIMEOUT          900             /* WebCit session timeout */
124 #define PORT_NUM                2000            /* port number to listen on */
125 #define DEVELOPER_ID            0
126 #define CLIENT_ID               4
127 #define CLIENT_VERSION          736             /* This version of WebCit */
128 #define MINIMUM_CIT_VERSION     730             /* min required Citadel ver */
129 #define LIBCITADEL_MIN          114             /* min required libcitadel ver */
130 #define DEFAULT_HOST            "localhost"     /* Default Citadel server */
131 #define DEFAULT_PORT            "504"
132 #define LB                      (1)             /* Internal escape chars */
133 #define RB                      (2)
134 #define QU                      (3)
135 #define TARGET                  "webcit01"      /* Target for inline URL's */
136 #define HOUSEKEEPING            15              /* Housekeeping frequency */
137 #define MIN_WORKER_THREADS      5
138 #define MAX_WORKER_THREADS      250
139 #define LISTEN_QUEUE_LENGTH     100             /* listen() backlog queue */
140
141 #define USERCONFIGROOM          "My Citadel Config"
142 #define DEFAULT_MAXMSGS         20
143
144
145 #ifdef LIBCITADEL_VERSION_NUMBER
146 #if LIBCITADEL_VERSION_NUMBER < LIBCITADEL_MIN
147 #error libcitadel is too old.  Please upgrade it before continuing.
148 #endif
149 #endif
150
151
152 /*
153  * Room flags (from Citadel)
154  *
155  * bucket one...
156  */
157 #define QR_PERMANENT    1               /**< Room does not purge                */
158 #define QR_INUSE        2               /**< Set if in use, clear if avail      */
159 #define QR_PRIVATE      4               /**< Set for any type of private room   */
160 #define QR_PASSWORDED   8               /**< Set if there's a password too      */
161 #define QR_GUESSNAME    16              /**< Set if it's a guessname room       */
162 #define QR_DIRECTORY    32              /**< Directory room                     */
163 #define QR_UPLOAD       64              /**< Allowed to upload                  */
164 #define QR_DOWNLOAD     128             /**< Allowed to download                */
165 #define QR_VISDIR       256             /**< Visible directory                  */
166 #define QR_ANONONLY     512             /**< Anonymous-Only room                */
167 #define QR_ANONOPT      1024            /**< Anonymous-Option room              */
168 #define QR_NETWORK      2048            /**< Shared network room                */
169 #define QR_PREFONLY     4096            /**< Preferred status needed to enter   */
170 #define QR_READONLY     8192            /**< Aide status required to post       */
171 #define QR_MAILBOX      16384           /**< Set if this is a private mailbox   */
172
173 /**
174  * bucket two...
175  */
176 #define QR2_SYSTEM      1               /**< System room; hide by default       */
177 #define QR2_SELFLIST    2               /**< Self-service mailing list mgmt     */
178 #define QR2_COLLABDEL   4               /**< Anyone who can post can also delete*/
179 #define QR2_SUBJECTREQ  8               /**< Subject strongly recommended */
180 #define QR2_SMTP_PUBLIC 16              /* smtp public postable room */
181 #define QR2_MODERATED   32              /* Listservice aide has to permit posts  */
182
183 /**
184  * user/room access
185  */
186 #define UA_KNOWN        2
187 #define UA_GOTOALLOWED  4
188 #define UA_HASNEWMSGS   8
189 #define UA_ZAPPED       16
190
191
192 /**
193  * User flags (from Citadel)
194  */
195 #define US_NEEDVALID    1               /**< User needs to be validated         */
196 #define US_PERM         4               /**< Permanent user                     */
197 #define US_LASTOLD      16              /**< Print last old message with new    */
198 #define US_EXPERT       32              /**< Experienced user                   */
199 #define US_UNLISTED     64              /**< Unlisted userlog entry             */
200 #define US_NOPROMPT     128             /**< Don't prompt after each message    */
201 #define US_PROMPTCTL    256             /**< <N>ext & <S>top work at prompt     */
202 #define US_DISAPPEAR    512             /**< Use "disappearing msg prompts"     */
203 #define US_REGIS        1024            /**< Registered user                    */
204 #define US_PAGINATOR    2048            /**< Pause after each screen of text    */
205 #define US_INTERNET     4096            /**< Internet mail privileges           */
206 #define US_FLOORS       8192            /**< User wants to see floors           */
207 #define US_COLOR        16384           /**< User wants ANSI color support      */
208 #define US_USER_SET     (US_LASTOLD | US_EXPERT | US_UNLISTED | \
209                         US_NOPROMPT | US_DISAPPEAR | US_PAGINATOR | \
210                         US_FLOORS | US_COLOR | US_PROMPTCTL )
211
212 /*
213  * NLI is the string that shows up in a who's online listing for sessions
214  * that are active, but for which no user has yet authenticated.
215  */
216 #define NLI     "(not logged in)"
217
218
219 /** \brief      Linked list of lines appearing in an HTTP client request */
220 struct httprequest {
221         struct httprequest *next;  /**< the next request in the list */
222         char line[SIZ];            /**< the request line */
223 };
224
225 /**
226  * \brief       Linked list of session variables encoded in an x-www-urlencoded content type
227  */
228 typedef struct urlcontent urlcontent;
229 struct urlcontent {
230         char url_key[32];          /**< the variable name */
231         char *url_data;            /**< its value */
232         size_t url_data_size;      /**< how big is it? */
233 };
234
235 /**
236  * \brief information about us ???
237  */ 
238 struct serv_info {
239         int serv_pid;                   /* Process ID of the Citadel server */
240         char serv_nodename[32];         /* Node name of the Citadel server */
241         char serv_humannode[64];        /* human readable node name of the Citadel server */
242         char serv_fqdn[64];             /* fully quallified Domain Name (such as uncensored.citadel.org) */
243         char serv_software[64];         /* What version does our connected citadel server use */
244         int serv_rev_level;             /* Whats the citadel server revision */
245         char serv_bbs_city[64];         /* Geographic location of the Citadel server */
246         char serv_sysadm[64];           /* Name of system administrator */
247         char serv_moreprompt[256];      /* Whats the commandline textprompt */
248         int serv_ok_floors;             /* nonzero == server supports floors */
249         int serv_supports_ldap;         /* is the server linked against an ldap tree for adresses? */
250         int serv_newuser_disabled;      /* Has the server disabled self-service new user creation? */
251         char serv_default_cal_zone[128];/* Default timezone for unspecified calendar items */
252         int serv_supports_sieve;        /* Does the server support Sieve mail filtering? */
253         int serv_fulltext_enabled;      /* Does the server have the full text index enabled? */
254         char serv_svn_revision[256];    /* SVN revision of the server */
255 };
256
257
258
259 /**
260  * \brief This struct holds a list of rooms for \\\<G\\\>oto operations.
261  */
262 struct march {
263         struct march *next;       /**< pointer to next in linked list */
264         char march_name[128];     /**< name of room */
265         int march_floor;          /**< floor number of room */
266         int march_order;          /**< sequence in which we are to visit this room */
267 };
268
269 /* *
270  * \brief       This struct holds a list of rooms for client display.
271  *              It is a binary tree.
272  */
273 struct roomlisting {
274         struct roomlisting *lnext;      /**< pointer to 'left' tree node */
275         struct roomlisting *rnext;      /**< pointer to 'right' tree node */
276         char rlname[128];               /**< name of room */
277         unsigned rlflags;               /**< room flags */
278         int rlfloor;                    /**< the floor it resides on */
279         int rlorder;                    /**< room listing order */
280 };
281
282
283
284 /**
285  * \brief Dynamic content for variable substitution in templates
286  */
287 typedef struct _wcsubst {
288         int wcs_type;                       /**< which type of ??? */
289         char wcs_key[32];                   /**< ??? what?*/
290         void *wcs_value;                    /**< ???? what?*/
291         void (*wcs_function)(void); /**< funcion hook ???*/
292 } wcsubst;
293
294 /**
295  * \brief Values for wcs_type
296  */
297 enum {
298         WCS_STRING,   /**< its a string */
299         WCS_FUNCTION, /**< its a function callback */
300         WCS_SERVCMD   /**< its a command to send to the citadel server */
301 };
302
303 /**
304  * \brief mail attachment ???
305  */
306 struct wc_attachment {
307         struct wc_attachment *next;/**< pointer to next in list */
308         size_t length;                     /**< length of the contenttype */
309         char content_type[SIZ];    /**< the content itself ???*/
310         char filename[SIZ];                /**< the filename hooked to this content ??? */
311         char *data;                /**< the data pool; aka this content */
312 };
313
314 /**
315  * \brief message summary structure. ???
316  */
317 struct message_summary {
318         time_t date;        /**< its creation date */
319         long msgnum;            /**< the message number on the citadel server */
320         char from[128];         /**< the author */
321         char to[128];           /**< the recipient */
322         char subj[256];         /**< the title / subject */
323         int hasattachments;     /**< does it have atachments? */
324         int is_new;         /**< is it yet read? */
325 };
326
327 /**
328  * \brief  Data structure for roomlist-to-folderlist conversion 
329  */
330 struct folder {
331         int floor;      /**< which floor is it on */
332         char room[SIZ]; /**< which roomname ??? */
333         char name[SIZ]; /**< which is its own name??? */
334         int hasnewmsgs; /**< are there unread messages inside */
335         int is_mailbox; /**< is it a mailbox?  */
336         int selectable; /**< can we select it ??? */
337         int view;       /**< whats its default view? inbox/calendar.... */
338         int num_rooms;  /**< If this is a floor, how many rooms does it have */
339 };
340
341 typedef struct _disp_cal {                                      
342         icalcomponent *cal;             /**< cal items for display */
343         long cal_msgnum;                /**< cal msgids for display */
344         char *from;                     /**< owner of this component */
345         int unread;                     /**< already seen by the user? */
346
347         time_t event_start;
348         time_t event_end;
349
350         int multi_day_event;
351         int is_repeat;
352 } disp_cal;                                             
353
354
355 /**
356  * \brief One of these is kept for each active Citadel session.
357  * HTTP transactions are bound to on e at a time.
358  */
359 struct wcsession {
360         struct wcsession *next;                 /**< Linked list */
361         int wc_session;                         /**< WebCit session ID */
362         char wc_username[128];                  /**< login name of current user */
363         char wc_fullname[128];                  /**< Screen name of current user */
364         char wc_password[128];                  /**< Password of current user */
365         char wc_roomname[256];                  /**< Room we are currently in */
366         int connected;                          /**< nonzero == we are connected to Citadel */
367         int logged_in;                          /**< nonzero == we are logged in  */
368         int axlevel;                            /**< this user's access level */
369         int is_aide;                            /**< nonzero == this user is an Aide */
370         int is_room_aide;                       /**< nonzero == this user is a Room Aide in this room */
371         int http_sock;                          /**< HTTP server socket */
372         int serv_sock;                          /**< Client socket to Citadel server */
373         int chat_sock;                          /**< Client socket to Citadel server - for chat */
374         unsigned room_flags;                    /**< flags associated with the current room */
375         unsigned room_flags2;                   /**< flags associated with the current room */
376         int wc_view;                            /**< view for the current room */
377         int wc_default_view;                    /**< default view for the current room */
378         int wc_is_trash;                        /**< nonzero == current room is a Trash folder */
379         int wc_floor;                           /**< floor number of current room */
380         char ugname[128];                       /**< where does 'ungoto' take us */
381         long uglsn;                             /**< last seen message number for ungoto */
382         int upload_length;                      /**< content length of http-uploaded data */
383         char *upload;                           /**< pointer to http-uploaded data */
384         char upload_filename[PATH_MAX];         /**< filename of http-uploaded data */
385         char upload_content_type[256];          /**< content type of http-uploaded data */
386         int new_mail;                           /**< user has new mail waiting */
387         int remember_new_mail;                  /**< last count of new mail messages */
388         int need_regi;                          /**< This user needs to register. */
389         int need_vali;                          /**< New users require validation. */
390         char cs_inet_email[256];                /**< User's preferred Internet addr. */
391         pthread_mutex_t SessionMutex;           /**< mutex for exclusive access */
392         time_t lastreq;                         /**< Timestamp of most recent HTTP */
393         int killthis;                           /**< Nonzero == purge this session */
394         struct march *march;                    /**< march mode room list */
395         char reply_to[512];                     /**< reply-to address */
396         long msgarr[10000];                     /**< for read operations */
397         int num_summ;                           /**< number of messages in mailbox summary view */
398         struct message_summary *summ;           /**< array of messages for mailbox summary view */
399         int is_wap;                             /**< Client is a WAP gateway */
400         HashList *urlstrings;                   /**< variables passed to webcit in a URL */
401         HashList *vars;                         /**< HTTP variable substitutions for this page */
402         char this_page[512];                    /**< URL of current page */
403         char http_host[512];                    /**< HTTP Host: header */
404         HashList *hash_prefs;                   /**< WebCit preferences for this user */
405         HashList *disp_cal_items;               /**< sorted list of calendar items; startdate is the sort criteria. */
406         struct wc_attachment *first_attachment; /**< linked list of attachments for 'enter message' */
407         char last_chat_user[256];               /**< ??? todo */
408         char ImportantMessage[SIZ];             /**< ??? todo */
409         int ctdl_pid;                           /**< Session ID on the Citadel server */
410         char httpauth_user[256];                /**< only for GroupDAV sessions */
411         char httpauth_pass[256];                /**< only for GroupDAV sessions */
412         size_t burst_len;                       /** <??? todo */
413         size_t burst_alloc;                     /** <??? todo */
414         char *burst;                            /** <??? todo */
415         int gzip_ok;                            /**< Nonzero if Accept-encoding: gzip */
416         int is_mailbox;                         /**< the current room is a private mailbox */
417         struct folder *cache_fold;              /**< cache the iconbar room list */
418         int cache_max_folders;                  /**< ??? todo */
419         int cache_num_floors;                   /**< ??? todo */
420         time_t cache_timestamp;                 /**< ??? todo */
421         int current_iconbar;                    /**< What is currently in the iconbar? */
422         char floordiv_expanded[32];             /**< which floordiv currently expanded */
423         int selected_language;                  /**< Language selected by user */
424         time_t last_pager_check;                /**< last time we polled for instant msgs */
425         int nonce;                              /**< session nonce (to prevent session riding) */
426         int time_format_cache;                  /**< which timeformat does our user like? */
427 };
428
429 /** values for WC->current_iconbar */
430 enum {
431         current_iconbar_menu,     /**< view the icon menue */
432         current_iconbar_roomlist  /**< view the roomtree */
433 };
434 enum {
435         S_SELECT,
436         S_SHUTDOWN,
437         MAX_SEMAPHORES
438 };
439
440 #ifndef num_parms
441 #define num_parms(source)               num_tokens(source, '|') 
442 #endif
443
444 /* Per-session data */
445 #define WC ((struct wcsession *)pthread_getspecific(MyConKey))
446 extern pthread_key_t MyConKey;
447
448 /* Per-thread SSL context */
449 #ifdef HAVE_OPENSSL
450 #define THREADSSL ((SSL *)pthread_getspecific(ThreadSSL))
451 extern pthread_key_t ThreadSSL;
452 extern char ctdl_key_dir[PATH_MAX];
453 extern char file_crpt_file_key[PATH_MAX];
454 extern char file_crpt_file_csr[PATH_MAX];
455 extern char file_crpt_file_cer[PATH_MAX];
456 #endif
457
458 struct serv_info serv_info;
459 extern char floorlist[128][SIZ];
460 extern char *axdefs[];
461 extern char *ctdlhost, *ctdlport;
462 extern int http_port;
463 extern char *server_cookie;
464 extern int is_https;
465 extern int setup_wizard;
466 extern char wizard_filename[];
467 extern time_t if_modified_since;
468 extern int follow_xff;
469 extern HashList *HandlerHash;
470 void do_setup_wizard(void);
471
472
473 void InitialiseSemaphores(void);
474 void begin_critical_section(int which_one);
475 void end_critical_section(int which_one);
476
477
478 void stuff_to_cookie(char *cookie, size_t clen, int session,
479                         char *user, char *pass, char *room);
480 void cookie_to_stuff(char *cookie, int *session,
481                 char *user, size_t user_len,
482                 char *pass, size_t pass_len,
483                 char *room, size_t room_len);
484 void locate_host(char *, int);
485 void become_logged_in(char *, char *, char *);
486 void do_login(void);
487 void do_openid_login(void);
488 void finalize_openid_login(void);
489 void display_login(char *mesg);
490 void display_openid_login(char *mesg);
491 void display_openids(void);
492 void openid_attach(void);
493 void do_welcome(void);
494 void do_logout(void);
495 void display_main_menu(void);
496 void display_aide_menu(void);
497 void display_shutdown(void);
498 void display_advanced_menu(void);
499 void slrp_highest(void);
500 void gotonext(void);
501 void ungoto(void);
502 void get_serv_info(char *, char *);
503 int uds_connectsock(char *);
504 int tcp_connectsock(char *, char *);
505 int serv_getln(char *strbuf, int bufsize);
506 void serv_puts(char *string);
507 void who(void);
508 void who_inner_div(void);
509 void wholist_section(void);
510 void tasks_section(void);
511 void calendar_section(void);
512 void ajax_mini_calendar(void);
513 void new_messages_section(void);
514 void fmout(char *align);
515 void pullquote_fmout(void);
516 void wDumpContent(int);
517 void serv_printf(const char *format,...);
518
519 /* TODO: get rid of the non-const-typecast */
520 #define bstr(a) (char*) Bstr(a, sizeof(a) - 1)
521 const char *BSTR(char *key);
522 const char *Bstr(char *key, size_t keylen);
523
524 #define xbstr(a, b) (char*) XBstr(a, sizeof(a) - 1, b)
525 const char *XBstr(char *key, size_t keylen, size_t *len);
526 const char *XBSTR(char *key, size_t *len);
527
528 #define lbstr(a) LBstr(a, sizeof(a) - 1)
529 long LBstr(char *key, size_t keylen);
530 long LBSTR(char *key);
531
532 #define ibstr(a) IBstr(a, sizeof(a) - 1)
533 int IBstr(char *key, size_t keylen);
534 int IBSTR(char *key);
535
536 #define havebstr(a) HaveBstr(a, sizeof(a) - 1)
537 int HaveBstr(char *key, size_t keylen);
538 int HAVEBSTR(char *key);
539
540 #define yesbstr(a) YesBstr(a, sizeof(a) - 1)
541 int YesBstr(char *key, size_t keylen);
542 int YESBSTR(char *key);
543
544
545 void urlescputs(char *);
546 void jsesc(char *, size_t, char *);
547 void jsescputs(char *);
548 void output_headers(    int do_httpheaders,
549                         int do_htmlhead,
550                         int do_room_banner,
551                         int unset_cookies,
552                         int suppress_check,
553                         int cache);
554 void wprintf(const char *format,...);
555 void output_static(char *what);
556 void display_mime_icon(void);
557 void print_menu_box(char* Title, char *Class, int nLines, ...);
558 long stresc(char *target, long tSize, char *strbuf, int nbsp, int nolinebreaks);
559 void escputs(char *strbuf);
560 void url(char *buf, size_t bufsize);
561 void escputs1(char *strbuf, int nbsp, int nolinebreaks);
562 void msgesc(char *target, size_t tlen, char *strbuf);
563 void msgescputs(char *strbuf);
564 void msgescputs1(char *strbuf);
565 void stripout(char *str, char leftboundary, char rightboundary);
566 void dump_vars(void);
567 void embed_main_menu(void);
568 void serv_read(char *buf, int bytes);
569 void readloop(char *oper);
570 void read_message(long msgnum, int printable_view, char *section);
571 void embed_message(char *msgnum_as_string);
572 void print_message(char *msgnum_as_string);
573 void display_headers(char *msgnum_as_string);
574 void text_to_server(char *ptr);
575 void text_to_server_qp(char *ptr);
576 void display_enter(void);
577 void post_message(void);
578 void confirm_delete_msg(void);
579 void delete_msg(void);
580 void confirm_move_msg(void);
581 void move_msg(void);
582 void userlist(void);
583 void showuser(void);
584 void display_page(void);
585 void page_user(void);
586 void do_chat(void);
587 void display_private(char *rname, int req_pass);
588 void goto_private(void);
589 void zapped_list(void);
590 void display_zap(void);
591 void zap(void);
592 void display_success(char *);
593 void authorization_required(const char *message);
594 void display_entroom(void);
595 void entroom(void);
596 void display_editroom(void);
597 void netedit(void);
598 void editroom(void);
599 void display_whok(void);
600 void do_invt_kick(void);
601 void server_to_text(void);
602 void save_edit(char *description, char *enter_cmd, int regoto);
603 void display_edit(char *description, char *check_cmd,
604                   char *read_cmd, char *save_cmd, int with_room_banner);
605 int gotoroom(char *gname);
606 void confirm_delete_room(void);
607 void delete_room(void);
608 void validate(void);
609 void display_graphics_upload(char *, char *, char *);
610 void do_graphics_upload(char *upl_cmd);
611 void serv_read(char *buf, int bytes);
612 void serv_gets(char *strbuf);
613 void serv_write(char *buf, int nbytes);
614 void serv_puts(char *string);
615 void serv_printf(const char *format,...);
616 void load_floorlist(void);
617 void display_reg(int);
618 void display_changepw(void);
619 void changepw(void);
620 void display_edit_node(void);
621 void edit_node(void);
622 void display_netconf(void);
623 void display_confirm_delete_node(void);
624 void delete_node(void);
625 void display_add_node(void);
626 void terminate_session(void);
627 void shutdown_sessions(void);
628 void do_housekeeping(void);
629 void edit_me(void);
630 void display_siteconfig(void);
631 void siteconfig(void);
632 void display_generic(void);
633 void do_generic(void);
634 void ajax_servcmd(void);
635 void display_menubar(int);
636 void smart_goto(char *);
637 void worker_entry(void);
638 void session_loop(struct httprequest *);
639 size_t wc_strftime(char *s, size_t max, const char *format, const struct tm *tm);
640 void fmt_time(char *buf, time_t thetime);
641 void httpdate(char *buf, time_t thetime);
642 time_t httpdate_to_timestamp(char *buf);
643 void end_webcit_session(void);
644 void page_popup(void);
645 void chat_recv(void);
646 void chat_send(void);
647 void http_redirect(char *);
648 void clear_substs(struct wcsession *wc);
649 void clear_local_substs(void);
650
651
652 typedef void (*var_callback_fptr)();
653
654
655 void SVPut(char *keyname, size_t keylen, int keytype, char *Data);
656 #define svput(a, b, c) SVPut(a, sizeof(a) - 1, b, c)
657 void svprintf(char *keyname, size_t keylen, int keytype, const char *format,...);
658 void SVPRINTF(char *keyname, int keytype, const char *format,...);
659 void SVCALLBACK(char *keyname, var_callback_fptr fcn_ptr);
660 void SVCallback(char *keyname, size_t keylen,  var_callback_fptr fcn_ptr);
661 #define svcallback(a, b) SVCallback(a, sizeof(a) - 1, b)
662
663 void do_template(void *templatename);
664
665
666 int lingering_close(int fd);
667 char *memreadline(char *start, char *buf, int maxlen);
668 char *memreadlinelen(char *start, char *buf, int maxlen, int *retlen);
669 long extract_token(char *dest, const char *source, int parmnum, char separator, int maxlen);
670 void remove_token(char *source, int parmnum, char separator);
671 char *load_mimepart(long msgnum, char *partnum);
672 int pattern2(char *search, char *patn);
673 void do_edit_vcard(long, char *, char *, char *);
674 void edit_vcard(void);
675 void submit_vcard(void);
676 void striplt(char *);
677 void stripltlen(char *, int *);
678 void select_user_to_edit(char *message, char *preselect);
679 void delete_user(char *);
680 void display_edituser(char *who, int is_new);
681 void create_user(void);
682 void edituser(void);
683 void do_change_view(int);
684 void change_view(void);
685 void folders(void);
686 void load_preferences(void);
687 void save_preferences(void);
688 void get_preference(char *key, char *value, size_t value_len);
689 void set_preference(char *key, char *value, int save_to_server);
690 void knrooms(void);
691 int is_msg_in_mset(char *mset, long msgnum);
692 void display_addressbook(long msgnum, char alpha);
693 void offer_start_page(void);
694 void convenience_page(char *titlebarcolor, char *titlebarmsg, char *messagetext);
695 void change_start_page(void);
696 void output_html(char *, int);
697 void display_floorconfig(char *);
698 void delete_floor(void);
699 void create_floor(void);
700 void rename_floor(void);
701 void do_listsub(void);
702 void toggle_self_service(void);
703 void summary(void);
704 void summary_inner_div(void);
705 ssize_t write(int fd, const void *buf, size_t count);
706 void cal_process_attachment(char *part_source, long msgnum, char *cal_partnum);
707 void display_calendar(long msgnum, int unread);
708 void display_task(long msgnum, int unread);
709 void display_note(long msgnum, int unread);
710 void add_new_note(void);
711 void updatenote(void);
712 void ajax_update_note(void);
713 void do_calendar_view(void);
714 void do_tasks_view(void);
715 void calendar_summary_view(void);
716 int load_msg_ptrs(char *servcmd, int with_headers);
717 void free_attachments(struct wcsession *sess);
718 void free_march_list(struct wcsession *wcf);
719 void set_room_policy(void);
720 void display_inetconf(void);
721 void save_inetconf(void);
722 void display_smtpqueue(void);
723 void display_smtpqueue_inner_div(void);
724 void display_sieve(void);
725 void display_rules_editor_inner_div(void);
726 void save_sieve(void);
727 void display_pushemail(void);
728 void save_pushemail(void);
729 void display_add_remove_scripts(char *);
730 void create_script(void);
731 void delete_script(void);
732 void generate_uuid(char *);
733 void CtdlMakeTempFileName(char *, int);
734 void display_preferences(void);
735 void set_preferences(void);
736 void recp_autocomplete(char *);
737 void address_book_popup(void);
738 void display_address_book_middle_div(void);
739 void display_address_book_inner_div(void);
740 void begin_ajax_response(void);
741 void end_ajax_response(void);
742 void initialize_viewdefs(void);
743 void initialize_axdefs(void);
744 void burn_folder_cache(time_t age);
745 void list_all_rooms_by_floor(char *viewpref);
746 void display_room_directory(void);
747 void display_picture(void);
748 void display_pictureview(void);
749 void download_file(char *);
750 void upload_file(void);
751
752 void display_edit_task(void);
753 void save_task(void);
754 void display_edit_event(void);
755 void save_event(void);
756 icaltimezone *get_default_icaltimezone(void);
757 void display_icaltimetype_as_webform(struct icaltimetype *, char *);
758 void icaltime_from_webform(struct icaltimetype *result, char *prefix);
759 void icaltime_from_webform_dateonly(struct icaltimetype *result, char *prefix);
760 void display_edit_individual_event(icalcomponent *supplied_vtodo, long msgnum, char *from, int unread);
761 void save_individual_event(icalcomponent *supplied_vtodo, long msgnum, char *from, int unread);
762 void respond_to_request(void);
763 void handle_rsvp(void);
764 void ical_dezonify(icalcomponent *cal);
765 void partstat_as_string(char *buf, icalproperty *attendee);
766 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp);
767 void check_attendee_availability(icalcomponent *supplied_vevent);
768 void do_freebusy(char *req);
769 int ical_ctdl_is_overlap(
770                         struct icaltimetype t1start,
771                         struct icaltimetype t1end,
772                         struct icaltimetype t2start,
773                         struct icaltimetype t2end
774 );
775
776 #ifdef ENABLE_NLS
777 void initialize_locales(void);
778 #endif
779
780 extern char *months[];
781 extern char *days[];
782 void read_server_binary(char *buffer, size_t total_len);
783 char *read_server_text(void);
784 int goto_config_room(void);
785 long locate_user_vcard(char *username, long usernum);
786 void sleeeeeeeeeep(int);
787 void http_transmit_thing(char *thing, size_t length, const char *content_type,
788                          int is_static);
789 long unescape_input(char *buf);
790 void do_iconbar(void);
791 void do_iconbar_roomlist(void);
792 void do_selected_iconbar(void);
793 void display_customize_iconbar(void);
794 void commit_iconbar(void);
795 int CtdlDecodeQuotedPrintable(char *decoded, char *encoded, int sourcelen);
796 void spawn_another_worker_thread(void);
797 void display_rss(char *roomname, char *request_method);
798 void set_floordiv_expanded(char *which_floordiv);
799 void offer_languages(void);
800 void set_selected_language(char *);
801 void go_selected_language(void);
802 void stop_selected_language(void);
803 void preset_locale(void);
804 void httplang_to_locale(char *LocaleString);
805 void tabbed_dialog(int num_tabs, char *tabnames[]);
806 void begin_tab(int tabnum, int num_tabs);
807 void end_tab(int tabnum, int num_tabs);
808 void str_wiki_index(char *s);
809 void display_wiki_page(void);
810 int get_time_format_cached (void);
811 int xtoi(char *in, size_t len);
812 void webcit_fmt_date(char *buf, time_t thetime, int brief);
813 int fetch_http(char *url, char *target_buf, int maxbytes);
814
815
816 #ifdef HAVE_ICONV
817 iconv_t ctdl_iconv_open(const char *tocode, const char *fromcode);
818 #endif
819
820 void embed_room_banner(char *, int);
821
822 /* navbar types that can be passed to embed_room_banner */
823 enum {
824         navbar_none,
825         navbar_default
826 };
827
828
829 #ifdef HAVE_OPENSSL
830 void init_ssl(void);
831 void endtls(void);
832 void ssl_lock(int mode, int n, const char *file, int line);
833 int starttls(int sock);
834 extern SSL_CTX *ssl_ctx;  
835 int client_read_ssl(char *buf, int bytes, int timeout);
836 void client_write_ssl(char *buf, int nbytes);
837 #endif
838
839 #ifdef HAVE_ZLIB
840 #include <zlib.h>
841 int ZEXPORT compress_gzip(Bytef * dest, size_t * destLen,
842                           const Bytef * source, uLong sourceLen, int level);
843 #endif
844
845 void utf8ify_rfc822_string(char *buf);
846
847 void begin_burst(void);
848 void end_burst(void);
849
850 extern char *hourname[];        /**< Names of hours (12am, 1am, etc.) */
851
852 void http_datestring(char *buf, size_t n, time_t xtime);
853
854
855 typedef void (*WebcitHandlerFunc)(void);
856 typedef struct  _WebcitHandler{
857         WebcitHandlerFunc F;
858         int IsAjax;
859 } WebcitHandler;
860 void WebcitAddUrlHandler(const char * UrlString, long UrlSLen, WebcitHandlerFunc F, int IsAjax);
861
862
863
864 /* These should be empty, but we have them for testing */
865 #define DEFAULT_HTTPAUTH_USER   ""
866 #define DEFAULT_HTTPAUTH_PASS   ""
867
868
869 /* Exit codes 101 through 109 are initialization failures so we don't want to
870  * just keep respawning indefinitely.
871  */
872 #define WC_EXIT_BIND            101     /* Can't bind to the port */
873 #define WC_EXIT_SSL             102     /* Can't initialize SSL */
874
875
876 #define WC_TIMEFORMAT_NONE 0
877 #define WC_TIMEFORMAT_AMPM 1
878 #define WC_TIMEFORMAT_24 2
879
880