1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187
|
/** BEGIN COPYRIGHT BLOCK
* Copyright (C) 2001 Sun Microsystems, Inc. Used by permission.
* Copyright (C) 2005 Red Hat, Inc.
* All rights reserved.
*
* License: GPL (version 3 or any later version).
* See LICENSE for details.
* END COPYRIGHT BLOCK **/
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
/* syntax.h - string syntax definitions */
#ifndef _LIBSYNTAX_H_
#define _LIBSYNTAX_H_
#include "slap.h"
#include "slapi-plugin.h"
#define SYNTAX_CIS 1
#define SYNTAX_CES 2
#define SYNTAX_TEL 4 /* telephone number: used with SYNTAX_CIS */
#define SYNTAX_DN 8 /* distinguished name: used with SYNTAX_CIS */
#define SYNTAX_SI 16 /* space insensitive: used with SYNTAX_CIS */
#define SYNTAX_INT 32 /* INTEGER */
#define SYNTAX_NORM_FILT 64 /* filter already normalized */
#define SUBBEGIN 3
#define SUBMIDDLE 3
#define SUBEND 3
#define SYNTAX_PLUGIN_SUBSYSTEM "syntax-plugin"
/* The following are derived from RFC 4512, section 1.4. */
#define IS_LEADKEYCHAR(c) (isalpha(c))
#define IS_KEYCHAR(c) (isalnum(c) || (c == '-'))
#define IS_SPACE(c) ((c == ' '))
#define IS_LDIGIT(c) ((c != '0') && isdigit(c))
#define IS_SHARP(c) ((c == '#'))
#define IS_DOLLAR(c) ((c == '$'))
#define IS_SQUOTE(c) ((c == '\''))
#define IS_ESC(c) ((c == '\\'))
#define IS_LPAREN(c) ((c == '('))
#define IS_RPAREN(c) ((c == ')'))
#define IS_COLON(c) ((c == ':'))
#define IS_UTF0(c) (((unsigned char)(c) >= (unsigned char)'\x80') && ((unsigned char)(c) <= (unsigned char)'\xBF'))
#define IS_UTF1(c) (!((unsigned char)(c)&128))
/* These are only checking the first byte of the multibyte character. They
* do not verify that the entire multibyte character is correct. */
#define IS_UTF2(c) (((unsigned char)(c) >= (unsigned char)'\xC2') && ((unsigned char)(c) <= (unsigned char)'\xDF'))
#define IS_UTF3(c) (((unsigned char)(c) >= (unsigned char)'\xE0') && ((unsigned char)(c) <= (unsigned char)'\xEF'))
#define IS_UTF4(c) (((unsigned char)(c) >= (unsigned char)'\xF0') && ((unsigned char)(c) <= (unsigned char)'\xF4'))
#define IS_UTFMB(c) (IS_UTF2(c) || IS_UTF3(c) || IS_UTF4(c))
#define IS_UTF8(c) (IS_UTF1(c) || IS_UTFMB(c))
/* The following are derived from RFC 4514, section 3. */
#define IS_ESCAPED(c) ((c == '"') || (c == '+') || (c == ',') || \
(c == ';') || (c == '<') || (c == '>'))
#define IS_SPECIAL(c) (IS_ESCAPED(c) || IS_SPACE(c) || \
IS_SHARP(c) || (c == '='))
#define IS_LUTF1(c) (IS_UTF1(c) && !IS_ESCAPED(c) && !IS_SPACE(c) && \
!IS_SHARP(c) && !IS_ESC(c))
#define IS_TUTF1(c) (IS_UTF1(c) && !IS_ESCAPED(c) && !IS_SPACE(c) && \
!IS_ESC(c))
#define IS_SUTF1(c) (IS_UTF1(c) && !IS_ESCAPED(c) && !IS_ESC(c))
/* Per RFC 4517:
*
* PrintableCharacter = ALPHA / DIGIT / SQUOTE / LPAREN / RPAREN /
* PLUS / COMMA / HYPHEN / DOT / EQUALS /
* SLASH / COLON / QUESTION / SPACE
*/
#define IS_PRINTABLE(c) (isalnum(c) || (c == '\'') || IS_LPAREN(c) || \
IS_RPAREN(c) || (c == '+') || (c == ',') || (c == '-') || (c == '.') || \
(c == '=') || (c == '/') || (c == ':') || (c == '?') || IS_SPACE(c))
int string_filter_sub(Slapi_PBlock *pb, char *initial, char **any, char * final, Slapi_Value **bvals, int syntax);
int string_filter_ava(struct berval *bvfilter, Slapi_Value **bvals, int syntax, int ftype, Slapi_Value **retVal);
int string_values2keys(Slapi_PBlock *pb, Slapi_Value **bvals, Slapi_Value ***ivals, int syntax, int ftype);
int string_assertion2keys_ava(Slapi_PBlock *pb, Slapi_Value *val, Slapi_Value ***ivals, int syntax, int ftype);
int string_assertion2keys_sub(Slapi_PBlock *pb, char *initial, char **any, char * final, Slapi_Value ***ivals, int syntax);
int value_cmp(struct berval *v1, struct berval *v2, int syntax, int normalize);
void value_normalize(char *s, int syntax, int trim_leading_blanks);
void value_normalize_ext(char *s, int syntax, int trim_leading_blanks, char **alt);
char *first_word(char *s);
char *next_word(char *s);
char *phonetic(char *s);
/* Validation helper functions */
int keystring_validate(const char *begin, const char *end);
int numericoid_validate(const char *begin, const char *end);
int utf8char_validate(const char *begin, const char *end, const char **last);
int utf8string_validate(const char *begin, const char *end, const char **last);
int distinguishedname_validate(const char *begin, const char *end);
int rdn_validate(const char *begin, const char *end, const char **last);
int bitstring_validate_internal(const char *begin, const char *end);
struct mr_plugin_def
{
Slapi_MatchingRuleEntry mr_def_entry; /* for slapi_matchingrule_register */
Slapi_PluginDesc mr_plg_desc; /* for SLAPI_PLUGIN_DESCRIPTION */
const char **mr_names; /* list of oid and names, NULL terminated SLAPI_PLUGIN_MR_NAMES */
/* these are optional for new style mr plugins */
IFP mr_filter_create; /* old style factory function SLAPI_PLUGIN_MR_FILTER_CREATE_FN */
IFP mr_indexer_create; /* old style factory function SLAPI_PLUGIN_MR_INDEXER_CREATE_FN */
/* new style syntax plugin functions */
/* not all functions will apply to all matching rule types */
/* e.g. a SUBSTR rule will not have a filter_ava func */
IFP mr_filter_ava; /* SLAPI_PLUGIN_MR_FILTER_AVA */
IFP mr_filter_sub; /* SLAPI_PLUGIN_MR_FILTER_SUB */
IFP mr_values2keys; /* SLAPI_PLUGIN_MR_VALUES2KEYS */
IFP mr_assertion2keys_ava; /* SLAPI_PLUGIN_MR_ASSERTION2KEYS_AVA */
IFP mr_assertion2keys_sub; /* SLAPI_PLUGIN_MR_ASSERTION2KEYS_SUB */
IFP mr_compare; /* SLAPI_PLUGIN_MR_COMPARE - only for ORDERING */
VFPV mr_normalize;
};
int syntax_register_matching_rule_plugins(struct mr_plugin_def mr_plugin_table[], size_t mr_plugin_table_size, IFP matching_rule_plugin_init);
int syntax_matching_rule_plugin_init(Slapi_PBlock *pb, struct mr_plugin_def mr_plugin_table[], size_t mr_plugin_table_size);
#endif
#ifdef UNSUPPORTED_MATCHING_RULES
/* list of names/oids/aliases for each matching rule */
static const char *keywordMatch_names[] = {"keywordMatch", "2.5.13.33", NULL};
static const char *wordMatch_names[] = {"wordMatch", "2.5.13.32", NULL};
/* table of matching rule plugin defs for mr register and plugin register */
static struct mr_plugin_def mr_plugin_table[] = {
{{"2.5.13.33",
NULL,
"keywordMatch",
"The keywordMatch rule compares an assertion value of the Directory"
"String syntax to an attribute value of a syntax (e.g., the Directory"
"String syntax) whose corresponding ASN.1 type is DirectoryString."
"The rule evaluates to TRUE if and only if the assertion value"
"character string matches any keyword in the attribute value. The"
"identification of keywords in the attribute value and the exactness"
"of the match are both implementation specific.",
"1.3.6.1.4.1.1466.115.121.1.15",
0}, /* matching rule desc */
{
"keywordMatch-mr",
VENDOR,
DS_PACKAGE_VERSION,
"keywordMatch matching rule plugin"}, /* plugin desc */
keywordMatch_names, /* matching rule name/oid/aliases */
NULL,
NULL,
mr_filter_ava,
mr_filter_sub,
mr_values2keys,
mr_assertion2keys_ava,
mr_assertion2keys_sub,
mr_compare,
keywordMatch_syntaxes},
{{"2.5.13.32",
NULL,
"wordMatch",
"The wordMatch rule compares an assertion value of the Directory"
"String syntax to an attribute value of a syntax (e.g., the Directory"
"String syntax) whose corresponding ASN.1 type is DirectoryString."
"The rule evaluates to TRUE if and only if the assertion value word"
"matches, according to the semantics of caseIgnoreMatch, any word in"
"the attribute value. The precise definition of a word is"
"implementation specific.",
"1.3.6.1.4.1.1466.115.121.1.15",
0}, /* matching rule desc */
{
"wordMatch-mr",
VENDOR,
DS_PACKAGE_VERSION,
"wordMatch matching rule plugin"}, /* plugin desc */
wordMatch_names, /* matching rule name/oid/aliases */
NULL,
NULL,
mr_filter_ava,
mr_filter_sub,
mr_values2keys,
mr_assertion2keys_ava,
mr_assertion2keys_sub,
mr_compare,
wordMatch_syntaxes},
};
#endif /* UNSUPPORTED_MATCHING_RULES */
|