ee471551d184a03ddd91e056362aeda762e115f9
[asterisk/asterisk.git] / main / datastore.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2007 - 2008, Digium, Inc.
5  *
6  * See http://www.asterisk.org for more information about
7  * the Asterisk project. Please do not directly contact
8  * any of the maintainers of this project for assistance;
9  * the project provides a web site, mailing lists and IRC
10  * channels for your use.
11  *
12  * This program is free software, distributed under the terms of
13  * the GNU General Public License Version 2. See the LICENSE file
14  * at the top of the source tree.
15  */
16
17 /*! \file
18  *
19  * \brief Asterisk datastore objects
20  */
21
22 #include "asterisk.h"
23
24 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
25
26 #include "asterisk/_private.h"
27
28 #include "asterisk/datastore.h"
29 #include "asterisk/utils.h"
30
31 struct ast_datastore *__ast_datastore_alloc(const struct ast_datastore_info *info, const char *uid,
32                                             const char *file, int line, const char *function)
33 {
34         struct ast_datastore *datastore = NULL;
35
36         /* Make sure we at least have type so we can identify this */
37         if (!info) {
38                 return NULL;
39         }
40
41 #if defined(__AST_DEBUG_MALLOC)
42         if (!(datastore = __ast_calloc(1, sizeof(*datastore), file, line, function))) {
43                 return NULL;
44         }
45 #else
46         if (!(datastore = ast_calloc(1, sizeof(*datastore)))) {
47                 return NULL;
48         }
49 #endif
50
51         datastore->info = info;
52
53         if (!ast_strlen_zero(uid) && !(datastore->uid = ast_strdup(uid))) {
54                 ast_free(datastore);
55                 datastore = NULL;
56         }
57
58         return datastore;
59 }
60
61 int ast_datastore_free(struct ast_datastore *datastore)
62 {
63         int res = 0;
64
65         /* Using the destroy function (if present) destroy the data */
66         if (datastore->info->destroy != NULL && datastore->data != NULL) {
67                 datastore->info->destroy(datastore->data);
68                 datastore->data = NULL;
69         }
70
71         /* Free allocated UID memory */
72         if (datastore->uid != NULL) {
73                 ast_free((void *) datastore->uid);
74                 datastore->uid = NULL;
75         }
76
77         /* Finally free memory used by ourselves */
78         ast_free(datastore);
79
80         return res;
81 }
82
83 /* DO NOT PUT ADDITIONAL FUNCTIONS BELOW THIS BOUNDARY
84  *
85  * ONLY FUNCTIONS FOR PROVIDING BACKWARDS ABI COMPATIBILITY BELONG HERE
86  *
87  */
88
89 /* Provide binary compatibility for modules that call ast_datastore_alloc() directly;
90  * newly compiled modules will call __ast_datastore_alloc() via the macros in datastore.h
91  */
92 #undef ast_datastore_alloc
93 struct ast_datastore *ast_datastore_alloc(const struct ast_datastore_info *info, const char *uid);
94 struct ast_datastore *ast_datastore_alloc(const struct ast_datastore_info *info, const char *uid)
95 {
96         return __ast_datastore_alloc(info, uid, __FILE__, __LINE__, __FUNCTION__);
97 }