indications.h File Reference

#include <asterisk/lock.h>

Include dependency graph for indications.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	tone_zone_sound
struct	tone_zone
Functions
int	ast_set_indication_country (const char *country)
tone_zone *	ast_get_indication_zone (const char *country)
tone_zone_sound *	ast_get_indication_tone (const struct tone_zone *zone, const char *indication)
int	ast_register_indication_country (struct tone_zone *country)
int	ast_unregister_indication_country (const char *country)
int	ast_register_indication (struct tone_zone *zone, const char *indication, const char *tonelist)
int	ast_unregister_indication (struct tone_zone *zone, const char *indication)
int	ast_playtones_start (struct ast_channel *chan, int vol, const char *tonelist, int interruptible)
void	ast_playtones_stop (struct ast_channel *chan)
Variables
tone_zone *	tone_zones
ast_mutex_t	tzlock

---

Function Documentation

struct tone_zone_sound* ast_get_indication_tone (  const struct tone_zone *  zone, const char *  indication )

Definition at line 288 of file indications.c. References ast_log(), ast_mutex_lock, ast_mutex_unlock, LOG_WARNING, tone_zone_sound::next, tone_zones, tone_zone::tones, and tzlock. Referenced by ast_indicate(). { struct tone_zone_sound *ts; /* we need some tonezone, pick the first */ if (zone == NULL && current_tonezone) zone = current_tonezone; /* default country? */ if (zone == NULL && tone_zones) zone = tone_zones; /* any country? */ if (zone == NULL) return 0; /* not a single country insight */ if (ast_mutex_lock(&tzlock)) { ast_log(LOG_WARNING, "Unable to lock tone_zones list\n"); return 0; } for (ts=zone->tones; ts; ts=ts->next) { if (strcasecmp(indication,ts->name)==0) { /* found indication! */ ast_mutex_unlock(&tzlock); return ts; } } /* nothing found, sorry */ ast_mutex_unlock(&tzlock); return 0; }

struct tone_zone* ast_get_indication_zone (  const char *  country  )

Definition at line 250 of file indications.c. References ast_log(), ast_mutex_lock, ast_mutex_unlock, LOG_NOTICE, LOG_WARNING, tone_zone::next, tone_zones, and tzlock. Referenced by ast_set_indication_country(). { struct tone_zone *tz; int alias_loop = 0; /* we need some tonezone, pick the first */ if (country == NULL && current_tonezone) return current_tonezone; /* default country? */ if (country == NULL && tone_zones) return tone_zones; /* any country? */ if (country == NULL) return 0; /* not a single country insight */ if (ast_mutex_lock(&tzlock)) { ast_log(LOG_WARNING, "Unable to lock tone_zones list\n"); return 0; } do { for (tz=tone_zones; tz; tz=tz->next) { if (strcasecmp(country,tz->country)==0) { /* tone_zone found */ if (tz->alias && tz->alias[0]) { country = tz->alias; break; } ast_mutex_unlock(&tzlock); return tz; } } } while (++alias_loop<20 && tz); ast_mutex_unlock(&tzlock); if (alias_loop==20) ast_log(LOG_NOTICE,"Alias loop for '%s' forcefull broken\n",country); /* nothing found, sorry */ return 0; }

int ast_playtones_start (  struct ast_channel *  chan, int  vol, const char *  tonelist, int  interruptible )

Definition at line 149 of file indications.c. References ast_activate_generator(), ast_log(), playtones_item::duration, free, playtones_item::freq1, playtones_item::freq2, playtones_def::interruptible, playtones_def::items, LOG_WARNING, playtones_item::modulate, ast_channel::name, playtones_def::nitems, realloc, playtones_def::reppos, s, and playtones_def::vol. Referenced by ast_indicate(). { char *s, *data = ast_strdupa(playlst); /* cute */ struct playtones_def d = { vol, -1, 0, 1, NULL}; char *stringp=NULL; char *separator; if (!data) return -1; if (vol < 1) d.vol = 8192; d.interruptible = interruptible; stringp=data; /* the stringp/data is not null here */ /* check if the data is separated with '|' or with ',' by default */ if (strchr(stringp,'|')) separator = "|"; else separator = ","; s = strsep(&stringp,separator); while(s && *s) { int freq1, freq2, time, modulate=0; if (s[0]=='!') s++; else if (d.reppos == -1) d.reppos = d.nitems; if (sscanf(s, "%d+%d/%d", &freq1, &freq2, &time) == 3) { /* f1+f2/time format */ } else if (sscanf(s, "%d+%d", &freq1, &freq2) == 2) { /* f1+f2 format */ time = 0; } else if (sscanf(s, "%d*%d/%d", &freq1, &freq2, &time) == 3) { /* f1*f2/time format */ modulate = 1; } else if (sscanf(s, "%d*%d", &freq1, &freq2) == 2) { /* f1*f2 format */ time = 0; modulate = 1; } else if (sscanf(s, "%d/%d", &freq1, &time) == 2) { /* f1/time format */ freq2 = 0; } else if (sscanf(s, "%d", &freq1) == 1) { /* f1 format */ freq2 = 0; time = 0; } else { ast_log(LOG_WARNING,"%s: tone component '%s' of '%s' is no good\n",chan->name,s,playlst); return -1; } d.items = realloc(d.items,(d.nitems+1)*sizeof(struct playtones_item)); if (d.items == NULL) return -1; d.items[d.nitems].freq1 = freq1; d.items[d.nitems].freq2 = freq2; d.items[d.nitems].duration = time; d.items[d.nitems].modulate = modulate; d.nitems++; s = strsep(&stringp,separator); } if (ast_activate_generator(chan, &playtones, &d)) { free(d.items); return -1; } return 0; }

void ast_playtones_stop (  struct ast_channel *  chan  )

Stop the tones from playing Definition at line 220 of file indications.c. References ast_deactivate_generator(). Referenced by ast_indicate(). { ast_deactivate_generator(chan); }

int ast_register_indication (  struct tone_zone *  zone, const char *  indication, const char *  tonelist )

Definition at line 419 of file indications.c. References tone_zone::alias, ast_log(), ast_mutex_lock, ast_mutex_unlock, free, LOG_WARNING, malloc, tone_zone_sound::next, strdup, tone_zone::tones, and tzlock. { struct tone_zone_sound *ts,*ps; /* is it an alias? stop */ if (zone->alias[0]) return -1; if (ast_mutex_lock(&tzlock)) { ast_log(LOG_WARNING, "Unable to lock tone_zones list\n"); return -2; } for (ps=NULL,ts=zone->tones; ts; ps=ts,ts=ts->next) { if (strcasecmp(indication,ts->name)==0) { /* indication already there, replace */ free((void*)ts->name); free((void*)ts->data); break; } } if (!ts) { /* not there, we have to add */ ts = malloc(sizeof(struct tone_zone_sound)); if (!ts) { ast_log(LOG_WARNING, "Out of memory\n"); ast_mutex_unlock(&tzlock); return -2; } ts->next = NULL; } ts->name = strdup(indication); ts->data = strdup(tonelist); if (ts->name==NULL || ts->data==NULL) { ast_log(LOG_WARNING, "Out of memory\n"); ast_mutex_unlock(&tzlock); return -2; } if (ps) ps->next = ts; else zone->tones = ts; ast_mutex_unlock(&tzlock); return 0; }

int ast_register_indication_country (  struct tone_zone *  country  )

Definition at line 334 of file indications.c. References ast_log(), ast_mutex_lock, ast_mutex_unlock, ast_verbose(), tone_zone::country, LOG_WARNING, tone_zone::next, option_verbose, tone_zones, tzlock, and VERBOSE_PREFIX_3. { struct tone_zone *tz,*pz; if (ast_mutex_lock(&tzlock)) { ast_log(LOG_WARNING, "Unable to lock tone_zones list\n"); return -1; } for (pz=NULL,tz=tone_zones; tz; pz=tz,tz=tz->next) { if (strcasecmp(zone->country,tz->country)==0) { /* tone_zone already there, replace */ zone->next = tz->next; if (pz) pz->next = zone; else tone_zones = zone; /* if we are replacing the default zone, re-point it */ if (tz == current_tonezone) current_tonezone = zone; /* now free the previous zone */ free_zone(tz); ast_mutex_unlock(&tzlock); return 0; } } /* country not there, add */ zone->next = NULL; if (pz) pz->next = zone; else tone_zones = zone; ast_mutex_unlock(&tzlock); if (option_verbose > 2) ast_verbose(VERBOSE_PREFIX_3 "Registered indication country '%s'\n",zone->country); return 0; }

int ast_set_indication_country (  const char *  country  )

Definition at line 235 of file indications.c. References ast_get_indication_zone(), ast_verbose(), option_verbose, and VERBOSE_PREFIX_3. { if (country) { struct tone_zone *z = ast_get_indication_zone(country); if (z) { if (option_verbose > 2) ast_verbose(VERBOSE_PREFIX_3 "Setting default indication country to '%s'\n",country); current_tonezone = z; return 0; } } return 1; /* not found */ }

int ast_unregister_indication (  struct tone_zone *  zone, const char *  indication )

Definition at line 465 of file indications.c. References tone_zone::alias, ast_log(), ast_mutex_lock, ast_mutex_unlock, free, LOG_WARNING, tone_zone_sound::next, tone_zone::tones, and tzlock. { struct tone_zone_sound *ts,*ps = NULL, *tmp; int res = -1; /* is it an alias? stop */ if (zone->alias[0]) return -1; if (ast_mutex_lock(&tzlock)) { ast_log(LOG_WARNING, "Unable to lock tone_zones list\n"); return -1; } ts = zone->tones; while (ts) { if (strcasecmp(indication,ts->name)==0) { /* indication found */ tmp = ts->next; if (ps) ps->next = tmp; else zone->tones = tmp; free((void*)ts->name); free((void*)ts->data); free(ts); ts = tmp; res = 0; } else { /* next zone please */ ps = ts; ts = ts->next; } } /* indication not found, goodbye */ ast_mutex_unlock(&tzlock); return res; }

int ast_unregister_indication_country (  const char *  country  )

Definition at line 374 of file indications.c. References ast_log(), ast_mutex_lock, ast_mutex_unlock, ast_verbose(), LOG_NOTICE, LOG_WARNING, tone_zone::next, option_verbose, tone_zones, tzlock, and VERBOSE_PREFIX_3. { struct tone_zone *tz, *pz = NULL, *tmp; int res = -1; if (ast_mutex_lock(&tzlock)) { ast_log(LOG_WARNING, "Unable to lock tone_zones list\n"); return -1; } tz = tone_zones; while (tz) { if (country==NULL || (strcasecmp(country, tz->country)==0 || strcasecmp(country, tz->alias)==0)) { /* tone_zone found, remove */ tmp = tz->next; if (pz) pz->next = tmp; else tone_zones = tmp; /* if we are unregistering the default country, w'll notice */ if (tz == current_tonezone) { ast_log(LOG_NOTICE,"Removed default indication country '%s'\n",tz->country); current_tonezone = NULL; } if (option_verbose > 2) ast_verbose(VERBOSE_PREFIX_3 "Unregistered indication country '%s'\n",tz->country); free_zone(tz); if (tone_zones == tz) tone_zones = tmp; tz = tmp; res = 0; } else { /* next zone please */ pz = tz; tz = tz->next; } } ast_mutex_unlock(&tzlock); return res; }

---

Variable Documentation

struct tone_zone* tone_zones

Definition at line 74 of file indications.h. Referenced by ast_get_indication_tone(), ast_get_indication_zone(), ast_register_indication_country(), and ast_unregister_indication_country().

ast_mutex_t tzlock

Definition at line 75 of file indications.h. Referenced by ast_get_indication_tone(), ast_get_indication_zone(), ast_register_indication(), ast_register_indication_country(), ast_unregister_indication(), and ast_unregister_indication_country().

---