python: models: rename argument ldb to samdb
[samba.git] / source3 / libads / ldap_utils.c
blobc08f046a4057c7375a8443beaa588ca04e3f9f38
1 /*
2 Unix SMB/CIFS implementation.
4 Some Helpful wrappers on LDAP
6 Copyright (C) Andrew Tridgell 2001
7 Copyright (C) Guenther Deschner 2006,2007
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.
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.
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/>.
23 #include "includes.h"
24 #include "ads.h"
25 #include "lib/param/loadparm.h"
27 #ifdef HAVE_LDAP
29 static ADS_STATUS ads_ranged_search_internal(ADS_STRUCT *ads,
30 TALLOC_CTX *mem_ctx,
31 int scope,
32 const char *base,
33 const char *filter,
34 const char **attrs,
35 void *args,
36 const char *range_attr,
37 char ***strings,
38 size_t *num_strings,
39 uint32_t *first_usn,
40 int *num_retries,
41 bool *more_values);
44 a wrapper around ldap_search_s that retries depending on the error code
45 this is supposed to catch dropped connections and auto-reconnect
47 static ADS_STATUS ads_do_search_retry_internal(ADS_STRUCT *ads, const char *bind_path, int scope,
48 const char *expr,
49 const char **attrs, void *args,
50 LDAPMessage **res)
52 ADS_STATUS status;
53 int count = 3;
54 char *bp;
56 *res = NULL;
58 if (!ads->ldap.ld &&
59 time_mono(NULL) - ads->ldap.last_attempt < ADS_RECONNECT_TIME) {
60 return ADS_ERROR(LDAP_SERVER_DOWN);
63 bp = SMB_STRDUP(bind_path);
65 if (!bp) {
66 return ADS_ERROR(LDAP_NO_MEMORY);
69 *res = NULL;
71 /* when binding anonymously, we cannot use the paged search LDAP
72 * control - Guenther */
74 if (ads->auth.flags & ADS_AUTH_ANON_BIND) {
75 status = ads_do_search(ads, bp, scope, expr, attrs, res);
76 } else {
77 status = ads_do_search_all_args(ads, bp, scope, expr, attrs, args, res);
79 if (ADS_ERR_OK(status)) {
80 DEBUG(5,("Search for %s in <%s> gave %d replies\n",
81 expr, bp, ads_count_replies(ads, *res)));
82 SAFE_FREE(bp);
83 return status;
86 while (--count) {
88 if (NT_STATUS_EQUAL(ads_ntstatus(status), NT_STATUS_IO_TIMEOUT) &&
89 ads->config.ldap_page_size >= (lp_ldap_page_size() / 4) &&
90 lp_ldap_page_size() > 4) {
91 int new_page_size = (ads->config.ldap_page_size / 2);
92 DEBUG(1, ("Reducing LDAP page size from %d to %d due to IO_TIMEOUT\n",
93 ads->config.ldap_page_size, new_page_size));
94 ads->config.ldap_page_size = new_page_size;
97 if (*res)
98 ads_msgfree(ads, *res);
99 *res = NULL;
101 DEBUG(3,("Reopening ads connection to realm '%s' after error %s\n",
102 ads->config.realm, ads_errstr(status)));
104 ads_disconnect(ads);
105 status = ads_connect(ads);
107 if (!ADS_ERR_OK(status)) {
108 DEBUG(1,("ads_search_retry: failed to reconnect (%s)\n",
109 ads_errstr(status)));
111 * We need to keep the ads pointer
112 * from being freed here as we don't own it and
113 * callers depend on it being around.
115 ads_disconnect(ads);
116 SAFE_FREE(bp);
117 return status;
120 *res = NULL;
122 /* when binding anonymously, we cannot use the paged search LDAP
123 * control - Guenther */
125 if (ads->auth.flags & ADS_AUTH_ANON_BIND) {
126 status = ads_do_search(ads, bp, scope, expr, attrs, res);
127 } else {
128 status = ads_do_search_all_args(ads, bp, scope, expr, attrs, args, res);
131 if (ADS_ERR_OK(status)) {
132 DEBUG(5,("Search for filter: %s, base: %s gave %d replies\n",
133 expr, bp, ads_count_replies(ads, *res)));
134 SAFE_FREE(bp);
135 return status;
138 SAFE_FREE(bp);
140 if (!ADS_ERR_OK(status)) {
141 DEBUG(1,("ads reopen failed after error %s\n",
142 ads_errstr(status)));
144 return status;
147 ADS_STATUS ads_do_search_retry(ADS_STRUCT *ads, const char *bind_path,
148 int scope, const char *expr,
149 const char **attrs, LDAPMessage **res)
151 return ads_do_search_retry_internal(ads, bind_path, scope, expr, attrs, NULL, res);
154 static ADS_STATUS ads_do_search_retry_args(ADS_STRUCT *ads, const char *bind_path,
155 int scope, const char *expr,
156 const char **attrs, void *args,
157 LDAPMessage **res)
159 return ads_do_search_retry_internal(ads, bind_path, scope, expr, attrs, args, res);
163 ADS_STATUS ads_search_retry(ADS_STRUCT *ads, LDAPMessage **res,
164 const char *expr, const char **attrs)
166 return ads_do_search_retry(ads, ads->config.bind_path, LDAP_SCOPE_SUBTREE,
167 expr, attrs, res);
170 ADS_STATUS ads_search_retry_dn(ADS_STRUCT *ads, LDAPMessage **res,
171 const char *dn,
172 const char **attrs)
174 return ads_do_search_retry(ads, dn, LDAP_SCOPE_BASE,
175 "(objectclass=*)", attrs, res);
178 ADS_STATUS ads_search_retry_dn_sd_flags(ADS_STRUCT *ads, LDAPMessage **res,
179 uint32_t sd_flags,
180 const char *dn,
181 const char **attrs)
183 ads_control args;
185 args.control = ADS_SD_FLAGS_OID;
186 args.val = sd_flags;
187 args.critical = True;
189 return ads_do_search_retry_args(ads, dn, LDAP_SCOPE_BASE,
190 "(objectclass=*)", attrs, &args, res);
193 ADS_STATUS ads_search_retry_extended_dn_ranged(ADS_STRUCT *ads, TALLOC_CTX *mem_ctx,
194 const char *dn,
195 const char **attrs,
196 enum ads_extended_dn_flags flags,
197 char ***strings,
198 size_t *num_strings)
200 ads_control args;
202 args.control = ADS_EXTENDED_DN_OID;
203 args.val = flags;
204 args.critical = True;
206 /* we can only range process one attribute */
207 if (!attrs || !attrs[0] || attrs[1]) {
208 return ADS_ERROR_NT(NT_STATUS_INVALID_PARAMETER);
211 return ads_ranged_search(ads, mem_ctx, LDAP_SCOPE_BASE, dn,
212 "(objectclass=*)", &args, attrs[0],
213 strings, num_strings);
217 ADS_STATUS ads_search_retry_sid(ADS_STRUCT *ads, LDAPMessage **res,
218 const struct dom_sid *sid,
219 const char **attrs)
221 char *dn, *sid_string;
222 ADS_STATUS status;
224 sid_string = sid_binstring_hex_talloc(talloc_tos(), sid);
225 if (sid_string == NULL) {
226 return ADS_ERROR(LDAP_NO_MEMORY);
229 if (!asprintf(&dn, "<SID=%s>", sid_string)) {
230 TALLOC_FREE(sid_string);
231 return ADS_ERROR(LDAP_NO_MEMORY);
234 status = ads_do_search_retry(ads, dn, LDAP_SCOPE_BASE,
235 "(objectclass=*)", attrs, res);
236 SAFE_FREE(dn);
237 TALLOC_FREE(sid_string);
238 return status;
241 ADS_STATUS ads_ranged_search(ADS_STRUCT *ads,
242 TALLOC_CTX *mem_ctx,
243 int scope,
244 const char *base,
245 const char *filter,
246 void *args,
247 const char *range_attr,
248 char ***strings,
249 size_t *num_strings)
251 ADS_STATUS status;
252 uint32_t first_usn;
253 int num_retries = 0;
254 const char **attrs;
255 bool more_values = False;
257 *num_strings = 0;
258 *strings = NULL;
260 attrs = talloc_array(mem_ctx, const char *, 3);
261 ADS_ERROR_HAVE_NO_MEMORY(attrs);
263 attrs[0] = talloc_strdup(mem_ctx, range_attr);
264 attrs[1] = talloc_strdup(mem_ctx, "usnChanged");
265 attrs[2] = NULL;
267 ADS_ERROR_HAVE_NO_MEMORY(attrs[0]);
268 ADS_ERROR_HAVE_NO_MEMORY(attrs[1]);
270 do {
271 status = ads_ranged_search_internal(ads, mem_ctx,
272 scope, base, filter,
273 attrs, args, range_attr,
274 strings, num_strings,
275 &first_usn, &num_retries,
276 &more_values);
278 if (NT_STATUS_EQUAL(STATUS_MORE_ENTRIES, ads_ntstatus(status))) {
279 continue;
282 if (!ADS_ERR_OK(status)) {
283 *num_strings = 0;
284 strings = NULL;
285 goto done;
288 } while (more_values);
290 done:
291 DEBUG(10,("returning with %d strings\n", (int)*num_strings));
293 return status;
296 static ADS_STATUS ads_ranged_search_internal(ADS_STRUCT *ads,
297 TALLOC_CTX *mem_ctx,
298 int scope,
299 const char *base,
300 const char *filter,
301 const char **attrs,
302 void *args,
303 const char *range_attr,
304 char ***strings,
305 size_t *num_strings,
306 uint32_t *first_usn,
307 int *num_retries,
308 bool *more_values)
310 LDAPMessage *res = NULL;
311 ADS_STATUS status;
312 int count;
313 uint32_t current_usn;
315 DEBUG(10, ("Searching for attrs[0] = %s, attrs[1] = %s\n", attrs[0], attrs[1]));
317 *more_values = False;
319 status = ads_do_search_retry_internal(ads, base, scope, filter, attrs, args, &res);
321 if (!ADS_ERR_OK(status)) {
322 DEBUG(1,("ads_search: %s\n",
323 ads_errstr(status)));
324 return status;
327 if (!res) {
328 return ADS_ERROR(LDAP_NO_MEMORY);
331 count = ads_count_replies(ads, res);
332 if (count == 0) {
333 ads_msgfree(ads, res);
334 return ADS_ERROR(LDAP_SUCCESS);
337 if (*num_strings == 0) {
338 if (!ads_pull_uint32(ads, res, "usnChanged", first_usn)) {
339 DEBUG(1, ("could not pull first usnChanged!\n"));
340 ads_msgfree(ads, res);
341 return ADS_ERROR(LDAP_NO_MEMORY);
345 if (!ads_pull_uint32(ads, res, "usnChanged", &current_usn)) {
346 DEBUG(1, ("could not pull current usnChanged!\n"));
347 ads_msgfree(ads, res);
348 return ADS_ERROR(LDAP_NO_MEMORY);
351 if (*first_usn != current_usn) {
352 DEBUG(5, ("USN on this record changed"
353 " - restarting search\n"));
354 if (*num_retries < 5) {
355 (*num_retries)++;
356 *num_strings = 0;
357 ads_msgfree(ads, res);
358 return ADS_ERROR_NT(STATUS_MORE_ENTRIES);
359 } else {
360 DEBUG(5, ("USN on this record changed"
361 " - restarted search too many times, aborting!\n"));
362 ads_msgfree(ads, res);
363 return ADS_ERROR(LDAP_NO_MEMORY);
367 *strings = ads_pull_strings_range(ads, mem_ctx, res,
368 range_attr,
369 *strings,
370 &attrs[0],
371 num_strings,
372 more_values);
374 ads_msgfree(ads, res);
376 /* paranoia checks */
377 if (*strings == NULL && *more_values) {
378 DEBUG(0,("no strings found but more values???\n"));
379 return ADS_ERROR(LDAP_NO_MEMORY);
381 if (*num_strings == 0 && *more_values) {
382 DEBUG(0,("no strings found but more values???\n"));
383 return ADS_ERROR(LDAP_NO_MEMORY);
386 return (*more_values) ? ADS_ERROR_NT(STATUS_MORE_ENTRIES) : ADS_ERROR(LDAP_SUCCESS);
389 #endif