1 // This module implements iCalendar object processing and the Calendar>
2 // room on a Citadel server. It handles iCalendar objects using the
3 // iTIP protocol. See RFCs 2445 and 2446.
5 // Copyright (c) 1987-2024 by the citadel.org team
7 // This program is open source software. Use, duplication, or disclosure
8 // are subject to the terms of the GNU General Public License version 3.
10 #define PRODID "-//Citadel//NONSGML Citadel Calendar//EN"
12 #include "../../ctdl_module.h"
13 #include <libical/ical.h>
14 #include "../../msgbase.h"
15 #include "../../internet_addressing.h"
16 #include "serv_calendar.h"
17 #include "../../room_ops.h"
18 #include "../../euidindex.h"
19 #include "../../default_timezone.h"
20 #include "../../config.h"
22 struct ical_respond_data {
23 char desired_partnum[SIZ];
28 // Utility function to create a new VCALENDAR component with some of the
29 // required fields already set the way we like them.
30 icalcomponent *icalcomponent_new_citadel_vcalendar(void) {
31 icalcomponent *encaps;
33 encaps = icalcomponent_new_vcalendar();
35 syslog(LOG_ERR, "calendar: could not allocate component");
40 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
42 // Set the Version Number
43 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
49 // Utility function to encapsulate a subcomponent into a full VCALENDAR
50 icalcomponent *ical_encapsulate_subcomponent(icalcomponent *subcomp) {
51 icalcomponent *encaps;
53 // If we're already looking at a full VCALENDAR component, don't bother ... just return itself.
54 if (icalcomponent_isa(subcomp) == ICAL_VCALENDAR_COMPONENT) {
58 // Encapsulate the VEVENT component into a complete VCALENDAR
59 encaps = icalcomponent_new_citadel_vcalendar();
60 if (encaps == NULL) return NULL;
62 // Encapsulate the subcomponent inside
63 icalcomponent_add_component(encaps, subcomp);
65 // Return the object we just created.
70 // Write a calendar object into the specified user's calendar room.
71 // If the supplied user is NULL, this function writes the calendar object
72 // to the currently selected room.
73 void ical_write_to_cal(struct ctdluser *u, icalcomponent *cal) {
76 icalcomponent *encaps = NULL;
77 struct CtdlMessage *msg = NULL;
78 icalcomponent *tmp=NULL;
80 if (cal == NULL) return;
82 // If the supplied object is a subcomponent, encapsulate it in
83 // a full VCALENDAR component, and save that instead.
84 if (icalcomponent_isa(cal) != ICAL_VCALENDAR_COMPONENT) {
85 tmp = icalcomponent_new_clone(cal);
86 encaps = ical_encapsulate_subcomponent(tmp);
87 ical_write_to_cal(u, encaps);
88 icalcomponent_free(tmp);
89 icalcomponent_free(encaps);
93 ser = icalcomponent_as_ical_string_r(cal);
94 if (ser == NULL) return;
98 // If the caller supplied a user, write to that user's default calendar room
100 CtdlWriteObject( // This handy API function does all the work for us.
101 USERCALENDARROOM, // which room
102 "text/calendar", // MIME type
104 serlen + 1, // length
111 // If the caller did not supply a user, write to the currently selected room
113 struct CitContext *CCC = CC;
116 msg = malloc(sizeof(struct CtdlMessage));
117 memset(msg, 0, sizeof(struct CtdlMessage));
118 msg->cm_magic = CTDLMESSAGE_MAGIC;
119 msg->cm_anon_type = MES_NORMAL;
120 msg->cm_format_type = 4;
121 CM_SetField(msg, eAuthor, CCC->user.fullname);
122 CM_SetField(msg, eOriginalRoom, CCC->room.QRname);
124 MsgBody = NewStrBufPlain(NULL, serlen + 100);
125 StrBufAppendBufPlain(MsgBody, HKEY("Content-type: text/calendar\r\n\r\n"), 0);
126 StrBufAppendBufPlain(MsgBody, ser, serlen, 0);
128 CM_SetAsFieldSB(msg, eMesageText, &MsgBody);
130 // Now write the data
131 CtdlSubmitMsg(msg, NULL, "");
135 // In either case, now we can free the serialized calendar object
140 // Send a reply to a meeting invitation.
142 // 'request' is the invitation to reply to.
143 // 'action' is the string "accept" or "decline" or "tentative".
144 void ical_send_a_reply(icalcomponent *request, char *action) {
145 icalcomponent *the_reply = NULL;
146 icalcomponent *vevent = NULL;
147 icalproperty *attendee = NULL;
148 char attendee_string[SIZ];
149 icalproperty *organizer = NULL;
150 char organizer_string[SIZ];
151 icalproperty *summary = NULL;
152 char summary_string[SIZ];
153 icalproperty *me_attend = NULL;
154 struct recptypes *recp = NULL;
155 icalparameter *partstat = NULL;
156 char *serialized_reply = NULL;
157 char *reply_message_text = NULL;
159 struct CtdlMessage *msg = NULL;
160 struct recptypes *valid = NULL;
162 *organizer_string = '\0';
163 strcpy(summary_string, "Calendar item");
165 if (request == NULL) {
166 syslog(LOG_ERR, "calendar: trying to reply to NULL event");
170 the_reply = icalcomponent_new_clone(request);
171 if (the_reply == NULL) {
172 syslog(LOG_ERR, "calendar: cannot clone request");
176 // Change the method from REQUEST to REPLY
177 icalcomponent_set_method(the_reply, ICAL_METHOD_REPLY);
179 vevent = icalcomponent_get_first_component(the_reply, ICAL_VEVENT_COMPONENT);
180 if (vevent != NULL) {
181 // Hunt for attendees, removing ones that aren't us.
182 // (Actually, remove them all, cloning our own one so we can
183 // re-insert it later)
184 while (attendee = icalcomponent_get_first_property(vevent,
185 ICAL_ATTENDEE_PROPERTY), (attendee != NULL)
187 ch = icalproperty_get_attendee(attendee);
188 if ((ch != NULL) && !strncasecmp(ch, "MAILTO:", 7)) {
189 safestrncpy(attendee_string, ch + 7, sizeof (attendee_string));
190 string_trim(attendee_string);
191 recp = validate_recipients(attendee_string, NULL, 0);
193 if (!strcasecmp(recp->recp_local, CC->user.fullname)) {
194 if (me_attend) icalproperty_free(me_attend);
195 me_attend = icalproperty_new_clone(attendee);
197 free_recipients(recp);
202 icalcomponent_remove_property(vevent, attendee);
203 icalproperty_free(attendee);
206 // We found our own address in the attendee list.
208 // Change the partstat from NEEDS-ACTION to ACCEPT or DECLINE
209 icalproperty_remove_parameter_by_kind(me_attend, ICAL_PARTSTAT_PARAMETER);
211 if (!strcasecmp(action, "accept")) {
212 partstat = icalparameter_new_partstat(ICAL_PARTSTAT_ACCEPTED);
214 else if (!strcasecmp(action, "decline")) {
215 partstat = icalparameter_new_partstat(ICAL_PARTSTAT_DECLINED);
217 else if (!strcasecmp(action, "tentative")) {
218 partstat = icalparameter_new_partstat(ICAL_PARTSTAT_TENTATIVE);
221 if (partstat) icalproperty_add_parameter(me_attend, partstat);
223 // Now insert it back into the vevent.
224 icalcomponent_add_property(vevent, me_attend);
227 // Figure out who to send this thing to
228 organizer = icalcomponent_get_first_property(vevent, ICAL_ORGANIZER_PROPERTY);
229 if (organizer != NULL) {
230 if (icalproperty_get_organizer(organizer)) {
231 strcpy(organizer_string,
232 icalproperty_get_organizer(organizer) );
235 if (!strncasecmp(organizer_string, "MAILTO:", 7)) {
236 strcpy(organizer_string, &organizer_string[7]);
237 string_trim(organizer_string);
240 strcpy(organizer_string, "");
243 // Extract the summary string -- we'll use it as the message subject for the reply
244 summary = icalcomponent_get_first_property(vevent, ICAL_SUMMARY_PROPERTY);
245 if (summary != NULL) {
246 if (icalproperty_get_summary(summary)) {
247 strcpy(summary_string,
248 icalproperty_get_summary(summary) );
253 // Now generate the reply message and send it out.
254 serialized_reply = icalcomponent_as_ical_string_r(the_reply);
255 icalcomponent_free(the_reply); // don't need this anymore
256 if (serialized_reply == NULL) return;
258 reply_message_text = malloc(strlen(serialized_reply) + SIZ);
259 if (reply_message_text != NULL) {
260 sprintf(reply_message_text,
261 "Content-type: text/calendar; charset=\"utf-8\"\r\n\r\n%s\r\n",
265 msg = CtdlMakeMessage(&CC->user,
266 organizer_string, // to
273 summary_string, // Use the event SUMMARY as the message subject
280 valid = validate_recipients(organizer_string, NULL, 0);
281 CtdlSubmitMsg(msg, valid, "");
283 free_recipients(valid);
286 free(serialized_reply);
290 // Callback function for mime parser that hunts for calendar content types
291 // and turns them into calendar objects. If something is found, it is placed
292 // in ird->cal, and the caller now owns that memory and is responsible for freeing it.
293 void ical_locate_part(char *name, char *filename, char *partnum, char *disp,
294 void *content, char *cbtype, char *cbcharset, size_t length, char *encoding,
295 char *cbid, void *cbuserdata) {
297 struct ical_respond_data *ird = NULL;
299 ird = (struct ical_respond_data *) cbuserdata;
301 // desired_partnum can be set to "_HUNT_" to have it just look for
302 // the first part with a content type of text/calendar. Otherwise
303 // we have to only process the right one.
304 if (strcasecmp(ird->desired_partnum, "_HUNT_")) {
305 if (strcasecmp(partnum, ird->desired_partnum)) {
310 if ( (strcasecmp(cbtype, "text/calendar"))
311 && (strcasecmp(cbtype, "application/ics")) ) {
315 if (ird->cal != NULL) {
316 icalcomponent_free(ird->cal);
320 ird->cal = icalcomponent_new_from_string(content);
324 // Respond to a meeting request.
325 void ical_respond(long msgnum, char *partnum, char *action) {
326 struct CtdlMessage *msg = NULL;
327 struct ical_respond_data ird;
330 (strcasecmp(action, "accept"))
331 && (strcasecmp(action, "decline"))
333 cprintf("%d Action must be 'accept' or 'decline'\n", ERROR + ILLEGAL_VALUE);
337 msg = CtdlFetchMessage(msgnum, 1);
339 cprintf("%d Message %ld not found.\n", ERROR + ILLEGAL_VALUE, (long)msgnum);
343 memset(&ird, 0, sizeof ird);
344 strcpy(ird.desired_partnum, partnum);
345 mime_parser(CM_RANGE(msg, eMesageText),
346 *ical_locate_part, // callback function
349 (void *) &ird, // user data
353 // We're done with the incoming message, because we now have a * calendar object in memory.
356 // Here is the real meat of this function. Handle the event.
357 if (ird.cal != NULL) {
358 // Save this in the user's calendar if necessary
359 if (!strcasecmp(action, "accept")) {
360 ical_write_to_cal(&CC->user, ird.cal);
363 // Send a reply if necessary
364 if (icalcomponent_get_method(ird.cal) == ICAL_METHOD_REQUEST) {
365 ical_send_a_reply(ird.cal, action);
368 // We used to delete the invitation after handling it.
369 // We don't do that anymore, but here is the code that handled it:
370 // CtdlDeleteMessages(CC->room.QRname, &msgnum, 1, "");
372 // Free the memory we allocated and return a response.
373 icalcomponent_free(ird.cal);
375 cprintf("%d ok\n", CIT_OK);
379 cprintf("%d No calendar object found\n", ERROR + ROOM_NOT_FOUND);
383 // should never get here
388 * Figure out the UID of the calendar event being referred to in a
389 * REPLY object. This function is recursive.
391 void ical_learn_uid_of_reply(char *uidbuf, icalcomponent *cal) {
392 icalcomponent *subcomponent;
395 /* If this object is a REPLY, then extract the UID. */
396 if (icalcomponent_isa(cal) == ICAL_VEVENT_COMPONENT) {
397 p = icalcomponent_get_first_property(cal, ICAL_UID_PROPERTY);
399 strcpy(uidbuf, icalproperty_get_comment(p));
403 /* Otherwise, recurse through any VEVENT subcomponents. We do NOT want the
404 * UID of the reply; we want the UID of the invitation being replied to.
406 for (subcomponent = icalcomponent_get_first_component(cal, ICAL_VEVENT_COMPONENT);
407 subcomponent != NULL;
408 subcomponent = icalcomponent_get_next_component(cal, ICAL_VEVENT_COMPONENT) ) {
409 ical_learn_uid_of_reply(uidbuf, subcomponent);
415 * ical_update_my_calendar_with_reply() refers to this callback function; when we
416 * locate the message containing the calendar event we're replying to, this function
417 * gets called. It basically just sticks the message number in a supplied buffer.
419 void ical_hunt_for_event_to_update(long msgnum, void *data) {
422 msgnumptr = (long *) data;
427 struct original_event_container {
432 * Callback function for mime parser that hunts for calendar content types
433 * and turns them into calendar objects (called by ical_update_my_calendar_with_reply()
434 * to fetch the object being updated)
436 void ical_locate_original_event(char *name, char *filename, char *partnum, char *disp,
437 void *content, char *cbtype, char *cbcharset, size_t length, char *encoding,
438 char *cbid, void *cbuserdata) {
440 struct original_event_container *oec = NULL;
442 if ( (strcasecmp(cbtype, "text/calendar"))
443 && (strcasecmp(cbtype, "application/ics")) ) {
446 oec = (struct original_event_container *) cbuserdata;
447 if (oec->c != NULL) {
448 icalcomponent_free(oec->c);
450 oec->c = icalcomponent_new_from_string(content);
455 * Merge updated attendee information from a REPLY into an existing event.
457 void ical_merge_attendee_reply(icalcomponent *event, icalcomponent *reply) {
459 icalproperty *e_attendee, *r_attendee;
461 /* First things first. If we're not looking at a VEVENT component,
462 * recurse through subcomponents until we find one.
464 if (icalcomponent_isa(event) != ICAL_VEVENT_COMPONENT) {
465 for (c = icalcomponent_get_first_component(event, ICAL_VEVENT_COMPONENT);
467 c = icalcomponent_get_next_component(event, ICAL_VEVENT_COMPONENT) ) {
468 ical_merge_attendee_reply(c, reply);
473 /* Now do the same thing with the reply.
475 if (icalcomponent_isa(reply) != ICAL_VEVENT_COMPONENT) {
476 for (c = icalcomponent_get_first_component(reply, ICAL_VEVENT_COMPONENT);
478 c = icalcomponent_get_next_component(reply, ICAL_VEVENT_COMPONENT) ) {
479 ical_merge_attendee_reply(event, c);
484 /* Clone the reply, because we're going to rip its guts out. */
485 reply = icalcomponent_new_clone(reply);
487 /* At this point we're looking at the correct subcomponents.
488 * Iterate through the attendees looking for a match.
491 for (e_attendee = icalcomponent_get_first_property(event, ICAL_ATTENDEE_PROPERTY);
493 e_attendee = icalcomponent_get_next_property(event, ICAL_ATTENDEE_PROPERTY)) {
495 for (r_attendee = icalcomponent_get_first_property(reply, ICAL_ATTENDEE_PROPERTY);
497 r_attendee = icalcomponent_get_next_property(reply, ICAL_ATTENDEE_PROPERTY)) {
499 /* Check to see if these two attendees match...
502 e = icalproperty_get_attendee(e_attendee);
503 r = icalproperty_get_attendee(r_attendee);
508 /* ...and if they do, remove the attendee from the event
509 * and replace it with the attendee from the reply. (The
510 * reply's copy will have the same address, but an updated
513 icalcomponent_remove_property(event, e_attendee);
514 icalproperty_free(e_attendee);
515 icalcomponent_remove_property(reply, r_attendee);
516 icalcomponent_add_property(event, r_attendee);
518 /* Since we diddled both sets of attendees, we have to start
519 * the iteration over again. This will not create an infinite
520 * loop because we removed the attendee from the reply. (That's
521 * why we cloned the reply, and that's what we mean by "ripping
530 /* Free the *clone* of the reply. */
531 icalcomponent_free(reply);
536 * Handle an incoming RSVP (object with method==ICAL_METHOD_REPLY) for a
537 * calendar event. The object has already been deserialized for us; all
538 * we have to do here is hunt for the event in our calendar, merge in the
539 * updated attendee status, and save it again.
541 * This function returns 0 on success, 1 if the event was not found in the
542 * user's calendar, or 2 if an internal error occurred.
544 int ical_update_my_calendar_with_reply(icalcomponent *cal) {
546 char hold_rm[ROOMNAMELEN];
547 long msgnum_being_replaced = 0;
548 struct CtdlMessage *msg = NULL;
549 struct original_event_container oec;
550 icalcomponent *original_event;
551 char *serialized_event = NULL;
552 char roomname[ROOMNAMELEN];
553 char *message_text = NULL;
555 /* Figure out just what event it is we're dealing with */
556 strcpy(uid, "--==<< InVaLiD uId >>==--");
557 ical_learn_uid_of_reply(uid, cal);
558 syslog(LOG_DEBUG, "calendar: UID of event being replied to is <%s>", uid);
560 strcpy(hold_rm, CC->room.QRname); /* save current room */
562 if (CtdlGetRoom(&CC->room, USERCALENDARROOM) != 0) {
563 CtdlGetRoom(&CC->room, hold_rm);
564 syslog(LOG_ERR, "calendar: cannot get user calendar room");
569 * Look in the EUID index for a message with
570 * the Citadel EUID set to the value we're looking for. Since
571 * Citadel always sets the message EUID to the iCalendar UID of
572 * the event, this will work.
574 msgnum_being_replaced = CtdlLocateMessageByEuid(uid, &CC->room);
576 CtdlGetRoom(&CC->room, hold_rm); /* return to saved room */
578 syslog(LOG_DEBUG, "calendar: msgnum_being_replaced == %ld", msgnum_being_replaced);
579 if (msgnum_being_replaced == 0) {
580 return(1); /* no calendar event found */
583 /* Now we know the ID of the message containing the event being updated.
584 * We don't actually have to delete it; that'll get taken care of by the
585 * server when we save another event with the same UID. This just gives
586 * us the ability to load the event into memory so we can diddle the
589 msg = CtdlFetchMessage(msgnum_being_replaced, 1);
591 return(2); /* internal error */
594 mime_parser(CM_RANGE(msg, eMesageText),
595 *ical_locate_original_event, /* callback function */
597 &oec, /* user data */
602 original_event = oec.c;
603 if (original_event == NULL) {
604 syslog(LOG_ERR, "calendar: original_component is NULL");
608 /* Merge the attendee's updated status into the event */
609 ical_merge_attendee_reply(original_event, cal);
612 serialized_event = icalcomponent_as_ical_string_r(original_event);
613 icalcomponent_free(original_event); /* Don't need this anymore. */
614 if (serialized_event == NULL) return(2);
616 CtdlMailboxName(roomname, sizeof roomname, &CC->user, USERCALENDARROOM);
618 message_text = malloc(strlen(serialized_event) + SIZ);
619 if (message_text != NULL) {
620 sprintf(message_text,
621 "Content-type: text/calendar; charset=\"utf-8\"\r\n\r\n%s\r\n",
625 msg = CtdlMakeMessage(&CC->user,
626 "", /* No recipient */
627 "", /* No recipient */
638 CIT_ICAL->avoid_sending_invitations = 1;
639 CtdlSubmitMsg(msg, NULL, roomname);
641 CIT_ICAL->avoid_sending_invitations = 0;
644 free(serialized_event);
650 * Handle an incoming RSVP for an event. (This is the server subcommand part; it
651 * simply extracts the calendar object from the message, deserializes it, and
652 * passes it up to ical_update_my_calendar_with_reply() for processing.
654 void ical_handle_rsvp(long msgnum, char *partnum, char *action) {
655 struct CtdlMessage *msg = NULL;
656 struct ical_respond_data ird;
660 (strcasecmp(action, "update"))
661 && (strcasecmp(action, "ignore"))
663 cprintf("%d Action must be 'update' or 'ignore'\n",
664 ERROR + ILLEGAL_VALUE
669 msg = CtdlFetchMessage(msgnum, 1);
671 cprintf("%d Message %ld not found.\n",
672 ERROR + ILLEGAL_VALUE,
678 memset(&ird, 0, sizeof ird);
679 strcpy(ird.desired_partnum, partnum);
680 mime_parser(CM_RANGE(msg, eMesageText),
681 *ical_locate_part, /* callback function */
683 (void *) &ird, /* user data */
687 /* We're done with the incoming message, because we now have a
688 * calendar object in memory.
693 * Here is the real meat of this function. Handle the event.
695 if (ird.cal != NULL) {
696 /* Update the user's calendar if necessary */
697 if (!strcasecmp(action, "update")) {
698 ret = ical_update_my_calendar_with_reply(ird.cal);
700 cprintf("%d Your calendar has been updated with this reply.\n",
704 cprintf("%d This event does not exist in your calendar.\n",
705 ERROR + FILE_NOT_FOUND);
708 cprintf("%d An internal error occurred.\n",
709 ERROR + INTERNAL_ERROR);
713 cprintf("%d This reply has been ignored.\n", CIT_OK);
716 /* Now that we've processed this message, we don't need it
717 * anymore. So delete it. (Don't do this anymore.)
718 CtdlDeleteMessages(CC->room.QRname, &msgnum, 1, "");
721 /* Free the memory we allocated and return a response. */
722 icalcomponent_free(ird.cal);
727 cprintf("%d No calendar object found\n", ERROR + ROOM_NOT_FOUND);
731 /* should never get here */
736 * Search for a property in both the top level and in a VEVENT subcomponent
738 icalproperty *ical_ctdl_get_subprop(
740 icalproperty_kind which_prop
745 p = icalcomponent_get_first_property(cal, which_prop);
747 c = icalcomponent_get_first_component(cal,
748 ICAL_VEVENT_COMPONENT);
750 p = icalcomponent_get_first_property(c, which_prop);
758 * Check to see if two events overlap. Returns nonzero if they do.
759 * (This function is used in both Citadel and WebCit. If you change it in
760 * one place, change it in the other. Better yet, put it in a library.)
762 int ical_ctdl_is_overlap(
763 struct icaltimetype t1start,
764 struct icaltimetype t1end,
765 struct icaltimetype t2start,
766 struct icaltimetype t2end
768 if (icaltime_is_null_time(t1start)) return(0);
769 if (icaltime_is_null_time(t2start)) return(0);
771 /* if either event lacks end time, assume end = start */
772 if (icaltime_is_null_time(t1end))
773 memcpy(&t1end, &t1start, sizeof(struct icaltimetype));
775 if (t1end.is_date && icaltime_compare(t1start, t1end)) {
777 * the end date is non-inclusive so adjust it by one
778 * day because our test is inclusive, note that a day is
779 * not too much because we are talking about all day
781 * if start = end we assume that nevertheless the whole
784 icaltime_adjust(&t1end, -1, 0, 0, 0);
788 if (icaltime_is_null_time(t2end))
789 memcpy(&t2end, &t2start, sizeof(struct icaltimetype));
791 if (t2end.is_date && icaltime_compare(t2start, t2end)) {
792 icaltime_adjust(&t2end, -1, 0, 0, 0);
796 /* First, check for all-day events */
797 if (t1start.is_date || t2start.is_date) {
798 /* If event 1 ends before event 2 starts, we're in the clear. */
799 if (icaltime_compare_date_only(t1end, t2start) < 0) return(0);
801 /* If event 2 ends before event 1 starts, we're also ok. */
802 if (icaltime_compare_date_only(t2end, t1start) < 0) return(0);
807 /* syslog(LOG_DEBUG, "Comparing t1start %d:%d t1end %d:%d t2start %d:%d t2end %d:%d",
808 t1start.hour, t1start.minute, t1end.hour, t1end.minute,
809 t2start.hour, t2start.minute, t2end.hour, t2end.minute);
812 /* Now check for overlaps using date *and* time. */
814 /* If event 1 ends before event 2 starts, we're in the clear. */
815 if (icaltime_compare(t1end, t2start) <= 0) return(0);
816 /* syslog(LOG_DEBUG, "calendar: first passed"); */
818 /* If event 2 ends before event 1 starts, we're also ok. */
819 if (icaltime_compare(t2end, t1start) <= 0) return(0);
820 /* syslog(LOG_DEBUG, "calendar: second passed"); */
822 /* Otherwise, they overlap. */
828 * Phase 6 of "hunt for conflicts"
829 * called by ical_conflicts_phase5()
831 * Now both the proposed and existing events have been boiled down to start and end times.
832 * Check for overlap and output any conflicts.
834 * Returns nonzero if a conflict was reported. This allows the caller to stop iterating.
836 int ical_conflicts_phase6(struct icaltimetype t1start,
837 struct icaltimetype t1end,
838 struct icaltimetype t2start,
839 struct icaltimetype t2end,
840 long existing_msgnum,
841 char *conflict_event_uid,
842 char *conflict_event_summary,
845 int conflict_reported = 0;
849 tt = icaltime_as_timet_with_zone(t1start, t1start.zone);
850 syslog(LOG_DEBUG, "PROPOSED START: %s", ctime(&tt));
851 tt = icaltime_as_timet_with_zone(t1end, t1end.zone);
852 syslog(LOG_DEBUG, " PROPOSED END: %s", ctime(&tt));
853 tt = icaltime_as_timet_with_zone(t2start, t2start.zone);
854 syslog(LOG_DEBUG, "EXISTING START: %s", ctime(&tt));
855 tt = icaltime_as_timet_with_zone(t2end, t2end.zone);
856 syslog(LOG_DEBUG, " EXISTING END: %s", ctime(&tt));
859 /* compare and output */
861 if (ical_ctdl_is_overlap(t1start, t1end, t2start, t2end)) {
862 cprintf("%ld||%s|%s|%d|\n",
865 conflict_event_summary,
866 ( (!IsEmptyStr(compare_uid)
867 &&(!strcasecmp(compare_uid,
868 conflict_event_uid))) ? 1 : 0
871 conflict_reported = 1;
874 return(conflict_reported);
879 * Phase 5 of "hunt for conflicts"
880 * Called by ical_conflicts_phase4()
882 * We have the proposed event boiled down to start and end times.
883 * Now check it against an existing event.
885 void ical_conflicts_phase5(struct icaltimetype t1start,
886 struct icaltimetype t1end,
887 icalcomponent *existing_event,
888 long existing_msgnum,
891 char conflict_event_uid[SIZ];
892 char conflict_event_summary[SIZ];
893 struct icaltimetype t2start, t2end;
896 /* recur variables */
897 icalproperty *rrule = NULL;
898 struct icalrecurrencetype recur;
899 icalrecur_iterator *ritr = NULL;
900 struct icaldurationtype dur;
904 strcpy(conflict_event_uid, "");
905 strcpy(conflict_event_summary, "");
906 t2start = icaltime_null_time();
907 t2end = icaltime_null_time();
909 /* existing event stuff */
910 p = ical_ctdl_get_subprop(existing_event, ICAL_DTSTART_PROPERTY);
911 if (p == NULL) return;
912 if (p != NULL) t2start = icalproperty_get_dtstart(p);
913 if (icaltime_is_utc(t2start)) {
914 t2start.zone = icaltimezone_get_utc_timezone();
917 t2start.zone = icalcomponent_get_timezone(existing_event,
918 icalparameter_get_tzid(
919 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
923 t2start.zone = get_default_icaltimezone();
927 p = ical_ctdl_get_subprop(existing_event, ICAL_DTEND_PROPERTY);
929 t2end = icalproperty_get_dtend(p);
931 if (icaltime_is_utc(t2end)) {
932 t2end.zone = icaltimezone_get_utc_timezone();
935 t2end.zone = icalcomponent_get_timezone(existing_event,
936 icalparameter_get_tzid(
937 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
941 t2end.zone = get_default_icaltimezone();
944 dur = icaltime_subtract(t2end, t2start);
947 memset (&dur, 0, sizeof(struct icaldurationtype));
950 rrule = ical_ctdl_get_subprop(existing_event, ICAL_RRULE_PROPERTY);
952 recur = icalproperty_get_rrule(rrule);
953 ritr = icalrecur_iterator_new(recur, t2start);
957 p = ical_ctdl_get_subprop(existing_event, ICAL_UID_PROPERTY);
959 strcpy(conflict_event_uid, icalproperty_get_comment(p));
962 p = ical_ctdl_get_subprop(existing_event, ICAL_SUMMARY_PROPERTY);
964 strcpy(conflict_event_summary, icalproperty_get_comment(p));
967 if (ical_conflicts_phase6(t1start, t1end, t2start, t2end,
968 existing_msgnum, conflict_event_uid, conflict_event_summary, compare_uid))
970 num_recur = MAX_RECUR + 1; /* force it out of scope, no need to continue */
974 t2start = icalrecur_iterator_next(ritr);
975 if (!icaltime_is_null_time(t2end)) {
976 const icaltimezone *hold_zone = t2end.zone;
977 t2end = icaltime_add(t2start, dur);
978 t2end.zone = hold_zone;
983 if (icaltime_compare(t2start, t1end) < 0) {
984 num_recur = MAX_RECUR + 1; /* force it out of scope */
987 } while ( (rrule) && (!icaltime_is_null_time(t2start)) && (num_recur < MAX_RECUR) );
988 icalrecur_iterator_free(ritr);
993 * Phase 4 of "hunt for conflicts"
994 * Called by ical_hunt_for_conflicts_backend()
996 * At this point we've got it boiled down to two icalcomponent events in memory.
997 * If they conflict, output something to the client.
999 void ical_conflicts_phase4(icalcomponent *proposed_event,
1000 icalcomponent *existing_event,
1001 long existing_msgnum)
1003 struct icaltimetype t1start, t1end;
1005 char compare_uid[SIZ];
1007 /* recur variables */
1008 icalproperty *rrule = NULL;
1009 struct icalrecurrencetype recur;
1010 icalrecur_iterator *ritr = NULL;
1011 struct icaldurationtype dur;
1014 /* initialization */
1015 t1end = icaltime_null_time();
1016 *compare_uid = '\0';
1018 /* proposed event stuff */
1020 p = ical_ctdl_get_subprop(proposed_event, ICAL_DTSTART_PROPERTY);
1024 t1start = icalproperty_get_dtstart(p);
1026 if (icaltime_is_utc(t1start)) {
1027 t1start.zone = icaltimezone_get_utc_timezone();
1030 t1start.zone = icalcomponent_get_timezone(proposed_event,
1031 icalparameter_get_tzid(
1032 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
1035 if (!t1start.zone) {
1036 t1start.zone = get_default_icaltimezone();
1040 p = ical_ctdl_get_subprop(proposed_event, ICAL_DTEND_PROPERTY);
1042 t1end = icalproperty_get_dtend(p);
1044 if (icaltime_is_utc(t1end)) {
1045 t1end.zone = icaltimezone_get_utc_timezone();
1048 t1end.zone = icalcomponent_get_timezone(proposed_event,
1049 icalparameter_get_tzid(
1050 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
1054 t1end.zone = get_default_icaltimezone();
1058 dur = icaltime_subtract(t1end, t1start);
1061 memset (&dur, 0, sizeof(struct icaldurationtype));
1064 rrule = ical_ctdl_get_subprop(proposed_event, ICAL_RRULE_PROPERTY);
1066 recur = icalproperty_get_rrule(rrule);
1067 ritr = icalrecur_iterator_new(recur, t1start);
1070 p = ical_ctdl_get_subprop(proposed_event, ICAL_UID_PROPERTY);
1072 strcpy(compare_uid, icalproperty_get_comment(p));
1076 ical_conflicts_phase5(t1start, t1end, existing_event, existing_msgnum, compare_uid);
1079 t1start = icalrecur_iterator_next(ritr);
1080 if (!icaltime_is_null_time(t1end)) {
1081 const icaltimezone *hold_zone = t1end.zone;
1082 t1end = icaltime_add(t1start, dur);
1083 t1end.zone = hold_zone;
1088 } while ( (rrule) && (!icaltime_is_null_time(t1start)) && (num_recur < MAX_RECUR) );
1089 icalrecur_iterator_free(ritr);
1094 * Phase 3 of "hunt for conflicts"
1095 * Called by ical_hunt_for_conflicts()
1097 void ical_hunt_for_conflicts_backend(long msgnum, void *data) {
1098 icalcomponent *proposed_event;
1099 struct CtdlMessage *msg = NULL;
1100 struct ical_respond_data ird;
1102 proposed_event = (icalcomponent *)data;
1104 msg = CtdlFetchMessage(msgnum, 1);
1105 if (msg == NULL) return;
1106 memset(&ird, 0, sizeof ird);
1107 strcpy(ird.desired_partnum, "_HUNT_");
1108 mime_parser(CM_RANGE(msg, eMesageText),
1109 *ical_locate_part, /* callback function */
1111 (void *) &ird, /* user data */
1116 if (ird.cal == NULL) return;
1118 ical_conflicts_phase4(proposed_event, ird.cal, msgnum);
1119 icalcomponent_free(ird.cal);
1124 * Phase 2 of "hunt for conflicts" operation.
1125 * At this point we have a calendar object which represents the VEVENT that
1126 * is proposed for addition to the calendar. Now hunt through the user's
1127 * calendar room, and output zero or more existing VEVENTs which conflict
1130 void ical_hunt_for_conflicts(icalcomponent *cal) {
1131 char hold_rm[ROOMNAMELEN];
1133 strcpy(hold_rm, CC->room.QRname); /* save current room */
1135 if (CtdlGetRoom(&CC->room, USERCALENDARROOM) != 0) {
1136 CtdlGetRoom(&CC->room, hold_rm);
1137 cprintf("%d You do not have a calendar.\n", ERROR + ROOM_NOT_FOUND);
1141 cprintf("%d Conflicting events:\n", LISTING_FOLLOWS);
1143 CtdlForEachMessage(MSGS_ALL, 0, NULL,
1146 ical_hunt_for_conflicts_backend,
1151 CtdlGetRoom(&CC->room, hold_rm); /* return to saved room */
1157 * Hunt for conflicts (Phase 1 -- retrieve the object and call Phase 2)
1159 void ical_conflicts(long msgnum, char *partnum) {
1160 struct CtdlMessage *msg = NULL;
1161 struct ical_respond_data ird;
1163 msg = CtdlFetchMessage(msgnum, 1);
1165 cprintf("%d Message %ld not found\n",
1166 ERROR + ILLEGAL_VALUE,
1172 memset(&ird, 0, sizeof ird);
1173 strcpy(ird.desired_partnum, partnum);
1174 mime_parser(CM_RANGE(msg, eMesageText),
1175 *ical_locate_part, /* callback function */
1177 (void *) &ird, /* user data */
1183 if (ird.cal != NULL) {
1184 ical_hunt_for_conflicts(ird.cal);
1185 icalcomponent_free(ird.cal);
1189 cprintf("%d No calendar object found\n", ERROR + ROOM_NOT_FOUND);
1194 * Look for busy time in a VEVENT and add it to the supplied VFREEBUSY.
1196 * fb The VFREEBUSY component to which we are appending
1197 * top_level_cal The top-level VCALENDAR component which contains a VEVENT to be added
1199 void ical_add_to_freebusy(icalcomponent *fb, icalcomponent *top_level_cal) {
1203 struct icalperiodtype this_event_period = icalperiodtype_null_period();
1204 icaltimetype dtstart;
1207 /* recur variables */
1208 icalproperty *rrule = NULL;
1209 struct icalrecurrencetype recur;
1210 icalrecur_iterator *ritr = NULL;
1211 struct icaldurationtype dur;
1214 if (!top_level_cal) return;
1216 /* Find the VEVENT component containing an event */
1217 cal = icalcomponent_get_first_component(top_level_cal, ICAL_VEVENT_COMPONENT);
1220 /* If this event is not opaque, the user isn't publishing it as
1221 * busy time, so don't bother doing anything else.
1223 p = icalcomponent_get_first_property(cal, ICAL_TRANSP_PROPERTY);
1225 v = icalproperty_get_value(p);
1227 if (icalvalue_get_transp(v) != ICAL_TRANSP_OPAQUE) {
1234 * Now begin calculating the event start and end times.
1236 p = icalcomponent_get_first_property(cal, ICAL_DTSTART_PROPERTY);
1238 dtstart = icalproperty_get_dtstart(p);
1240 if (icaltime_is_utc(dtstart)) {
1241 dtstart.zone = icaltimezone_get_utc_timezone();
1244 dtstart.zone = icalcomponent_get_timezone(top_level_cal,
1245 icalparameter_get_tzid(
1246 icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER)
1249 if (!dtstart.zone) {
1250 dtstart.zone = get_default_icaltimezone();
1254 dtend = icalcomponent_get_dtend(cal);
1255 if (!icaltime_is_null_time(dtend)) {
1256 dur = icaltime_subtract(dtend, dtstart);
1259 memset (&dur, 0, sizeof(struct icaldurationtype));
1262 /* Is a recurrence specified? If so, get ready to process it... */
1263 rrule = ical_ctdl_get_subprop(cal, ICAL_RRULE_PROPERTY);
1265 recur = icalproperty_get_rrule(rrule);
1266 ritr = icalrecur_iterator_new(recur, dtstart);
1270 /* Convert the DTSTART and DTEND properties to an icalperiod. */
1271 this_event_period.start = dtstart;
1273 if (!icaltime_is_null_time(dtend)) {
1274 this_event_period.end = dtend;
1277 /* Convert the timestamps to UTC. It's ok to do this because we've already expanded
1278 * recurrences and this data is never going to get used again.
1280 this_event_period.start = icaltime_convert_to_zone(
1281 this_event_period.start,
1282 icaltimezone_get_utc_timezone()
1284 this_event_period.end = icaltime_convert_to_zone(
1285 this_event_period.end,
1286 icaltimezone_get_utc_timezone()
1290 icalcomponent_add_property(fb, icalproperty_new_freebusy(this_event_period));
1292 /* Make sure the DTSTART property of the freebusy *list* is set to
1293 * the DTSTART property of the *earliest event*.
1295 p = icalcomponent_get_first_property(fb, ICAL_DTSTART_PROPERTY);
1297 icalcomponent_set_dtstart(fb, this_event_period.start);
1300 if (icaltime_compare(this_event_period.start, icalcomponent_get_dtstart(fb)) < 0) {
1301 icalcomponent_set_dtstart(fb, this_event_period.start);
1305 /* Make sure the DTEND property of the freebusy *list* is set to
1306 * the DTEND property of the *latest event*.
1308 p = icalcomponent_get_first_property(fb, ICAL_DTEND_PROPERTY);
1310 icalcomponent_set_dtend(fb, this_event_period.end);
1313 if (icaltime_compare(this_event_period.end, icalcomponent_get_dtend(fb)) > 0) {
1314 icalcomponent_set_dtend(fb, this_event_period.end);
1319 dtstart = icalrecur_iterator_next(ritr);
1320 if (!icaltime_is_null_time(dtend)) {
1321 dtend = icaltime_add(dtstart, dur);
1322 dtend.zone = dtstart.zone;
1327 } while ( (rrule) && (!icaltime_is_null_time(dtstart)) && (num_recur < MAX_RECUR) ) ;
1328 icalrecur_iterator_free(ritr);
1333 * Backend for ical_freebusy()
1335 * This function simply loads the messages in the user's calendar room,
1336 * which contain VEVENTs, then strips them of all non-freebusy data, and
1337 * adds them to the supplied VCALENDAR.
1340 void ical_freebusy_backend(long msgnum, void *data) {
1342 struct CtdlMessage *msg = NULL;
1343 struct ical_respond_data ird;
1345 fb = (icalcomponent *)data; /* User-supplied data will be the VFREEBUSY component */
1347 msg = CtdlFetchMessage(msgnum, 1);
1348 if (msg == NULL) return;
1349 memset(&ird, 0, sizeof ird);
1350 strcpy(ird.desired_partnum, "_HUNT_");
1351 mime_parser(CM_RANGE(msg, eMesageText),
1352 *ical_locate_part, /* callback function */
1354 (void *) &ird, /* user data */
1360 ical_add_to_freebusy(fb, ird.cal); /* Add VEVENT times to VFREEBUSY */
1361 icalcomponent_free(ird.cal);
1367 * Grab another user's free/busy times
1369 void ical_freebusy(char *who) {
1370 struct ctdluser usbuf;
1371 char calendar_room_name[ROOMNAMELEN];
1372 char hold_rm[ROOMNAMELEN];
1373 char *serialized_request = NULL;
1374 icalcomponent *encaps = NULL;
1375 icalcomponent *fb = NULL;
1376 int found_user = (-1);
1377 struct recptypes *recp = NULL;
1382 int config_lines = 0;
1384 /* First try an exact match. */
1385 found_user = CtdlGetUser(&usbuf, who);
1387 /* If not found, try it as an unqualified email address. */
1388 if (found_user != 0) {
1390 recp = validate_recipients(buf, NULL, 0);
1391 syslog(LOG_DEBUG, "calendar: trying <%s>", buf);
1393 if (recp->num_local == 1) {
1394 found_user = CtdlGetUser(&usbuf, recp->recp_local);
1396 free_recipients(recp);
1400 /* If still not found, try it as an address qualified with the
1401 * primary FQDN of this Citadel node.
1403 if (found_user != 0) {
1404 snprintf(buf, sizeof buf, "%s@%s", who, CtdlGetConfigStr("c_fqdn"));
1405 syslog(LOG_DEBUG, "calendar: trying <%s>", buf);
1406 recp = validate_recipients(buf, NULL, 0);
1408 if (recp->num_local == 1) {
1409 found_user = CtdlGetUser(&usbuf, recp->recp_local);
1411 free_recipients(recp);
1415 /* Still not found? Try qualifying it with every domain we
1416 * might have addresses in.
1418 if (found_user != 0) {
1419 config_lines = num_tokens(inetcfg, '\n');
1420 for (i=0; ((i < config_lines) && (found_user != 0)); ++i) {
1421 extract_token(buf, inetcfg, i, '\n', sizeof buf);
1422 extract_token(host, buf, 0, '|', sizeof host);
1423 extract_token(type, buf, 1, '|', sizeof type);
1425 if ( (!strcasecmp(type, "localhost"))
1426 || (!strcasecmp(type, "directory")) ) {
1427 snprintf(buf, sizeof buf, "%s@%s", who, host);
1428 syslog(LOG_DEBUG, "calendar: trying <%s>", buf);
1429 recp = validate_recipients(buf, NULL, 0);
1431 if (recp->num_local == 1) {
1432 found_user = CtdlGetUser(&usbuf, recp->recp_local);
1434 free_recipients(recp);
1440 if (found_user != 0) {
1441 cprintf("%d No such user.\n", ERROR + NO_SUCH_USER);
1445 CtdlMailboxName(calendar_room_name, sizeof calendar_room_name,
1446 &usbuf, USERCALENDARROOM);
1448 strcpy(hold_rm, CC->room.QRname); /* save current room */
1450 if (CtdlGetRoom(&CC->room, calendar_room_name) != 0) {
1451 cprintf("%d Cannot open calendar\n", ERROR + ROOM_NOT_FOUND);
1452 CtdlGetRoom(&CC->room, hold_rm);
1456 /* Create a VFREEBUSY subcomponent */
1457 syslog(LOG_DEBUG, "calendar: creating VFREEBUSY component");
1458 fb = icalcomponent_new_vfreebusy();
1460 cprintf("%d Internal error: cannot allocate memory.\n", ERROR + INTERNAL_ERROR);
1461 CtdlGetRoom(&CC->room, hold_rm);
1465 /* Set the method to PUBLISH */
1466 icalcomponent_set_method(fb, ICAL_METHOD_PUBLISH);
1468 /* Set the DTSTAMP to right now. */
1469 icalcomponent_set_dtstamp(fb, icaltime_from_timet_with_zone(time(NULL), 0, icaltimezone_get_utc_timezone()));
1471 /* Add the user's email address as ORGANIZER */
1472 sprintf(buf, "MAILTO:%s", who);
1473 if (strchr(buf, '@') == NULL) {
1475 strcat(buf, CtdlGetConfigStr("c_fqdn"));
1477 for (i=0; buf[i]; ++i) {
1478 if (buf[i]==' ') buf[i] = '_';
1480 icalcomponent_add_property(fb, icalproperty_new_organizer(buf));
1482 /* Add busy time from events */
1483 syslog(LOG_DEBUG, "calendar: adding busy time from events");
1484 CtdlForEachMessage(MSGS_ALL, 0, NULL, NULL, NULL, ical_freebusy_backend, (void *)fb );
1486 /* If values for DTSTART and DTEND are still not present, set them
1487 * to yesterday and tomorrow as default values.
1489 if (icalcomponent_get_first_property(fb, ICAL_DTSTART_PROPERTY) == NULL) {
1490 icalcomponent_set_dtstart(fb, icaltime_from_timet_with_zone(time(NULL)-86400L, 0, icaltimezone_get_utc_timezone()));
1492 if (icalcomponent_get_first_property(fb, ICAL_DTEND_PROPERTY) == NULL) {
1493 icalcomponent_set_dtend(fb, icaltime_from_timet_with_zone(time(NULL)+86400L, 0, icaltimezone_get_utc_timezone()));
1496 /* Put the freebusy component into the calendar component */
1497 syslog(LOG_DEBUG, "calendar: encapsulating");
1498 encaps = ical_encapsulate_subcomponent(fb);
1499 if (encaps == NULL) {
1500 icalcomponent_free(fb);
1501 cprintf("%d Internal error: cannot allocate memory.\n",
1502 ERROR + INTERNAL_ERROR);
1503 CtdlGetRoom(&CC->room, hold_rm);
1507 /* Set the method to PUBLISH */
1508 syslog(LOG_DEBUG, "calendar: setting method");
1509 icalcomponent_set_method(encaps, ICAL_METHOD_PUBLISH);
1512 syslog(LOG_DEBUG, "calendar: serializing");
1513 serialized_request = icalcomponent_as_ical_string_r(encaps);
1514 icalcomponent_free(encaps); /* Don't need this anymore. */
1516 cprintf("%d Free/busy for %s\n", LISTING_FOLLOWS, usbuf.fullname);
1517 if (serialized_request != NULL) {
1518 client_write(serialized_request, strlen(serialized_request));
1519 free(serialized_request);
1523 /* Go back to the room from which we came... */
1524 CtdlGetRoom(&CC->room, hold_rm);
1529 * Backend for ical_getics()
1531 * This is a ForEachMessage() callback function that searches the current room
1532 * for calendar events and adds them each into one big calendar component.
1534 void ical_getics_backend(long msgnum, void *data) {
1535 icalcomponent *encaps, *c;
1536 struct CtdlMessage *msg = NULL;
1537 struct ical_respond_data ird;
1539 encaps = (icalcomponent *)data;
1540 if (encaps == NULL) return;
1542 /* Look for the calendar event... */
1544 msg = CtdlFetchMessage(msgnum, 1);
1545 if (msg == NULL) return;
1546 memset(&ird, 0, sizeof ird);
1547 strcpy(ird.desired_partnum, "_HUNT_");
1548 mime_parser(CM_RANGE(msg, eMesageText),
1549 *ical_locate_part, /* callback function */
1551 (void *) &ird, /* user data */
1556 if (ird.cal == NULL) return;
1558 /* Here we go: put the VEVENT into the VCALENDAR. We now no longer
1559 * are responsible for "the_request"'s memory -- it will be freed
1560 * when we free "encaps".
1563 /* If the top-level component is *not* a VCALENDAR, we can drop it right
1564 * in. This will almost never happen.
1566 if (icalcomponent_isa(ird.cal) != ICAL_VCALENDAR_COMPONENT) {
1567 icalcomponent_add_component(encaps, ird.cal);
1570 * In the more likely event that we're looking at a VCALENDAR with the VEVENT
1571 * and other components encapsulated inside, we have to extract them.
1574 for (c = icalcomponent_get_first_component(ird.cal, ICAL_ANY_COMPONENT);
1576 c = icalcomponent_get_next_component(ird.cal, ICAL_ANY_COMPONENT)) {
1578 /* For VTIMEZONE components, suppress duplicates of the same tzid */
1580 if (icalcomponent_isa(c) == ICAL_VTIMEZONE_COMPONENT) {
1581 icalproperty *p = icalcomponent_get_first_property(c, ICAL_TZID_PROPERTY);
1583 const char *tzid = icalproperty_get_tzid(p);
1584 if (!icalcomponent_get_timezone(encaps, tzid)) {
1585 icalcomponent_add_component(encaps,
1586 icalcomponent_new_clone(c));
1591 /* All other types of components can go in verbatim */
1593 icalcomponent_add_component(encaps, icalcomponent_new_clone(c));
1596 icalcomponent_free(ird.cal);
1602 * Retrieve all of the calendar items in the current room, and output them
1603 * as a single icalendar object.
1605 void ical_getics(void)
1607 icalcomponent *encaps = NULL;
1610 if ( (CC->room.QRdefaultview != VIEW_CALENDAR)
1611 &&(CC->room.QRdefaultview != VIEW_TASKS) ) {
1612 cprintf("%d Not a calendar room\n", ERROR+NOT_HERE);
1613 return; /* Not an iCalendar-centric room */
1616 encaps = icalcomponent_new_vcalendar();
1617 if (encaps == NULL) {
1618 syslog(LOG_ERR, "calendar: could not allocate component!");
1619 cprintf("%d Could not allocate memory\n", ERROR+INTERNAL_ERROR);
1623 cprintf("%d one big calendar\n", LISTING_FOLLOWS);
1625 /* Set the Product ID */
1626 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
1628 /* Set the Version Number */
1629 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
1631 /* Set the method to PUBLISH */
1632 icalcomponent_set_method(encaps, ICAL_METHOD_PUBLISH);
1634 /* Now go through the room encapsulating all calendar items. */
1635 CtdlForEachMessage(MSGS_ALL, 0, NULL,
1638 ical_getics_backend,
1642 ser = icalcomponent_as_ical_string_r(encaps);
1643 icalcomponent_free(encaps); /* Don't need this anymore. */
1644 client_write(ser, strlen(ser));
1651 * Helper callback function for ical_putics() to discover which TZID's we need.
1652 * Simply put the tzid name string into a hash table. After the callbacks are
1653 * done we'll go through them and attach the ones that we have.
1655 void ical_putics_grabtzids(icalparameter *param, void *data)
1657 const char *tzid = icalparameter_get_tzid(param);
1658 HashList *keys = (HashList *) data;
1660 if ( (keys) && (tzid) && (!IsEmptyStr(tzid)) ) {
1661 Put(keys, tzid, strlen(tzid), strdup(tzid), NULL);
1667 * Delete all of the calendar items in the current room, and replace them
1668 * with calendar items from a client-supplied data stream.
1670 void ical_putics(void)
1672 char *calstream = NULL;
1675 icalcomponent *encaps = NULL;
1676 HashList *tzidlist = NULL;
1682 /* Only allow this operation if we're in a room containing a calendar or tasks view */
1683 if ( (CC->room.QRdefaultview != VIEW_CALENDAR)
1684 &&(CC->room.QRdefaultview != VIEW_TASKS) ) {
1685 cprintf("%d Not a calendar room\n", ERROR+NOT_HERE);
1689 /* Only allow this operation if we have permission to overwrite the existing calendar */
1690 if (!CtdlDoIHavePermissionToDeleteMessagesFromThisRoom()) {
1691 cprintf("%d Permission denied.\n", ERROR+HIGHER_ACCESS_REQUIRED);
1695 cprintf("%d Transmit data now\n", SEND_LISTING);
1696 calstream = CtdlReadMessageBody(HKEY("000"), CtdlGetConfigLong("c_maxmsglen"), NULL, 0);
1697 if (calstream == NULL) {
1701 cal = icalcomponent_new_from_string(calstream);
1704 /* We got our data stream -- now do something with it. */
1706 /* Delete the existing messages in the room, because we are overwriting
1707 * the entire calendar with an entire new (or updated) calendar.
1708 * (Careful: this opens an S_ROOMS critical section!)
1710 CtdlDeleteMessages(CC->room.QRname, NULL, 0, "");
1712 /* If the top-level component is *not* a VCALENDAR, we can drop it right
1713 * in. This will almost never happen.
1715 if (icalcomponent_isa(cal) != ICAL_VCALENDAR_COMPONENT) {
1716 ical_write_to_cal(NULL, cal);
1719 * In the more likely event that we're looking at a VCALENDAR with the VEVENT
1720 * and other components encapsulated inside, we have to extract them.
1723 for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
1725 c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)) {
1727 /* Non-VTIMEZONE components each get written as individual messages.
1728 * But we also need to attach the relevant VTIMEZONE components to them.
1730 if ( (icalcomponent_isa(c) != ICAL_VTIMEZONE_COMPONENT)
1731 && (encaps = icalcomponent_new_vcalendar()) ) {
1732 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
1733 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
1734 icalcomponent_set_method(encaps, ICAL_METHOD_PUBLISH);
1736 /* Attach any needed timezones here */
1737 tzidlist = NewHash(1, NULL);
1739 icalcomponent_foreach_tzid(c, ical_putics_grabtzids, tzidlist);
1741 HashPos = GetNewHashPos(tzidlist, 0);
1743 while (GetNextHashPos(tzidlist, HashPos, &len, &Key, &Value)) {
1744 syslog(LOG_DEBUG, "calendar: attaching timezone '%s'", (char*) Value);
1745 icaltimezone *t = NULL;
1747 /* First look for a timezone attached to the original calendar */
1748 t = icalcomponent_get_timezone(cal, Value);
1750 /* Try built-in tzdata if the right one wasn't attached */
1752 t = icaltimezone_get_builtin_timezone(Value);
1755 /* I've got a valid timezone to attach. */
1757 icalcomponent_add_component(encaps,
1758 icalcomponent_new_clone(
1759 icaltimezone_get_component(t)
1765 DeleteHashPos(&HashPos);
1766 DeleteHash(&tzidlist);
1768 /* Now attach the component itself (usually a VEVENT or VTODO) */
1769 icalcomponent_add_component(encaps, icalcomponent_new_clone(c));
1771 /* Write it to the message store */
1772 ical_write_to_cal(NULL, encaps);
1773 icalcomponent_free(encaps);
1778 icalcomponent_free(cal);
1783 * All Citadel calendar commands from the client come through here.
1785 void cmd_ical(char *argbuf)
1793 extract_token(subcmd, argbuf, 0, '|', sizeof subcmd);
1795 /* Allow "test" and "freebusy" subcommands without logging in. */
1797 if (!strcasecmp(subcmd, "test")) {
1798 cprintf("%d This server supports calendaring\n", CIT_OK);
1802 if (!strcasecmp(subcmd, "freebusy")) {
1803 extract_token(who, argbuf, 1, '|', sizeof who);
1808 if (!strcasecmp(subcmd, "sgi")) {
1809 CIT_ICAL->server_generated_invitations = (extract_int(argbuf, 1) ? 1 : 0) ;
1810 cprintf("%d %d\n", CIT_OK, CIT_ICAL->server_generated_invitations);
1814 if (CtdlAccessCheck(ac_logged_in)) return;
1816 if (!strcasecmp(subcmd, "respond")) {
1817 msgnum = extract_long(argbuf, 1);
1818 extract_token(partnum, argbuf, 2, '|', sizeof partnum);
1819 extract_token(action, argbuf, 3, '|', sizeof action);
1820 ical_respond(msgnum, partnum, action);
1824 if (!strcasecmp(subcmd, "handle_rsvp")) {
1825 msgnum = extract_long(argbuf, 1);
1826 extract_token(partnum, argbuf, 2, '|', sizeof partnum);
1827 extract_token(action, argbuf, 3, '|', sizeof action);
1828 ical_handle_rsvp(msgnum, partnum, action);
1832 if (!strcasecmp(subcmd, "conflicts")) {
1833 msgnum = extract_long(argbuf, 1);
1834 extract_token(partnum, argbuf, 2, '|', sizeof partnum);
1835 ical_conflicts(msgnum, partnum);
1839 if (!strcasecmp(subcmd, "getics")) {
1844 if (!strcasecmp(subcmd, "putics")) {
1849 cprintf("%d Invalid subcommand\n", ERROR + CMD_NOT_SUPPORTED);
1854 * We don't know if the calendar room exists so we just create it at login
1856 void ical_CtdlCreateRoom(void)
1861 /* Create the calendar room if it doesn't already exist */
1862 CtdlCreateRoom(USERCALENDARROOM, 4, "", 0, 1, 0, VIEW_CALENDAR);
1864 /* Set expiration policy to manual; otherwise objects will be lost! */
1865 if (CtdlGetRoomLock(&qr, USERCALENDARROOM)) {
1866 syslog(LOG_ERR, "calendar: couldn't get the user calendar room");
1869 qr.QRep.expire_mode = EXPIRE_MANUAL;
1870 qr.QRdefaultview = VIEW_CALENDAR; /* 3 = calendar view */
1871 CtdlPutRoomLock(&qr);
1873 /* Set the view to a calendar view */
1874 CtdlGetRelationship(&vbuf, &CC->user, &qr);
1875 vbuf.v_view = VIEW_CALENDAR;
1876 CtdlSetRelationship(&vbuf, &CC->user, &qr);
1878 /* Create the tasks list room if it doesn't already exist */
1879 CtdlCreateRoom(USERTASKSROOM, 4, "", 0, 1, 0, VIEW_TASKS);
1881 /* Set expiration policy to manual; otherwise objects will be lost! */
1882 if (CtdlGetRoomLock(&qr, USERTASKSROOM)) {
1883 syslog(LOG_ERR, "calendar: couldn't get the user calendar room!");
1886 qr.QRep.expire_mode = EXPIRE_MANUAL;
1887 qr.QRdefaultview = VIEW_TASKS;
1888 CtdlPutRoomLock(&qr);
1890 /* Set the view to a task list view */
1891 CtdlGetRelationship(&vbuf, &CC->user, &qr);
1892 vbuf.v_view = VIEW_TASKS;
1893 CtdlSetRelationship(&vbuf, &CC->user, &qr);
1895 /* Create the notes room if it doesn't already exist */
1896 CtdlCreateRoom(USERNOTESROOM, 4, "", 0, 1, 0, VIEW_NOTES);
1898 /* Set expiration policy to manual; otherwise objects will be lost! */
1899 if (CtdlGetRoomLock(&qr, USERNOTESROOM)) {
1900 syslog(LOG_ERR, "calendar: couldn't get the user calendar room!");
1903 qr.QRep.expire_mode = EXPIRE_MANUAL;
1904 qr.QRdefaultview = VIEW_NOTES;
1905 CtdlPutRoomLock(&qr);
1907 /* Set the view to a notes view */
1908 CtdlGetRelationship(&vbuf, &CC->user, &qr);
1909 vbuf.v_view = VIEW_NOTES;
1910 CtdlSetRelationship(&vbuf, &CC->user, &qr);
1917 * ical_send_out_invitations() is called by ical_saving_vevent() when it finds a VEVENT.
1919 * top_level_cal is the highest available level calendar object.
1920 * cal is the subcomponent containing the VEVENT.
1922 * Note: if you change the encapsulation code here, change it in WebCit's ical_encapsulate_subcomponent()
1924 void ical_send_out_invitations(icalcomponent *top_level_cal, icalcomponent *cal) {
1925 icalcomponent *the_request = NULL;
1926 char *serialized_request = NULL;
1927 icalcomponent *encaps = NULL;
1928 char *request_message_text = NULL;
1929 struct CtdlMessage *msg = NULL;
1930 struct recptypes *valid = NULL;
1931 char attendees_string[SIZ];
1932 int num_attendees = 0;
1933 char this_attendee[256];
1934 icalproperty *attendee = NULL;
1935 char summary_string[SIZ];
1936 icalproperty *summary = NULL;
1939 struct icaltimetype t;
1940 const icaltimezone *attached_zones[5] = { NULL, NULL, NULL, NULL, NULL };
1942 const icaltimezone *z;
1943 int num_zones_attached = 0;
1944 int zone_already_attached;
1945 icalparameter *tzidp = NULL;
1946 const char *tzidc = NULL;
1949 syslog(LOG_ERR, "calendar: trying to reply to NULL event?");
1953 /* If this is a VCALENDAR component, look for a VEVENT subcomponent. */
1954 if (icalcomponent_isa(cal) == ICAL_VCALENDAR_COMPONENT) {
1955 ical_send_out_invitations(top_level_cal,
1956 icalcomponent_get_first_component(
1957 cal, ICAL_VEVENT_COMPONENT
1963 /* Clone the event */
1964 the_request = icalcomponent_new_clone(cal);
1965 if (the_request == NULL) {
1966 syslog(LOG_ERR, "calendar: cannot clone calendar object");
1970 /* Extract the summary string -- we'll use it as the
1971 * message subject for the request
1973 strcpy(summary_string, "Meeting request");
1974 summary = icalcomponent_get_first_property(the_request, ICAL_SUMMARY_PROPERTY);
1975 if (summary != NULL) {
1976 if (icalproperty_get_summary(summary)) {
1977 strcpy(summary_string,
1978 icalproperty_get_summary(summary) );
1982 /* Determine who the recipients of this message are (the attendees) */
1983 strcpy(attendees_string, "");
1984 for (attendee = icalcomponent_get_first_property(the_request, ICAL_ATTENDEE_PROPERTY); attendee != NULL; attendee = icalcomponent_get_next_property(the_request, ICAL_ATTENDEE_PROPERTY)) {
1985 const char *ch = icalproperty_get_attendee(attendee);
1986 if ((ch != NULL) && !strncasecmp(ch, "MAILTO:", 7)) {
1987 safestrncpy(this_attendee, ch + 7, sizeof(this_attendee));
1989 if (!CtdlIsMe(this_attendee, sizeof this_attendee)) { /* don't send an invitation to myself! */
1990 snprintf(&attendees_string[strlen(attendees_string)],
1991 sizeof(attendees_string) - strlen(attendees_string),
2000 syslog(LOG_DEBUG, "calendar: <%d> attendees: <%s>", num_attendees, attendees_string);
2002 /* If there are no attendees, there are no invitations to send, so...
2003 * don't bother putting one together! Punch out, Maverick!
2005 if (num_attendees == 0) {
2006 icalcomponent_free(the_request);
2010 /* Encapsulate the VEVENT component into a complete VCALENDAR */
2011 encaps = icalcomponent_new_vcalendar();
2012 if (encaps == NULL) {
2013 syslog(LOG_ERR, "calendar: could not allocate component!");
2014 icalcomponent_free(the_request);
2018 /* Set the Product ID */
2019 icalcomponent_add_property(encaps, icalproperty_new_prodid(PRODID));
2021 /* Set the Version Number */
2022 icalcomponent_add_property(encaps, icalproperty_new_version("2.0"));
2024 /* Set the method to REQUEST */
2025 icalcomponent_set_method(encaps, ICAL_METHOD_REQUEST);
2027 /* Look for properties containing timezone parameters, to see if we need to attach VTIMEZONEs */
2028 for (p = icalcomponent_get_first_property(the_request, ICAL_ANY_PROPERTY);
2030 p = icalcomponent_get_next_property(the_request, ICAL_ANY_PROPERTY))
2032 if ( (icalproperty_isa(p) == ICAL_COMPLETED_PROPERTY)
2033 || (icalproperty_isa(p) == ICAL_CREATED_PROPERTY)
2034 || (icalproperty_isa(p) == ICAL_DATEMAX_PROPERTY)
2035 || (icalproperty_isa(p) == ICAL_DATEMIN_PROPERTY)
2036 || (icalproperty_isa(p) == ICAL_DTEND_PROPERTY)
2037 || (icalproperty_isa(p) == ICAL_DTSTAMP_PROPERTY)
2038 || (icalproperty_isa(p) == ICAL_DTSTART_PROPERTY)
2039 || (icalproperty_isa(p) == ICAL_DUE_PROPERTY)
2040 || (icalproperty_isa(p) == ICAL_EXDATE_PROPERTY)
2041 || (icalproperty_isa(p) == ICAL_LASTMODIFIED_PROPERTY)
2042 || (icalproperty_isa(p) == ICAL_MAXDATE_PROPERTY)
2043 || (icalproperty_isa(p) == ICAL_MINDATE_PROPERTY)
2044 || (icalproperty_isa(p) == ICAL_RECURRENCEID_PROPERTY)
2046 t = icalproperty_get_dtstart(p); // it's safe to use dtstart for all of them
2048 /* Determine the tzid in order for some of the conditions below to work */
2049 tzidp = icalproperty_get_first_parameter(p, ICAL_TZID_PARAMETER);
2051 tzidc = icalparameter_get_tzid(tzidp);
2057 /* First see if there's a timezone attached to the data structure itself */
2058 if (icaltime_is_utc(t)) {
2059 z = icaltimezone_get_utc_timezone();
2062 z = icaltime_get_timezone(t);
2065 /* If not, try to determine the tzid from the parameter using attached zones */
2066 if ((!z) && (tzidc)) {
2067 z = icalcomponent_get_timezone(top_level_cal, tzidc);
2070 /* Still no good? Try our internal database */
2071 if ((!z) && (tzidc)) {
2072 z = icaltimezone_get_builtin_timezone_from_tzid(tzidc);
2076 /* We have a valid timezone. Good. Now we need to attach it. */
2078 zone_already_attached = 0;
2079 for (i=0; i<5; ++i) {
2080 if (z == attached_zones[i]) {
2081 /* We've already got this one, no need to attach another. */
2082 ++zone_already_attached;
2085 if ((!zone_already_attached) && (num_zones_attached < 5)) {
2086 /* This is a new one, so attach it. */
2087 attached_zones[num_zones_attached++] = z;
2090 icalproperty_set_parameter(p, icalparameter_new_tzid(icaltimezone_get_tzid(z))
2096 /* Encapsulate any timezones we need */
2097 if (num_zones_attached > 0) for (i=0; i<num_zones_attached; ++i) {
2099 zc = icalcomponent_new_clone(icaltimezone_get_component(attached_zones[i]));
2100 icalcomponent_add_component(encaps, zc);
2103 /* Here we go: encapsulate the VEVENT into the VCALENDAR. We now no longer
2104 * are responsible for "the_request"'s memory -- it will be freed
2105 * when we free "encaps".
2107 icalcomponent_add_component(encaps, the_request);
2110 serialized_request = icalcomponent_as_ical_string_r(encaps);
2111 icalcomponent_free(encaps); /* Don't need this anymore. */
2112 if (serialized_request == NULL) return;
2114 reqsize = strlen(serialized_request) + SIZ;
2115 request_message_text = malloc(reqsize);
2116 if (request_message_text != NULL) {
2117 snprintf(request_message_text, reqsize,
2118 "Content-type: text/calendar\r\n\r\n%s\r\n",
2122 msg = CtdlMakeMessage(
2124 NULL, /* No single recipient here */
2125 NULL, /* No single recipient here */
2131 summary_string, /* Use summary for subject */
2133 request_message_text,
2138 valid = validate_recipients(attendees_string, NULL, 0);
2139 CtdlSubmitMsg(msg, valid, "");
2141 free_recipients(valid);
2144 free(serialized_request);
2149 * When a calendar object is being saved, determine whether it's a VEVENT
2150 * and the user saving it is the organizer. If so, send out invitations
2151 * to any listed attendees.
2153 * This function is recursive. The caller can simply supply the same object
2154 * as both arguments. When it recurses it will alter the second argument
2155 * while holding on to the top level object. This allows us to go back and
2156 * grab things like time zones which might be attached.
2159 void ical_saving_vevent(icalcomponent *top_level_cal, icalcomponent *cal) {
2161 icalproperty *organizer = NULL;
2162 char organizer_string[SIZ];
2164 syslog(LOG_DEBUG, "calendar: ical_saving_vevent() has been called");
2166 /* Don't send out invitations unless the client wants us to. */
2167 if (CIT_ICAL->server_generated_invitations == 0) {
2171 /* Don't send out invitations if we've been asked not to. */
2172 if (CIT_ICAL->avoid_sending_invitations > 0) {
2176 strcpy(organizer_string, "");
2178 * The VEVENT subcomponent is the one we're interested in.
2179 * Send out invitations if, and only if, this user is the Organizer.
2181 if (icalcomponent_isa(cal) == ICAL_VEVENT_COMPONENT) {
2182 organizer = icalcomponent_get_first_property(cal, ICAL_ORGANIZER_PROPERTY);
2183 if (organizer != NULL) {
2184 if (icalproperty_get_organizer(organizer)) {
2185 strcpy(organizer_string,
2186 icalproperty_get_organizer(organizer));
2189 if (!strncasecmp(organizer_string, "MAILTO:", 7)) {
2190 strcpy(organizer_string, &organizer_string[7]);
2191 string_trim(organizer_string);
2193 * If the user saving the event is listed as the
2194 * organizer, then send out invitations.
2196 if (CtdlIsMe(organizer_string, sizeof organizer_string)) {
2197 ical_send_out_invitations(top_level_cal, cal);
2202 /* If the component has subcomponents, recurse through them. */
2203 for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
2205 c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)) {
2206 /* Recursively process subcomponent */
2207 ical_saving_vevent(top_level_cal, c);
2214 * Back end for ical_obj_beforesave()
2215 * This hunts for the UID of the calendar event (becomes Citadel msg EUID),
2216 * the summary of the event (becomes message subject),
2217 * and the start time (becomes message date/time).
2219 void ical_obj_beforesave_backend(char *name, char *filename, char *partnum,
2220 char *disp, void *content, char *cbtype, char *cbcharset, size_t length,
2221 char *encoding, char *cbid, void *cbuserdata)
2224 icalcomponent *cal, *nested_event, *nested_todo, *whole_cal;
2226 char new_uid[256] = "";
2227 struct CtdlMessage *msg = (struct CtdlMessage *) cbuserdata;
2231 /* We're only interested in calendar data. */
2232 if ( (strcasecmp(cbtype, "text/calendar"))
2233 && (strcasecmp(cbtype, "application/ics")) ) {
2237 /* Hunt for the UID and drop it in
2238 * the "user data" pointer for the MIME parser. When
2239 * ical_obj_beforesave() sees it there, it'll set the Exclusive msgid
2242 whole_cal = icalcomponent_new_from_string(content);
2245 if (icalcomponent_isa(cal) == ICAL_VCALENDAR_COMPONENT) {
2246 nested_event = icalcomponent_get_first_component(
2247 cal, ICAL_VEVENT_COMPONENT);
2248 if (nested_event != NULL) {
2252 nested_todo = icalcomponent_get_first_component(
2253 cal, ICAL_VTODO_COMPONENT);
2254 if (nested_todo != NULL) {
2262 /* Set the message EUID to the iCalendar UID */
2264 p = ical_ctdl_get_subprop(cal, ICAL_UID_PROPERTY);
2266 /* If there's no uid we must generate one */
2267 generate_uuid(new_uid);
2268 icalcomponent_add_property(cal, icalproperty_new_uid(new_uid));
2269 p = ical_ctdl_get_subprop(cal, ICAL_UID_PROPERTY);
2272 pch = icalproperty_get_comment(p);
2273 if (!IsEmptyStr(pch)) {
2274 CM_SetField(msg, eExclusiveID, pch);
2275 syslog(LOG_DEBUG, "calendar: saving calendar UID <%s>", pch);
2279 /* Set the message subject to the iCalendar summary */
2281 p = ical_ctdl_get_subprop(cal, ICAL_SUMMARY_PROPERTY);
2283 pch = icalproperty_get_comment(p);
2284 if (!IsEmptyStr(pch)) {
2287 subj = rfc2047encode(pch, strlen(pch));
2288 CM_SetAsField(msg, eMsgSubject, &subj, strlen(subj));
2292 /* Set the message date/time to the iCalendar start time */
2294 p = ical_ctdl_get_subprop(cal, ICAL_DTSTART_PROPERTY);
2297 idtstart = icaltime_as_timet(icalproperty_get_dtstart(p));
2299 CM_SetFieldLONG(msg, eTimestamp, idtstart);
2304 icalcomponent_free(cal);
2305 if (whole_cal != cal) {
2306 icalcomponent_free(whole_cal);
2313 * See if we need to prevent the object from being saved (we don't allow
2314 * MIME types other than text/calendar in "calendar" or "tasks" rooms).
2316 * If the message is being saved, we also set various message header fields
2317 * using data found in the iCalendar object.
2319 int ical_obj_beforesave(struct CtdlMessage *msg, struct recptypes *recp)
2321 /* First determine if this is a calendar or tasks room */
2322 if ( (CC->room.QRdefaultview != VIEW_CALENDAR)
2323 && (CC->room.QRdefaultview != VIEW_TASKS)
2325 return(0); /* Not an iCalendar-centric room */
2328 /* It must be an RFC822 message! */
2329 if (msg->cm_format_type != 4) {
2330 syslog(LOG_DEBUG, "calendar: rejecting non-RFC822 message");
2331 return(1); /* You tried to save a non-RFC822 message! */
2334 if (CM_IsEmpty(msg, eMesageText)) {
2335 return(1); /* You tried to save a null message! */
2338 /* Do all of our lovely back-end parsing */
2339 mime_parser(CM_RANGE(msg, eMesageText),
2340 *ical_obj_beforesave_backend,
2351 * Things we need to do after saving a calendar event.
2353 void ical_obj_aftersave_backend(char *name, char *filename, char *partnum,
2354 char *disp, void *content, char *cbtype, char *cbcharset, size_t length,
2355 char *encoding, char *cbid, void *cbuserdata)
2359 /* We're only interested in calendar items here. */
2360 if ( (strcasecmp(cbtype, "text/calendar"))
2361 && (strcasecmp(cbtype, "application/ics")) ) {
2365 /* Hunt for the UID and drop it in
2366 * the "user data" pointer for the MIME parser. When
2367 * ical_obj_beforesave() sees it there, it'll set the Exclusive msgid
2370 if ( (!strcasecmp(cbtype, "text/calendar"))
2371 || (!strcasecmp(cbtype, "application/ics")) ) {
2372 cal = icalcomponent_new_from_string(content);
2374 ical_saving_vevent(cal, cal);
2375 icalcomponent_free(cal);
2382 * Things we need to do after saving a calendar event.
2383 * (This will start back end tasks such as automatic generation of invitations,
2384 * if such actions are appropriate.)
2386 int ical_obj_aftersave(struct CtdlMessage *msg, struct recptypes *recp)
2388 char roomname[ROOMNAMELEN];
2391 * If this isn't the Calendar> room, no further action is necessary.
2394 /* First determine if this is our room */
2395 CtdlMailboxName(roomname, sizeof roomname, &CC->user, USERCALENDARROOM);
2396 if (strcasecmp(roomname, CC->room.QRname)) {
2397 return(0); /* Not the Calendar room -- don't do anything. */
2400 // It must be an RFC822 message!
2401 if (msg->cm_format_type != 4) return(1);
2403 // Reject null messages
2404 if (CM_IsEmpty(msg, eMesageText)) return(1);
2406 // Now recurse through it looking for our icalendar data
2407 mime_parser(CM_RANGE(msg, eMesageText),
2408 *ical_obj_aftersave_backend,
2418 void ical_session_startup(void) {
2419 CIT_ICAL = malloc(sizeof(struct cit_ical));
2420 memset(CIT_ICAL, 0, sizeof(struct cit_ical));
2424 void ical_session_shutdown(void) {
2429 // Back end for ical_fixed_output()
2430 void ical_fixed_output_backend(icalcomponent *cal, int recursion_level) {
2436 p = icalcomponent_get_first_property(cal, ICAL_SUMMARY_PROPERTY);
2438 cprintf("%s\n", (const char *)icalproperty_get_comment(p));
2441 p = icalcomponent_get_first_property(cal, ICAL_LOCATION_PROPERTY);
2443 cprintf("%s\n", (const char *)icalproperty_get_comment(p));
2446 p = icalcomponent_get_first_property(cal, ICAL_DESCRIPTION_PROPERTY);
2448 cprintf("%s\n", (const char *)icalproperty_get_comment(p));
2451 // If the component has attendees, iterate through them.
2452 for (p = icalcomponent_get_first_property(cal, ICAL_ATTENDEE_PROPERTY); (p != NULL); p = icalcomponent_get_next_property(cal, ICAL_ATTENDEE_PROPERTY)) {
2453 ch = icalproperty_get_attendee(p);
2455 !strncasecmp(ch, "MAILTO:", 7)) {
2457 // screen name or email address
2458 safestrncpy(buf, ch + 7, sizeof(buf));
2460 cprintf("%s ", buf);
2465 // If the component has subcomponents, recurse through them.
2466 for (c = icalcomponent_get_first_component(cal, ICAL_ANY_COMPONENT);
2468 c = icalcomponent_get_next_component(cal, ICAL_ANY_COMPONENT)) {
2469 // Recursively process subcomponent
2470 ical_fixed_output_backend(c, recursion_level+1);
2475 // Function to output iCalendar data as plain text. Nobody uses MSG0
2476 // anymore, so really this is just so we expose the vCard data to the full
2478 void ical_fixed_output(char *ptr, int len) {
2482 stringy_cal = malloc(len + 1);
2483 safestrncpy(stringy_cal, ptr, len + 1);
2484 cal = icalcomponent_new_from_string(stringy_cal);
2491 ical_fixed_output_backend(cal, 0);
2493 // Free the memory we obtained from libical's constructor
2494 icalcomponent_free(cal);
2498 // Initialization function, called from modules_init.c
2499 char *ctdl_module_init_calendar(void) {
2502 // Tell libical to return errors instead of aborting if it gets bad data.
2503 // If this library call is not found, you need to upgrade libical.
2504 icalerror_set_errors_are_fatal(0);
2506 // Use our own application prefix in tzid's generated from system tzdata
2507 icaltimezone_set_tzid_prefix("/citadel.org/");
2509 // Initialize our hook functions
2510 CtdlRegisterMessageHook(ical_obj_beforesave, EVT_BEFORESAVE);
2511 CtdlRegisterMessageHook(ical_obj_aftersave, EVT_AFTERSAVE);
2512 CtdlRegisterSessionHook(ical_CtdlCreateRoom, EVT_LOGIN, PRIO_LOGIN + 1);
2513 CtdlRegisterProtoHook(cmd_ical, "ICAL", "Citadel iCalendar commands");
2514 CtdlRegisterSessionHook(ical_session_startup, EVT_START, PRIO_START + 1);
2515 CtdlRegisterSessionHook(ical_session_shutdown, EVT_STOP, PRIO_STOP + 80);
2516 CtdlRegisterFixedOutputHook("text/calendar", ical_fixed_output);
2517 CtdlRegisterFixedOutputHook("application/ics", ical_fixed_output);
2520 // return our module name for the log