Sat Jul 12 2014 17:18:36

Asterisk developer's documentation


res_calendar_exchange.c
Go to the documentation of this file.
00001 /*
00002  * Asterisk -- An open source telephony toolkit.
00003  *
00004  * Copyright (C) 2008 - 2009, Digium, Inc.
00005  *
00006  * Terry Wilson <twilson@digium.com>
00007  *
00008  * See http://www.asterisk.org for more information about
00009  * the Asterisk project. Please do not directly contact
00010  * any of the maintainers of this project for assistance;
00011  * the project provides a web site, mailing lists and IRC
00012  * channels for your use.
00013  *
00014  * This program is free software, distributed under the terms of
00015  * the GNU General Public License Version 2. See the LICENSE file
00016  * at the top of the source tree.
00017  */
00018 
00019 /*! \file
00020  * \brief Resource for handling MS Exchange calendars
00021  */
00022 
00023 /*** MODULEINFO
00024    <depend>neon</depend>
00025    <depend>ical</depend>
00026    <depend>iksemel</depend>
00027    <support_level>core</support_level>
00028 ***/
00029 
00030 #include "asterisk.h"
00031 
00032 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 413587 $")
00033 
00034 #include <libical/ical.h>
00035 #include <ne_session.h>
00036 #include <ne_uri.h>
00037 #include <ne_request.h>
00038 #include <ne_auth.h>
00039 #include <ne_redirect.h>
00040 #include <iksemel.h>
00041 
00042 #include "asterisk/module.h"
00043 #include "asterisk/calendar.h"
00044 #include "asterisk/lock.h"
00045 #include "asterisk/config.h"
00046 #include "asterisk/astobj2.h"
00047 
00048 static void *exchangecal_load_calendar(void *data);
00049 static void *unref_exchangecal(void *obj);
00050 static int exchangecal_write_event(struct ast_calendar_event *event);
00051 
00052 static struct ast_calendar_tech exchangecal_tech = {
00053    .type = "exchange",
00054    .description = "MS Exchange calendars",
00055    .module = AST_MODULE,
00056    .load_calendar = exchangecal_load_calendar,
00057    .unref_calendar = unref_exchangecal,
00058    .write_event = exchangecal_write_event,
00059 };
00060 
00061 struct exchangecal_pvt {
00062    AST_DECLARE_STRING_FIELDS(
00063       AST_STRING_FIELD(url);
00064       AST_STRING_FIELD(user);
00065       AST_STRING_FIELD(secret);
00066    );
00067    struct ast_calendar *owner;
00068    ne_uri uri;
00069    ne_session *session;
00070    struct ao2_container *events;
00071 };
00072 
00073 struct xmlstate {
00074    char tag[80];
00075    int in_response;
00076    int in_propstat;
00077    int in_prop;
00078    void *ptr;
00079    struct exchangecal_pvt *pvt;
00080 };
00081 
00082 static int parse_tag(void *data, char *name, char **atts, int type)
00083 {
00084    struct xmlstate *state = data;
00085    char *tmp;
00086 
00087    if ((tmp = strchr(name, ':'))) {
00088       tmp++;
00089    } else {
00090       return IKS_HOOK;
00091    }
00092 
00093    ast_copy_string(state->tag, tmp, sizeof(state->tag));
00094 
00095    switch (type) {
00096    case IKS_OPEN:
00097       if (!strcasecmp(state->tag, "response")) {
00098          struct ast_calendar_event *event;
00099 
00100          state->in_response = 1;
00101          if (!(event = ast_calendar_event_alloc(state->pvt->owner))) {
00102             return IKS_NOMEM;
00103          }
00104          state->ptr = event;
00105       } else if (!strcasecmp(state->tag, "propstat")) {
00106          state->in_propstat = 1;
00107       } else if (!strcasecmp(state->tag, "prop")) {
00108          state->in_prop = 1;
00109       }
00110       break;
00111 
00112    case IKS_CLOSE:
00113       if (!strcasecmp(state->tag, "response")) {
00114          struct ao2_container *events = state->pvt->events;
00115          struct ast_calendar_event *event = state->ptr;
00116 
00117          state->in_response = 0;
00118          if (ast_strlen_zero(event->uid)) {
00119             ast_log(LOG_ERROR, "This event has no UID, something has gone wrong\n");
00120             event = ast_calendar_unref_event(event);
00121             return IKS_HOOK;
00122          }
00123          ao2_link(events, event);
00124          event = ast_calendar_unref_event(event);
00125       } else if (!strcasecmp(state->tag, "propstat")) {
00126          state->in_propstat = 0;
00127       } else if (!strcasecmp(state->tag, "prop")) {
00128          state->in_prop = 0;
00129       }
00130       break;
00131 
00132    default:
00133       return IKS_OK;
00134    }
00135 
00136    return IKS_OK;
00137 }
00138 
00139 static time_t mstime_to_time_t(char *mstime)
00140 {
00141    char *read, *write;
00142    icaltimetype tt;
00143    for (read = write = mstime; *read; read++) {
00144       if (*read == '.') {
00145          *write++ = 'Z';
00146          *write = '\0';
00147          break;
00148       }
00149       if (*read == '-' || *read == ':')
00150          continue;
00151       *write = *read;
00152       write++;
00153    }
00154 
00155    tt = icaltime_from_string(mstime);
00156    return icaltime_as_timet(tt);
00157 }
00158 
00159 static enum ast_calendar_busy_state msbusy_to_bs(const char *msbusy)
00160 {
00161    if (!strcasecmp(msbusy, "FREE")) {
00162       return AST_CALENDAR_BS_FREE;
00163    } else if (!strcasecmp(msbusy, "TENTATIVE")) {
00164       return AST_CALENDAR_BS_BUSY_TENTATIVE;
00165    } else {
00166       return AST_CALENDAR_BS_BUSY;
00167    }
00168 }
00169 
00170 static int parse_cdata(void *data, char *value, size_t len)
00171 {
00172    char *str;
00173    struct xmlstate *state = data;
00174    struct ast_calendar_event *event = state->ptr;
00175 
00176 
00177    str = ast_skip_blanks(value);
00178 
00179    if (str == value + len)
00180       return IKS_OK;
00181 
00182    if (!(str = ast_calloc(1, len + 1))) {
00183       return IKS_NOMEM;
00184    }
00185    memcpy(str, value, len);
00186    if (!(state->in_response && state->in_propstat && state->in_prop)) {
00187       ast_free(str);
00188       return IKS_OK;
00189    }
00190    /* We use ast_string_field_build here because libiksemel is parsing CDATA with &lt; as
00191     * new elements which is a bit odd and shouldn't happen */
00192    if (!strcasecmp(state->tag, "subject")) {
00193       ast_string_field_build(event, summary, "%s%s", event->summary, str);
00194    } else if (!strcasecmp(state->tag, "location")) {
00195       ast_string_field_build(event, location, "%s%s", event->location, str);
00196    } else if (!strcasecmp(state->tag, "uid")) {
00197       ast_string_field_build(event, uid, "%s%s", event->location, str);
00198    } else if (!strcasecmp(state->tag, "organizer")) {
00199       ast_string_field_build(event, organizer, "%s%s", event->organizer, str);
00200    } else if (!strcasecmp(state->tag, "textdescription")) {
00201       ast_string_field_build(event, description, "%s%s", event->description, str);
00202    } else if (!strcasecmp(state->tag, "dtstart")) {
00203       event->start = mstime_to_time_t(str);
00204    } else if (!strcasecmp(state->tag, "dtend")) {
00205       event->end = mstime_to_time_t(str);
00206    } else if (!strcasecmp(state->tag, "busystatus")) {
00207       event->busy_state = msbusy_to_bs(str);
00208    } else if (!strcasecmp(state->tag, "reminderoffset")) {
00209       /*XXX Currently we rely on event->start being set first which means we rely on the response order
00210        * which technically should be fine since the query returns in the order we ask for, but ... */
00211       event->alarm = event->start - atoi(str);
00212    }
00213 
00214    ast_free(str);
00215    return IKS_OK;
00216 }
00217 
00218 static void exchangecal_destructor(void *obj)
00219 {
00220    struct exchangecal_pvt *pvt = obj;
00221 
00222    ast_debug(1, "Destroying pvt for Exchange calendar %s\n", pvt->owner->name);
00223    if (pvt->session) {
00224       ne_session_destroy(pvt->session);
00225    }
00226    ast_string_field_free_memory(pvt);
00227 
00228    ao2_callback(pvt->events, OBJ_UNLINK | OBJ_NODATA | OBJ_MULTIPLE, NULL, NULL);
00229 
00230    ao2_ref(pvt->events, -1);
00231 }
00232 
00233 static void *unref_exchangecal(void *obj)
00234 {
00235    struct exchangecal_pvt *pvt = obj;
00236 
00237    ao2_ref(pvt, -1);
00238    return NULL;
00239 }
00240 
00241 /* It is very important to use the return value of this function as a realloc could occur */
00242 static struct ast_str *generate_exchange_uuid(struct ast_str *uid)
00243 {
00244    unsigned short val[8];
00245    int x;
00246 
00247    for (x = 0; x < 8; x++) {
00248       val[x] = ast_random();
00249    }
00250    ast_str_set(&uid, 0, "%04x%04x-%04x-%04x-%04x-%04x%04x%04x", (unsigned)val[0],
00251       (unsigned)val[1], (unsigned)val[2], (unsigned)val[3], (unsigned)val[4],
00252       (unsigned)val[5], (unsigned)val[6], (unsigned)val[7]);
00253 
00254    return uid;
00255 }
00256 
00257 static int is_valid_uuid(struct ast_str *uid)
00258 {
00259    int i;
00260 
00261    if (ast_str_strlen(uid) != 36) {
00262       return 0;
00263    }
00264 
00265    for (i = 0; i < ast_str_strlen(uid); i++) {
00266       if (i == 8 || i == 13 || i == 18 || i == 23) {
00267          if (ast_str_buffer(uid)[i] != '-') {
00268             return 0;
00269          }
00270       } else if (!((ast_str_buffer(uid)[i] > 47 && ast_str_buffer(uid)[i] < 58) || (ast_str_buffer(uid)[i] > 96 && ast_str_buffer(uid)[i] < 103))) {
00271          return 0;
00272       }
00273    }
00274 
00275    return 1;
00276 }
00277 
00278 static struct ast_str *xml_encode_str(struct ast_str *dst, const char *src)
00279 {
00280    const char *tmp;
00281    char buf[7];
00282 
00283    for (tmp = src; *tmp; tmp++) {
00284       switch (*tmp) {
00285       case '\"':
00286          strcpy(buf, "&quot;");
00287          break;
00288 
00289       case '\'':
00290          strcpy(buf, "&apos;");
00291          break;
00292 
00293       case '&':
00294          strcpy(buf, "&amp;");
00295          break;
00296 
00297       case '<':
00298          strcpy(buf, "&lt;");
00299          break;
00300 
00301       case '>':
00302          strcpy(buf, "&gt;");
00303          break;
00304 
00305       default:
00306          sprintf(buf, "%c", *tmp);
00307       }
00308 
00309       ast_str_append(&dst, 0, "%s", buf);
00310    }
00311 
00312    return dst;
00313 }
00314 
00315 static struct ast_str *epoch_to_exchange_time(struct ast_str *dst, time_t epoch)
00316 {
00317    icaltimezone *utc = icaltimezone_get_utc_timezone();
00318    icaltimetype tt = icaltime_from_timet_with_zone(epoch, 0, utc);
00319    char tmp[30];
00320    int i;
00321 
00322    ast_copy_string(tmp, icaltime_as_ical_string(tt), sizeof(tmp));
00323    for (i = 0; tmp[i]; i++) {
00324       ast_str_append(&dst, 0, "%c", tmp[i]);
00325       if (i == 3 || i == 5)
00326          ast_str_append(&dst, 0, "%c", '-');
00327       if (i == 10 || i == 12)
00328          ast_str_append(&dst, 0, "%c", ':');
00329       if (i == 14)
00330          ast_str_append(&dst, 0, "%s", ".000");
00331    }
00332 
00333    return dst;
00334 }
00335 
00336 static struct ast_str *bs_to_exchange_bs(struct ast_str *dst, enum ast_calendar_busy_state bs)
00337 {
00338    switch (bs) {
00339    case AST_CALENDAR_BS_BUSY:
00340       ast_str_set(&dst, 0, "%s", "BUSY");
00341       break;
00342 
00343    case AST_CALENDAR_BS_BUSY_TENTATIVE:
00344       ast_str_set(&dst, 0, "%s", "TENTATIVE");
00345       break;
00346 
00347    default:
00348       ast_str_set(&dst, 0, "%s", "FREE");
00349    }
00350 
00351    return dst;
00352 }
00353 
00354 static int fetch_response_reader(void *data, const char *block, size_t len)
00355 {
00356    struct ast_str **response = data;
00357    unsigned char *tmp;
00358 
00359    if (!(tmp = ast_malloc(len + 1))) {
00360       return -1;
00361    }
00362    memcpy(tmp, block, len);
00363    tmp[len] = '\0';
00364    ast_str_append(response, 0, "%s", tmp);
00365    ast_free(tmp);
00366 
00367    return 0;
00368 }
00369 
00370 static int auth_credentials(void *userdata, const char *realm, int attempts, char *username, char *secret)
00371 {
00372    struct exchangecal_pvt *pvt = userdata;
00373 
00374    if (attempts > 1) {
00375       ast_log(LOG_WARNING, "Invalid username or password for Exchange calendar '%s'\n", pvt->owner->name);
00376       return -1;
00377    }
00378 
00379    ne_strnzcpy(username, pvt->user, NE_ABUFSIZ);
00380    ne_strnzcpy(secret, pvt->secret, NE_ABUFSIZ);
00381 
00382    return 0;
00383 }
00384 
00385 static struct ast_str *exchangecal_request(struct exchangecal_pvt *pvt, const char *method, struct ast_str *req_body, struct ast_str *subdir)
00386 {
00387    struct ast_str *response;
00388    ne_request *req;
00389    int ret;
00390    char buf[1000];
00391 
00392    if (!pvt) {
00393       ast_log(LOG_ERROR, "There is no private!\n");
00394       return NULL;
00395    }
00396 
00397    if (!(response = ast_str_create(512))) {
00398       ast_log(LOG_ERROR, "Could not allocate memory for response.\n");
00399       return NULL;
00400    }
00401 
00402    snprintf(buf, sizeof(buf), "%s%s", pvt->uri.path, subdir ? ast_str_buffer(subdir) : "");
00403 
00404    req = ne_request_create(pvt->session, method, buf);
00405    ne_add_response_body_reader(req, ne_accept_2xx, fetch_response_reader, &response);
00406    ne_set_request_body_buffer(req, ast_str_buffer(req_body), ast_str_strlen(req_body));
00407    ne_add_request_header(req, "Content-type", "text/xml");
00408 
00409    ret = ne_request_dispatch(req);
00410    ne_request_destroy(req);
00411 
00412    if (ret != NE_OK || !ast_str_strlen(response)) {
00413       ast_log(LOG_WARNING, "Unknown response to CalDAV calendar %s, request %s to %s: %s\n", pvt->owner->name, method, pvt->url, ne_get_error(pvt->session));
00414       ast_free(response);
00415       return NULL;
00416    }
00417 
00418    return response;
00419 }
00420 
00421 static int exchangecal_write_event(struct ast_calendar_event *event)
00422 {
00423    struct ast_str *body = NULL, *response = NULL, *subdir = NULL;
00424    struct ast_str *uid = NULL, *summary = NULL, *description = NULL, *organizer = NULL,
00425                   *location = NULL, *start = NULL, *end = NULL, *busystate = NULL;
00426    int ret = -1;
00427 
00428    if (!event) {
00429       ast_log(LOG_WARNING, "No event passed!\n");
00430       return -1;
00431    }
00432 
00433    if (!(event->start && event->end)) {
00434       ast_log(LOG_WARNING, "The event must contain a start and an end\n");
00435       return -1;
00436    }
00437    if (!(body = ast_str_create(512)) ||
00438       !(subdir = ast_str_create(32))) {
00439       ast_log(LOG_ERROR, "Could not allocate memory for request!\n");
00440       goto write_cleanup;
00441    }
00442 
00443    if (!(uid = ast_str_create(32)) ||
00444       !(summary = ast_str_create(32)) ||
00445       !(description = ast_str_create(32)) ||
00446       !(organizer = ast_str_create(32)) ||
00447       !(location = ast_str_create(32)) ||
00448       !(start = ast_str_create(32)) ||
00449       !(end = ast_str_create(32)) ||
00450       !(busystate = ast_str_create(32))) {
00451       ast_log(LOG_ERROR, "Unable to allocate memory for request values\n");
00452       goto write_cleanup;
00453    }
00454 
00455    if (ast_strlen_zero(event->uid)) {
00456       uid = generate_exchange_uuid(uid);
00457    } else {
00458       ast_str_set(&uid, 36, "%s", event->uid);
00459    }
00460 
00461    if (!is_valid_uuid(uid)) {
00462       ast_log(LOG_WARNING, "An invalid uid was provided, you may leave this field blank to have one generated for you\n");
00463       goto write_cleanup;
00464    }
00465 
00466    summary = xml_encode_str(summary, event->summary);
00467    description = xml_encode_str(description, event->description);
00468    organizer = xml_encode_str(organizer, event->organizer);
00469    location = xml_encode_str(location, event->location);
00470    start = epoch_to_exchange_time(start, event->start);
00471    end = epoch_to_exchange_time(end, event->end);
00472    busystate = bs_to_exchange_bs(busystate, event->busy_state);
00473 
00474    ast_str_append(&body, 0,
00475       "<?xml version=\"1.0\"?>\n"
00476       "<a:propertyupdate\n"
00477       "  xmlns:a=\"DAV:\"\n"
00478       "  xmlns:e=\"http://schemas.microsoft.com/exchange/\"\n"
00479       "  xmlns:mapi=\"http://schemas.microsoft.com/mapi/\"\n"
00480       "  xmlns:mapit=\"http://schemas.microsoft.com/mapi/proptag/\"\n"
00481       "  xmlns:x=\"xml:\" xmlns:cal=\"urn:schemas:calendar:\"\n"
00482       "  xmlns:dt=\"uuid:%s/\"\n" /* uid */
00483       "  xmlns:header=\"urn:schemas:mailheader:\"\n"
00484       "  xmlns:mail=\"urn:schemas:httpmail:\"\n"
00485       ">\n"
00486       "    <a:set>\n"
00487       "      <a:prop>\n"
00488       "        <a:contentclass>urn:content-classes:appointment</a:contentclass>\n"
00489       "        <e:outlookmessageclass>IPM.Appointment</e:outlookmessageclass>\n"
00490       "        <mail:subject>%s</mail:subject>\n" /* summary */
00491       "        <mail:description>%s</mail:description>\n" /* description */
00492       "        <header:to>%s</header:to>\n" /* organizer */
00493       "        <cal:location>%s</cal:location>\n" /* location */
00494       "        <cal:dtstart dt:dt=\"dateTime.tz\">%s</cal:dtstart>\n" /* start */
00495       "        <cal:dtend dt:dt=\"dateTime.tz\">%s</cal:dtend>\n" /* end */
00496       "        <cal:instancetype dt:dt=\"int\">0</cal:instancetype>\n"
00497       "        <cal:busystatus>%s</cal:busystatus>\n" /* busy_state (BUSY, FREE, BUSY_TENTATIVE) */
00498       "        <cal:meetingstatus>CONFIRMED</cal:meetingstatus>\n"
00499       "        <cal:alldayevent dt:dt=\"boolean\">0</cal:alldayevent>\n" /* XXX need to add event support for all day events */
00500       "        <cal:responserequested dt:dt=\"boolean\">0</cal:responserequested>\n"
00501       "        <mapi:finvited dt:dt=\"boolean\">1</mapi:finvited>\n"
00502       "      </a:prop>\n"
00503       "    </a:set>\n"
00504       "</a:propertyupdate>\n",
00505       ast_str_buffer(uid), ast_str_buffer(summary), ast_str_buffer(description), ast_str_buffer(organizer), ast_str_buffer(location), ast_str_buffer(start), ast_str_buffer(end), ast_str_buffer(busystate));
00506    ast_verb(0, "\n\n%s\n\n", ast_str_buffer(body));
00507    ast_str_set(&subdir, 0, "/Calendar/%s.eml", ast_str_buffer(uid));
00508 
00509    if ((response = exchangecal_request(event->owner->tech_pvt, "PROPPATCH", body, subdir))) {
00510       ret = 0;
00511    }
00512 
00513 write_cleanup:
00514    if (uid) {
00515       ast_free(uid);
00516    }
00517    if (summary) {
00518       ast_free(summary);
00519    }
00520    if (description) {
00521       ast_free(description);
00522    }
00523    if (organizer) {
00524       ast_free(organizer);
00525    }
00526    if (location) {
00527       ast_free(location);
00528    }
00529    if (start) {
00530       ast_free(start);
00531    }
00532    if (end) {
00533       ast_free(end);
00534    }
00535    if (busystate) {
00536       ast_free(busystate);
00537    }
00538    if (body) {
00539       ast_free(body);
00540    }
00541    if (response) {
00542       ast_free(response);
00543    }
00544    if (subdir) {
00545       ast_free(subdir);
00546    }
00547 
00548    return ret;
00549 }
00550 
00551 
00552 static struct ast_str *exchangecal_get_events_between(struct exchangecal_pvt *pvt, time_t start_time, time_t end_time)
00553 {
00554    struct ast_str *body, *response;
00555    char start[80], end[80];
00556    struct timeval tv = {0,};
00557    struct ast_tm tm;
00558 
00559    tv.tv_sec = start_time;
00560    ast_localtime(&tv, &tm, "UTC");
00561    ast_strftime(start, sizeof(start), "%Y/%m/%d %T", &tm);
00562 
00563    tv.tv_sec = end_time;
00564    ast_localtime(&tv, &tm, "UTC");
00565    ast_strftime(end, sizeof(end), "%Y/%m/%d %T", &tm);
00566 
00567    if (!(body = ast_str_create(512))) {
00568       ast_log(LOG_ERROR, "Could not allocate memory for body of request!\n");
00569       return NULL;
00570    }
00571 
00572    ast_str_append(&body, 0,
00573       "<?xml version=\"1.0\"?>\n"
00574       "<g:searchrequest xmlns:g=\"DAV:\">\n"
00575       "        <g:sql> SELECT \"urn:schemas:calendar:location\", \"urn:schemas:httpmail:subject\",\n"
00576       "                \"urn:schemas:calendar:dtstart\", \"urn:schemas:calendar:dtend\",\n"
00577       "                \"urn:schemas:calendar:busystatus\", \"urn:schemas:calendar:instancetype\",\n"
00578       "                \"urn:schemas:calendar:uid\", \"urn:schemas:httpmail:textdescription\",\n"
00579       "                \"urn:schemas:calendar:organizer\", \"urn:schemas:calendar:reminderoffset\"\n"
00580       "                FROM Scope('SHALLOW TRAVERSAL OF \"%s/Calendar\"')\n"
00581       "                WHERE NOT \"urn:schemas:calendar:instancetype\" = 1\n"
00582       "                AND \"DAV:contentclass\" = 'urn:content-classes:appointment'\n"
00583       "                AND NOT (\"urn:schemas:calendar:dtend\" &lt; '%s'\n"
00584       "                OR \"urn:schemas:calendar:dtstart\" &gt; '%s')\n"
00585       "                ORDER BY \"urn:schemas:calendar:dtstart\" ASC\n"
00586       "         </g:sql>\n"
00587       "</g:searchrequest>\n", pvt->url, start, end);
00588 
00589    ast_debug(5, "Request:\n%s\n", ast_str_buffer(body));
00590    response = exchangecal_request(pvt, "SEARCH", body, NULL);
00591    ast_debug(5, "Response:\n%s\n", ast_str_buffer(response));
00592    ast_free(body);
00593 
00594    return response;
00595 }
00596 
00597 static int update_exchangecal(struct exchangecal_pvt *pvt)
00598 {
00599    struct xmlstate state;
00600    struct timeval now = ast_tvnow();
00601    time_t start, end;
00602    struct ast_str *response;
00603    iksparser *p;
00604 
00605    state.pvt = pvt;
00606    start = now.tv_sec;
00607    end = now.tv_sec + 60 * pvt->owner->timeframe;
00608    if (!(response = exchangecal_get_events_between(pvt, start, end))) {
00609       return -1;
00610    }
00611 
00612    p = iks_sax_new(&state, parse_tag, parse_cdata);
00613    iks_parse(p, ast_str_buffer(response), ast_str_strlen(response), 1);
00614    ast_calendar_merge_events(pvt->owner, pvt->events);
00615    ast_free(response);
00616 
00617    return 0;
00618 }
00619 
00620 static void *exchangecal_load_calendar(void *void_data)
00621 {
00622    struct exchangecal_pvt *pvt;
00623    const struct ast_config *cfg;
00624    struct ast_variable *v;
00625    struct ast_calendar *cal = void_data;
00626    ast_mutex_t refreshlock;
00627 
00628    if (!(cal && (cfg = ast_calendar_config_acquire()))) {
00629       ast_log(LOG_ERROR, "You must enable calendar support for res_exchangecal to load\n");
00630       return NULL;
00631    }
00632 
00633    if (ao2_trylock(cal)) {
00634       if (cal->unloading) {
00635          ast_log(LOG_WARNING, "Unloading module, load_calendar cancelled.\n");
00636       } else {
00637          ast_log(LOG_WARNING, "Could not lock calendar, aborting!\n");
00638       }
00639       ast_calendar_config_release();
00640       return NULL;
00641    }
00642 
00643    if (!(pvt = ao2_alloc(sizeof(*pvt), exchangecal_destructor))) {
00644       ast_log(LOG_ERROR, "Could not allocate exchangecal_pvt structure for calendar: %s\n", cal->name);
00645       ast_calendar_config_release();
00646       return NULL;
00647    }
00648 
00649    pvt->owner = cal;
00650 
00651    if (!(pvt->events = ast_calendar_event_container_alloc())) {
00652       ast_log(LOG_ERROR, "Could not allocate space for fetching events for calendar: %s\n", cal->name);
00653       pvt = unref_exchangecal(pvt);
00654       ao2_unlock(cal);
00655       ast_calendar_config_release();
00656       return NULL;
00657    }
00658 
00659    if (ast_string_field_init(pvt, 32)) {
00660       ast_log(LOG_ERROR, "Couldn't allocate string field space for calendar: %s\n", cal->name);
00661       pvt = unref_exchangecal(pvt);
00662       ao2_unlock(cal);
00663       ast_calendar_config_release();
00664       return NULL;
00665    }
00666 
00667    for (v = ast_variable_browse(cfg, cal->name); v; v = v->next) {
00668       if (!strcasecmp(v->name, "url")) {
00669          ast_string_field_set(pvt, url, v->value);
00670       } else if (!strcasecmp(v->name, "user")) {
00671          ast_string_field_set(pvt, user, v->value);
00672       } else if (!strcasecmp(v->name, "secret")) {
00673          ast_string_field_set(pvt, secret, v->value);
00674       }
00675    }
00676 
00677    ast_calendar_config_release();
00678 
00679    if (ast_strlen_zero(pvt->url)) {
00680       ast_log(LOG_WARNING, "No URL was specified for Exchange calendar '%s' - skipping.\n", cal->name);
00681       pvt = unref_exchangecal(pvt);
00682       ao2_unlock(cal);
00683       return NULL;
00684    }
00685 
00686    if (ne_uri_parse(pvt->url, &pvt->uri) || pvt->uri.host == NULL || pvt->uri.path == NULL) {
00687       ast_log(LOG_WARNING, "Could not parse url '%s' for Exchange calendar '%s' - skipping.\n", pvt->url, cal->name);
00688       pvt = unref_exchangecal(pvt);
00689       ao2_unlock(cal);
00690       return NULL;
00691    }
00692 
00693    if (pvt->uri.scheme == NULL) {
00694       pvt->uri.scheme = "http";
00695    }
00696 
00697    if (pvt->uri.port == 0) {
00698       pvt->uri.port = ne_uri_defaultport(pvt->uri.scheme);
00699    }
00700 
00701    pvt->session = ne_session_create(pvt->uri.scheme, pvt->uri.host, pvt->uri.port);
00702    ne_redirect_register(pvt->session);
00703    ne_set_server_auth(pvt->session, auth_credentials, pvt);
00704    if (!strcasecmp(pvt->uri.scheme, "https")) {
00705       ne_ssl_trust_default_ca(pvt->session);
00706    }
00707 
00708    cal->tech_pvt = pvt;
00709 
00710    ast_mutex_init(&refreshlock);
00711 
00712    /* Load it the first time */
00713    update_exchangecal(pvt);
00714 
00715    ao2_unlock(cal);
00716 
00717    /* The only writing from another thread will be if unload is true */
00718    for (;;) {
00719       struct timeval tv = ast_tvnow();
00720       struct timespec ts = {0,};
00721 
00722       ts.tv_sec = tv.tv_sec + (60 * pvt->owner->refresh);
00723 
00724       ast_mutex_lock(&refreshlock);
00725       while (!pvt->owner->unloading) {
00726          if (ast_cond_timedwait(&pvt->owner->unload, &refreshlock, &ts) == ETIMEDOUT) {
00727             break;
00728          }
00729       }
00730       ast_mutex_unlock(&refreshlock);
00731 
00732       if (pvt->owner->unloading) {
00733          ast_debug(10, "Skipping refresh since we got a shutdown signal\n");
00734          return NULL;
00735       }
00736 
00737       ast_debug(10, "Refreshing after %d minute timeout\n", pvt->owner->refresh);
00738 
00739       update_exchangecal(pvt);
00740    }
00741 
00742    return NULL;
00743 }
00744 
00745 static int load_module(void)
00746 {
00747    ne_sock_init();
00748    if (ast_calendar_register(&exchangecal_tech)) {
00749       ne_sock_exit();
00750       return AST_MODULE_LOAD_DECLINE;
00751    }
00752 
00753    return AST_MODULE_LOAD_SUCCESS;
00754 }
00755 
00756 static int unload_module(void)
00757 {
00758    ast_calendar_unregister(&exchangecal_tech);
00759    ne_sock_exit();
00760    return 0;
00761 }
00762 
00763 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Asterisk MS Exchange Calendar Integration",
00764       .load = load_module,
00765       .unload = unload_module,
00766       .load_pri = AST_MODPRI_DEVSTATE_PLUGIN,
00767    );