X-Git-Url: https://code.citadel.org/?a=blobdiff_plain;f=webcit%2Fical_dezonify.c;h=ecd04d886f2d78958fd073e579d4336206318ac1;hb=16408b0a369aa1c0645079ab40135306c6c9d551;hp=f48051eb5618f927bdd4b2d96dbed7d198cf0606;hpb=385e86f4a8694462b1f723de6aca93c7dbd9e623;p=citadel.git diff --git a/webcit/ical_dezonify.c b/webcit/ical_dezonify.c index f48051eb5..ecd04d886 100644 --- a/webcit/ical_dezonify.c +++ b/webcit/ical_dezonify.c @@ -1,90 +1,90 @@ -/* - * $Id$ - */ -/** - * \defgroup IcalDezonify normalize ical dates to UTC - * Function to go through an ical component set and convert all non-UTC - * date/time properties to UTC. It also strips out any VTIMEZONE - * subcomponents afterwards, because they're irrelevant. - * - * Everything here will work on both a fully encapsulated VCALENDAR component - * or any type of subcomponent. - * - * \ingroup Calendaring - */ -/*@{*/ +// Go through an ical component set and convert all non-UTC date/time properties to UTC. +// It also strips out any VTIMEZONE subcomponents afterwards, because they are now unreferenced. +// +// Everything here will work on both components and subcomponents. If subcomponents are discovered it will recurse through them. +// +// Copyright (c) 2002-2024 by the citadel.org team (Art Cancro et al) +// This program is open source software. Use, duplication, or disclosure is subject to the GNU General Public License v3. #include "webcit.h" #include "webserver.h" - -#ifdef WEBCIT_WITH_CALENDAR_SERVICE - - -/* - * Figure out which time zone needs to be used for timestamps that are - * not UTC and do not have a time zone specified. - * - */ +// Figure out which time zone needs to be used for timestamps that are not UTC and do not have a time zone specified. icaltimezone *get_default_icaltimezone(void) { icaltimezone *zone = NULL; + const char *default_zone_name = ChrPtr(WC->serv_info->serv_default_cal_zone); // mmmmmm ... calzone if (!zone) { - zone = icaltimezone_get_builtin_timezone(serv_info.serv_default_cal_zone); + zone = icaltimezone_get_builtin_timezone(default_zone_name); } if (!zone) { + syslog(LOG_WARNING, "ical_dezonify: unable to load '%s' time zone, defaulting to UTC", default_zone_name); zone = icaltimezone_get_utc_timezone(); } + if (!zone) { + syslog(LOG_ERR, "ical_dezonify: unable to load UTC time zone!"); + } return zone; } -/* - * Back end function for ical_dezonify() - * - * We supply this with the master component, the relevant component, - * and the property (which will be a DTSTART, DTEND, etc.) - * which we want to convert to UTC. - */ -void ical_dezonify_backend(icalcomponent *cal, - icalcomponent *rcal, - icalproperty *prop) { +// Back end function for ical_dezonify() +// +// We supply this with the master component, the relevant component, and the property +// (which will be a DTSTART, DTEND, etc.) which we want to convert to UTC. +void ical_dezonify_backend(icalcomponent *cal, icalcomponent *rcal, icalproperty *prop) { icaltimezone *t = NULL; icalparameter *param; const char *tzid = NULL; struct icaltimetype TheTime; - int utc_declared_as_tzid = 0; /**< Component declared 'TZID=GMT' instead of using Z syntax */ + int utc_declared_as_tzid = 0; // Component declared 'TZID=GMT' instead of using Z syntax - /* Give me nothing and I will give you nothing in return. */ + // Give me nothing and I will give you nothing in return. if (cal == NULL) return; - /* Hunt for a TZID parameter in this property. */ + // Hunt for a TZID parameter in this property. param = icalproperty_get_first_parameter(prop, ICAL_TZID_PARAMETER); - /* Get the stringish name of this TZID. */ + // Get the stringish name of this TZID. if (param != NULL) { tzid = icalparameter_get_tzid(param); - /* Convert it to an icaltimezone type. */ + // Convert it to an icaltimezone type. if (tzid != NULL) { - /* lprintf(9, " * Stringy supplied timezone is: '%s'\n", tzid); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: Stringy supplied timezone is: '%s'\n", tzid); +#endif if ( (!strcasecmp(tzid, "UTC")) || (!strcasecmp(tzid, "GMT")) ) { utc_declared_as_tzid = 1; - /* lprintf(9, " * ...and we handle that internally.\n"); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: ...and we handle that internally.\n"); +#endif } else { + // try attached first t = icalcomponent_get_timezone(cal, tzid); - /* lprintf(9, " * ...and I %s have tzdata for that zone.\n", +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: ...and I %s have tzdata for that zone.\n", (t ? "DO" : "DO NOT") - ); */ + ); +#endif + // then try built-in timezones + if (!t) { + t = icaltimezone_get_builtin_timezone(tzid); +#ifdef DBG_ICAL + if (t) { + syslog(LOG_DEBUG, "ical_dezonify: Using system tzdata!\n"); + } +#endif + } } } } - /* Now we know the timezone. Convert to UTC. */ + // Now we know the timezone. Convert to UTC. if (icalproperty_isa(prop) == ICAL_DTSTART_PROPERTY) { TheTime = icalproperty_get_dtstart(prop); @@ -102,41 +102,49 @@ void ical_dezonify_backend(icalcomponent *cal, return; } - /* lprintf(9, " * Was: %s\n", icaltime_as_ical_string(TheTime)); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: was: %s\n", icaltime_as_ical_string(TheTime)); +#endif - if (TheTime.is_utc) { - /* lprintf(9, " * This property is ALREADY UTC.\n"); */ + if (icaltime_is_utc(TheTime)) { +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: this property is ALREADY UTC"); +#endif } else if (utc_declared_as_tzid) { - /* lprintf(9, " * Replacing '%s' TZID with 'Z' suffix.\n", tzid); */ - TheTime.is_utc = 1; +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: replacing '%s' TZID with 'Z' suffix", tzid); +#endif + TheTime.zone = icaltimezone_get_utc_timezone(); } else { - /* Do the conversion. */ + // Do the conversion. if (t != NULL) { - /* lprintf(9, " * Timezone prop found. Converting to UTC.\n"); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: timezone prop found, converting to UTC"); +#endif } else { - /* lprintf(9, " * Converting default timezone to UTC.\n"); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: converting default timezone to UTC"); +#endif } if (t == NULL) { t = get_default_icaltimezone(); } - - icaltimezone_convert_time(&TheTime, - t, - icaltimezone_get_utc_timezone() - ); - TheTime.is_utc = 1; + icaltimezone_convert_time(&TheTime, t, icaltimezone_get_utc_timezone()); + TheTime.zone = icaltimezone_get_utc_timezone(); } icalproperty_remove_parameter_by_kind(prop, ICAL_TZID_PARAMETER); - /* lprintf(9, " * Now: %s\n", icaltime_as_ical_string(TheTime)); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify: now: %s", icaltime_as_ical_string(TheTime)); +#endif - /* Now add the converted property back in. */ + // Now add the converted property back in. if (icalproperty_isa(prop) == ICAL_DTSTART_PROPERTY) { icalproperty_set_dtstart(prop, TheTime); } @@ -152,31 +160,23 @@ void ical_dezonify_backend(icalcomponent *cal, } -/* - * Recursive portion of ical_dezonify() - */ +// Recursive portion of ical_dezonify() void ical_dezonify_recurse(icalcomponent *cal, icalcomponent *rcal) { icalcomponent *c; icalproperty *p; - /* - * Recurse through all subcomponents *except* VTIMEZONE ones. - */ - for (c=icalcomponent_get_first_component( - rcal, ICAL_ANY_COMPONENT); + // Recurse through all subcomponents *except* VTIMEZONE ones. + for ( c=icalcomponent_get_first_component(rcal, ICAL_ANY_COMPONENT); c != NULL; - c = icalcomponent_get_next_component( - rcal, ICAL_ANY_COMPONENT) + c = icalcomponent_get_next_component(rcal, ICAL_ANY_COMPONENT) ) { if (icalcomponent_isa(c) != ICAL_VTIMEZONE_COMPONENT) { ical_dezonify_recurse(cal, c); } } - /* - * Now look for DTSTART and DTEND properties - */ - for (p=icalcomponent_get_first_property(rcal, ICAL_ANY_PROPERTY); + // Now look for DTSTART and DTEND properties + for ( p=icalcomponent_get_first_property(rcal, ICAL_ANY_PROPERTY); p != NULL; p = icalcomponent_get_next_property(rcal, ICAL_ANY_PROPERTY) ) { @@ -185,35 +185,33 @@ void ical_dezonify_recurse(icalcomponent *cal, icalcomponent *rcal) { || (icalproperty_isa(p) == ICAL_DTEND_PROPERTY) || (icalproperty_isa(p) == ICAL_DUE_PROPERTY) || (icalproperty_isa(p) == ICAL_EXDATE_PROPERTY) - ) { + ) { ical_dezonify_backend(cal, rcal, p); } } } -/* - * Convert all DTSTART and DTEND properties in all subcomponents to UTC. - * This function will search any VTIMEZONE subcomponents to learn the - * relevant timezone information. - */ +// Convert all DTSTART and DTEND properties in all subcomponents to UTC. +// This function will search any VTIMEZONE subcomponents to learn the +// relevant timezone information. void ical_dezonify(icalcomponent *cal) { icalcomponent *vt = NULL; - /* lprintf(9, "ical_dezonify() started\n"); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify() started"); +#endif - /* Convert all times to UTC */ + // Convert all times to UTC ical_dezonify_recurse(cal, cal); - /* Strip out VTIMEZONE subcomponents -- we don't need them anymore */ - while (vt = icalcomponent_get_first_component( - cal, ICAL_VTIMEZONE_COMPONENT), vt != NULL) { + // Strip out VTIMEZONE subcomponents -- we don't need them anymore. + while (vt = icalcomponent_get_first_component(cal, ICAL_VTIMEZONE_COMPONENT), vt != NULL) { icalcomponent_remove_component(cal, vt); icalcomponent_free(vt); } - /* lprintf(9, "ical_dezonify() completed\n"); */ +#ifdef DBG_ICAL + syslog(LOG_DEBUG, "ical_dezonify() completed"); +#endif } - - -#endif /* WEBCIT_WITH_CALENDAR_SERVICE */