1 /* config.h - configuration abstraction structure */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 1998-2006 The OpenLDAP Foundation.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted only as authorized by the OpenLDAP
12 * A copy of this license is available in the file LICENSE in the
13 * top-level directory of the distribution or, alternatively, at
14 * <http://www.OpenLDAP.org/license.html>.
20 typedef struct ConfigTable {
26 unsigned int arg_type;
29 AttributeDescription *ad;
42 Cft_Misc /* backend/overlay defined */
45 #define ARGS_USERLAND 0x00000fff
46 #define ARGS_TYPES 0x000ff000
47 #define ARGS_POINTER 0x0003f000
48 #define ARGS_NUMERIC 0x0000f000
49 #define ARG_INT 0x00001000
50 #define ARG_LONG 0x00002000
51 #define ARG_BER_LEN_T 0x00004000
52 #define ARG_ON_OFF 0x00008000
53 #define ARG_STRING 0x00010000
54 #define ARG_BERVAL 0x00020000
55 #define ARG_DN 0x00040000
56 #define ARG_IGNORED 0x00080000
58 #define ARGS_SYNTAX 0xfff00000
59 #define ARG_PRE_BI 0x00100000
60 #define ARG_PRE_DB 0x00200000
61 #define ARG_DB 0x00400000 /* Only applies to DB */
62 #define ARG_MAY_DB 0x00800000 /* May apply to DB */
63 #define ARG_PAREN 0x01000000
64 #define ARG_NONZERO 0x02000000
65 #define ARG_NO_INSERT 0x04000000 /* no arbitrary inserting */
66 #define ARG_NO_DELETE 0x08000000 /* no runtime deletes */
67 #define ARG_UNIQUE 0x10000000
68 #define ARG_QUOTE 0x20000000 /* wrap with quotes before parsing */
69 #define ARG_OFFSET 0x40000000
70 #define ARG_MAGIC 0x80000000
72 #define ARG_BAD_CONF 0xdead0000 /* overload return values */
74 /* This is a config entry's e_private data */
75 typedef struct CfEntryInfo {
76 struct CfEntryInfo *ce_parent;
77 struct CfEntryInfo *ce_sibs;
78 struct CfEntryInfo *ce_kids;
88 /* Check if the child is allowed to be LDAPAdd'd to the parent */
89 typedef int (ConfigLDAPadd)(
90 CfEntryInfo *parent, Entry *child, struct config_args_s *ca);
92 /* Let the object create children out of slapd.conf */
93 typedef int (ConfigCfAdd)(
94 Operation *op, SlapReply *rs, Entry *parent, struct config_args_s *ca );
96 typedef struct ConfigOCs {
99 ConfigTable *co_table;
100 ConfigLDAPadd *co_ldadd;
101 ConfigCfAdd *co_cfadd;
103 struct berval *co_name;
106 typedef int (ConfigDriver)(struct config_args_s *c);
108 typedef struct config_args_s {
116 char log[MAXPATHLEN + STRLENOF(": line 18446744073709551615") + 1];
117 char msg[SLAP_TEXT_BUFLEN];
119 int valx; /* multi-valued value index */
120 /* parsed first val for simple cases */
128 struct berval vdn_dn;
129 struct berval vdn_ndn;
132 /* return values for emit mode */
133 BerVarray rvalue_vals;
134 BerVarray rvalue_nvals;
135 #define SLAP_CONFIG_EMIT 0x2000 /* emit instead of set */
136 #define SLAP_CONFIG_ADD 0x4000 /* config file add vs LDAP add */
138 int type; /* ConfigTable.arg_type & ARGS_USERLAND */
141 Entry *ca_entry; /* entry being modified */
142 void *private; /* anything */
143 ConfigDriver *cleanup;
146 /* If lineno is zero, we have an actual LDAP Add request from a client.
147 * Otherwise, we're reading a config file or a config dir.
149 #define CONFIG_ONLINE_ADD(ca) (!((ca)->lineno))
151 #define value_int values.v_int
152 #define value_long values.v_long
153 #define value_ber_t values.v_ber_t
154 #define value_string values.v_string
155 #define value_bv values.v_bv
156 #define value_dn values.v_dn.vdn_dn
157 #define value_ndn values.v_dn.vdn_ndn
159 int config_register_schema(ConfigTable *ct, ConfigOCs *co);
160 int config_del_vals(ConfigTable *cf, ConfigArgs *c);
161 int config_get_vals(ConfigTable *ct, ConfigArgs *c);
162 int config_add_vals(ConfigTable *ct, ConfigArgs *c);
164 void init_config_argv( ConfigArgs *c );
165 int init_config_attrs(ConfigTable *ct);
166 int init_config_ocs( ConfigOCs *ocs );
167 int config_parse_vals(ConfigTable *ct, ConfigArgs *c, int valx);
168 int config_parse_add(ConfigTable *ct, ConfigArgs *c);
169 int read_config_file(const char *fname, int depth, ConfigArgs *cf,
172 ConfigTable * config_find_keyword(ConfigTable *ct, ConfigArgs *c);
173 Entry * config_build_entry( Operation *op, SlapReply *rs, CfEntryInfo *parent,
174 ConfigArgs *c, struct berval *rdn, ConfigOCs *main, ConfigOCs *extra );
176 int config_shadow( ConfigArgs *c, int flag );
177 #define config_slurp_shadow(c) config_shadow((c), SLAP_DBFLAG_SLURP_SHADOW)
178 #define config_sync_shadow(c) config_shadow((c), SLAP_DBFLAG_SYNC_SHADOW)
180 /* Make sure we don't exceed the bits reserved for userland */
181 #define config_check_userland(last) \
182 assert( ( ( (last) - 1 ) & ARGS_USERLAND ) == ( (last) - 1 ) );
184 #define SLAP_X_ORDERED_FMT "{%d}"
186 #endif /* CONFIG_H */