webcit/webcit.h

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