811390829769f7b7a404ae07b674d4b6f4e6b1ce
[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 "asterisk/options.h"
36 #include "asterisk/file.h"
37 #include "asterisk/logger.h"
38 #include "asterisk/channel.h"
39 #include "asterisk/pbx.h"
40 #include "asterisk/module.h"
41 #include "asterisk/astdb.h"
42 #include "asterisk/lock.h"
43
44 /*! \todo XXX Remove this application after 1.4 is relased */
45 static char *d_descrip =
46 "  DBdel(family/key): This application will delete a key from the Asterisk\n"
47 "database.\n"
48 "  This application has been DEPRECATED in favor of the DB_DELETE function.\n";
49
50 static char *dt_descrip =
51 "  DBdeltree(family[/keytree]): This application will delete a family or keytree\n"
52 "from the Asterisk database\n";
53
54 static char *d_app = "DBdel";
55 static char *dt_app = "DBdeltree";
56
57 static char *d_synopsis = "Delete a key from the database";
58 static char *dt_synopsis = "Delete a family or keytree from the database";
59
60
61 static int deltree_exec(struct ast_channel *chan, void *data)
62 {
63         char *argv, *family, *keytree;
64         
65         argv = ast_strdupa(data);
66         
67         if (strchr(argv, '/')) {
68                 family = strsep(&argv, "/");
69                 keytree = strsep(&argv, "\0");
70                 if (!family || !keytree) {
71                         ast_debug(1, "Ignoring; Syntax error in argument\n");
72                         return 0;
73                 }
74                 if (ast_strlen_zero(keytree))
75                         keytree = 0;
76         } else {
77                 family = argv;
78                 keytree = 0;
79         }
80         
81         if (keytree)
82                 ast_verb(3, "DBdeltree: family=%s, keytree=%s\n", family, keytree);
83         else
84                 ast_verb(3, "DBdeltree: family=%s\n", family);
85         
86         if (ast_db_deltree(family, keytree))
87                 ast_verb(3, "DBdeltree: Error deleting key from database.\n");
88
89         return 0;
90 }
91
92 static int del_exec(struct ast_channel *chan, void *data)
93 {
94         char *argv, *family, *key;
95         static int deprecation_warning = 0;
96         
97         if (!deprecation_warning) {
98                 deprecation_warning = 1;
99                 ast_log(LOG_WARNING, "The DBdel application has been deprecated in favor of the DB_DELETE dialplan function!\n");
100         }
101         
102         argv = ast_strdupa(data);
103         
104         if (strchr(argv, '/')) {
105                 family = strsep(&argv, "/");
106                 key = strsep(&argv, "\0");
107                 if (!family || !key) {
108                         ast_debug(1, "Ignoring; Syntax error in argument\n");
109                         return 0;
110                 }
111                 ast_verb(3, "DBdel: family=%s, key=%s\n", family, key);
112                 if (ast_db_del(family, key))
113                         ast_verb(3, "DBdel: Error deleting key from database.\n");
114         } else {
115                 ast_debug(1, "Ignoring, no parameters\n");
116         }
117         
118         return 0;
119 }
120
121 static int unload_module(void)
122 {
123         int retval;
124
125         retval = ast_unregister_application(dt_app);
126         retval |= ast_unregister_application(d_app);
127
128         return retval;
129 }
130
131 static int load_module(void)
132 {
133         int retval;
134
135         retval = ast_register_application(d_app, del_exec, d_synopsis, d_descrip);
136         retval |= ast_register_application(dt_app, deltree_exec, dt_synopsis, dt_descrip);
137         
138         return retval;
139 }
140
141 AST_MODULE_INFO_STANDARD(ASTERISK_GPL_KEY, "Database Access Functions");