Asterisk - The Open Source Telephony Project  21.4.1
res_calendar_icalendar.c
Go to the documentation of this file.
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2008 - 2009, Digium, Inc.
5  *
6  * Terry Wilson <twilson@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18 
19 /*! \file
20  * \brief Resource for handling iCalendar calendars
21  */
22 
23 /*** MODULEINFO
24  <depend>res_calendar</depend>
25  <depend>neon</depend>
26  <depend>ical</depend>
27  <support_level>extended</support_level>
28 ***/
29 
30 #include "asterisk.h"
31 
32 #include <libical/ical.h>
33 #include <ne_session.h>
34 #include <ne_uri.h>
35 #include <ne_request.h>
36 #include <ne_auth.h>
37 #include <ne_redirect.h>
38 
39 #include "asterisk/module.h"
40 #include "asterisk/channel.h"
41 #include "asterisk/calendar.h"
42 #include "asterisk/lock.h"
43 #include "asterisk/config.h"
44 #include "asterisk/astobj2.h"
45 
46 static void *ical_load_calendar(void *data);
47 static void *unref_icalendar(void *obj);
48 
49 static struct ast_calendar_tech ical_tech = {
50  .type = "ical",
51  .module = AST_MODULE,
52  .description = "iCalendar .ics calendars",
53  .load_calendar = ical_load_calendar,
54  .unref_calendar = unref_icalendar,
55 };
56 
57 struct icalendar_pvt {
59  AST_STRING_FIELD(url);
61  AST_STRING_FIELD(secret);
62  );
63  struct ast_calendar *owner;
64  ne_uri uri;
65  ne_session *session;
66  icalcomponent *data;
67  struct ao2_container *events;
68 };
69 
70 static void icalendar_destructor(void *obj)
71 {
72  struct icalendar_pvt *pvt = obj;
73 
74  ast_debug(1, "Destroying pvt for iCalendar %s\n", pvt->owner->name);
75  if (pvt->session) {
76  ne_session_destroy(pvt->session);
77  }
78  if (pvt->data) {
79  icalcomponent_free(pvt->data);
80  }
81  ne_uri_free(&pvt->uri);
83 
84  ao2_callback(pvt->events, OBJ_UNLINK | OBJ_NODATA | OBJ_MULTIPLE, NULL, NULL);
85 
86  ao2_ref(pvt->events, -1);
87 }
88 
89 static void *unref_icalendar(void *obj)
90 {
91  struct icalendar_pvt *pvt = obj;
92 
93  ao2_ref(pvt, -1);
94  return NULL;
95 }
96 
97 static int fetch_response_reader(void *data, const char *block, size_t len)
98 {
99  struct ast_str **response = data;
100  unsigned char *tmp;
101 
102  if (!(tmp = ast_malloc(len + 1))) {
103  return -1;
104  }
105  memcpy(tmp, block, len);
106  tmp[len] = '\0';
107  ast_str_append(response, 0, "%s", tmp);
108  ast_free(tmp);
109 
110  return 0;
111 }
112 
113 static int auth_credentials(void *userdata, const char *realm, int attempts, char *username, char *secret)
114 {
115  struct icalendar_pvt *pvt = userdata;
116 
117  if (attempts > 1) {
118  ast_log(LOG_WARNING, "Invalid username or password for iCalendar '%s'\n", pvt->owner->name);
119  return -1;
120  }
121 
122  ne_strnzcpy(username, pvt->user, NE_ABUFSIZ);
123  ne_strnzcpy(secret, pvt->secret, NE_ABUFSIZ);
124 
125  return 0;
126 }
127 
128 static icalcomponent *fetch_icalendar(struct icalendar_pvt *pvt)
129 {
130  int ret;
131  struct ast_str *response;
132  ne_request *req;
133  icalcomponent *comp = NULL;
134 
135  if (!pvt) {
136  ast_log(LOG_ERROR, "There is no private!\n");
137  return NULL;
138  }
139 
140  if (!(response = ast_str_create(512))) {
141  ast_log(LOG_ERROR, "Could not allocate memory for response.\n");
142  return NULL;
143  }
144 
145  req = ne_request_create(pvt->session, "GET", pvt->uri.path);
146  ne_add_response_body_reader(req, ne_accept_2xx, fetch_response_reader, &response);
147 
148  ret = ne_request_dispatch(req);
149  ne_request_destroy(req);
150  if (ret != NE_OK || !ast_str_strlen(response)) {
151  ast_log(LOG_WARNING, "Unable to retrieve iCalendar '%s' from '%s': %s\n", pvt->owner->name, pvt->url, ne_get_error(pvt->session));
152  ast_free(response);
153  return NULL;
154  }
155 
156  if (!ast_strlen_zero(ast_str_buffer(response))) {
157  comp = icalparser_parse_string(ast_str_buffer(response));
158  if (!comp) {
159  ast_debug(3, "iCalendar response data: %s\n", ast_str_buffer(response));
160  ast_log(LOG_WARNING, "Failed to parse iCalendar data: %s\n", icalerror_perror());
161  }
162  }
163  ast_free(response);
164 
165  return comp;
166 }
167 
168 static time_t icalfloat_to_timet(icaltimetype time)
169 {
170  struct ast_tm tm = {0,};
171  struct timeval tv;
172 
173  tm.tm_mday = time.day;
174  tm.tm_mon = time.month - 1;
175  tm.tm_year = time.year - 1900;
176  tm.tm_hour = time.hour;
177  tm.tm_min = time.minute;
178  tm.tm_sec = time.second;
179  tm.tm_isdst = -1;
180  tv = ast_mktime(&tm, NULL);
181 
182  return tv.tv_sec;
183 }
184 
185 /* span->start & span->end may be dates or floating times which have no timezone,
186  * which would mean that they should apply to the local timezone for all recipients.
187  * For example, if a meeting was set for 1PM-2PM floating time, people in different time
188  * zones would not be scheduled at the same local times. Dates are often treated as
189  * floating times, so all day events will need to be converted--so we can trust the
190  * span here, and instead will grab the start and end from the component, which will
191  * allow us to test for floating times or dates.
192  */
193 
194 static void icalendar_add_event(icalcomponent *comp, struct icaltime_span *span, void *data)
195 {
196  struct icalendar_pvt *pvt = data;
197  struct ast_calendar_event *event;
198  icaltimezone *utc = icaltimezone_get_utc_timezone();
199  icaltimetype start, end, tmp;
200  icalcomponent *valarm;
201  icalproperty *prop;
202  struct icaltriggertype trigger;
203 
204  if (!(pvt && pvt->owner)) {
205  ast_log(LOG_ERROR, "Require a private structure with an owner\n");
206  return;
207  }
208 
209  if (!(event = ast_calendar_event_alloc(pvt->owner))) {
210  ast_log(LOG_ERROR, "Could not allocate an event!\n");
211  return;
212  }
213 
214  start = icalcomponent_get_dtstart(comp);
215  end = icalcomponent_get_dtend(comp);
216 
217  event->start = icaltime_get_tzid(start) ? span->start : icalfloat_to_timet(start);
218  event->end = icaltime_get_tzid(end) ? span->end : icalfloat_to_timet(end);
219  event->busy_state = span->is_busy ? AST_CALENDAR_BS_BUSY : AST_CALENDAR_BS_FREE;
220 
221  if ((prop = icalcomponent_get_first_property(comp, ICAL_SUMMARY_PROPERTY))) {
222  ast_string_field_set(event, summary, icalproperty_get_value_as_string(prop));
223  }
224 
225  if ((prop = icalcomponent_get_first_property(comp, ICAL_DESCRIPTION_PROPERTY))) {
226  ast_string_field_set(event, description, icalproperty_get_value_as_string(prop));
227  }
228 
229  if ((prop = icalcomponent_get_first_property(comp, ICAL_ORGANIZER_PROPERTY))) {
230  ast_string_field_set(event, organizer, icalproperty_get_value_as_string(prop));
231  }
232 
233  if ((prop = icalcomponent_get_first_property(comp, ICAL_LOCATION_PROPERTY))) {
234  ast_string_field_set(event, location, icalproperty_get_value_as_string(prop));
235  }
236 
237  if ((prop = icalcomponent_get_first_property(comp, ICAL_CATEGORIES_PROPERTY))) {
238  ast_string_field_set(event, categories, icalproperty_get_value_as_string(prop));
239  }
240 
241  if ((prop = icalcomponent_get_first_property(comp, ICAL_PRIORITY_PROPERTY))) {
242  event->priority = icalvalue_get_integer(icalproperty_get_value(prop));
243  }
244 
245  if ((prop = icalcomponent_get_first_property(comp, ICAL_UID_PROPERTY))) {
246  ast_string_field_set(event, uid, icalproperty_get_value_as_string(prop));
247  } else {
248  ast_log(LOG_WARNING, "No UID found, but one is required. Generating, but updates may not be accurate\n");
249  if (!ast_strlen_zero(event->summary)) {
250  ast_string_field_set(event, uid, event->summary);
251  } else {
252  char tmp[AST_TIME_T_LEN];
253  ast_time_t_to_string(event->start, tmp, sizeof(tmp));
254  ast_string_field_set(event, uid, tmp);
255  }
256  }
257 
258  /*
259  * If comp has an RRULE and/or RDATE property, we need to check whether
260  * another vevent component supercedes this span. Such a component would
261  * have two characteristics:
262  * - its UID is the same as comp
263  * - its RECURRENCE-ID property is the same time as span->start
264  */
265  if (icalcomponent_get_first_property(comp, ICAL_RRULE_PROPERTY)
266  || icalcomponent_get_first_property(comp, ICAL_RDATE_PROPERTY)) {
267  icalcompiter comp_iter;
268  icaltimetype span_start = icaltime_from_timet_with_zone(
269  event->start, icaltime_is_date(start), icaltime_get_timezone(start));
270 
271  icaltime_set_timezone(&span_start, icaltime_get_timezone(start));
272  for (comp_iter = icalcomponent_begin_component(pvt->data, ICAL_VEVENT_COMPONENT);
273  icalcompiter_deref(&comp_iter);
274  icalcompiter_next(&comp_iter)) {
275  icalcomponent *vevent = icalcompiter_deref(&comp_iter);
276  icalproperty *uid = icalcomponent_get_first_property(vevent, ICAL_UID_PROPERTY);
277 
278  if (uid && !strcmp(icalproperty_get_value_as_string(uid), event->uid)) {
279  icaltimetype recurrence_id = icalcomponent_get_recurrenceid(vevent);
280 
281  /* Set the same timezone that we want to compare against */
282  icaltime_set_timezone(&recurrence_id, icaltime_get_timezone(start));
283 
284  if (!icaltime_compare(recurrence_id, span_start)
285  && icaltime_is_date(span_start) == icaltime_is_date(recurrence_id)) {
286  event = ast_calendar_unref_event(event);
287  return;
288  }
289  }
290  }
291  }
292 
293  /* Get the attendees */
294  for (prop = icalcomponent_get_first_property(comp, ICAL_ATTENDEE_PROPERTY);
295  prop; prop = icalcomponent_get_next_property(comp, ICAL_ATTENDEE_PROPERTY)) {
296  struct ast_calendar_attendee *attendee;
297  const char *data;
298 
299  if (!(attendee = ast_calloc(1, sizeof(*attendee)))) {
300  event = ast_calendar_unref_event(event);
301  return;
302  }
303  data = icalproperty_get_attendee(prop);
304  if (ast_strlen_zero(data)) {
305  ast_free(attendee);
306  continue;
307  }
308  attendee->data = ast_strdup(data);;
309  AST_LIST_INSERT_TAIL(&event->attendees, attendee, next);
310  }
311 
312 
313  /* Only set values for alarm based on VALARM. Can be overriden in main/calendar.c by autoreminder
314  * therefore, go ahead and add events even if their is no VALARM or it is malformed
315  * Currently we are only getting the first VALARM and are handling repitition in main/calendar.c from calendar.conf */
316  if (!(valarm = icalcomponent_get_first_component(comp, ICAL_VALARM_COMPONENT))) {
317  ao2_link(pvt->events, event);
318  event = ast_calendar_unref_event(event);
319  return;
320  }
321 
322  if (!(prop = icalcomponent_get_first_property(valarm, ICAL_TRIGGER_PROPERTY))) {
323  ast_log(LOG_WARNING, "VALARM has no TRIGGER, skipping!\n");
324  ao2_link(pvt->events, event);
325  event = ast_calendar_unref_event(event);
326  return;
327  }
328 
329  trigger = icalproperty_get_trigger(prop);
330 
331  if (icaltriggertype_is_null_trigger(trigger)) {
332  ast_log(LOG_WARNING, "Bad TRIGGER for VALARM, skipping!\n");
333  ao2_link(pvt->events, event);
334  event = ast_calendar_unref_event(event);
335  return;
336  }
337 
338  if (!icaltime_is_null_time(trigger.time)) { /* This is an absolute time */
339  tmp = icaltime_convert_to_zone(trigger.time, utc);
340  event->alarm = icaltime_as_timet_with_zone(tmp, utc);
341  } else { /* Offset from either dtstart or dtend */
342  /* XXX Technically you can check RELATED to see if the event fires from the END of the event
343  * But, I'm not sure I've ever seen anyone implement it in calendaring software, so I'm ignoring for now */
344  tmp = icaltime_add(start, trigger.duration);
345  event->alarm = icaltime_as_timet_with_zone(tmp, icaltime_get_timezone(start));
346  }
347 
348  ao2_link(pvt->events, event);
349  event = ast_calendar_unref_event(event);
350 
351  return;
352 }
353 
354  static void icalendar_update_events(struct icalendar_pvt *pvt)
355 {
356  struct icaltimetype start_time, end_time;
357  icalcomponent *iter;
358 
359  if (!pvt) {
360  ast_log(LOG_ERROR, "iCalendar is NULL\n");
361  return;
362  }
363 
364  if (!pvt->owner) {
365  ast_log(LOG_ERROR, "iCalendar is an orphan!\n");
366  return;
367  }
368 
369  if (!pvt->data) {
370  ast_log(LOG_ERROR, "The iCalendar has not been parsed!\n");
371  return;
372  }
373 
374  start_time = icaltime_current_time_with_zone(icaltimezone_get_utc_timezone());
375  end_time = icaltime_current_time_with_zone(icaltimezone_get_utc_timezone());
376  end_time.second += pvt->owner->timeframe * 60;
377  end_time = icaltime_normalize(end_time);
378 
379  for (iter = icalcomponent_get_first_component(pvt->data, ICAL_VEVENT_COMPONENT);
380  iter;
381  iter = icalcomponent_get_next_component(pvt->data, ICAL_VEVENT_COMPONENT))
382  {
383  icalcomponent_foreach_recurrence(iter, start_time, end_time, icalendar_add_event, pvt);
384  }
385 
386  ast_calendar_merge_events(pvt->owner, pvt->events);
387 }
388 
389 static void *ical_load_calendar(void *void_data)
390 {
391  struct icalendar_pvt *pvt;
392  const struct ast_config *cfg;
393  struct ast_variable *v;
394  struct ast_calendar *cal = void_data;
395  ast_mutex_t refreshlock;
396 
397  if (!(cal && (cfg = ast_calendar_config_acquire()))) {
398  ast_log(LOG_ERROR, "You must enable calendar support for res_icalendar to load\n");
399  return NULL;
400  }
401  if (ao2_trylock(cal)) {
402  if (cal->unloading) {
403  ast_log(LOG_WARNING, "Unloading module, load_calendar cancelled.\n");
404  } else {
405  ast_log(LOG_WARNING, "Could not lock calendar, aborting!\n");
406  }
408  return NULL;
409  }
410 
411  if (!(pvt = ao2_alloc(sizeof(*pvt), icalendar_destructor))) {
412  ast_log(LOG_ERROR, "Could not allocate icalendar_pvt structure for calendar: %s\n", cal->name);
414  return NULL;
415  }
416 
417  pvt->owner = cal;
418 
419  if (!(pvt->events = ast_calendar_event_container_alloc())) {
420  ast_log(LOG_ERROR, "Could not allocate space for fetching events for calendar: %s\n", cal->name);
421  pvt = unref_icalendar(pvt);
422  ao2_unlock(cal);
424  return NULL;
425  }
426 
427  if (ast_string_field_init(pvt, 32)) {
428  ast_log(LOG_ERROR, "Couldn't allocate string field space for calendar: %s\n", cal->name);
429  pvt = unref_icalendar(pvt);
430  ao2_unlock(cal);
432  return NULL;
433  }
434 
435  for (v = ast_variable_browse(cfg, cal->name); v; v = v->next) {
436  if (!strcasecmp(v->name, "url")) {
437  ast_string_field_set(pvt, url, v->value);
438  } else if (!strcasecmp(v->name, "user")) {
439  ast_string_field_set(pvt, user, v->value);
440  } else if (!strcasecmp(v->name, "secret")) {
441  ast_string_field_set(pvt, secret, v->value);
442  }
443  }
444 
446 
447  if (ast_strlen_zero(pvt->url)) {
448  ast_log(LOG_WARNING, "No URL was specified for iCalendar '%s' - skipping.\n", cal->name);
449  pvt = unref_icalendar(pvt);
450  ao2_unlock(cal);
451  return NULL;
452  }
453 
454  if (ne_uri_parse(pvt->url, &pvt->uri) || pvt->uri.host == NULL || pvt->uri.path == NULL) {
455  ast_log(LOG_WARNING, "Could not parse url '%s' for iCalendar '%s' - skipping.\n", pvt->url, cal->name);
456  pvt = unref_icalendar(pvt);
457  ao2_unlock(cal);
458  return NULL;
459  }
460 
461  if (pvt->uri.scheme == NULL) {
462  pvt->uri.scheme = "http";
463  }
464 
465  if (pvt->uri.port == 0) {
466  pvt->uri.port = ne_uri_defaultport(pvt->uri.scheme);
467  }
468 
469  pvt->session = ne_session_create(pvt->uri.scheme, pvt->uri.host, pvt->uri.port);
470  ne_redirect_register(pvt->session);
471  ne_set_server_auth(pvt->session, auth_credentials, pvt);
472  ne_set_useragent(pvt->session, "Asterisk");
473  if (!strcasecmp(pvt->uri.scheme, "https")) {
474  ne_ssl_trust_default_ca(pvt->session);
475  }
476 
477  cal->tech_pvt = pvt;
478 
479  ast_mutex_init(&refreshlock);
480 
481  /* Load it the first time */
482  if (!(pvt->data = fetch_icalendar(pvt))) {
483  ast_log(LOG_WARNING, "Unable to parse iCalendar '%s'\n", cal->name);
484  }
485 
486  icalendar_update_events(pvt);
487 
488  ao2_unlock(cal);
489 
490  /* The only writing from another thread will be if unload is true */
491  for(;;) {
492  struct timeval tv = ast_tvnow();
493  struct timespec ts = {0,};
494 
495  ts.tv_sec = tv.tv_sec + (60 * pvt->owner->refresh);
496 
497  ast_mutex_lock(&refreshlock);
498  while (!pvt->owner->unloading) {
499  if (ast_cond_timedwait(&pvt->owner->unload, &refreshlock, &ts) == ETIMEDOUT) {
500  break;
501  }
502  }
503  ast_mutex_unlock(&refreshlock);
504 
505  if (pvt->owner->unloading) {
506  ast_debug(10, "Skipping refresh since we got a shutdown signal\n");
507  return NULL;
508  }
509 
510  ast_debug(10, "Refreshing after %d minute timeout\n", pvt->owner->refresh);
511 
512  /* Free the old calendar data */
513  if (pvt->data) {
514  icalcomponent_free(pvt->data);
515  pvt->data = NULL;
516  }
517  if (!(pvt->data = fetch_icalendar(pvt))) {
518  ast_log(LOG_WARNING, "Unable to parse iCalendar '%s'\n", pvt->owner->name);
519  continue;
520  }
521 
522  icalendar_update_events(pvt);
523  }
524 
525  return NULL;
526 }
527 
528 static int load_module(void)
529 {
530  ne_sock_init();
531  if (ast_calendar_register(&ical_tech)) {
532  ne_sock_exit();
534  }
535 
537 }
538 
539 static int unload_module(void)
540 {
541  ast_calendar_unregister(&ical_tech);
542  ne_sock_exit();
543  return 0;
544 }
545 
546 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Asterisk iCalendar .ics file integration",
547  .support_level = AST_MODULE_SUPPORT_EXTENDED,
548  .load = load_module,
549  .unload = unload_module,
550  .load_pri = AST_MODPRI_DEVSTATE_PLUGIN,
551  .requires = "res_calendar",
552 );
struct ast_variable * next
Asterisk locking-related definitions:
int ast_calendar_register(struct ast_calendar_tech *tech)
Register a new calendar technology.
Definition: res_calendar.c:551
Asterisk main include file. File version handling, generic pbx functions.
int ast_time_t_to_string(time_t time, char *buf, size_t length)
Converts to a string representation of a time_t as decimal seconds since the epoch. Returns -1 on failure, zero otherwise.
Definition: time.c:152
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:761
#define ao2_callback(c, flags, cb_fn, arg)
ao2_callback() is a generic function that applies cb_fn() to all objects in a container, as described below.
Definition: astobj2.h:1693
Structure for variables, used for configurations and for channel variables.
Definition: astman.c:222
int ast_str_append(struct ast_str **buf, ssize_t max_len, const char *fmt,...)
Append to a thread local dynamic string.
Definition: strings.h:1139
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:159
#define AST_DECLARE_STRING_FIELDS(field_list)
Declare the fields needed in a structure.
Definition: stringfields.h:341
#define ast_strdup(str)
A wrapper for strdup()
Definition: astmm.h:241
int timeframe
Definition: calendar.h:135
int tm_year
Definition: localtime.h:41
void ast_calendar_merge_events(struct ast_calendar *cal, struct ao2_container *new_events)
Add an event to the list of events for a calendar.
Configuration File Parser.
General Asterisk PBX channel definitions.
#define ast_string_field_init(x, size)
Initialize a field pool and fields.
Definition: stringfields.h:359
#define ao2_ref(o, delta)
Reference/unreference an object and return the old refcount.
Definition: astobj2.h:459
struct ao2_container * ast_calendar_event_container_alloc(void)
Allocate an astobj2 container for ast_calendar_event objects.
Definition: res_calendar.c:691
#define AST_STRING_FIELD(name)
Declare a string field.
Definition: stringfields.h:303
int tm_mon
Definition: localtime.h:40
A general API for managing calendar events with Asterisk.
static struct stasis_rest_handlers events
REST handler for /api-docs/events.json.
#define ast_malloc(len)
A wrapper for malloc()
Definition: astmm.h:191
#define ast_debug(level,...)
Log a DEBUG message.
int tm_mday
Definition: localtime.h:39
const ast_string_field name
Definition: calendar.h:129
struct ast_calendar_event * ast_calendar_event_alloc(struct ast_calendar *cal)
Allocate an astobj2 ast_calendar_event object.
Definition: res_calendar.c:669
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:731
Support for dynamic strings.
Definition: strings.h:623
#define ast_calloc(num, len)
A wrapper for calloc()
Definition: astmm.h:202
const struct ast_config * ast_calendar_config_acquire(void)
Grab and lock pointer to the calendar config (read only)
Definition: res_calendar.c:260
Module has failed to load, may be in an inconsistent state.
Definition: module.h:78
struct ast_calendar_event * ast_calendar_unref_event(struct ast_calendar_event *event)
Unreference an ast_calendar_event.
Definition: res_calendar.c:323
int tm_hour
Definition: localtime.h:38
structure to hold users read from users.conf
int tm_sec
Definition: localtime.h:36
void ast_calendar_unregister(struct ast_calendar_tech *tech)
Unregister a new calendar technology.
Definition: res_calendar.c:589
size_t ast_str_strlen(const struct ast_str *buf)
Returns the current length of the string stored within buf.
Definition: strings.h:730
struct timeval ast_mktime(struct ast_tm *const tmp, const char *zone)
Timezone-independent version of mktime(3).
Definition: localtime.c:2357
Individual calendaring technology data.
Definition: calendar.h:71
int tm_isdst
Definition: localtime.h:44
Generic container type.
Asterisk calendar structure.
Definition: calendar.h:119
Calendar events.
Definition: calendar.h:95
void ast_calendar_config_release(void)
Release the calendar config.
Definition: res_calendar.c:272
#define ASTERISK_GPL_KEY
The text the key() function should return.
Definition: module.h:46
Asterisk module definitions.
#define ast_string_field_free_memory(x)
free all memory - to be called before destroying the object
Definition: stringfields.h:374
int tm_min
Definition: localtime.h:37
Structure for mutex and tracking information.
Definition: lock.h:135
#define ast_str_create(init_len)
Create a malloc'ed dynamic length string.
Definition: strings.h:659
#define ast_string_field_set(x, field, data)
Set a field to a simple string value.
Definition: stringfields.h:521
#define ao2_link(container, obj)
Add an object to a container.
Definition: astobj2.h:1532