1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
|
/*
* Asterisk -- A telephony toolkit for Linux.
*
* Module definitions
*
* Copyright (C) 1999, Mark Spencer
*
* Mark Spencer <markster@linux-support.net>
*
* This program is free software, distributed under the terms of
* the GNU General Public License
*/
#ifndef _ASTERISK_MODULE_H
#define _ASTERISK_MODULE_H
#if defined(__cplusplus) || defined(c_plusplus)
extern "C" {
#endif
/* Every module must provide these functions */
int load_module(void); /* Initialize the module */
int unload_module(void); /* Cleanup all module structures,
sockets, etc */
int usecount(void); /* How many channels provided by this module are in use? */
char *description(void); /* Description of this module */
#define AST_MODULE_CONFIG "modules.conf" /* Module configuration file */
#define AST_FORCE_SOFT 0
#define AST_FORCE_FIRM 1
#define AST_FORCE_HARD 2
/* Load a module */
int ast_load_resource(char *resource_name);
/* Unload a module. Force unloading a module is not recommended. */
int ast_unload_resource(char *resource_name, int force);
/* Notify when usecount has been changed */
void ast_update_use_count(void);
/* Ask for a list of modules, descriptions, and use counts */
int ast_update_module_list(int (*modentry)(char *module, char *description, int usecnt));
/* Ask this procedure to be run with modules have been updated */
int ast_loader_register(int (*updater)(void));
/* No longer run me when modules are updated */
int ast_loader_unregister(int (*updater)(void));
/* Local user routines keep track of which channels are using a given module resource.
They can help make removing modules safer, particularly if they're in use at the time
they have been requested to be removed */
#define STANDARD_LOCAL_USER struct localuser { \
struct ast_channel *chan; \
struct localuser *next; \
}
#define LOCAL_USER_DECL static pthread_mutex_t localuser_lock = PTHREAD_MUTEX_INITIALIZER; \
static struct localuser *localusers = NULL; \
static int localusecnt = 0;
#define LOCAL_USER_ADD(u) { \
\
if (!(u=malloc(sizeof(struct localuser)))) { \
ast_log(LOG_WARNING, "Out of memory\n"); \
return -1; \
} \
pthread_mutex_lock(&localuser_lock); \
u->chan = chan; \
u->next = localusers; \
localusers = u; \
localusecnt++; \
pthread_mutex_unlock(&localuser_lock); \
ast_update_use_count(); \
}
#define LOCAL_USER_REMOVE(u) { \
struct localuser *uc, *ul = NULL; \
pthread_mutex_lock(&localuser_lock); \
uc = localusers; \
while (uc) { \
if (uc == u) { \
if (ul) \
ul->next = uc->next; \
else \
localusers = uc->next; \
break; \
} \
ul = uc; \
uc = uc->next; \
}\
free(u); \
localusecnt--; \
pthread_mutex_unlock(&localuser_lock); \
ast_update_use_count(); \
}
#define STANDARD_HANGUP_LOCALUSERS { \
struct localuser *u, *ul; \
pthread_mutex_lock(&localuser_lock); \
u = localusers; \
while(u) { \
ast_softhangup(u->chan); \
ul = u; \
u = u->next; \
free(ul); \
} \
pthread_mutex_unlock(&localuser_lock); \
localusecnt=0; \
}
#define STANDARD_USECOUNT(res) { \
pthread_mutex_lock(&localuser_lock); \
res = localusecnt; \
pthread_mutex_unlock(&localuser_lock); \
}
#if defined(__cplusplus) || defined(c_plusplus)
}
#endif
#endif
|