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