mirror of
https://github.com/asterisk/asterisk.git
synced 2025-09-05 12:16:00 +00:00
42d4c7991c
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@134 65c4cc65-6c06-0410-ace0-fbb531ad65f3
128 lines
3.2 KiB
C
Executable File
128 lines
3.2 KiB
C
Executable File
/*
|
|
* 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
|