webcit/webcit.h

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