422ecb2027b707a30fec7f9094b0b10cf8b4fa32
[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 #define _(string)       gettext(string)
59 #else
60 #define _(string)       (string)
61 #endif
62
63 #define IsEmptyStr(a) ((a)[0] == '\0')
64 /*
65  * Uncomment to dump an HTTP trace to stderr
66 #define HTTP_TRACING 1
67  */
68
69 #ifdef HTTP_TRACING
70 #undef HAVE_ZLIB_H
71 #undef HAVE_ZLIB
72 #endif
73
74 #ifdef HAVE_ZLIB_H
75 #include <zlib.h>
76 #endif
77
78 #include <libical/ical.h>
79
80 #undef PACKAGE
81 #undef VERSION
82 #undef PACKAGE_NAME
83 #undef PACKAGE_STRING
84 #undef PACKAGE_TARNAME
85 #undef PACKAGE_VERSION
86 #undef PACKAGE_BUGREPORT
87 #include "sysdep.h"
88
89 #include "subst.h"
90 #include "messages.h"
91 #include "paramhandling.h"
92 #include "preferences.h"
93 #include "roomops.h"
94
95 #ifdef HAVE_OPENSSL
96 /* Work around RedHat's b0rken OpenSSL includes */
97 #define OPENSSL_NO_KRB5
98 #include <openssl/ssl.h>
99 #include <openssl/err.h>
100 #include <openssl/rand.h>
101 extern char *ssl_cipher_list;
102 #define DEFAULT_SSL_CIPHER_LIST "DEFAULT"       /* See http://openssl.org/docs/apps/ciphers.html */
103 #endif
104
105
106 #define CALENDAR_ROOM_NAME      "Calendar"
107 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
108
109 #define SIZ                     4096            /* generic buffer size */
110
111 #define TRACE fprintf(stderr, "Checkpoint: %s, %d\n", __FILE__, __LINE__)
112
113 #define SLEEPING                180             /* TCP connection timeout */
114 #define WEBCIT_TIMEOUT          900             /* WebCit session timeout */
115 #define PORT_NUM                2000            /* port number to listen on */
116 #define DEVELOPER_ID            0
117 #define CLIENT_ID               4
118 #define CLIENT_VERSION          766             /* This version of WebCit */
119 #define MINIMUM_CIT_VERSION     766             /* min required Citadel ver */
120 #define LIBCITADEL_MIN          766             /* min required libcitadel ver */
121 #define DEFAULT_HOST            "localhost"     /* Default Citadel server */
122 #define DEFAULT_PORT            "504"
123 #define TARGET                  "webcit01"      /* Target for inline URL's */
124 #define HOUSEKEEPING            15              /* Housekeeping frequency */
125 #define MIN_WORKER_THREADS      5
126 #define MAX_WORKER_THREADS      250
127 #define LISTEN_QUEUE_LENGTH     100             /* listen() backlog queue */
128
129 #define USERCONFIGROOM          "My Citadel Config"
130 #define DEFAULT_MAXMSGS         20
131
132
133 #ifdef LIBCITADEL_VERSION_NUMBER
134 #if LIBCITADEL_VERSION_NUMBER < LIBCITADEL_MIN
135 #error libcitadel is too old.  Please upgrade it before continuing.
136 #endif
137 #endif
138
139
140 /*
141  * Room flags (from Citadel)
142  *
143  * bucket one...
144  */
145 #define QR_PERMANENT    1               /* Room does not purge          */
146 #define QR_INUSE        2               /* Set if in use, clear if avail        */
147 #define QR_PRIVATE      4               /* Set for any type of private room     */
148 #define QR_PASSWORDED   8               /* Set if there's a password too        */
149 #define QR_GUESSNAME    16              /* Set if it's a guessname room */
150 #define QR_DIRECTORY    32              /* Directory room                       */
151 #define QR_UPLOAD       64              /* Allowed to upload                    */
152 #define QR_DOWNLOAD     128             /* Allowed to download          */
153 #define QR_VISDIR       256             /* Visible directory                    */
154 #define QR_ANONONLY     512             /* Anonymous-Only room          */
155 #define QR_ANONOPT      1024            /* Anonymous-Option room                */
156 #define QR_NETWORK      2048            /* Shared network room          */
157 #define QR_PREFONLY     4096            /* Preferred status needed to enter     */
158 #define QR_READONLY     8192            /* Aide status required to post */
159 #define QR_MAILBOX      16384           /* Set if this is a private mailbox     */
160
161 /*
162  * bucket two...
163  */
164 #define QR2_SYSTEM      1               /* System room; hide by default */
165 #define QR2_SELFLIST    2               /* Self-service mailing list mgmt       */
166 #define QR2_COLLABDEL   4               /* Anyone who can post can also delete*/
167 #define QR2_SUBJECTREQ  8               /* Subject strongly recommended */
168 #define QR2_SMTP_PUBLIC 16              /* smtp public postable room */
169 #define QR2_MODERATED   32              /* Listservice aide has to permit posts  */
170
171 /*
172  * user/room access
173  */
174 #define UA_KNOWN        2
175 #define UA_GOTOALLOWED  4
176 #define UA_HASNEWMSGS   8
177 #define UA_ZAPPED       16
178 #define UA_POSTALLOWED          32
179 #define UA_ADMINALLOWED         64
180 #define UA_DELETEALLOWED        128
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 #define MAJORCODE(a) (((int)(a / 100) ) * 100)
205
206 #define LISTING_FOLLOWS 100
207 #define CIT_OK          200     
208 #define MORE_DATA       300
209 #define SEND_LISTING    400
210 #define ERROR           500
211 #define BINARY_FOLLOWS  600
212 #define SEND_BINARY     700
213 #define START_CHAT_MODE 800
214 #define ASYNC_MSG       900
215
216 #define MINORCODE(a) (a % 100)
217 #define ASYNC_GEXP                      02      
218 #define INTERNAL_ERROR                  10      
219 #define TOO_BIG                         11      
220 #define ILLEGAL_VALUE                   12      
221 #define NOT_LOGGED_IN                   20      
222 #define CMD_NOT_SUPPORTED               30      
223 #define SERVER_SHUTTING_DOWN            31      
224 #define PASSWORD_REQUIRED               40      
225 #define ALREADY_LOGGED_IN               41      
226 #define USERNAME_REQUIRED               42      
227 #define HIGHER_ACCESS_REQUIRED          50      
228 #define MAX_SESSIONS_EXCEEDED           51      
229 #define RESOURCE_BUSY                   52      
230 #define RESOURCE_NOT_OPEN               53      
231 #define NOT_HERE                        60      
232 #define INVALID_FLOOR_OPERATION         61      
233 #define NO_SUCH_USER                    70      
234 #define FILE_NOT_FOUND                  71      
235 #define ROOM_NOT_FOUND                  72      
236 #define NO_SUCH_SYSTEM                  73      
237 #define ALREADY_EXISTS                  74      
238 #define MESSAGE_NOT_FOUND               75
239 /*
240  * NLI is the string that shows up in a who's online listing for sessions
241  * that are active, but for which no user has yet authenticated.
242  */
243 #define NLI     "(not logged in)"
244
245
246 /*
247  * Linked list of session variables encoded in an x-www-urlencoded content type
248  */
249 typedef struct urlcontent urlcontent;
250 struct urlcontent {
251         char url_key[32];               /* key */
252         StrBuf *url_data;               /* value */
253 };
254
255 /*
256  * Information about the Citadel server to which we are connected
257  */ 
258 typedef struct _serv_info {
259         int serv_pid;                   /* Process ID of the Citadel server */
260         StrBuf *serv_nodename;          /* Node name of the Citadel server */
261         StrBuf *serv_humannode;         /* human readable node name of the Citadel server */
262         StrBuf *serv_fqdn;              /* fully quallified Domain Name (such as uncensored.citadel.org) */
263         StrBuf *serv_software;          /* What version does our connected citadel server use */
264         int serv_rev_level;             /* Whats the citadel server revision */
265         StrBuf *serv_bbs_city;          /* Geographic location of the Citadel server */
266         StrBuf *serv_sysadm;            /* Name of system administrator */
267         StrBuf *serv_moreprompt;        /* Whats the commandline textprompt */
268         int serv_supports_ldap;         /* is the server linked against an ldap tree for adresses? */
269         int serv_newuser_disabled;      /* Has the server disabled self-service new user creation? */
270         StrBuf *serv_default_cal_zone;  /* Default timezone for unspecified calendar items */
271         int serv_supports_sieve;        /* Does the server support Sieve mail filtering? */
272         int serv_fulltext_enabled;      /* Does the server have the full text index enabled? */
273         StrBuf *serv_svn_revision;      /* SVN revision of the server */
274         int serv_supports_openid;       /* Does the server support authentication via OpenID? */
275 } ServInfo;
276
277
278 typedef struct _disp_cal {                                      
279         icalcomponent *cal;             /* cal items for display */
280         long cal_msgnum;                /* cal msgids for display */
281         char *from;                     /* owner of this component */
282         int unread;                     /* already seen by the user? */
283
284         time_t event_start;
285         time_t event_end;
286
287         int multi_day_event;
288         int is_repeat;
289         icalcomponent *SortBy;          /* cal items for display */
290         icalproperty_status Status;
291 } disp_cal;                                             
292
293 typedef struct _IcalEnumMap {
294         const char *Name;
295         long NameLen;
296         icalproperty_kind map;
297 } IcalEnumMap;
298
299 /*
300  * Address book entry (keep it short and sweet, it's just a quickie lookup
301  * which we can use to get to the real meat and bones later)
302  */
303 typedef struct _addrbookent {
304         char ab_name[64];       /* name string */
305         long ab_msgnum;         /* message number of address book entry */
306 } addrbookent;
307
308
309 #define AJAX (1<<0)
310 #define ANONYMOUS (1<<1)
311 #define NEED_URL (1<<2)
312 #define XHTTP_COMMANDS (1<<3)
313 #define BOGUS (1<<4)
314 #define URLNAMESPACE (1<<4)
315 #define LOGCHATTY (1<<5)
316 #define COOKIEUNNEEDED (1<<6)
317 #define ISSTATIC (1<<7)
318 #define FORCE_SESSIONCLOSE (1<<8)
319 #define PARSE_REST_URL (1<<0)
320
321 typedef void (*WebcitHandlerFunc)(void);
322 typedef struct  _WebcitHandler{
323         WebcitHandlerFunc F;
324         long Flags;
325         StrBuf *Name;
326 } WebcitHandler;
327 void WebcitAddUrlHandler(const char * UrlString, long UrlSLen, WebcitHandlerFunc F, long Flags);
328
329 typedef struct _headereval {
330         ExamineMsgHeaderFunc evaluator;
331         int Type;
332 } headereval;
333
334
335 struct attach_link {
336         char partnum[32];
337         char html[1024];
338 };
339
340
341 enum {
342         eUp,
343         eDown,
344         eNone
345 };
346
347 enum {
348         eGET,
349         ePOST,
350         eOPTIONS,
351         ePROPFIND,
352         ePUT,
353         eDELETE,
354         eHEAD,
355         eMOVE,
356         eCOPY,
357         eNONE
358 };
359 const char *ReqStrs[eNONE];
360
361 #define NO_AUTH 0
362 #define AUTH_COOKIE 1
363 #define AUTH_BASIC 2
364
365
366
367 typedef struct _HdrRefs {
368         long eReqType;                          /* HTTP method */
369         int desired_session;
370         int SessionKey;
371
372         int got_auth;
373         int DontNeedAuth;
374         long ContentLength;
375         time_t if_modified_since;
376         int gzip_ok;                            /* Nonzero if Accept-encoding: gzip */
377         int prohibit_caching;
378         int dav_depth;
379
380         /* these are references into Hdr->HTTPHeaders, so we don't need to free them. */
381         StrBuf *ContentType;
382         StrBuf *RawCookie;
383         StrBuf *ReqLine;
384         StrBuf *http_host;                      /* HTTP Host: header */
385         StrBuf *browser_host;
386         StrBuf *user_agent;
387         StrBuf *plainauth;
388         StrBuf *dav_ifmatch;
389
390         const WebcitHandler *Handler;
391 } HdrRefs;
392
393 typedef struct _ParsedHttpHdrs {
394         int http_sock;                          /* HTTP server socket */
395         const char *Pos;
396         StrBuf *ReadBuf;
397
398         StrBuf *c_username;
399         StrBuf *c_password;
400         StrBuf *c_roomname;
401         StrBuf *c_language;
402         StrBuf *this_page;                      /* URL of current page */
403         StrBuf *PlainArgs; 
404
405         HashList *urlstrings;                   /* variables passed to webcit in a URL */
406         HashList *HTTPHeaders;                  /* the headers the client sent us */
407         int nWildfireHeaders;                   /* how many wildfire headers did we already send? */
408
409         HdrRefs HR;
410 } ParsedHttpHdrs;
411
412
413 /*
414  * One of these is kept for each active Citadel session.
415  * HTTP transactions are bound to one at a time.
416  */
417 typedef struct wcsession wcsession;
418 struct wcsession {
419 /* infrastructural members */
420         wcsession *next;                        /* Linked list */
421         pthread_mutex_t SessionMutex;           /* mutex for exclusive access */
422         int wc_session;                         /* WebCit session ID */
423         int killthis;                           /* Nonzero == purge this session */
424         int is_mobile;                          /* Client is a handheld browser */
425         int ctdl_pid;                           /* Session ID on the Citadel server */
426         int nonce;                              /* session nonce (to prevent session riding) */
427         int SessionKey;
428
429 /* Session local Members */
430         int serv_sock;                          /* Client socket to Citadel server */
431         StrBuf *ReadBuf;                        /* here we keep our stuff while reading linebuffered from the server. */
432         StrBuf *MigrateReadLineBuf;             /* here we buffer legacy server read stuff */
433         const char *ReadPos;                    /* whats our read position in ReadBuf? */
434         int chat_sock;                          /* Client socket to Citadel server - for chat */
435         time_t lastreq;                         /* Timestamp of most recent HTTP */
436         time_t last_pager_check;                /* last time we polled for instant msgs */
437         ServInfo *serv_info;                    /* Information about the citserver we're connected to */
438         int is_ajax;                            /* are we doing an ajax request? */
439
440 /* Request local Members */
441         StrBuf *CLineBuf;                       /* linebuffering client stuff */
442         ParsedHttpHdrs *Hdr;
443         StrBuf *WBuf;                           /* Our output buffer */
444         StrBuf *HBuf;                           /* Our HeaderBuffer */
445
446         HashList *vars;                         /* HTTP variable substitutions for this page */
447         StrBuf *trailing_javascript;            /* extra javascript to be appended to page */
448         char ImportantMessage[SIZ];
449         StrBuf *ImportantMsg;
450         HashList *Directory;                    /* Parts of the directory URL in snippets */
451         const floor *CurrentFloor;              /**< when Parsing REST, which floor are we on? */
452
453 /* accounting */
454         StrBuf *wc_username;                    /* login name of current user */
455         StrBuf *wc_fullname;                    /* Screen name of current user */
456         StrBuf *wc_password;                    /* Password of current user */
457         StrBuf *httpauth_pass;                  /* only for GroupDAV sessions */
458         int axlevel;                            /* this user's access level */
459         int is_aide;                            /* nonzero == this user is an Aide */
460         int is_room_aide;                       /* nonzero == this user is a Room Aide in this room */
461         int connected;                          /* nonzero == we are connected to Citadel */
462         int logged_in;                          /* nonzero == we are logged in  */
463         int need_regi;                          /* This user needs to register. */
464         int need_vali;                          /* New users require validation. */
465
466 /* Preferences */
467         StrBuf *cs_inet_email;                  /* User's preferred Internet addr. */
468         char reply_to[512];                     /* reply-to address */
469         HashList *hash_prefs;                   /* WebCit preferences for this user */
470         StrBuf *DefaultCharset;                 /* Charset the user preferes */
471         int downloaded_prefs;                   /* Has the client download its prefs yet? */
472         int SavePrefsToServer;                  /* Should we save our preferences to the server at the end of the request? */
473         int selected_language;                  /* Language selected by user */
474         int time_format_cache;                  /* which timeformat does our user like? */
475
476 /* current room related */
477         StrBuf *wc_roomname;                    /* Room we are currently in */
478         unsigned room_flags;                    /* flags associated with the current room */
479         unsigned room_flags2;                   /* flags associated with the current room */
480         int wc_view;                            /* view for the current room */
481         int wc_default_view;                    /* default view for the current room */
482         int wc_is_trash;                        /* nonzero == current room is a Trash folder */
483         int wc_floor;                           /* floor number of current room */
484         int is_mailbox;                         /* the current room is a private mailbox */
485
486 /* next/previous room thingabob */
487         struct march *march;                    /* march mode room list */
488         char ugname[128];                       /* where does 'ungoto' take us */
489         long uglsn;                             /* last seen message number for ungoto */
490
491 /* Uploading; mime attachments for composing messages */
492         HashList *attachments;                  /* list of attachments for 'enter message' */
493         int upload_length;                      /* content length of http-uploaded data */
494         StrBuf *upload;                         /* pointer to http-uploaded data */
495         char upload_filename[PATH_MAX];         /* filename of http-uploaded data */
496         char upload_content_type[256];          /* content type of http-uploaded data */
497
498         int new_mail;                           /* user has new mail waiting */
499         int remember_new_mail;                  /* last count of new mail messages */
500
501 /* Roomiew control */
502         HashList *Floors;                       /* floors our citserver has... */
503         HashList *summ;                         /* list of messages for mailbox summary view */
504   /** Perhaps these should be within a struct instead */
505         long startmsg;                          /* message number to start at */
506         long maxmsgs;                           /* maximum messages to display */
507         long num_displayed;                     /* number of messages actually displayed */
508         HashList *disp_cal_items;               /* sorted list of calendar items; startdate is the sort criteria. */
509
510
511         char last_chat_user[256];
512
513 /* Iconbar controls */
514         struct __ofolder *cache_fold;           /* cache the iconbar room list */
515         int cache_max_folders;
516         int cache_num_floors;
517         time_t cache_timestamp;
518         HashList *IconBarSettings;              /* which icons should be shown / not shown? */
519         const StrBuf *floordiv_expanded;        /* which floordiv currently expanded */
520
521
522
523 /* cache stuff for templates. TODO: find a smartrer way */
524         HashList *ServCfg;                      /* cache our server config for editing */
525         HashList *InetCfg;                      /* Our inet server config for editing */
526
527 };
528
529
530 typedef void (*Header_Evaluator)(StrBuf *Line, ParsedHttpHdrs *hdr);
531
532 typedef struct _HttpHeader {
533         Header_Evaluator H;
534         StrBuf *Val;
535         int HaveEvaluator;
536 } OneHttpHeader;
537
538 void RegisterHeaderHandler(const char *Name, long Len, Header_Evaluator F);
539
540
541 enum {
542         S_SELECT,
543         S_SHUTDOWN,
544         MAX_SEMAPHORES
545 };
546
547
548 #ifndef num_parms
549 #define num_parms(source)               num_tokens(source, '|') 
550 #endif
551
552 /* Per-session data */
553 #define WC ((struct wcsession *)pthread_getspecific(MyConKey))
554 extern pthread_key_t MyConKey;
555
556 /* Per-thread SSL context */
557 #ifdef HAVE_OPENSSL
558 #define THREADSSL ((SSL *)pthread_getspecific(ThreadSSL))
559 extern pthread_key_t ThreadSSL;
560 extern char ctdl_key_dir[PATH_MAX];
561 extern char file_crpt_file_key[PATH_MAX];
562 extern char file_crpt_file_csr[PATH_MAX];
563 extern char file_crpt_file_cer[PATH_MAX];
564 #endif
565
566 extern char floorlist[128][SIZ];
567 extern char *axdefs[];
568 extern char *ctdlhost, *ctdlport;
569 extern int http_port;
570 extern char *server_cookie;
571 extern int is_https;
572 extern int setup_wizard;
573 extern char wizard_filename[];
574 extern int follow_xff;
575 extern int num_threads;
576
577 void InitialiseSemaphores(void);
578 void begin_critical_section(int which_one);
579 void end_critical_section(int which_one);
580
581 void stuff_to_cookie(char *cookie, size_t clen,
582                 int session,
583                 StrBuf *user,
584                 StrBuf *pass,
585                 StrBuf *room,
586                 const char *language
587 );
588 void cookie_to_stuff(StrBuf *cookie,
589                 int *session,
590                 StrBuf *user,
591                 StrBuf *pass,
592                 StrBuf *room,
593                 StrBuf *language
594 );
595 void locate_host(StrBuf *TBuf, int);
596 void become_logged_in(const StrBuf *user, const StrBuf *pass, StrBuf *serv_response);
597 void openid_manual_create(void);
598 void display_login();
599 void display_openids(void);
600 void do_welcome(void);
601 void do_logout(void);
602 void display_main_menu(void);
603 void display_aide_menu(void);
604 void display_advanced_menu(void);
605 void slrp_highest(void);
606 ServInfo *get_serv_info(StrBuf *, StrBuf *);
607 void RegisterEmbeddableMimeType(const char *MimeType, long MTLen, int Priority);
608 void CreateMimeStr(void);
609 int GetConnected(void);
610 void DeleteServInfo(ServInfo **FreeMe);
611 int uds_connectsock(char *);
612 int tcp_connectsock(char *, char *);
613 int serv_getln(char *strbuf, int bufsize);
614 int StrBuf_ServGetln(StrBuf *buf);
615 int GetServerStatus(StrBuf *Line, long* FullState);
616 void serv_puts(const char *string);
617 void who(void);
618 void who_inner_div(void);
619 void ajax_mini_calendar(void);
620 void fmout(char *align);
621 void _fmout(StrBuf *Targt, char *align);
622 void FmOut(StrBuf *Target, char *align, StrBuf *Source);
623 void pullquote_fmout(void);
624 void wDumpContent(int);
625
626
627
628 void UrlescPutStrBuf(const StrBuf *strbuf);
629 void StrEscPuts(const StrBuf *strbuf);
630 void StrEscputs1(const StrBuf *strbuf, int nbsp, int nolinebreaks);
631
632 void urlescputs(const char *);
633 void hurlescputs(const char *);
634 void jsesc(char *, size_t, char *);
635 void jsescputs(char *);
636 void output_headers(    int do_httpheaders,
637                         int do_htmlhead,
638                         int do_room_banner,
639                         int unset_cookies,
640                         int suppress_check,
641                         int cache);
642 void output_custom_content_header(const char *ctype);
643 void wprintf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
644 void hprintf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
645 void output_static(const char* What);
646
647 long stresc(char *target, long tSize, char *strbuf, int nbsp, int nolinebreaks);
648 void escputs(const char *strbuf);
649 void url(char *buf, size_t bufsize);
650 void UrlizeText(StrBuf* Target, StrBuf *Source, StrBuf *WrkBuf);
651 void escputs1(const char *strbuf, int nbsp, int nolinebreaks);
652 void msgesc(char *target, size_t tlen, char *strbuf);
653 void msgescputs(char *strbuf);
654 void msgescputs1(char *strbuf);
655 void dump_vars(void);
656 void embed_main_menu(void);
657
658 void do_addrbook_view(addrbookent *addrbook, int num_ab);
659 void fetch_ab_name(message_summary *Msg, char **namebuf);
660 void display_vcard(StrBuf *Target, StrBuf *vcard_source, char alpha, int full, char **storename, long msgnum);
661 void jsonMessageList(void);
662 void new_summary_view(void);
663 void getseen(void);
664 void text_to_server(char *ptr);
665 void text_to_server_qp(char *ptr);
666 void confirm_delete_msg(void);
667 void display_success(char *);
668 void CheckAuthBasic(ParsedHttpHdrs *hdr);
669 void GetAuthBasic(ParsedHttpHdrs *hdr);
670 void server_to_text(void);
671 void save_edit(char *description, char *enter_cmd, int regoto);
672 void display_edit(char *description, char *check_cmd,
673                   char *read_cmd, char *save_cmd, int with_room_banner);
674 long gotoroom(const StrBuf *gname);
675 void remove_march(const StrBuf *aaa);
676 void dotskip(void);
677 void confirm_delete_room(void);
678 void validate(void);
679 void display_graphics_upload(char *, char *, char *);
680 void do_graphics_upload(char *upl_cmd);
681 void serv_gets(char *strbuf);
682 void serv_write(const char *buf, int nbytes);
683 void serv_putbuf(const StrBuf *string);
684 void serv_printf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
685 void load_floorlist(StrBuf *Buf);
686 void shutdown_sessions(void);
687 void do_housekeeping(void);
688 void smart_goto(const StrBuf *);
689 void worker_entry(void);
690 void session_loop(void);
691 size_t wc_strftime(char *s, size_t max, const char *format, const struct tm *tm);
692 void fmt_time(char *buf, size_t siz, time_t thetime);
693 void httpdate(char *buf, time_t thetime);
694 time_t httpdate_to_timestamp(StrBuf *buf);
695 void end_webcit_session(void);
696 void page_popup(void);
697 void http_redirect(const char *);
698 void clear_substs(struct wcsession *wc);
699 void clear_local_substs(void);
700
701
702
703 int lingering_close(int fd);
704 char *memreadline(char *start, char *buf, int maxlen);
705 char *memreadlinelen(char *start, char *buf, int maxlen, int *retlen);
706 long extract_token(char *dest, const char *source, int parmnum, char separator, int maxlen);
707 void remove_token(char *source, int parmnum, char separator);
708 StrBuf *load_mimepart(long msgnum, char *partnum);
709 void MimeLoadData(wc_mime_attachment *Mime);
710 int pattern2(char *search, char *patn);
711 void do_edit_vcard(long msgnum, char *partnum, 
712                    message_summary *VCMsg,
713                    wc_mime_attachment *VCAtt,
714                    const char *return_to, 
715                    const char *force_room);
716
717 void select_user_to_edit(const char *preselect);
718 void delete_user(char *);
719 void do_change_view(int);
720 void folders(void);
721
722
723
724 void display_addressbook(long msgnum, char alpha);
725 void offer_start_page(StrBuf *Target, WCTemplputParams *TP);
726 void convenience_page(const char *titlebarcolor, const char *titlebarmsg, const char *messagetext);
727 void output_html(const char *, int, int, StrBuf *, StrBuf *);
728 void do_listsub(void);
729 ssize_t write(int fd, const void *buf, size_t count);
730 void cal_process_attachment(wc_mime_attachment *Mime);
731 void display_calendar(message_summary *Msg, int unread);
732 void display_note(message_summary *Msg, int unread);
733 void updatenote(void);
734 void do_tasks_view(void);
735 int calendar_summary_view(void);
736 void free_march_list(wcsession *wcf);
737 void display_rules_editor_inner_div(void);
738 void generate_uuid(char *);
739 void CtdlMakeTempFileName(char *, int);
740 void address_book_popup(void);
741 void begin_ajax_response(void);
742 void end_ajax_response(void);
743 void initialize_viewdefs(void);
744 void initialize_axdefs(void);
745 void burn_folder_cache(time_t age);
746 void list_all_rooms_by_floor(const char *viewpref);
747 void display_pictureview(void);
748
749 void display_edit_task(void);
750 void display_edit_event(void);
751 icaltimezone *get_default_icaltimezone(void);
752 void display_icaltimetype_as_webform(struct icaltimetype *, char *, int);
753 void icaltime_from_webform(struct icaltimetype *result, char *prefix);
754 void icaltime_from_webform_dateonly(struct icaltimetype *result, char *prefix);
755 void partstat_as_string(char *buf, icalproperty *attendee);
756 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp);
757 void check_attendee_availability(icalcomponent *supplied_vevent);
758 int ical_ctdl_is_overlap(
759                         struct icaltimetype t1start,
760                         struct icaltimetype t1end,
761                         struct icaltimetype t2start,
762                         struct icaltimetype t2end
763 );
764
765
766 extern char *months[];
767 extern char *days[];
768 int read_server_binary(StrBuf *Ret, size_t total_len, StrBuf *Buf);
769 int StrBuf_ServGetBLOB(StrBuf *buf, long BlobSize);
770 int StrBuf_ServGetBLOBBuffered(StrBuf *buf, long BlobSize);
771 int read_server_text(StrBuf *Buf, long *nLines);
772 int goto_config_room(StrBuf *Buf);
773 long locate_user_vcard_in_this_room(message_summary **VCMsg,
774                                     wc_mime_attachment **VCAtt);
775 void sleeeeeeeeeep(int);
776 void http_transmit_thing(const char *content_type, int is_static);
777 long unescape_input(char *buf);
778 void do_selected_iconbar(void);
779 void spawn_another_worker_thread(void);
780 void StrEndTab(StrBuf *Target, int tabnum, int num_tabs);
781 void StrBeginTab(StrBuf *Target, int tabnum, int num_tabs);
782 void StrTabbedDialog(StrBuf *Target, int num_tabs, StrBuf *tabnames[]);
783 void tabbed_dialog(int num_tabs, char *tabnames[]);
784 void begin_tab(int tabnum, int num_tabs);
785 void end_tab(int tabnum, int num_tabs);
786 void str_wiki_index(char *s);
787 long guess_calhourformat(void);
788 int get_time_format_cached (void);
789 int xtoi(const char *in, size_t len);
790 const char *get_selected_language(void);
791
792 #define DATEFMT_FULL 0
793 #define DATEFMT_BRIEF 1
794 #define DATEFMT_RAWDATE 2
795 #define DATEFMT_LOCALEDATE 3
796 void webcit_fmt_date(char *buf, size_t siz, time_t thetime, int Format);
797 int fetch_http(char *url, char *target_buf, int maxbytes);
798 void free_attachments(wcsession *sess);
799 void summary(void);
800
801 int is_mobile_ua(char *user_agent);
802
803 void embed_room_banner(char *, int);
804 HashList *GetFloorListHash(StrBuf *Target, WCTemplputParams *TP);
805 HashList *GetRoomListHash(StrBuf *Target, WCTemplputParams *TP);
806 int SortRoomsByListOrder(const void *room1, const void *room2);
807 /* navbar types that can be passed to embed_room_banner */
808 enum {
809         navbar_none,
810         navbar_default
811 };
812
813 /* actual supported locales */
814 void TmplGettext(StrBuf *Target, WCTemplputParams *TP);
815 void offer_languages(StrBuf *Target, int nArgs, WCTemplateToken *Token, void *Context, int ContextType);
816 void set_selected_language(const char *);
817 void go_selected_language(void);
818 void stop_selected_language(void);
819
820 #ifdef HAVE_OPENSSL
821 void init_ssl(void);
822 void endtls(void);
823 void ssl_lock(int mode, int n, const char *file, int line);
824 int starttls(int sock);
825 extern SSL_CTX *ssl_ctx;  
826 int client_read_sslbuffer(StrBuf *buf, int timeout);
827 void client_write_ssl(const StrBuf *Buf);
828 #endif
829
830 void utf8ify_rfc822_string(char **buf);
831
832 void begin_burst(void);
833 long end_burst(void);
834
835 extern char *hourname[];        /* Names of hours (12am, 1am, etc.) */
836
837 void http_datestring(char *buf, size_t n, time_t xtime);
838
839
840 /* These should be empty, but we have them for testing */
841 #define DEFAULT_HTTPAUTH_USER   ""
842 #define DEFAULT_HTTPAUTH_PASS   ""
843
844
845 /* Exit codes 101 through 109 are initialization failures so we don't want to
846  * just keep respawning indefinitely.
847  */
848 #define WC_EXIT_BIND            101     /* Can't bind to the port */
849 #define WC_EXIT_SSL             102     /* Can't initialize SSL */
850
851
852 #define WC_TIMEFORMAT_NONE 0
853 #define WC_TIMEFORMAT_AMPM 1
854 #define WC_TIMEFORMAT_24 2
855