docs-xml: fix typos and format in smb.conf server max protocol man
[Samba/gebeck_regimport.git] / lib / ldb / common / ldb_match.c
blob5eee02dea31197a7e146a666a9af28dd6c30f43a
1 /*
2 ldb database library
4 Copyright (C) Andrew Tridgell 2004-2005
5 Copyright (C) Simo Sorce 2005
7 ** NOTE! The following LGPL license applies to the ldb
8 ** library. This does NOT imply that all of Samba is released
9 ** under the LGPL
11 This library is free software; you can redistribute it and/or
12 modify it under the terms of the GNU Lesser General Public
13 License as published by the Free Software Foundation; either
14 version 3 of the License, or (at your option) any later version.
16 This library is distributed in the hope that it will be useful,
17 but WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public
22 License along with this library; if not, see <http://www.gnu.org/licenses/>.
26 * Name: ldb
28 * Component: ldb expression matching
30 * Description: ldb expression matching
32 * Author: Andrew Tridgell
35 #include "ldb_private.h"
38 check if the scope matches in a search result
40 static int ldb_match_scope(struct ldb_context *ldb,
41 struct ldb_dn *base,
42 struct ldb_dn *dn,
43 enum ldb_scope scope)
45 int ret = 0;
47 if (base == NULL || dn == NULL) {
48 return 1;
51 switch (scope) {
52 case LDB_SCOPE_BASE:
53 if (ldb_dn_compare(base, dn) == 0) {
54 ret = 1;
56 break;
58 case LDB_SCOPE_ONELEVEL:
59 if (ldb_dn_get_comp_num(dn) == (ldb_dn_get_comp_num(base) + 1)) {
60 if (ldb_dn_compare_base(base, dn) == 0) {
61 ret = 1;
64 break;
66 case LDB_SCOPE_SUBTREE:
67 default:
68 if (ldb_dn_compare_base(base, dn) == 0) {
69 ret = 1;
71 break;
74 return ret;
79 match if node is present
81 static int ldb_match_present(struct ldb_context *ldb,
82 const struct ldb_message *msg,
83 const struct ldb_parse_tree *tree,
84 enum ldb_scope scope, bool *matched)
86 const struct ldb_schema_attribute *a;
87 struct ldb_message_element *el;
89 if (ldb_attr_dn(tree->u.present.attr) == 0) {
90 *matched = true;
91 return LDB_SUCCESS;
94 el = ldb_msg_find_element(msg, tree->u.present.attr);
95 if (el == NULL) {
96 *matched = false;
97 return LDB_SUCCESS;
100 a = ldb_schema_attribute_by_name(ldb, el->name);
101 if (!a) {
102 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
105 if (a->syntax->operator_fn) {
106 unsigned int i;
107 for (i = 0; i < el->num_values; i++) {
108 int ret = a->syntax->operator_fn(ldb, LDB_OP_PRESENT, a, &el->values[i], NULL, matched);
109 if (ret != LDB_SUCCESS) return ret;
110 if (*matched) return LDB_SUCCESS;
112 *matched = false;
113 return LDB_SUCCESS;
116 *matched = true;
117 return LDB_SUCCESS;
120 static int ldb_match_comparison(struct ldb_context *ldb,
121 const struct ldb_message *msg,
122 const struct ldb_parse_tree *tree,
123 enum ldb_scope scope,
124 enum ldb_parse_op comp_op, bool *matched)
126 unsigned int i;
127 struct ldb_message_element *el;
128 const struct ldb_schema_attribute *a;
130 /* FIXME: APPROX comparison not handled yet */
131 if (comp_op == LDB_OP_APPROX) {
132 return LDB_ERR_INAPPROPRIATE_MATCHING;
135 el = ldb_msg_find_element(msg, tree->u.comparison.attr);
136 if (el == NULL) {
137 *matched = false;
138 return LDB_SUCCESS;
141 a = ldb_schema_attribute_by_name(ldb, el->name);
142 if (!a) {
143 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
146 for (i = 0; i < el->num_values; i++) {
147 if (a->syntax->operator_fn) {
148 int ret;
149 ret = a->syntax->operator_fn(ldb, comp_op, a, &el->values[i], &tree->u.comparison.value, matched);
150 if (ret != LDB_SUCCESS) return ret;
151 if (*matched) return LDB_SUCCESS;
152 } else {
153 int ret = a->syntax->comparison_fn(ldb, ldb, &el->values[i], &tree->u.comparison.value);
155 if (ret == 0) {
156 *matched = true;
157 return LDB_SUCCESS;
159 if (ret > 0 && comp_op == LDB_OP_GREATER) {
160 *matched = true;
161 return LDB_SUCCESS;
163 if (ret < 0 && comp_op == LDB_OP_LESS) {
164 *matched = true;
165 return LDB_SUCCESS;
170 *matched = false;
171 return LDB_SUCCESS;
175 match a simple leaf node
177 static int ldb_match_equality(struct ldb_context *ldb,
178 const struct ldb_message *msg,
179 const struct ldb_parse_tree *tree,
180 enum ldb_scope scope,
181 bool *matched)
183 unsigned int i;
184 struct ldb_message_element *el;
185 const struct ldb_schema_attribute *a;
186 struct ldb_dn *valuedn;
187 int ret;
189 if (ldb_attr_dn(tree->u.equality.attr) == 0) {
190 valuedn = ldb_dn_from_ldb_val(ldb, ldb, &tree->u.equality.value);
191 if (valuedn == NULL) {
192 return LDB_ERR_INVALID_DN_SYNTAX;
195 ret = ldb_dn_compare(msg->dn, valuedn);
197 talloc_free(valuedn);
199 *matched = (ret == 0);
200 return LDB_SUCCESS;
203 /* TODO: handle the "*" case derived from an extended search
204 operation without the attibute type defined */
205 el = ldb_msg_find_element(msg, tree->u.equality.attr);
206 if (el == NULL) {
207 *matched = false;
208 return LDB_SUCCESS;
211 a = ldb_schema_attribute_by_name(ldb, el->name);
212 if (a == NULL) {
213 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
216 for (i=0;i<el->num_values;i++) {
217 if (a->syntax->operator_fn) {
218 ret = a->syntax->operator_fn(ldb, LDB_OP_EQUALITY, a,
219 &tree->u.equality.value, &el->values[i], matched);
220 if (ret != LDB_SUCCESS) return ret;
221 if (*matched) return LDB_SUCCESS;
222 } else {
223 if (a->syntax->comparison_fn(ldb, ldb, &tree->u.equality.value,
224 &el->values[i]) == 0) {
225 *matched = true;
226 return LDB_SUCCESS;
231 *matched = false;
232 return LDB_SUCCESS;
235 static int ldb_wildcard_compare(struct ldb_context *ldb,
236 const struct ldb_parse_tree *tree,
237 const struct ldb_val value, bool *matched)
239 const struct ldb_schema_attribute *a;
240 struct ldb_val val;
241 struct ldb_val cnk;
242 struct ldb_val *chunk;
243 char *p, *g;
244 uint8_t *save_p = NULL;
245 unsigned int c = 0;
247 a = ldb_schema_attribute_by_name(ldb, tree->u.substring.attr);
248 if (!a) {
249 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
252 if (a->syntax->canonicalise_fn(ldb, ldb, &value, &val) != 0) {
253 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
256 save_p = val.data;
257 cnk.data = NULL;
259 if ( ! tree->u.substring.start_with_wildcard ) {
261 chunk = tree->u.substring.chunks[c];
262 if (a->syntax->canonicalise_fn(ldb, ldb, chunk, &cnk) != 0) goto mismatch;
264 /* This deals with wildcard prefix searches on binary attributes (eg objectGUID) */
265 if (cnk.length > val.length) {
266 goto mismatch;
268 if (memcmp((char *)val.data, (char *)cnk.data, cnk.length) != 0) goto mismatch;
269 val.length -= cnk.length;
270 val.data += cnk.length;
271 c++;
272 talloc_free(cnk.data);
273 cnk.data = NULL;
276 while (tree->u.substring.chunks[c]) {
278 chunk = tree->u.substring.chunks[c];
279 if(a->syntax->canonicalise_fn(ldb, ldb, chunk, &cnk) != 0) goto mismatch;
281 /* FIXME: case of embedded nulls */
282 p = strstr((char *)val.data, (char *)cnk.data);
283 if (p == NULL) goto mismatch;
284 if ( (! tree->u.substring.chunks[c + 1]) && (! tree->u.substring.end_with_wildcard) ) {
285 do { /* greedy */
286 g = strstr((char *)p + cnk.length, (char *)cnk.data);
287 if (g) p = g;
288 } while(g);
290 val.length = val.length - (p - (char *)(val.data)) - cnk.length;
291 val.data = (uint8_t *)(p + cnk.length);
292 c++;
293 talloc_free(cnk.data);
294 cnk.data = NULL;
297 /* last chunk may not have reached end of string */
298 if ( (! tree->u.substring.end_with_wildcard) && (*(val.data) != 0) ) goto mismatch;
299 talloc_free(save_p);
300 *matched = true;
301 return LDB_SUCCESS;
303 mismatch:
304 *matched = false;
305 talloc_free(save_p);
306 talloc_free(cnk.data);
307 return LDB_SUCCESS;
311 match a simple leaf node
313 static int ldb_match_substring(struct ldb_context *ldb,
314 const struct ldb_message *msg,
315 const struct ldb_parse_tree *tree,
316 enum ldb_scope scope, bool *matched)
318 unsigned int i;
319 struct ldb_message_element *el;
321 el = ldb_msg_find_element(msg, tree->u.substring.attr);
322 if (el == NULL) {
323 *matched = false;
324 return LDB_SUCCESS;
327 for (i = 0; i < el->num_values; i++) {
328 int ret;
329 ret = ldb_wildcard_compare(ldb, tree, el->values[i], matched);
330 if (ret != LDB_SUCCESS) return ret;
331 if (*matched) return LDB_SUCCESS;
334 *matched = false;
335 return LDB_SUCCESS;
340 bitwise-and comparator
342 static int ldb_comparator_bitmask(const char *oid, const struct ldb_val *v1, const struct ldb_val *v2,
343 bool *matched)
345 uint64_t i1, i2;
346 char ibuf[100];
347 char *endptr = NULL;
349 if (v1->length >= sizeof(ibuf)-1) {
350 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
352 memcpy(ibuf, (char *)v1->data, v1->length);
353 ibuf[v1->length] = 0;
354 i1 = strtoull(ibuf, &endptr, 0);
355 if (endptr != NULL) {
356 if (endptr == ibuf || *endptr != 0) {
357 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
361 if (v2->length >= sizeof(ibuf)-1) {
362 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
364 endptr = NULL;
365 memcpy(ibuf, (char *)v2->data, v2->length);
366 ibuf[v2->length] = 0;
367 i2 = strtoull(ibuf, &endptr, 0);
368 if (endptr != NULL) {
369 if (endptr == ibuf || *endptr != 0) {
370 return LDB_ERR_INVALID_ATTRIBUTE_SYNTAX;
373 if (strcmp(LDB_OID_COMPARATOR_AND, oid) == 0) {
374 *matched = ((i1 & i2) == i2);
375 } else if (strcmp(LDB_OID_COMPARATOR_OR, oid) == 0) {
376 *matched = ((i1 & i2) != 0);
377 } else {
378 return LDB_ERR_INAPPROPRIATE_MATCHING;
380 return LDB_SUCCESS;
384 always return false
386 static int ldb_comparator_false(const char *oid, const struct ldb_val *v1, const struct ldb_val *v2,
387 bool *matched)
389 *matched = false;
390 return LDB_SUCCESS;
395 extended match, handles things like bitops
397 static int ldb_match_extended(struct ldb_context *ldb,
398 const struct ldb_message *msg,
399 const struct ldb_parse_tree *tree,
400 enum ldb_scope scope, bool *matched)
402 unsigned int i;
403 const struct {
404 const char *oid;
405 int (*comparator)(const char *, const struct ldb_val *, const struct ldb_val *, bool *);
406 } rules[] = {
407 { LDB_OID_COMPARATOR_AND, ldb_comparator_bitmask},
408 { LDB_OID_COMPARATOR_OR, ldb_comparator_bitmask},
409 { SAMBA_LDAP_MATCH_ALWAYS_FALSE, ldb_comparator_false}
411 int (*comp)(const char *,const struct ldb_val *, const struct ldb_val *, bool *) = NULL;
412 struct ldb_message_element *el;
414 if (tree->u.extended.dnAttributes) {
415 /* FIXME: We really need to find out what this ":dn" part in
416 * an extended match means and how to handle it. For now print
417 * only a warning to have s3 winbind and other tools working
418 * against us. - Matthias */
419 ldb_debug(ldb, LDB_DEBUG_WARNING, "ldb: dnAttributes extended match not supported yet");
421 if (tree->u.extended.rule_id == NULL) {
422 ldb_debug(ldb, LDB_DEBUG_ERROR, "ldb: no-rule extended matches not supported yet");
423 return LDB_ERR_INAPPROPRIATE_MATCHING;
425 if (tree->u.extended.attr == NULL) {
426 ldb_debug(ldb, LDB_DEBUG_ERROR, "ldb: no-attribute extended matches not supported yet");
427 return LDB_ERR_INAPPROPRIATE_MATCHING;
430 for (i=0;i<ARRAY_SIZE(rules);i++) {
431 if (strcmp(rules[i].oid, tree->u.extended.rule_id) == 0) {
432 comp = rules[i].comparator;
433 break;
436 if (comp == NULL) {
437 ldb_debug(ldb, LDB_DEBUG_ERROR, "ldb: unknown extended rule_id %s",
438 tree->u.extended.rule_id);
439 return LDB_ERR_INAPPROPRIATE_MATCHING;
442 /* find the message element */
443 el = ldb_msg_find_element(msg, tree->u.extended.attr);
444 if (el == NULL) {
445 *matched = false;
446 return LDB_SUCCESS;
449 for (i=0;i<el->num_values;i++) {
450 int ret = comp(tree->u.extended.rule_id, &el->values[i], &tree->u.extended.value, matched);
451 if (ret != LDB_SUCCESS) return ret;
452 if (*matched) return LDB_SUCCESS;
455 *matched = false;
456 return LDB_SUCCESS;
460 return 0 if the given parse tree matches the given message. Assumes
461 the message is in sorted order
463 return 1 if it matches, and 0 if it doesn't match
465 this is a recursive function, and does short-circuit evaluation
467 static int ldb_match_message(struct ldb_context *ldb,
468 const struct ldb_message *msg,
469 const struct ldb_parse_tree *tree,
470 enum ldb_scope scope, bool *matched)
472 unsigned int i;
473 int ret;
475 *matched = false;
477 if (scope != LDB_SCOPE_BASE && ldb_dn_is_special(msg->dn)) {
478 /* don't match special records except on base searches */
479 return LDB_SUCCESS;
482 switch (tree->operation) {
483 case LDB_OP_AND:
484 for (i=0;i<tree->u.list.num_elements;i++) {
485 ret = ldb_match_message(ldb, msg, tree->u.list.elements[i], scope, matched);
486 if (ret != LDB_SUCCESS) return ret;
487 if (!*matched) return LDB_SUCCESS;
489 *matched = true;
490 return LDB_SUCCESS;
492 case LDB_OP_OR:
493 for (i=0;i<tree->u.list.num_elements;i++) {
494 ret = ldb_match_message(ldb, msg, tree->u.list.elements[i], scope, matched);
495 if (ret != LDB_SUCCESS) return ret;
496 if (*matched) return LDB_SUCCESS;
498 *matched = false;
499 return LDB_SUCCESS;
501 case LDB_OP_NOT:
502 ret = ldb_match_message(ldb, msg, tree->u.isnot.child, scope, matched);
503 if (ret != LDB_SUCCESS) return ret;
504 *matched = ! *matched;
505 return LDB_SUCCESS;
507 case LDB_OP_EQUALITY:
508 return ldb_match_equality(ldb, msg, tree, scope, matched);
510 case LDB_OP_SUBSTRING:
511 return ldb_match_substring(ldb, msg, tree, scope, matched);
513 case LDB_OP_GREATER:
514 return ldb_match_comparison(ldb, msg, tree, scope, LDB_OP_GREATER, matched);
516 case LDB_OP_LESS:
517 return ldb_match_comparison(ldb, msg, tree, scope, LDB_OP_LESS, matched);
519 case LDB_OP_PRESENT:
520 return ldb_match_present(ldb, msg, tree, scope, matched);
522 case LDB_OP_APPROX:
523 return ldb_match_comparison(ldb, msg, tree, scope, LDB_OP_APPROX, matched);
525 case LDB_OP_EXTENDED:
526 return ldb_match_extended(ldb, msg, tree, scope, matched);
529 return LDB_ERR_INAPPROPRIATE_MATCHING;
532 int ldb_match_msg(struct ldb_context *ldb,
533 const struct ldb_message *msg,
534 const struct ldb_parse_tree *tree,
535 struct ldb_dn *base,
536 enum ldb_scope scope)
538 bool matched;
539 int ret;
541 if ( ! ldb_match_scope(ldb, base, msg->dn, scope) ) {
542 return 0;
545 ret = ldb_match_message(ldb, msg, tree, scope, &matched);
546 if (ret != LDB_SUCCESS) {
547 /* to match the old API, we need to consider this a
548 failure to match */
549 return 0;
551 return matched?1:0;
554 int ldb_match_msg_error(struct ldb_context *ldb,
555 const struct ldb_message *msg,
556 const struct ldb_parse_tree *tree,
557 struct ldb_dn *base,
558 enum ldb_scope scope,
559 bool *matched)
561 if ( ! ldb_match_scope(ldb, base, msg->dn, scope) ) {
562 *matched = false;
563 return LDB_SUCCESS;
566 return ldb_match_message(ldb, msg, tree, scope, matched);
569 int ldb_match_msg_objectclass(const struct ldb_message *msg,
570 const char *objectclass)
572 unsigned int i;
573 struct ldb_message_element *el = ldb_msg_find_element(msg, "objectClass");
574 if (!el) {
575 return 0;
577 for (i=0; i < el->num_values; i++) {
578 if (ldb_attr_cmp((const char *)el->values[i].data, objectclass) == 0) {
579 return 1;
582 return 0;