4 Copyright (C) Andrew Tridgell 2004
5 Copyright (C) Stefan Metzmacher 2004
6 Copyright (C) Simo Sorce 2004-2005
8 ** NOTE! The following LGPL license applies to the ldb
9 ** library. This does NOT imply that all of Samba is released
12 This library is free software; you can redistribute it and/or
13 modify it under the terms of the GNU Lesser General Public
14 License as published by the Free Software Foundation; either
15 version 3 of the License, or (at your option) any later version.
17 This library is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 Lesser General Public License for more details.
22 You should have received a copy of the GNU Lesser General Public
23 License along with this library; if not, see <http://www.gnu.org/licenses/>.
29 * Component: ldb private header
31 * Description: defines internal ldb structures used by the subsystem and modules
33 * Author: Andrew Tridgell
34 * Author: Stefan Metzmacher
37 #ifndef _LDB_PRIVATE_H_
38 #define _LDB_PRIVATE_H_ 1
42 struct ldb_module_ops
;
44 /* basic module structure */
46 struct ldb_module
*prev
, *next
;
47 struct ldb_context
*ldb
;
49 const struct ldb_module_ops
*ops
;
53 these function pointers define the operations that a ldb module must perform
54 they correspond exactly to the ldb_*() interface
56 struct ldb_module_ops
{
58 int (*init_context
) (struct ldb_module
*);
59 int (*search
)(struct ldb_module
*, struct ldb_request
*); /* search */
60 int (*add
)(struct ldb_module
*, struct ldb_request
*); /* add */
61 int (*modify
)(struct ldb_module
*, struct ldb_request
*); /* modify */
62 int (*del
)(struct ldb_module
*, struct ldb_request
*); /* delete */
63 int (*rename
)(struct ldb_module
*, struct ldb_request
*); /* rename */
64 int (*request
)(struct ldb_module
*, struct ldb_request
*); /* match any other operation */
65 int (*extended
)(struct ldb_module
*, struct ldb_request
*); /* extended operations */
66 int (*start_transaction
)(struct ldb_module
*);
67 int (*end_transaction
)(struct ldb_module
*);
68 int (*del_transaction
)(struct ldb_module
*);
69 int (*wait
)(struct ldb_handle
*, enum ldb_wait_type
);
70 int (*sequence_number
)(struct ldb_module
*, struct ldb_request
*);
73 typedef int (*ldb_connect_fn
) (struct ldb_context
*ldb
, const char *url
, unsigned int flags
, const char *options
[],
74 struct ldb_module
**module
);
77 schema related information needed for matching rules
80 /* attribute handling table */
81 unsigned num_attrib_handlers
;
82 struct ldb_attrib_handler
*attrib_handlers
;
84 /* objectclass information */
93 every ldb connection is started by establishing a ldb_context
96 /* the operations provided by the backend */
97 struct ldb_module
*modules
;
99 /* debugging operations */
100 struct ldb_debug_ops debug_ops
;
102 /* custom utf8 functions */
103 struct ldb_utf8_fns utf8_fns
;
105 /* backend specific opaque parameters */
107 struct ldb_opaque
*next
;
112 struct ldb_schema schema
;
116 int transaction_active
;
122 unsigned int create_perms
;
126 #define ARRAY_SIZE(a) (sizeof(a)/sizeof(a[0]))
130 simplify out of memory handling
132 #define ldb_oom(ldb) ldb_debug_set(ldb, LDB_DEBUG_FATAL, "ldb out of memory at %s:%d\n", __FILE__, __LINE__)
134 /* The following definitions come from lib/ldb/common/ldb.c */
136 int ldb_connect_backend(struct ldb_context
*ldb
, const char *url
, const char *options
[],
137 struct ldb_module
**backend_module
);
139 /* The following definitions come from lib/ldb/common/ldb_modules.c */
141 const char **ldb_modules_list_from_string(struct ldb_context
*ldb
, TALLOC_CTX
*mem_ctx
, const char *string
);
142 int ldb_load_modules_list(struct ldb_context
*ldb
, const char **module_list
, struct ldb_module
*backend
, struct ldb_module
**out
);
143 int ldb_load_modules(struct ldb_context
*ldb
, const char *options
[]);
144 int ldb_init_module_chain(struct ldb_context
*ldb
, struct ldb_module
*module
);
145 int ldb_next_request(struct ldb_module
*module
, struct ldb_request
*request
);
146 int ldb_next_start_trans(struct ldb_module
*module
);
147 int ldb_next_end_trans(struct ldb_module
*module
);
148 int ldb_next_del_trans(struct ldb_module
*module
);
149 int ldb_next_init(struct ldb_module
*module
);
151 void ldb_set_errstring(struct ldb_context
*ldb
, const char *err_string
);
152 void ldb_asprintf_errstring(struct ldb_context
*ldb
, const char *format
, ...) PRINTF_ATTRIBUTE(2,3);
153 void ldb_reset_err_string(struct ldb_context
*ldb
);
155 int ldb_register_module(const struct ldb_module_ops
*);
156 int ldb_register_backend(const char *url_prefix
, ldb_connect_fn
);
157 int ldb_try_load_dso(struct ldb_context
*ldb
, const char *name
);
159 /* The following definitions come from lib/ldb/common/ldb_debug.c */
160 void ldb_debug(struct ldb_context
*ldb
, enum ldb_debug_level level
, const char *fmt
, ...) PRINTF_ATTRIBUTE(3, 4);
161 void ldb_debug_set(struct ldb_context
*ldb
, enum ldb_debug_level level
,
162 const char *fmt
, ...) PRINTF_ATTRIBUTE(3, 4);
164 /* The following definitions come from lib/ldb/common/ldb_ldif.c */
165 int ldb_should_b64_encode(const struct ldb_val
*val
);
167 int ldb_objectclass_init(void);
168 int ldb_operational_init(void);
169 int ldb_paged_results_init(void);
170 int ldb_rdn_name_init(void);
171 int ldb_schema_init(void);
172 int ldb_asq_init(void);
173 int ldb_sort_init(void);
174 int ldb_ldap_init(void);
175 int ldb_ildap_init(void);
176 int ldb_tdb_init(void);
177 int ldb_sqlite3_init(void);
179 int ldb_match_msg(struct ldb_context
*ldb
,
180 const struct ldb_message
*msg
,
181 const struct ldb_parse_tree
*tree
,
182 const struct ldb_dn
*base
,
183 enum ldb_scope scope
);
185 void ldb_remove_attrib_handler(struct ldb_context
*ldb
, const char *attrib
);
186 const struct ldb_attrib_handler
*ldb_attrib_handler_syntax(struct ldb_context
*ldb
,
188 int ldb_set_attrib_handlers(struct ldb_context
*ldb
,
189 const struct ldb_attrib_handler
*handlers
,
190 unsigned num_handlers
);
191 int ldb_setup_wellknown_attributes(struct ldb_context
*ldb
);
192 int ldb_set_attrib_handler_syntax(struct ldb_context
*ldb
,
193 const char *attr
, const char *syntax
);
195 /* The following definitions come from lib/ldb/common/ldb_attributes.c */
196 const char **ldb_subclass_list(struct ldb_context
*ldb
, const char *classname
);
197 void ldb_subclass_remove(struct ldb_context
*ldb
, const char *classname
);
198 int ldb_subclass_add(struct ldb_context
*ldb
, const char *classname
, const char *subclass
);
200 int ldb_handler_copy(struct ldb_context
*ldb
, void *mem_ctx
,
201 const struct ldb_val
*in
, struct ldb_val
*out
);
202 int ldb_comparison_binary(struct ldb_context
*ldb
, void *mem_ctx
,
203 const struct ldb_val
*v1
, const struct ldb_val
*v2
);
205 /* The following definitions come from lib/ldb/common/ldb_controls.c */
206 struct ldb_control
*get_control_from_list(struct ldb_control
**controls
, const char *oid
);
207 int save_controls(struct ldb_control
*exclude
, struct ldb_request
*req
, struct ldb_control
***saver
);
208 int check_critical_controls(struct ldb_control
**controls
);
210 /* The following definitions come from lib/ldb/common/ldb_utf8.c */
211 char *ldb_casefold_default(void *context
, void *mem_ctx
, const char *s
);
213 void ldb_msg_remove_element(struct ldb_message
*msg
, struct ldb_message_element
*el
);
216 Obtain current/next database sequence number
218 int ldb_sequence_number(struct ldb_context
*ldb
, enum ldb_sequence_type type
, uint64_t *seq_num
);
220 #define LDB_SEQ_GLOBAL_SEQUENCE 0x01
221 #define LDB_SEQ_TIMESTAMP_SEQUENCE 0x02