342571fcbce08e25e07ee3cf07690b8ec1955085
[citadel.git] / webcit / webcit.h
1 /*
2  * Copyright (c) 1987-2012 by the citadel.org team
3  *
4  * This program is open source software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License version 3.
6  *
7  * This program is distributed in the hope that it will be useful,
8  * but WITHOUT ANY WARRANTY; without even the implied warranty of
9  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
10  * GNU General Public License for more details.
11  */
12
13 #include "sysdep.h"
14 #include <sys/select.h>
15 #include <ctype.h>
16 #include <stdlib.h>
17 #ifdef HAVE_UNISTD_H
18 #include <unistd.h>
19 #endif
20 #include <stdio.h>
21 #ifdef HAVE_FCNTL_H
22 #include <fcntl.h>
23 #endif
24 #include <signal.h>
25 #include <sys/types.h>
26 #include <sys/wait.h>
27 #include <sys/socket.h>
28 #ifdef HAVE_SYS_TIME_H
29 #include <sys/time.h>
30 #endif
31 #include <sys/stat.h>
32 #ifdef HAVE_LIMITS_H
33 #include <limits.h>
34 #endif
35 #include <sys/socket.h>
36 #include <netinet/in.h>
37 #include <arpa/inet.h>
38 #include <netdb.h>
39 #include <sys/un.h>
40 #include <sys/poll.h>
41 #include <string.h>
42 #include <pwd.h>
43 #include <errno.h>
44 #include <stdarg.h>
45 #include <pthread.h>
46 #include <signal.h>
47 #include <syslog.h>
48 #include <sys/utsname.h>
49 #include <expat.h>
50 #include <libcitadel.h>
51
52 #ifdef HAVE_ICONV
53 #include <iconv.h>
54 #endif
55
56 #ifdef ENABLE_NLS
57 #ifdef HAVE_XLOCALE_H
58 #include <xlocale.h>
59 #endif
60 #include <libintl.h>
61 #include <locale.h>
62 #define _(string)       gettext(string)
63 #else
64 #define _(string)       (string)
65 #endif
66
67 #define IsEmptyStr(a) ((a)[0] == '\0')
68
69 #define DO_DBG_QR 0
70 #define DBG_QR(x) if(DO_DBG_QR) _DBG_QR(x)
71 #define DBG_QR2(x) if(DO_DBG_QR) _DBG_QR2(x)
72
73 #include <zlib.h>
74
75 #include <libical/ical.h>
76
77 #undef PACKAGE
78 #undef VERSION
79 #undef PACKAGE_NAME
80 #undef PACKAGE_STRING
81 #undef PACKAGE_TARNAME
82 #undef PACKAGE_VERSION
83 #undef PACKAGE_BUGREPORT
84
85 typedef struct wcsession wcsession;
86
87 #include "sysdep.h"
88
89 #include "subst.h"
90 #include "messages.h"
91 #include "paramhandling.h"
92 #include "roomops.h"
93 #include "preferences.h"
94
95 #include "tcp_sockets.h"
96 #include "utils.h"
97 #ifdef HAVE_OPENSSL
98 /* Work around RedHat's b0rken OpenSSL includes */
99 #define OPENSSL_NO_KRB5
100 #include <openssl/ssl.h>
101 #include <openssl/err.h>
102 #include <openssl/rand.h>
103 extern char *ssl_cipher_list;
104 #define DEFAULT_SSL_CIPHER_LIST "DEFAULT"       /* See http://openssl.org/docs/apps/ciphers.html */
105 #endif
106
107 #if SIZEOF_SIZE_T == SIZEOF_INT 
108 #define SIZE_T_FMT "%d"
109 #else
110 #define SIZE_T_FMT "%ld"
111 #endif
112
113 #if SIZEOF_LONG_UNSIGNED_INT == SIZEOF_INT
114 #define ULONG_FMT "%d"
115 #else
116 #define ULONG_FMT "%ld"
117 #endif
118
119 #define CALENDAR_ROOM_NAME      "Calendar"
120 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
121
122 #define SIZ                     4096            /* generic buffer size */
123
124 #define TRACE syslog(LOG_DEBUG, "\033[3%dmCHECKPOINT: %s:%d\033[0m", ((__LINE__%6)+1), __FILE__, __LINE__)
125
126 #ifdef UNDEF_MEMCPY
127 #undef memcpy
128 #endif
129
130 #define SLEEPING                180             /* TCP connection timeout */
131 #define WEBCIT_TIMEOUT          900             /* WebCit session timeout */
132 #define PORT_NUM                2000            /* port number to listen on */
133 #define DEVELOPER_ID            0
134 #define CLIENT_ID               4
135 #define CLIENT_VERSION          813             /* This version of WebCit */
136 #define MINIMUM_CIT_VERSION     813             /* Minimum required version of Citadel server */
137 #define LIBCITADEL_MIN          813             /* Minimum required version of libcitadel */
138 #define DEFAULT_HOST            "localhost"     /* Default Citadel server */
139 #define DEFAULT_PORT            "504"
140 #define TARGET                  "webcit01"      /* Window target for inline URL's */
141 #define HOUSEKEEPING            15              /* Housekeeping frequency */
142 #define MAX_WORKER_THREADS      250
143 #define LISTEN_QUEUE_LENGTH     100             /* listen() backlog queue */
144
145 #define USERCONFIGROOM          "My Citadel Config"
146 #define DEFAULT_MAXMSGS         20
147
148
149 #ifdef LIBCITADEL_VERSION_NUMBER
150 #if LIBCITADEL_VERSION_NUMBER < LIBCITADEL_MIN
151 #error libcitadel is too old.  Please upgrade it before continuing.
152 #endif
153 #endif
154
155
156
157
158 #define SRV_STATUS_MSG(ServerLineBuf) (ChrPtr(ServerLineBuf) + 4), (StrLength(ServerLineBuf) - 4)
159 #define MAJORCODE(a) (((int)(a / 100) ) * 100)
160
161 #define LISTING_FOLLOWS 100
162 #define CIT_OK          200     
163 #define MORE_DATA       300
164 #define SEND_LISTING    400
165 #define ERROR           500
166 #define BINARY_FOLLOWS  600
167 #define SEND_BINARY     700
168 #define START_CHAT_MODE 800
169 #define ASYNC_MSG       900
170
171 #define MINORCODE(a) (a % 100)
172 #define ASYNC_GEXP                      02      
173 #define INTERNAL_ERROR                  10      
174 #define TOO_BIG                         11      
175 #define ILLEGAL_VALUE                   12      
176 #define NOT_LOGGED_IN                   20      
177 #define CMD_NOT_SUPPORTED               30      
178 #define SERVER_SHUTTING_DOWN            31      
179 #define PASSWORD_REQUIRED               40      
180 #define ALREADY_LOGGED_IN               41      
181 #define USERNAME_REQUIRED               42      
182 #define HIGHER_ACCESS_REQUIRED          50      
183 #define MAX_SESSIONS_EXCEEDED           51      
184 #define RESOURCE_BUSY                   52      
185 #define RESOURCE_NOT_OPEN               53      
186 #define NOT_HERE                        60      
187 #define INVALID_FLOOR_OPERATION         61      
188 #define NO_SUCH_USER                    70      
189 #define FILE_NOT_FOUND                  71      
190 #define ROOM_NOT_FOUND                  72      
191 #define NO_SUCH_SYSTEM                  73      
192 #define ALREADY_EXISTS                  74      
193 #define MESSAGE_NOT_FOUND               75
194
195 /*
196  * NLI is the string that shows up in a who's online listing for sessions
197  * that are active but do not (yet) have a user logged in.
198  */
199 #define NLI     "(not logged in)"
200
201 /*
202  * Expiry policy for the autopurger
203  */
204 #define EXPIRE_NEXTLEVEL        0       /* Inherit expiration policy    */
205 #define EXPIRE_MANUAL           1       /* Don't expire messages at all */
206 #define EXPIRE_NUMMSGS          2       /* Keep only latest n messages  */
207 #define EXPIRE_AGE              3       /* Expire messages after n days */
208
209 typedef struct __ExpirePolicy {
210         int expire_mode;
211         int expire_value;
212 } ExpirePolicy;
213 void LoadExpirePolicy(GPEXWhichPolicy which);
214 void SaveExpirePolicyFromHTTP(GPEXWhichPolicy which);
215
216 /*
217  * Linked list of session variables encoded in an x-www-urlencoded content type
218  */
219 typedef struct urlcontent urlcontent;
220 struct urlcontent {
221         char url_key[32];               /* key */
222         StrBuf *url_data;               /* value */
223 };
224
225 /*
226  * Information about the Citadel server to which we are connected
227  */ 
228 typedef struct _serv_info {
229         int serv_pid;                   /* Process ID of the Citadel server */
230         StrBuf *serv_nodename;          /* Node name of the Citadel server */
231         StrBuf *serv_humannode;         /* Juman readable node name of the Citadel server */
232         StrBuf *serv_fqdn;              /* Fully qualified Domain Name (such as uncensored.citadel.org) */
233         StrBuf *serv_software;          /* Free form text description of the server software in use */
234         int serv_rev_level;             /* Server version number (times 100) */
235         StrBuf *serv_bbs_city;          /* Geographic location of the Citadel server */
236         StrBuf *serv_sysadm;            /* Name of system administrator */
237         int serv_supports_ldap;         /* is the server linked against an ldap tree for adresses? */
238         int serv_newuser_disabled;      /* Has the server disabled self-service new user creation? */
239         StrBuf *serv_default_cal_zone;  /* Default timezone for unspecified calendar items */
240         int serv_supports_sieve;        /* Server supports Sieve mail filtering */
241         int serv_fulltext_enabled;      /* Full text index is enabled */
242         StrBuf *serv_svn_revision;      /* svn or git revision of the server */
243         int serv_supports_openid;       /* Server supports authentication via OpenID */
244         int serv_supports_guest;        /* Server supports unauthenticated guest logins */
245 } ServInfo;
246
247
248 typedef struct _disp_cal {                                      
249         icalcomponent *cal;             /* cal items for display */
250         long cal_msgnum;                /* cal msgids for display */
251         char *from;                     /* owner of this component */
252         int unread;                     /* already seen by the user? */
253
254         time_t event_start;
255         time_t event_end;
256
257         int multi_day_event;
258         int is_repeat;
259         icalcomponent *SortBy;          /* cal items for display */
260         icalproperty_status Status;
261 } disp_cal;                                             
262
263 typedef struct _IcalEnumMap {
264         const char *Name;
265         long NameLen;
266         icalproperty_kind map;
267 } IcalEnumMap;
268
269 /*
270  * Address book entry (keep it short and sweet, it's just a quickie lookup
271  * which we can use to get to the real meat and bones later)
272  */
273 typedef struct _addrbookent {
274         char ab_name[64];       /* name string */
275         long ab_msgnum;         /* message number of address book entry */
276 } addrbookent;
277
278
279 #define AJAX (1<<0)
280 #define ANONYMOUS (1<<1)
281 #define NEED_URL (1<<2)
282 #define XHTTP_COMMANDS (1<<3)
283 #define BOGUS (1<<4)
284 #define URLNAMESPACE (1<<4)
285 #define LOGCHATTY (1<<5)
286 #define COOKIEUNNEEDED (1<<6)
287 #define ISSTATIC (1<<7)
288 #define FORCE_SESSIONCLOSE (1<<8)
289 #define PARSE_REST_URL (1<<9)
290 #define PROHIBIT_STARTPAGE (1<<10)
291
292
293 #define DATEFMT_FULL 0
294 #define DATEFMT_BRIEF 1
295 #define DATEFMT_RAWDATE 2
296 #define DATEFMT_LOCALEDATE 3
297 void webcit_fmt_date(char *buf, size_t siz, time_t thetime, int Format);
298
299
300 typedef enum _RESTDispatchID {
301         ExistsID,
302         PutID,
303         DeleteID
304 } RESTDispatchID;
305
306 typedef int (*WebcitRESTDispatchID)(RESTDispatchID WhichAction, int IgnoreFloor);
307 typedef void (*WebcitHandlerFunc)(void);
308 typedef struct  _WebcitHandler{
309         WebcitHandlerFunc F;
310         WebcitRESTDispatchID RID;
311         long Flags;
312         StrBuf *Name;
313         StrBuf *DisplayName;
314 } WebcitHandler;
315
316
317 void WebcitAddUrlHandler(const char * UrlString, long UrlSLen, const char *DisplayName, long dslen, WebcitHandlerFunc F, long Flags);
318
319 typedef struct _headereval {
320         ExamineMsgHeaderFunc evaluator;
321         int Type;
322 } headereval;
323
324
325 struct attach_link {
326         char partnum[32];
327         char html[1024];
328 };
329
330
331 enum {
332         eUp,
333         eDown,
334         eNone
335 };
336
337 enum {
338         eGET,
339         ePOST,
340         eOPTIONS,
341         ePROPFIND,
342         ePUT,
343         eDELETE,
344         eHEAD,
345         eMOVE,
346         eCOPY,
347         eREPORT,
348         eNONE
349 };
350 extern const char *ReqStrs[eNONE];
351
352 #define NO_AUTH 0
353 #define AUTH_COOKIE 1
354 #define AUTH_BASIC 2
355
356
357
358 typedef struct _HdrRefs {
359         long eReqType;                          /* HTTP method */
360         int desired_session;
361         int SessionKey;
362
363         int got_auth;
364         int DontNeedAuth;
365         long ContentLength;
366         time_t if_modified_since;
367         int gzip_ok;                            /* Nonzero if Accept-encoding: gzip */
368         int prohibit_caching;
369         int dav_depth;
370         int Static;
371
372         /* these are references into Hdr->HTTPHeaders, so we don't need to free them. */
373         StrBuf *ContentType;
374         StrBuf *RawCookie;
375         StrBuf *ReqLine;
376         StrBuf *browser_host;
377         StrBuf *browser_language;
378         StrBuf *user_agent;
379         StrBuf *plainauth;
380         StrBuf *dav_ifmatch;
381
382         const WebcitHandler *Handler;
383 } HdrRefs;
384
385 typedef struct _ParsedHttpHdrs {
386         int http_sock;                          /* HTTP server socket */
387         const char *Pos;
388         StrBuf *ReadBuf;
389
390         StrBuf *c_username;
391         StrBuf *c_password;
392         StrBuf *c_roomname;
393         StrBuf *c_language;
394         StrBuf *this_page;                      /* URL of current page */
395         StrBuf *PlainArgs; 
396         StrBuf *HostHeader;
397
398         HashList *urlstrings;                   /* variables passed to webcit in a URL */
399         HashList *HTTPHeaders;                  /* the headers the client sent us */
400         int nWildfireHeaders;                   /* how many wildfire headers did we already send? */
401
402         HdrRefs HR;
403 } ParsedHttpHdrs;
404
405
406 /*
407  * One of these is kept for each active Citadel session.
408  * HTTP transactions are bound to one at a time.
409  */
410 struct wcsession {
411 /* infrastructural members */
412         wcsession *next;                        /* Linked list */
413         pthread_mutex_t SessionMutex;           /* mutex for exclusive access */
414         int wc_session;                         /* WebCit session ID */
415         int killthis;                           /* Nonzero == purge this session */
416         int ctdl_pid;                           /* Session ID on the Citadel server */
417         int nonce;                              /* session nonce (to prevent session riding) */
418         int inuse;                              /* set to nonzero if bound to a running thread */
419
420 /* Session local Members */
421         int serv_sock;                          /* Client socket to Citadel server */
422         StrBuf *ReadBuf;                        /* linebuffered reads from the server */
423         StrBuf *MigrateReadLineBuf;             /* here we buffer legacy server read stuff */
424         const char *ReadPos;                    /* whats our read position in ReadBuf? */
425         int last_chat_seq;                      /* When in chat - last message seq# we saw */
426         time_t lastreq;                         /* Timestamp of most recent HTTP */
427         time_t last_pager_check;                /* last time we polled for instant msgs */
428         ServInfo *serv_info;                    /* Information about the citserver we're connected to */
429         StrBuf *PushedDestination;              /* Where to go after login, registration, etc. */
430
431 /* Request local Members */
432         StrBuf *CLineBuf;                       /* linebuffering client stuff */
433         ParsedHttpHdrs *Hdr;
434         StrBuf *WBuf;                           /* Our output buffer */
435         StrBuf *HBuf;                           /* Our HeaderBuffer */
436         StrBuf *WFBuf;                          /* Wildfire error logging buffer */
437         StrBuf *trailing_javascript;            /* extra javascript to be appended to page */
438         StrBuf *ImportantMsg;
439         HashList *Directory;                    /* Parts of the directory URL in snippets */
440         const Floor *CurrentFloor;              /* when Parsing REST, which floor are we on? */
441
442 /* accounting */
443         StrBuf *wc_username;                    /* login name of current user */
444         StrBuf *wc_fullname;                    /* Screen name of current user */
445         StrBuf *wc_password;                    /* Password of current user */
446         StrBuf *httpauth_pass;                  /* only for GroupDAV sessions */
447         int axlevel;                            /* this user's access level */
448         int is_aide;                            /* nonzero == this user is an Aide */
449         int connected;                          /* nonzero == we are connected to Citadel */
450         int logged_in;                          /* nonzero == we are logged in  */
451         int need_regi;                          /* This user needs to register. */
452         int need_vali;                          /* New users require validation. */
453
454 /* Preferences */
455         StrBuf *cs_inet_email;                  /* User's preferred Internet addr. */
456         HashList *hash_prefs;                   /* WebCit preferences for this user */
457         StrBuf *DefaultCharset;                 /* Charset the user preferes */
458         int downloaded_prefs;                   /* Has the client download its prefs yet? */
459         int SavePrefsToServer;                  /* Should we save our preferences to the server at the end of the request? */
460         int selected_language;                  /* Language selected by user */
461         int time_format_cache;                  /* which timeformat does our user like? */
462
463         folder CurRoom;                         /* information about our current room */
464         const folder *ThisRoom;                 /* if REST found a room, remember it here. */
465 /* next/previous room thingabob */
466         struct march *march;                    /* march mode room list */
467         char ugname[128];                       /* where does 'ungoto' take us */
468         long uglsn;                             /* last seen message number for ungoto */
469
470 /* Uploading; mime attachments for composing messages */
471         HashList *attachments;                  /* list of attachments for 'enter message' */
472         int upload_length;                      /* content length of http-uploaded data */
473         StrBuf *upload;                         /* pointer to http-uploaded data */
474         StrBuf *upload_filename;                /* filename of http-uploaded data */
475         char upload_content_type[256];          /* content type of http-uploaded data */
476
477         int remember_new_mail;                  /* last count of new mail messages */
478
479 /* Roomiew control */
480         HashList *Floors;                       /* floors our citserver has hashed numeric for quicker access*/
481         HashList *FloorsByName;                 /* same but hashed by its name */
482         HashList *Rooms;                        /* our directory structure as loaded by LKRA */
483         HashList *summ;                         /* list of messages for mailbox summary view */
484   /** Perhaps these should be within a struct instead */
485         long startmsg;                          /* message number to start at */
486         long maxmsgs;                           /* maximum messages to display */
487         long num_displayed;                     /* number of messages actually displayed */
488         HashList *disp_cal_items;               /* sorted list of calendar items; startdate is the sort criteria. */
489
490
491         char last_chat_user[256];
492
493 /* Iconbar controls */
494         int cache_max_folders;
495         int cache_num_floors;
496         long *IBSettingsVec;                    /* which icons should be shown / not shown? */
497         const StrBuf *floordiv_expanded;        /* which floordiv currently expanded */
498         int ib_wholist_expanded;
499         int ib_roomlist_expanded;
500
501 /* our known Sieve scripts; loaded by SIEVE:SCRIPTS iterator. */
502         HashList *KnownSieveScripts;
503
504 /* Transcoding cache buffers; used to avoid to frequent realloc */
505         StrBuf *ConvertBuf1;
506         StrBuf *ConvertBuf2;
507
508 /* cache stuff for templates. TODO: find a smarter way */
509         HashList *ServCfg;                      /* cache our server config for editing */
510         HashList *InetCfg;                      /* Our inet server config for editing */
511         ExpirePolicy Policy[maxpolicy];
512
513 /* used by the blog viewer */
514         int bptlid;                             /* hash of thread currently being rendered */
515 };
516
517
518 typedef void (*Header_Evaluator)(StrBuf *Line, ParsedHttpHdrs *hdr);
519
520 typedef struct _HttpHeader {
521         Header_Evaluator H;
522         StrBuf *Val;
523         int HaveEvaluator;
524 } OneHttpHeader;
525
526 void RegisterHeaderHandler(const char *Name, long Len, Header_Evaluator F);
527
528
529 enum {
530         S_SHUTDOWN,
531         S_SPAWNER,
532         MAX_SEMAPHORES
533 };
534
535 #ifndef num_parms
536 #define num_parms(source)               num_tokens(source, '|') 
537 #endif
538
539 #define site_prefix     (WC ? (WC->Hdr->HostHeader) : NULL)
540
541 /* Per-session data */
542 #define WC ((struct wcsession *)pthread_getspecific(MyConKey))
543 extern pthread_key_t MyConKey;
544
545 /* Per-thread SSL context */
546 #ifdef HAVE_OPENSSL
547 #define THREADSSL ((SSL *)pthread_getspecific(ThreadSSL))
548 extern pthread_key_t ThreadSSL;
549 extern char ctdl_key_dir[PATH_MAX];
550 extern char file_crpt_file_key[PATH_MAX];
551 extern char file_crpt_file_csr[PATH_MAX];
552 extern char file_crpt_file_cer[PATH_MAX];
553
554 void init_ssl(void);
555 void endtls(void);
556 void ssl_lock(int mode, int n, const char *file, int line);
557 int starttls(int sock);
558 extern SSL_CTX *ssl_ctx;  
559 int client_read_sslbuffer(StrBuf *buf, int timeout);
560 void client_write_ssl(const StrBuf *Buf);
561 #endif
562
563 extern int is_https;
564 extern int follow_xff;
565 extern char *server_cookie;
566 extern char *ctdlhost, *ctdlport;
567 extern char *axdefs[];
568 extern int num_threads_existing;
569 extern int num_threads_executing;
570 extern int setup_wizard;
571 extern char wizard_filename[];
572
573 void InitialiseSemaphores(void);
574 void begin_critical_section(int which_one);
575 void end_critical_section(int which_one);
576
577
578 extern void do_404(void);
579 void http_redirect(const char *);
580
581
582 #ifdef UBER_VERBOSE_DEBUGGING
583 #define wc_printf(...) wcc_printf(__FILE__, __FUNCTION__, __LINE__, __VA_ARGS__)
584 void wcc_printf(const char *FILE, const char *FUNCTION, long LINE, const char *format, ...);
585 #else 
586 void wc_printf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
587 #endif
588
589 void hprintf(const char *format,...)__attribute__((__format__(__printf__,1,2)));
590
591 void CheckAuthBasic(ParsedHttpHdrs *hdr);
592 void GetAuthBasic(ParsedHttpHdrs *hdr);
593
594 void sleeeeeeeeeep(int);
595
596 size_t wc_strftime(char *s, size_t max, const char *format, const struct tm *tm);
597 void fmt_time(char *buf, size_t siz, time_t thetime);
598 void httpdate(char *buf, time_t thetime);
599 time_t httpdate_to_timestamp(StrBuf *buf);
600
601
602
603
604 void end_webcit_session(void);
605
606
607
608
609 void cookie_to_stuff(StrBuf *cookie,
610                 int *session,
611                 StrBuf *user,
612                 StrBuf *pass,
613                 StrBuf *room,
614                 StrBuf *language
615 );
616 void locate_host(StrBuf *TBuf, int);
617 void become_logged_in(const StrBuf *user, const StrBuf *pass, StrBuf *serv_response);
618
619 void display_login(void);
620 void display_openids(void);
621 void display_default_landing_page(void);
622 void do_welcome(void);
623
624 void display_reg(int during_login);
625 void display_main_menu(void);
626 void display_aide_menu(void);
627
628 void RegisterEmbeddableMimeType(const char *MimeType, long MTLen, int Priority);
629 void CreateMimeStr(void);
630
631
632 void pop_destination(void);
633
634 void FmOut(StrBuf *Target, const char *align, const StrBuf *Source);
635 void wDumpContent(int);
636
637
638 void PutRequestLocalMem(void *Data, DeleteHashDataFunc DeleteIt);
639
640 void output_headers(    int do_httpheaders,
641                         int do_htmlhead,
642                         int do_room_banner,
643                         int unset_cookies,
644                         int suppress_check,
645                         int cache);
646 void output_custom_content_header(const char *ctype);
647 void cdataout(char *rawdata);
648
649
650 void url(char *buf, size_t bufsize);
651 void UrlizeText(StrBuf* Target, StrBuf *Source, StrBuf *WrkBuf);
652
653
654 void display_vcard(StrBuf *Target, wc_mime_attachment *Mime, char alpha, int full, char **storename, long msgnum);
655
656 void display_success(const char *successmessage);
657
658 void shutdown_sessions(void);
659
660
661
662 StrBuf *load_mimepart(long msgnum, char *partnum);
663 void MimeLoadData(wc_mime_attachment *Mime);
664 void do_edit_vcard(long msgnum, char *partnum, 
665                    message_summary *VCMsg,
666                    wc_mime_attachment *VCAtt,
667                    const char *return_to, 
668                    const char *force_room);
669
670 void select_user_to_edit(const char *preselect);
671
672 void convenience_page(const char *titlebarcolor, const char *titlebarmsg, const char *messagetext);
673 void output_html(const char *, int, int, StrBuf *, StrBuf *);
674
675 ssize_t write(int fd, const void *buf, size_t count);
676 void cal_process_attachment(wc_mime_attachment *Mime);
677
678 void address_book_popup(void);
679 void begin_ajax_response(void);
680 void end_ajax_response(void);
681
682 extern char *months[];
683 extern char *days[];
684 long locate_user_vcard_in_this_room(message_summary **VCMsg,
685                                     wc_mime_attachment **VCAtt);
686 void http_transmit_thing(const char *content_type, int is_static);
687 long unescape_input(char *buf);
688 void check_thread_pool_size(void);
689 void StrEndTab(StrBuf *Target, int tabnum, int num_tabs);
690 void StrBeginTab(StrBuf *Target, int tabnum, int num_tabs, StrBuf **Names);
691 void StrTabbedDialog(StrBuf *Target, int num_tabs, StrBuf *tabnames[]);
692 void tabbed_dialog(int num_tabs, char *tabnames[]);
693 void begin_tab(int tabnum, int num_tabs);
694 void end_tab(int tabnum, int num_tabs);
695
696 int get_time_format_cached (void);
697 void display_wiki_pagelist(void);
698 void str_wiki_index(char *);
699
700 HashList *GetRoomListHashLKRA(StrBuf *Target, WCTemplputParams *TP);
701
702 /* actual supported locales */
703 void TmplGettext(StrBuf *Target, WCTemplputParams *TP);
704
705 void set_selected_language(const char *);
706 void go_selected_language(void);
707 void stop_selected_language(void);
708 const char *get_selected_language(void);
709
710 void utf8ify_rfc822_string(char **buf);
711
712 void begin_burst(void);
713 long end_burst(void);
714
715 void AppendImportantMessage(const char *pch, long len);
716
717 void http_datestring(char *buf, size_t n, time_t xtime);
718
719
720 /* These should be empty, but we have them for testing */
721 #define DEFAULT_HTTPAUTH_USER   ""
722 #define DEFAULT_HTTPAUTH_PASS   ""
723
724
725 /* Exit codes 101 through 109 are initialization failures so we don't want to
726  * just keep respawning indefinitely.
727  */
728 #define WC_EXIT_BIND            101     /* Can't bind to the port */
729 #define WC_EXIT_SSL             102     /* Can't initialize SSL */
730
731
732 #define WC_TIMEFORMAT_NONE 0
733 #define WC_TIMEFORMAT_AMPM 1
734 #define WC_TIMEFORMAT_24 2
735
736 extern int time_to_die;                 /* Nonzero if server is shutting down */
737 extern int DisableGzip;
738
739 /* 
740  * Array type for a blog post.  The first message is the post; the rest are comments
741  */
742 struct blogpost {
743         int top_level_id;
744         long *msgs;             /* Array of msgnums for messages we are displaying */
745         int num_msgs;           /* Number of msgnums stored in 'msgs' */
746         int alloc_msgs;         /* Currently allocated size of array */
747 };
748
749
750 /*
751  * Data which gets returned from a call to blogview_learn_thread_references()
752  */
753 struct bltr {
754         int id;
755         int refs;
756 };
757
758
759 struct bltr blogview_learn_thread_references(long msgnum);
760 void tmplput_blog_permalink(StrBuf *Target, WCTemplputParams *TP);
761 void display_summary_page(void);