ldb:gendb_* calls: support a "NULL" resultset parameter
[samba.git] / lib / util / util_ldb.c
1 /*
2    Unix SMB/CIFS implementation.
3
4    common share info functions
5
6    Copyright (C) Andrew Tridgell 2004
7    Copyright (C) Tim Potter 2004
8
9    This program is free software; you can redistribute it and/or modify
10    it under the terms of the GNU General Public License as published by
11    the Free Software Foundation; either version 3 of the License, or
12    (at your option) any later version.
13
14    This program is distributed in the hope that it will be useful,
15    but WITHOUT ANY WARRANTY; without even the implied warranty of
16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17    GNU General Public License for more details.
18
19    You should have received a copy of the GNU General Public License
20    along with this program.  If not, see <http://www.gnu.org/licenses/>.
21 */
22
23 #include "includes.h"
24 #include "lib/ldb/include/ldb.h"
25 #include "../lib/util/util_ldb.h"
26
27 /*
28  * search the LDB for the specified attributes - va_list variant
29  */
30 int gendb_search_v(struct ldb_context *ldb,
31                    TALLOC_CTX *mem_ctx,
32                    struct ldb_dn *basedn,
33                    struct ldb_message ***msgs,
34                    const char * const *attrs,
35                    const char *format,
36                    va_list ap)
37 {
38         enum ldb_scope scope = LDB_SCOPE_SUBTREE;
39         struct ldb_result *res;
40         char *expr = NULL;
41         int ret;
42
43         if (format) {
44                 expr = talloc_vasprintf(mem_ctx, format, ap);
45                 if (expr == NULL) {
46                         return -1;
47                 }
48         } else {
49                 scope = LDB_SCOPE_BASE;
50         }
51
52         res = NULL;
53
54         ret = ldb_search(ldb, mem_ctx, &res, basedn, scope, attrs,
55                          expr?"%s":NULL, expr);
56
57         if (ret == LDB_SUCCESS) {
58                 DEBUG(6,("gendb_search_v: %s %s -> %d\n",
59                          basedn?ldb_dn_get_linearized(basedn):"NULL",
60                          expr?expr:"NULL", res->count));
61
62                 ret = res->count;
63                 if (msgs != NULL) {
64                         *msgs = talloc_steal(mem_ctx, res->msgs);
65                 }
66                 talloc_free(res);
67         } else if (scope == LDB_SCOPE_BASE && ret == LDB_ERR_NO_SUCH_OBJECT) {
68                 ret = 0;
69                 if (msgs != NULL) *msgs = NULL;
70         } else {
71                 DEBUG(4,("gendb_search_v: search failed: %s\n",
72                                         ldb_errstring(ldb)));
73                 ret = -1;
74                 if (msgs != NULL) *msgs = NULL;
75         }
76
77         talloc_free(expr);
78
79         return ret;
80 }
81
82 /*
83  * search the LDB for the specified attributes - varargs variant
84  */
85 int gendb_search(struct ldb_context *ldb,
86                  TALLOC_CTX *mem_ctx,
87                  struct ldb_dn *basedn,
88                  struct ldb_message ***res,
89                  const char * const *attrs,
90                  const char *format, ...)
91 {
92         va_list ap;
93         int count;
94
95         va_start(ap, format);
96         count = gendb_search_v(ldb, mem_ctx, basedn, res, attrs, format, ap);
97         va_end(ap);
98
99         return count;
100 }
101
102 /*
103  * search the LDB for a specified record (by DN)
104  */
105 int gendb_search_dn(struct ldb_context *ldb,
106                  TALLOC_CTX *mem_ctx,
107                  struct ldb_dn *dn,
108                  struct ldb_message ***res,
109                  const char * const *attrs)
110 {
111         return gendb_search(ldb, mem_ctx, dn, res, attrs, NULL);
112 }
113