aaadf4ebf53afca11b96b41aa451808c243de700
[asterisk/asterisk.git] / apps / app_db.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2005, Digium, Inc.
5  * Copyright (C) 2003, Jefferson Noxon
6  *
7  * Mark Spencer <markster@digium.com>
8  * Jefferson Noxon <jeff@debian.org>
9  *
10  * See http://www.asterisk.org for more information about
11  * the Asterisk project. Please do not directly contact
12  * any of the maintainers of this project for assistance;
13  * the project provides a web site, mailing lists and IRC
14  * channels for your use.
15  *
16  * This program is free software, distributed under the terms of
17  * the GNU General Public License Version 2. See the LICENSE file
18  * at the top of the source tree.
19  */
20
21 /*! \file
22  *
23  * \brief Database access functions
24  *
25  * \author Mark Spencer <markster@digium.com>
26  * \author Jefferson Noxon <jeff@debian.org>
27  *
28  * \ingroup applications
29  */
30
31 #include "asterisk.h"
32
33 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
34
35 #include <stdlib.h>
36 #include <stdio.h>
37 #include <string.h>
38 #include <unistd.h>
39 #include <sys/types.h>
40
41 #include "asterisk/options.h"
42 #include "asterisk/file.h"
43 #include "asterisk/logger.h"
44 #include "asterisk/channel.h"
45 #include "asterisk/pbx.h"
46 #include "asterisk/module.h"
47 #include "asterisk/astdb.h"
48 #include "asterisk/lock.h"
49 #include "asterisk/options.h"
50
51 /*! \todo XXX Remove this application after 1.4 is relased */
52 static char *d_descrip =
53 "  DBdel(family/key): This application will delete a key from the Asterisk\n"
54 "database.\n"
55 "  This application has been DEPRECATED in favor of the DB_DELETE function.\n";
56
57 static char *dt_descrip =
58 "  DBdeltree(family[/keytree]): This application will delete a family or keytree\n"
59 "from the Asterisk database\n";
60
61 static char *d_app = "DBdel";
62 static char *dt_app = "DBdeltree";
63
64 static char *d_synopsis = "Delete a key from the database";
65 static char *dt_synopsis = "Delete a family or keytree from the database";
66
67
68 static int deltree_exec(struct ast_channel *chan, void *data)
69 {
70         char *argv, *family, *keytree;
71         struct ast_module_user *u;
72
73         u = ast_module_user_add(chan);
74
75         argv = ast_strdupa(data);
76
77         if (strchr(argv, '/')) {
78                 family = strsep(&argv, "/");
79                 keytree = strsep(&argv, "\0");
80                         if (!family || !keytree) {
81                                 if (option_debug)
82                                         ast_log(LOG_DEBUG, "Ignoring; Syntax error in argument\n");
83                                 ast_module_user_remove(u);
84                                 return 0;
85                         }
86                 if (ast_strlen_zero(keytree))
87                         keytree = 0;
88         } else {
89                 family = argv;
90                 keytree = 0;
91         }
92
93         if (option_verbose > 2) {
94                 if (keytree)
95                         ast_verbose(VERBOSE_PREFIX_3 "DBdeltree: family=%s, keytree=%s\n", family, keytree);
96                 else
97                         ast_verbose(VERBOSE_PREFIX_3 "DBdeltree: family=%s\n", family);
98         }
99
100         if (ast_db_deltree(family, keytree)) {
101                 if (option_verbose > 2)
102                         ast_verbose(VERBOSE_PREFIX_3 "DBdeltree: Error deleting key from database.\n");
103         }
104
105         ast_module_user_remove(u);
106
107         return 0;
108 }
109
110 static int del_exec(struct ast_channel *chan, void *data)
111 {
112         char *argv, *family, *key;
113         struct ast_module_user *u;
114         static int deprecation_warning = 0;
115
116         u = ast_module_user_add(chan);
117
118         if (!deprecation_warning) {
119                 deprecation_warning = 1;
120                 ast_log(LOG_WARNING, "The DBdel application has been deprecated in favor of the DB_DELETE dialplan function!\n");
121         }
122
123         argv = ast_strdupa(data);
124
125         if (strchr(argv, '/')) {
126                 family = strsep(&argv, "/");
127                 key = strsep(&argv, "\0");
128                 if (!family || !key) {
129                         if (option_debug)
130                                 ast_log(LOG_DEBUG, "Ignoring; Syntax error in argument\n");
131                         ast_module_user_remove(u);
132                         return 0;
133                 }
134                 if (option_verbose > 2)
135                         ast_verbose(VERBOSE_PREFIX_3 "DBdel: family=%s, key=%s\n", family, key);
136                 if (ast_db_del(family, key)) {
137                         if (option_verbose > 2)
138                                 ast_verbose(VERBOSE_PREFIX_3 "DBdel: Error deleting key from database.\n");
139                 }
140         } else {
141                 if (option_debug)
142                         ast_log(LOG_DEBUG, "Ignoring, no parameters\n");
143         }
144
145         ast_module_user_remove(u);
146         
147         return 0;
148 }
149
150 static int unload_module(void)
151 {
152         int retval;
153
154         retval = ast_unregister_application(dt_app);
155         retval |= ast_unregister_application(d_app);
156
157         return retval;
158 }
159
160 static int load_module(void)
161 {
162         int retval;
163
164         retval = ast_register_application(d_app, del_exec, d_synopsis, d_descrip);
165         retval |= ast_register_application(dt_app, deltree_exec, dt_synopsis, dt_descrip);
166         
167         return retval;
168 }
169
170 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Database Access Functions");