Wed Jan 8 2020 09:49:49

Asterisk developer's documentation


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>neon</depend>
25  <depend>ical</depend>
26  <support_level>core</support_level>
27 ***/
28 
29 #include "asterisk.h"
30 
31 ASTERISK_FILE_VERSION(__FILE__, "$Revision: 413586 $")
32 
33 #include <libical/ical.h>
34 #include <ne_session.h>
35 #include <ne_uri.h>
36 #include <ne_request.h>
37 #include <ne_auth.h>
38 #include <ne_redirect.h>
39 
40 #include "asterisk/module.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 {
62  );
64  ne_uri uri;
65  ne_session *session;
66  icalcomponent *data;
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  }
82 
83  ao2_callback(pvt->events, OBJ_UNLINK | OBJ_NODATA | OBJ_MULTIPLE, NULL, NULL);
84 
85  ao2_ref(pvt->events, -1);
86 }
87 
88 static void *unref_icalendar(void *obj)
89 {
90  struct icalendar_pvt *pvt = obj;
91 
92  ao2_ref(pvt, -1);
93  return NULL;
94 }
95 
96 static int fetch_response_reader(void *data, const char *block, size_t len)
97 {
98  struct ast_str **response = data;
99  unsigned char *tmp;
100 
101  if (!(tmp = ast_malloc(len + 1))) {
102  return -1;
103  }
104  memcpy(tmp, block, len);
105  tmp[len] = '\0';
106  ast_str_append(response, 0, "%s", tmp);
107  ast_free(tmp);
108 
109  return 0;
110 }
111 
112 static int auth_credentials(void *userdata, const char *realm, int attempts, char *username, char *secret)
113 {
114  struct icalendar_pvt *pvt = userdata;
115 
116  if (attempts > 1) {
117  ast_log(LOG_WARNING, "Invalid username or password for iCalendar '%s'\n", pvt->owner->name);
118  return -1;
119  }
120 
121  ne_strnzcpy(username, pvt->user, NE_ABUFSIZ);
122  ne_strnzcpy(secret, pvt->secret, NE_ABUFSIZ);
123 
124  return 0;
125 }
126 
127 static icalcomponent *fetch_icalendar(struct icalendar_pvt *pvt)
128 {
129  int ret;
130  struct ast_str *response;
131  ne_request *req;
132  icalcomponent *comp = NULL;
133 
134  if (!pvt) {
135  ast_log(LOG_ERROR, "There is no private!\n");
136  return NULL;
137  }
138 
139  if (!(response = ast_str_create(512))) {
140  ast_log(LOG_ERROR, "Could not allocate memory for response.\n");
141  return NULL;
142  }
143 
144  req = ne_request_create(pvt->session, "GET", pvt->uri.path);
145  ne_add_response_body_reader(req, ne_accept_2xx, fetch_response_reader, &response);
146 
147  ret = ne_request_dispatch(req);
148  ne_request_destroy(req);
149  if (ret != NE_OK || !ast_str_strlen(response)) {
150  ast_log(LOG_WARNING, "Unable to retrieve iCalendar '%s' from '%s': %s\n", pvt->owner->name, pvt->url, ne_get_error(pvt->session));
151  ast_free(response);
152  return NULL;
153  }
154 
155  if (!ast_strlen_zero(ast_str_buffer(response))) {
156  comp = icalparser_parse_string(ast_str_buffer(response));
157  }
158  ast_free(response);
159 
160  return comp;
161 }
162 
163 static time_t icalfloat_to_timet(icaltimetype time)
164 {
165  struct ast_tm tm = {0,};
166  struct timeval tv;
167 
168  tm.tm_mday = time.day;
169  tm.tm_mon = time.month - 1;
170  tm.tm_year = time.year - 1900;
171  tm.tm_hour = time.hour;
172  tm.tm_min = time.minute;
173  tm.tm_sec = time.second;
174  tm.tm_isdst = -1;
175  tv = ast_mktime(&tm, NULL);
176 
177  return tv.tv_sec;
178 }
179 
180 /* span->start & span->end may be dates or floating times which have no timezone,
181  * which would mean that they should apply to the local timezone for all recepients.
182  * For example, if a meeting was set for 1PM-2PM floating time, people in different time
183  * zones would not be scheduled at the same local times. Dates are often treated as
184  * floating times, so all day events will need to be converted--so we can trust the
185  * span here, and instead will grab the start and end from the component, which will
186  * allow us to test for floating times or dates.
187  */
188 
189 static void icalendar_add_event(icalcomponent *comp, struct icaltime_span *span, void *data)
190 {
191  struct icalendar_pvt *pvt = data;
192  struct ast_calendar_event *event;
193  icaltimezone *utc = icaltimezone_get_utc_timezone();
194  icaltimetype start, end, tmp;
195  icalcomponent *valarm;
196  icalproperty *prop;
197  struct icaltriggertype trigger;
198 
199  if (!(pvt && pvt->owner)) {
200  ast_log(LOG_ERROR, "Require a private structure with an ownenr\n");
201  return;
202  }
203 
204  if (!(event = ast_calendar_event_alloc(pvt->owner))) {
205  ast_log(LOG_ERROR, "Could not allocate an event!\n");
206  return;
207  }
208 
209  start = icalcomponent_get_dtstart(comp);
210  end = icalcomponent_get_dtend(comp);
211 
212  event->start = icaltime_get_tzid(start) ? span->start : icalfloat_to_timet(start);
213  event->end = icaltime_get_tzid(end) ? span->end : icalfloat_to_timet(end);
214  event->busy_state = span->is_busy ? AST_CALENDAR_BS_BUSY : AST_CALENDAR_BS_FREE;
215 
216  if ((prop = icalcomponent_get_first_property(comp, ICAL_SUMMARY_PROPERTY))) {
217  ast_string_field_set(event, summary, icalproperty_get_value_as_string(prop));
218  }
219 
220  if ((prop = icalcomponent_get_first_property(comp, ICAL_DESCRIPTION_PROPERTY))) {
221  ast_string_field_set(event, description, icalproperty_get_value_as_string(prop));
222  }
223 
224  if ((prop = icalcomponent_get_first_property(comp, ICAL_ORGANIZER_PROPERTY))) {
225  ast_string_field_set(event, organizer, icalproperty_get_value_as_string(prop));
226  }
227 
228  if ((prop = icalcomponent_get_first_property(comp, ICAL_LOCATION_PROPERTY))) {
229  ast_string_field_set(event, location, icalproperty_get_value_as_string(prop));
230  }
231 
232  if ((prop = icalcomponent_get_first_property(comp, ICAL_CATEGORIES_PROPERTY))) {
233  ast_string_field_set(event, categories, icalproperty_get_value_as_string(prop));
234  }
235 
236  if ((prop = icalcomponent_get_first_property(comp, ICAL_PRIORITY_PROPERTY))) {
237  event->priority = icalvalue_get_integer(icalproperty_get_value(prop));
238  }
239 
240  if ((prop = icalcomponent_get_first_property(comp, ICAL_UID_PROPERTY))) {
241  ast_string_field_set(event, uid, icalproperty_get_value_as_string(prop));
242  } else {
243  ast_log(LOG_WARNING, "No UID found, but one is required. Generating, but updates may not be acurate\n");
244  if (!ast_strlen_zero(event->summary)) {
245  ast_string_field_set(event, uid, event->summary);
246  } else {
247  char tmp[100];
248  snprintf(tmp, sizeof(tmp), "%ld", event->start);
249  ast_string_field_set(event, uid, tmp);
250  }
251  }
252 
253  /* Get the attendees */
254  for (prop = icalcomponent_get_first_property(comp, ICAL_ATTENDEE_PROPERTY);
255  prop; prop = icalcomponent_get_next_property(comp, ICAL_ATTENDEE_PROPERTY)) {
256  struct ast_calendar_attendee *attendee;
257  const char *data;
258 
259  if (!(attendee = ast_calloc(1, sizeof(*attendee)))) {
260  event = ast_calendar_unref_event(event);
261  return;
262  }
263  data = icalproperty_get_attendee(prop);
264  if (ast_strlen_zero(data)) {
265  ast_free(attendee);
266  continue;
267  }
268  attendee->data = ast_strdup(data);;
269  AST_LIST_INSERT_TAIL(&event->attendees, attendee, next);
270  }
271 
272 
273  /* Only set values for alarm based on VALARM. Can be overriden in main/calendar.c by autoreminder
274  * therefore, go ahead and add events even if their is no VALARM or it is malformed
275  * Currently we are only getting the first VALARM and are handling repitition in main/calendar.c from calendar.conf */
276  if (!(valarm = icalcomponent_get_first_component(comp, ICAL_VALARM_COMPONENT))) {
277  ao2_link(pvt->events, event);
278  event = ast_calendar_unref_event(event);
279  return;
280  }
281 
282  if (!(prop = icalcomponent_get_first_property(valarm, ICAL_TRIGGER_PROPERTY))) {
283  ast_log(LOG_WARNING, "VALARM has no TRIGGER, skipping!\n");
284  ao2_link(pvt->events, event);
285  event = ast_calendar_unref_event(event);
286  return;
287  }
288 
289  trigger = icalproperty_get_trigger(prop);
290 
291  if (icaltriggertype_is_null_trigger(trigger)) {
292  ast_log(LOG_WARNING, "Bad TRIGGER for VALARM, skipping!\n");
293  ao2_link(pvt->events, event);
294  event = ast_calendar_unref_event(event);
295  return;
296  }
297 
298  if (!icaltime_is_null_time(trigger.time)) { /* This is an absolute time */
299  tmp = icaltime_convert_to_zone(trigger.time, utc);
300  event->alarm = icaltime_as_timet_with_zone(tmp, utc);
301  } else { /* Offset from either dtstart or dtend */
302  /* XXX Technically you can check RELATED to see if the event fires from the END of the event
303  * But, I'm not sure I've ever seen anyone implement it in calendaring software, so I'm ignoring for now */
304  tmp = icaltime_add(start, trigger.duration);
305  event->alarm = icaltime_as_timet_with_zone(tmp, utc);
306  }
307 
308  ao2_link(pvt->events, event);
309  event = ast_calendar_unref_event(event);
310 
311  return;
312 }
313 
314  static void icalendar_update_events(struct icalendar_pvt *pvt)
315 {
316  struct icaltimetype start_time, end_time;
317  icalcomponent *iter;
318 
319  if (!pvt) {
320  ast_log(LOG_ERROR, "iCalendar is NULL\n");
321  return;
322  }
323 
324  if (!pvt->owner) {
325  ast_log(LOG_ERROR, "iCalendar is an orphan!\n");
326  return;
327  }
328 
329  if (!pvt->data) {
330  ast_log(LOG_ERROR, "The iCalendar has not been parsed!\n");
331  return;
332  }
333 
334  start_time = icaltime_current_time_with_zone(icaltimezone_get_utc_timezone());
335  end_time = icaltime_current_time_with_zone(icaltimezone_get_utc_timezone());
336  end_time.second += pvt->owner->timeframe * 60;
337  icaltime_normalize(end_time);
338 
339  for (iter = icalcomponent_get_first_component(pvt->data, ICAL_VEVENT_COMPONENT);
340  iter;
341  iter = icalcomponent_get_next_component(pvt->data, ICAL_VEVENT_COMPONENT))
342  {
343  icalcomponent_foreach_recurrence(iter, start_time, end_time, icalendar_add_event, pvt);
344  }
345 
347 }
348 
349 static void *ical_load_calendar(void *void_data)
350 {
351  struct icalendar_pvt *pvt;
352  const struct ast_config *cfg;
353  struct ast_variable *v;
354  struct ast_calendar *cal = void_data;
356 
357  if (!(cal && (cfg = ast_calendar_config_acquire()))) {
358  ast_log(LOG_ERROR, "You must enable calendar support for res_icalendar to load\n");
359  return NULL;
360  }
361  if (ao2_trylock(cal)) {
362  if (cal->unloading) {
363  ast_log(LOG_WARNING, "Unloading module, load_calendar cancelled.\n");
364  } else {
365  ast_log(LOG_WARNING, "Could not lock calendar, aborting!\n");
366  }
368  return NULL;
369  }
370 
371  if (!(pvt = ao2_alloc(sizeof(*pvt), icalendar_destructor))) {
372  ast_log(LOG_ERROR, "Could not allocate icalendar_pvt structure for calendar: %s\n", cal->name);
374  return NULL;
375  }
376 
377  pvt->owner = cal;
378 
379  if (!(pvt->events = ast_calendar_event_container_alloc())) {
380  ast_log(LOG_ERROR, "Could not allocate space for fetching events for calendar: %s\n", cal->name);
381  pvt = unref_icalendar(pvt);
382  ao2_unlock(cal);
384  return NULL;
385  }
386 
387  if (ast_string_field_init(pvt, 32)) {
388  ast_log(LOG_ERROR, "Couldn't allocate string field space for calendar: %s\n", cal->name);
389  pvt = unref_icalendar(pvt);
390  ao2_unlock(cal);
392  return NULL;
393  }
394 
395  for (v = ast_variable_browse(cfg, cal->name); v; v = v->next) {
396  if (!strcasecmp(v->name, "url")) {
397  ast_string_field_set(pvt, url, v->value);
398  } else if (!strcasecmp(v->name, "user")) {
399  ast_string_field_set(pvt, user, v->value);
400  } else if (!strcasecmp(v->name, "secret")) {
402  }
403  }
404 
406 
407  if (ast_strlen_zero(pvt->url)) {
408  ast_log(LOG_WARNING, "No URL was specified for iCalendar '%s' - skipping.\n", cal->name);
409  pvt = unref_icalendar(pvt);
410  ao2_unlock(cal);
411  return NULL;
412  }
413 
414  if (ne_uri_parse(pvt->url, &pvt->uri) || pvt->uri.host == NULL || pvt->uri.path == NULL) {
415  ast_log(LOG_WARNING, "Could not parse url '%s' for iCalendar '%s' - skipping.\n", pvt->url, cal->name);
416  pvt = unref_icalendar(pvt);
417  ao2_unlock(cal);
418  return NULL;
419  }
420 
421  if (pvt->uri.scheme == NULL) {
422  pvt->uri.scheme = "http";
423  }
424 
425  if (pvt->uri.port == 0) {
426  pvt->uri.port = ne_uri_defaultport(pvt->uri.scheme);
427  }
428 
429  pvt->session = ne_session_create(pvt->uri.scheme, pvt->uri.host, pvt->uri.port);
430  ne_redirect_register(pvt->session);
431  ne_set_server_auth(pvt->session, auth_credentials, pvt);
432  if (!strcasecmp(pvt->uri.scheme, "https")) {
433  ne_ssl_trust_default_ca(pvt->session);
434  }
435 
436  cal->tech_pvt = pvt;
437 
438  ast_mutex_init(&refreshlock);
439 
440  /* Load it the first time */
441  if (!(pvt->data = fetch_icalendar(pvt))) {
442  ast_log(LOG_WARNING, "Unable to parse iCalendar '%s'\n", cal->name);
443  }
444 
446 
447  ao2_unlock(cal);
448 
449  /* The only writing from another thread will be if unload is true */
450  for(;;) {
451  struct timeval tv = ast_tvnow();
452  struct timespec ts = {0,};
453 
454  ts.tv_sec = tv.tv_sec + (60 * pvt->owner->refresh);
455 
456  ast_mutex_lock(&refreshlock);
457  while (!pvt->owner->unloading) {
458  if (ast_cond_timedwait(&pvt->owner->unload, &refreshlock, &ts) == ETIMEDOUT) {
459  break;
460  }
461  }
462  ast_mutex_unlock(&refreshlock);
463 
464  if (pvt->owner->unloading) {
465  ast_debug(10, "Skipping refresh since we got a shutdown signal\n");
466  return NULL;
467  }
468 
469  ast_debug(10, "Refreshing after %d minute timeout\n", pvt->owner->refresh);
470 
471  /* Free the old calendar data */
472  if (pvt->data) {
473  icalcomponent_free(pvt->data);
474  pvt->data = NULL;
475  }
476  if (!(pvt->data = fetch_icalendar(pvt))) {
477  ast_log(LOG_WARNING, "Unable to parse iCalendar '%s'\n", pvt->owner->name);
478  continue;
479  }
480 
482  }
483 
484  return NULL;
485 }
486 
487 static int load_module(void)
488 {
489  ne_sock_init();
490  if (ast_calendar_register(&ical_tech)) {
491  ne_sock_exit();
493  }
494 
496 }
497 
498 static int unload_module(void)
499 {
500  ast_calendar_unregister(&ical_tech);
501  ne_sock_exit();
502  return 0;
503 }
504 
505 AST_MODULE_INFO(ASTERISK_GPL_KEY, AST_MODFLAG_LOAD_ORDER, "Asterisk iCalendar .ics file integration",
506  .load = load_module,
507  .unload = unload_module,
508  .load_pri = AST_MODPRI_DEVSTATE_PLUGIN,
509  );
static void * unref_icalendar(void *obj)
struct ast_calendar * owner
ast_cond_t unload
Definition: calendar.h:133
Asterisk locking-related definitions:
int ast_calendar_register(struct ast_calendar_tech *tech)
Register a new calendar technology.
Definition: res_calendar.c:490
Asterisk main include file. File version handling, generic pbx functions.
#define ao2_link(arg1, arg2)
Definition: astobj2.h:785
int unloading
Definition: calendar.h:134
static icalcomponent * fetch_icalendar(struct icalendar_pvt *pvt)
#define ast_strdup(a)
Definition: astmm.h:109
const ast_string_field user
const ast_string_field secret
#define AST_MODULE
Definition: evt.c:58
#define LOG_WARNING
Definition: logger.h:144
struct ast_variable * ast_variable_browse(const struct ast_config *config, const char *category)
Goes through variables.
Definition: config.c:597
char * ast_str_buffer(const struct ast_str *buf)
Returns the string buffer within the ast_str buf.
Definition: strings.h:497
static void * ical_load_calendar(void *data)
#define ao2_callback(c, flags, cb_fn, arg)
Definition: astobj2.h:910
struct ast_calendar_attendee * next
Definition: calendar.h:89
static time_t icalfloat_to_timet(icaltimetype time)
Structure for variables, used for configurations and for channel variables.
Definition: config.h:75
static void icalendar_add_event(icalcomponent *comp, struct icaltime_span *span, void *data)
Configuration File Parser.
struct ao2_container * events
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:900
struct timeval ast_tvnow(void)
Returns current timeval. Meant to replace calls to gettimeofday().
Definition: time.h:142
#define AST_DECLARE_STRING_FIELDS(field_list)
Declare the fields needed in a structure.
Definition: stringfields.h:235
struct ast_str * ast_str_create(size_t init_len)
Create a malloc&#39;ed dynamic length string.
Definition: strings.h:420
#define ast_mutex_lock(a)
Definition: lock.h:155
#define ao2_unlock(a)
Definition: astobj2.h:497
#define AST_MODULE_INFO(keystr, flags_to_set, desc, fields...)
Definition: module.h:374
int timeframe
Definition: calendar.h:131
static struct ast_calendar_tech ical_tech
int tm_year
Definition: localtime.h:41
static void icalendar_update_events(struct icalendar_pvt *pvt)
struct ast_config * ast_calendar_config_acquire(void)
Grab and lock pointer to the calendar config (read only)
Definition: res_calendar.c:237
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.
Definition: res_calendar.c:961
void * tech_pvt
Definition: calendar.h:119
const char * type
Definition: calendar.h:70
#define ast_debug(level,...)
Log a DEBUG message.
Definition: logger.h:236
static int fetch_response_reader(void *data, const char *block, size_t len)
static int auth_credentials(void *userdata, const char *realm, int attempts, char *username, char *secret)
const char * value
Definition: config.h:79
static int load_module(void)
#define ast_string_field_init(x, size)
Initialize a field pool and fields.
Definition: stringfields.h:249
static force_inline int attribute_pure ast_strlen_zero(const char *s)
Definition: strings.h:63
struct ao2_container * ast_calendar_event_container_alloc(void)
Allocate an astobj2 container for ast_calendar_event objects.
Definition: res_calendar.c:625
#define AST_STRING_FIELD(name)
Declare a string field.
Definition: stringfields.h:220
int tm_mon
Definition: localtime.h:40
#define ao2_ref(o, delta)
Definition: astobj2.h:472
A general API for managing calendar events with Asterisk.
const char * name
Definition: config.h:77
int tm_mday
Definition: localtime.h:39
const ast_string_field name
Definition: calendar.h:127
struct ast_calendar_event * ast_calendar_event_alloc(struct ast_calendar *cal)
Allocate an astobj2 ast_calendar_event object.
Definition: res_calendar.c:603
#define LOG_ERROR
Definition: logger.h:155
#define AST_LIST_INSERT_TAIL(head, elm, field)
Appends a list entry to the tail of a list.
Definition: linkedlists.h:716
#define ao2_trylock(a)
Definition: astobj2.h:506
The descriptor of a dynamic string XXX storage will be optimized later if needed We use the ts field ...
Definition: strings.h:364
static ast_mutex_t refreshlock
Definition: res_calendar.c:204
static int len(struct ast_channel *chan, const char *cmd, char *data, char *buf, size_t buflen)
const ast_string_field url
void ast_log(int level, const char *file, int line, const char *function, const char *fmt,...)
Used for sending a log message This is the standard logger function. Probably the only way you will i...
Definition: logger.c:1207
#define ao2_alloc(data_size, destructor_fn)
Definition: astobj2.h:430
static void icalendar_destructor(void *obj)
#define ast_free(a)
Definition: astmm.h:97
struct ast_calendar_event * ast_calendar_unref_event(struct ast_calendar_event *event)
Unreference an ast_calendar_event.
Definition: res_calendar.c:300
int tm_hour
Definition: localtime.h:38
structure to hold users read from users.conf
struct ast_calendar_event::attendees attendees
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:523
size_t ast_str_strlen(const struct ast_str *buf)
Returns the current length of the string stored within buf.
Definition: strings.h:471
static char secret[50]
Definition: chan_h323.c:148
struct timeval ast_mktime(struct ast_tm *const tmp, const char *zone)
Timezone-independent version of mktime(3).
Definition: localtime.c:2185
icalcomponent * data
#define ast_calloc(a, b)
Definition: astmm.h:82
Individual calendaring technology data.
Definition: calendar.h:69
int tm_isdst
Definition: localtime.h:44
struct ast_variable * next
Definition: config.h:82
#define ast_mutex_init(pmutex)
Definition: lock.h:152
Asterisk calendar structure.
Definition: calendar.h:117
void ast_calendar_config_release(void)
Release the calendar config.
Definition: res_calendar.c:249
static char url[512]
#define ASTERISK_GPL_KEY
The text the key() function should return.
Definition: module.h:38
#define ast_malloc(a)
Definition: astmm.h:91
Asterisk module definitions.
const ast_string_field summary
Definition: calendar.h:101
#define ast_string_field_free_memory(x)
free all memory - to be called before destroying the object
Definition: stringfields.h:253
#define ast_cond_timedwait(cond, mutex, time)
Definition: lock.h:172
int tm_min
Definition: localtime.h:37
Structure for mutex and tracking information.
Definition: lock.h:121
#define ASTERISK_FILE_VERSION(file, version)
Register/unregister a source code file with the core.
Definition: asterisk.h:180
static int unload_module(void)
#define ast_mutex_unlock(a)
Definition: lock.h:156
#define ast_string_field_set(x, field, data)
Set a field to a simple string value.
Definition: stringfields.h:344