e722af7cf3685b66d34f388bf434aeb8a59688f6
[citadel.git] / webcit / webcit.h
1 /* $Id$ */
2
3 #ifdef HAVE_ZLIB_H
4 #include <zlib.h>
5 #endif
6
7
8 #ifdef HAVE_ICAL_H
9 #ifdef HAVE_LIBICAL
10 #define WEBCIT_WITH_CALENDAR_SERVICE 1
11 #endif
12 #endif
13
14 #ifdef WEBCIT_WITH_CALENDAR_SERVICE
15 #include <ical.h>
16 #endif
17
18 #define CALENDAR_ROOM_NAME      "Calendar"
19 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
20
21 #define SIZ                     4096            /* generic buffer size */
22
23 #define TRACE fprintf(stderr, "Checkpoint: %s, %d\n", __FILE__, __LINE__)
24
25 #define SLEEPING                180             /* TCP connection timeout */
26 #define WEBCIT_TIMEOUT          900             /* WebCit session timeout */
27 #define PORT_NUM                2000            /* port number to listen on */
28 #define SERVER                  "WebCit v5.00"  /* who's in da house */
29 #define DEVELOPER_ID            0
30 #define CLIENT_ID               4
31 #define CLIENT_VERSION          500             /* This version of WebCit */
32 #define MINIMUM_CIT_VERSION     607             /* min required Citadel vers */
33 #define DEFAULT_HOST            "localhost"     /* Default Citadel server */
34 #define DEFAULT_PORT            "504"
35 #define LB                      (1)             /* Internal escape chars */
36 #define RB                      (2)
37 #define QU                      (3)
38 #define TARGET                  "webcit01"      /* Target for inline URL's */
39 #define HOUSEKEEPING            15              /* Housekeeping frequency */
40 #define INITIAL_WORKER_THREADS  5
41 #define LISTEN_QUEUE_LENGTH     100             /* listen() backlog queue */
42
43 #define USERCONFIGROOM          "My Citadel Config"
44
45
46 /*
47  * Room flags (from Citadel)
48  *
49  * bucket one...
50  */
51 #define QR_PERMANENT    1               /* Room does not purge              */
52 #define QR_INUSE        2               /* Set if in use, clear if avail    */
53 #define QR_PRIVATE      4               /* Set for any type of private room */
54 #define QR_PASSWORDED   8               /* Set if there's a password too    */
55 #define QR_GUESSNAME    16              /* Set if it's a guessname room     */
56 #define QR_DIRECTORY    32              /* Directory room                   */
57 #define QR_UPLOAD       64              /* Allowed to upload                */
58 #define QR_DOWNLOAD     128             /* Allowed to download              */
59 #define QR_VISDIR       256             /* Visible directory                */
60 #define QR_ANONONLY     512             /* Anonymous-Only room              */
61 #define QR_ANONOPT      1024            /* Anonymous-Option room            */
62 #define QR_NETWORK      2048            /* Shared network room              */
63 #define QR_PREFONLY     4096            /* Preferred status needed to enter */
64 #define QR_READONLY     8192            /* Aide status required to post     */
65 #define QR_MAILBOX      16384           /* Set if this is a private mailbox */
66
67 /*
68  * bucket two...
69  */
70 #define QR2_SYSTEM      1               /* System room; hide by default     */
71 #define QR2_SELFLIST    2               /* Self-service mailing list mgmt   */
72
73
74 #define UA_KNOWN                2
75 #define UA_GOTOALLOWED          4
76 #define UA_HASNEWMSGS           8
77 #define UA_ZAPPED               16
78
79
80
81
82
83
84 struct httprequest {
85         struct httprequest *next;
86         char line[SIZ];
87 };
88
89 struct urlcontent {
90         struct urlcontent *next;
91         char url_key[32];
92         char *url_data;
93 };
94
95 struct serv_info {
96         int serv_pid;
97         char serv_nodename[32];
98         char serv_humannode[64];
99         char serv_fqdn[64];
100         char serv_software[64];
101         int serv_rev_level;
102         char serv_bbs_city[64];
103         char serv_sysadm[64];
104         char serv_moreprompt[SIZ];
105         int serv_ok_floors;
106 };
107
108
109
110 /*
111  * This struct holds a list of rooms for <G>oto operations.
112  */
113 struct march {
114         struct march *next;
115         char march_name[32];
116         int march_floor;
117         int march_order;
118 };
119
120 /* 
121  * This struct holds a list of rooms for client display.
122  * (oooh, a tree!)
123  */
124 struct roomlisting {
125         struct roomlisting *lnext;
126         struct roomlisting *rnext;
127         char rlname[64];
128         unsigned rlflags;
129         int rlfloor;
130         int rlorder;
131 };
132
133
134
135 /*
136  * Dynamic content for variable substitution in templates
137  */
138 struct wcsubst {
139         struct wcsubst *next;
140         int wcs_type;
141         char wcs_key[32];
142         void *wcs_value;
143         void (*wcs_function)(void);
144 };
145
146 /*
147  * Values for wcs_type
148  */
149 enum {
150         WCS_STRING,
151         WCS_FUNCTION,
152         WCS_SERVCMD
153 };
154
155
156 struct wc_attachment {
157         struct wc_attachment *next;
158         size_t length;
159         char content_type[SIZ];
160         char filename[SIZ];
161         char *data;
162 };
163
164
165 /*
166  * One of these is kept for each active Citadel session.
167  * HTTP transactions are bound to one at a time.
168  */
169 struct wcsession {
170         struct wcsession *next;         /* Linked list */
171         int wc_session;                 /* WebCit session ID */
172         char wc_username[SIZ];
173         char wc_password[SIZ];
174         char wc_roomname[SIZ];
175         int connected;
176         int logged_in;
177         int axlevel;
178         int is_aide;
179         int is_room_aide;
180         int http_sock;
181         int serv_sock;
182         unsigned room_flags;
183         int wc_view;
184         int wc_default_view;
185         char ugname[128];
186         long uglsn;
187         int upload_length;
188         char *upload;
189         char upload_filename[SIZ];
190         char upload_content_type[SIZ];
191         int new_mail;
192         int remember_new_mail;
193         int need_regi;                  /* This user needs to register. */
194         int need_vali;                  /* New users require validation. */
195         char cs_inet_email[SIZ];        /* User's preferred Internet addr. */
196         pthread_mutex_t SessionMutex;   /* mutex for exclusive access */
197         time_t lastreq;                 /* Timestamp of most recent HTTP */
198         int killthis;                   /* Nonzero == purge this session */
199         struct march *march;            /* march mode room list */
200         char reply_to[SIZ];             /* reply-to address */
201         long msgarr[4096];              /* for read operations */
202         int fake_frames;
203         int is_wap;                     /* Client is a WAP gateway */
204         struct urlcontent *urlstrings;
205         int HaveExpressMessages;        /* Nonzero if incoming msgs exist */
206         struct wcsubst *vars;
207         char this_page[SIZ];            /* address of current page */
208         char http_host[SIZ];            /* HTTP Host: header */
209         char *preferences;
210 #ifdef HAVE_ICAL_H
211         icalcomponent **disp_cal;       /* store calendar items for display */
212         long *cal_msgnum;               /* store calendar msgids for display */
213         int num_cal;
214 #endif
215         struct wc_attachment *first_attachment;
216         char ImportantMessage[SIZ];
217 };
218
219 #define extract(dest,source,parmnum)    extract_token(dest,source,parmnum,'|')
220 #define num_parms(source)               num_tokens(source, '|')
221
222 #define WC ((struct wcsession *)pthread_getspecific(MyConKey))
223 extern pthread_key_t MyConKey;
224
225 struct serv_info serv_info;
226 extern char floorlist[128][SIZ];
227 extern char *axdefs[];
228 extern char *ctdlhost, *ctdlport;
229 extern char *server_cookie;
230
231 extern struct wcsubst *global_subst;
232
233
234 void stuff_to_cookie(char *cookie, int session,
235                         char *user, char *pass, char *room);
236 void cookie_to_stuff(char *cookie, int *session,
237                         char *user, char *pass, char *room);
238 void locate_host(char *, int);
239 void become_logged_in(char *, char *, char *);
240 void do_login(void);
241 void display_login(char *mesg);
242 void do_welcome(void);
243 void do_logout(void);
244 void display_main_menu(void);
245 void display_advanced_menu(void);
246 void slrp_highest(void);
247 void gotonext(void);
248 void ungoto(void);
249 void get_serv_info(char *, char *);
250 int uds_connectsock(char *);
251 int tcp_connectsock(char *, char *);
252 void serv_gets(char *strbuf);
253 void serv_puts(char *string);
254 void whobbs(void);
255 void fmout(FILE *fp, char *align);
256 void wDumpContent(int);
257 void serv_printf(const char *format,...);
258 char *bstr(char *key);
259 void urlesc(char *, char *);
260 void urlescputs(char *);
261 void output_headers(int);
262 void wprintf(const char *format,...);
263 void output_static(char *what);
264 void stresc(char *target, char *strbuf, int nbsp);
265 void escputs(char *strbuf);
266 void url(char *buf);
267 void escputs1(char *strbuf, int nbsp);
268 long extract_long(char *source, long int parmnum);
269 int extract_int(char *source, int parmnum);
270 void stripout(char *str, char leftboundary, char rightboundary);
271 void dump_vars(void);
272 void embed_main_menu(void);
273 void serv_read(char *buf, int bytes);
274 int haschar(char *, char);
275 void readloop(char *oper);
276 void text_to_server(char *ptr, int convert_to_html);
277 void display_enter(void);
278 void post_message(void);
279 void confirm_delete_msg(void);
280 void delete_msg(void);
281 void confirm_move_msg(void);
282 void move_msg(void);
283 void userlist(void);
284 void showuser(void);
285 void display_page(void);
286 void page_user(void);
287 void do_chat(void);
288 void display_private(char *rname, int req_pass);
289 void goto_private(void);
290 void zapped_list(void);
291 void display_zap(void);
292 void zap(void);
293 void display_success(char *);
294 void display_entroom(void);
295 void entroom(void);
296 void display_editroom(void);
297 void netedit(void);
298 void editroom(void);
299 void display_whok(void);
300 void server_to_text(void);
301 void save_edit(char *description, char *enter_cmd, int regoto);
302 void display_edit(char *description, char *check_cmd,
303                   char *read_cmd, char *save_cmd, int headers_type);
304 void gotoroom(char *gname, int display_name);
305 void confirm_delete_room(void);
306 void delete_room(void);
307 void validate(void);
308 void display_graphics_upload(char *, char *, char *);
309 void do_graphics_upload(char *upl_cmd);
310 void serv_read(char *buf, int bytes);
311 void serv_gets(char *strbuf);
312 void serv_write(char *buf, int nbytes);
313 void serv_puts(char *string);
314 void serv_printf(const char *format,...);
315 void load_floorlist(void);
316 void display_reg(int);
317 void display_changepw(void);
318 void changepw(void);
319 void display_edit_node(void);
320 void edit_node(void);
321 void display_netconf(void);
322 void display_confirm_delete_node(void);
323 void delete_node(void);
324 void display_add_node(void);
325 void add_node(void);
326 void terminate_session(void);
327 void edit_me(void);
328 void display_siteconfig(void);
329 void siteconfig(void);
330 void display_generic(void);
331 void do_generic(void);
332 void display_menubar(int);
333 void embed_room_banner(char *);
334 void smart_goto(char *);
335 void worker_entry(void);
336 void session_loop(struct httprequest *);
337 void fmt_date(char *buf, time_t thetime);
338 void fmt_time(char *buf, time_t thetime);
339 void httpdate(char *buf, time_t thetime);
340 void end_webcit_session(void);
341 void page_popup(void);
342 void http_redirect(char *);
343 void clear_local_substs(void);
344 void svprintf(char *keyname, int keytype, const char *format,...);
345 void svcallback(char *keyname, void (*fcn_ptr)() );
346 void do_template(void *templatename);
347 int lingering_close(int fd);
348 char *memreadline(char *start, char *buf, int maxlen);
349 int num_tokens (char *source, char tok);
350 void extract_token(char *dest, char *source, int parmnum, char separator);
351 void remove_token(char *source, int parmnum, char separator);
352 char *load_mimepart(long msgnum, char *partnum);
353 int pattern2(char *search, char *patn);
354 void do_edit_vcard(long, char *, char *);
355 void edit_vcard(void);
356 void submit_vcard(void);
357 void striplt(char *);
358 void select_user_to_edit(char *message, char *preselect);
359 void display_edituser(char *who);
360 void create_user(void);
361 void edituser(void);
362 void change_view(void);
363 void folders(void);
364 void do_stuff_to_msgs(void);
365 void load_preferences(void);
366 void save_preferences(void);
367 void get_preference(char *key, char *value);
368 void set_preference(char *key, char *value);
369 void knrooms(void);
370 int is_msg_in_mset(char *mset, long msgnum);
371 char *safestrncpy(char *dest, const char *src, size_t n);
372 void display_addressbook(long msgnum, char alpha);
373 void offer_start_page(void);
374 void change_start_page(void);
375 void output_html(void);
376 void display_floorconfig(char *);
377 void delete_floor(void);
378 void create_floor(void);
379 void rename_floor(void);
380 void do_listsub(void);
381 void toggle_self_service(void);
382 void summary(void);
383 ssize_t write(int fd, const void *buf, size_t count);
384 void cal_process_attachment(char *part_source, long msgnum, char *cal_partnum);
385 void display_calendar(long msgnum);
386 void display_task(long msgnum);
387 void do_calendar_view(void);
388 void free_calendar_buffer(void);
389 void calendar_summary_view(void);
390 int load_msg_ptrs(char *servcmd);
391 void CtdlEncodeBase64(char *dest, const char *source, size_t sourcelen);
392 int CtdlDecodeBase64(char *dest, const char *source, size_t length);
393 void free_attachments(struct wcsession *sess);
394
395
396 #ifdef HAVE_ICAL_H
397 void display_edit_task(void);
398 void save_task(void);
399 void display_edit_event(void);
400 void save_event(void);
401 void display_icaltimetype_as_webform(struct icaltimetype *, char *);
402 struct icaltimetype icaltime_from_webform(char *prefix);
403 void display_edit_individual_event(icalcomponent *supplied_vtodo, long msgnum);
404 void save_individual_event(icalcomponent *supplied_vtodo, long msgnum);
405 void generate_new_uid(char *);
406 void respond_to_request(void);
407 void handle_rsvp(void);
408 void ical_dezonify(icalcomponent *cal);
409 void partstat_as_string(char *buf, icalproperty *attendee);
410 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp);
411 void check_attendee_availability(icalcomponent *supplied_vevent);
412 #endif
413
414 extern char *months[];
415 extern char *days[];
416 void read_server_binary(char *buffer, size_t total_len);
417 char *read_server_text(void);
418 int goto_config_room(void);
419 long locate_user_vcard(char *username, long usernum);
420 void sleeeeeeeeeep(int);
421 void http_transmit_thing(char *thing, size_t length, char *content_type,
422                          int is_static);
423 void unescape_input(char *buf);