2 ldb database library - command line handling for ldb tools
4 Copyright (C) Andrew Tridgell 2005
6 ** NOTE! The following LGPL license applies to the ldb
7 ** library. This does NOT imply that all of Samba is released
10 This library is free software; you can redistribute it and/or
11 modify it under the terms of the GNU Lesser General Public
12 License as published by the Free Software Foundation; either
13 version 2 of the License, or (at your option) any later version.
15 This library is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 Lesser General Public License for more details.
20 You should have received a copy of the GNU Lesser General Public
21 License along with this library; if not, write to the Free Software
22 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 #include "ldb/include/includes.h"
27 #include "ldb/tools/cmdline.h"
30 #include "lib/cmdline/popt_common.h"
31 #include "auth/auth.h"
35 process command line options
37 struct ldb_cmdline *ldb_cmdline_process(struct ldb_context *ldb, int argc, const char **argv,
40 struct ldb_cmdline options, *ret=NULL;
47 struct poptOption popt_options[] = {
49 { "url", 'H', POPT_ARG_STRING, &options.url, 0, "database URL", "URL" },
50 { "basedn", 'b', POPT_ARG_STRING, &options.basedn, 0, "base DN", "DN" },
51 { "editor", 'e', POPT_ARG_STRING, &options.editor, 0, "external editor", "PROGRAM" },
52 { "scope", 's', POPT_ARG_STRING, NULL, 's', "search scope", "SCOPE" },
53 { "verbose", 'v', POPT_ARG_NONE, NULL, 'v', "increase verbosity", NULL },
54 { "interactive", 'i', POPT_ARG_NONE, &options.interactive, 0, "input from stdin", NULL },
55 { "recursive", 'r', POPT_ARG_NONE, &options.recursive, 0, "recursive delete", NULL },
56 { "num-searches", 0, POPT_ARG_INT, &options.num_searches, 0, "number of test searches", NULL },
57 { "num-records", 0, POPT_ARG_INT, &options.num_records, 0, "number of test records", NULL },
58 { "all", 'a', POPT_ARG_NONE, &options.all_records, 0, "(|(objectClass=*)(distinguishedName=*))", NULL },
59 { "nosync", 0, POPT_ARG_NONE, &options.nosync, 0, "non-synchronous transactions", NULL },
60 { "sorted", 'S', POPT_ARG_NONE, &options.sorted, 0, "sort attributes", NULL },
61 { "sasl-mechanism", 0, POPT_ARG_STRING, &options.sasl_mechanism, 0, "choose SASL mechanism", "MECHANISM" },
62 { "input", 'I', POPT_ARG_STRING, &options.input, 0, "Input File", "Input" },
63 { "output", 'O', POPT_ARG_STRING, &options.output, 0, "Output File", "Output" },
64 { NULL, 'o', POPT_ARG_STRING, NULL, 'o', "ldb_connect option", "OPTION" },
65 { "controls", 0, POPT_ARG_STRING, NULL, 'c', "controls", NULL },
68 POPT_COMMON_CREDENTIALS
77 r = ldb_register_samba_handlers(ldb);
84 ret = talloc_zero(ldb, struct ldb_cmdline);
93 options.url = getenv("LDB_URL");
95 /* and editor (used by ldbedit) */
96 options.editor = getenv("VISUAL");
97 if (!options.editor) {
98 options.editor = getenv("EDITOR");
100 if (!options.editor) {
101 options.editor = "vi";
104 options.scope = LDB_SCOPE_DEFAULT;
106 pc = poptGetContext(argv[0], argc, argv, popt_options,
107 POPT_CONTEXT_KEEP_FIRST);
109 while((opt = poptGetNextOpt(pc)) != -1) {
112 const char *arg = poptGetOptArg(pc);
113 if (strcmp(arg, "base") == 0) {
114 options.scope = LDB_SCOPE_BASE;
115 } else if (strcmp(arg, "sub") == 0) {
116 options.scope = LDB_SCOPE_SUBTREE;
117 } else if (strcmp(arg, "one") == 0) {
118 options.scope = LDB_SCOPE_ONELEVEL;
120 fprintf(stderr, "Invalid scope '%s'\n", arg);
131 options.options = talloc_realloc(ret, options.options,
132 const char *, num_options+3);
133 if (options.options == NULL) {
137 options.options[num_options] = poptGetOptArg(pc);
138 options.options[num_options+1] = NULL;
143 const char *cs = poptGetOptArg(pc);
147 for (p = cs, cc = 1; (q = strchr(p, ',')); cc++, p = q + 1) ;
149 options.controls = talloc_array(ret, char *, cc + 1);
150 if (options.controls == NULL) {
154 for (p = cs, cc = 0; p != NULL; cc++) {
159 options.controls[cc] = talloc_strdup(options.controls, p);
162 options.controls[cc] = talloc_strndup(options.controls, p, t-p);
166 options.controls[cc] = NULL;
171 fprintf(stderr, "Invalid option %s: %s\n",
172 poptBadOption(pc, 0), poptStrerror(opt));
178 /* setup the remaining options for the main program to use */
179 options.argv = poptGetArgs(pc);
182 while (options.argv[options.argc]) options.argc++;
187 /* all utils need some option */
188 if (ret->url == NULL) {
189 fprintf(stderr, "You must supply a url with -H or with $LDB_URL\n");
194 if (strcmp(ret->url, "NONE") != 0) {
196 if (options.nosync) {
197 flags |= LDB_FLG_NOSYNC;
201 if (ldb_set_opaque(ldb, "sessionInfo", system_session(ldb))) {
204 if (ldb_set_opaque(ldb, "credentials", cmdline_credentials)) {
207 ldb_set_utf8_fns(ldb, NULL, wrap_caseless_cmp, wrap_casefold);
209 if (ldb_connect(ldb, ret->url, flags, ret->options) != 0) {
210 fprintf(stderr, "Failed to connect to %s - %s\n",
211 ret->url, ldb_errstring(ldb));
224 struct ldb_control **parse_controls(void *mem_ctx, char **control_strings)
227 struct ldb_control **ctrl;
229 if (control_strings == NULL || control_strings[0] == NULL)
232 for (i = 0; control_strings[i]; i++);
234 ctrl = talloc_array(mem_ctx, struct ldb_control *, i + 1);
236 for (i = 0; control_strings[i]; i++) {
237 if (strncmp(control_strings[i], "dirsync:", 8) == 0) {
238 struct ldb_dirsync_control *control;
241 int crit, flags, max_attrs, ret;
244 p = &(control_strings[i][8]);
245 ret = sscanf(p, "%d:%d:%d:%1023[^$]", &crit, &flags, &max_attrs, cookie);
247 if ((ret < 3) || (crit < 0) || (crit > 1) || (flags < 0) || (max_attrs < 0)) {
248 fprintf(stderr, "invalid dirsync control syntax\n");
252 /* w2k3 seems to ignore the parameter,
253 * but w2k sends a wrong cookie when this value is to small
254 * this would cause looping forever, while getting
255 * the same data and same cookie forever
257 if (max_attrs == 0) max_attrs = 0x0FFFFFFF;
259 ctrl[i] = talloc(ctrl, struct ldb_control);
260 ctrl[i]->oid = LDB_CONTROL_DIRSYNC_OID;
261 ctrl[i]->critical = crit;
262 control = talloc(ctrl[i], struct ldb_dirsync_control);
263 control->flags = flags;
264 control->max_attributes = max_attrs;
266 control->cookie_len = ldb_base64_decode(cookie);
267 control->cookie = talloc_memdup(control, cookie, control->cookie_len);
269 control->cookie = NULL;
270 control->cookie_len = 0;
272 ctrl[i]->data = control;
277 if (strncmp(control_strings[i], "asq:", 4) == 0) {
278 struct ldb_asq_control *control;
284 p = &(control_strings[i][4]);
285 ret = sscanf(p, "%d:%255[^$]", &crit, attr);
286 if ((ret != 2) || (crit < 0) || (crit > 1) || (attr[0] == '\0')) {
287 fprintf(stderr, "invalid asq control syntax\n");
291 ctrl[i] = talloc(ctrl, struct ldb_control);
292 ctrl[i]->oid = LDB_CONTROL_ASQ_OID;
293 ctrl[i]->critical = crit;
294 control = talloc(ctrl[i], struct ldb_asq_control);
295 control->request = 1;
296 control->source_attribute = talloc_strdup(control, attr);
297 control->src_attr_len = strlen(attr);
298 ctrl[i]->data = control;
303 if (strncmp(control_strings[i], "extended_dn:", 12) == 0) {
304 struct ldb_extended_dn_control *control;
308 p = &(control_strings[i][12]);
309 ret = sscanf(p, "%d:%d", &crit, &type);
310 if ((ret != 2) || (crit < 0) || (crit > 1) || (type < 0) || (type > 1)) {
311 fprintf(stderr, "invalid extended_dn control syntax\n");
315 ctrl[i] = talloc(ctrl, struct ldb_control);
316 ctrl[i]->oid = LDB_CONTROL_EXTENDED_DN_OID;
317 ctrl[i]->critical = crit;
318 control = talloc(ctrl[i], struct ldb_extended_dn_control);
319 control->type = type;
320 ctrl[i]->data = control;
325 if (strncmp(control_strings[i], "paged_results:", 14) == 0) {
326 struct ldb_paged_control *control;
330 p = &(control_strings[i][14]);
331 ret = sscanf(p, "%d:%d", &crit, &size);
333 if ((ret != 2) || (crit < 0) || (crit > 1) || (size < 0)) {
334 fprintf(stderr, "invalid paged_results control syntax\n");
338 ctrl[i] = talloc(ctrl, struct ldb_control);
339 ctrl[i]->oid = LDB_CONTROL_PAGED_RESULTS_OID;
340 ctrl[i]->critical = crit;
341 control = talloc(ctrl[i], struct ldb_paged_control);
342 control->size = size;
343 control->cookie = NULL;
344 control->cookie_len = 0;
345 ctrl[i]->data = control;
350 if (strncmp(control_strings[i], "server_sort:", 12) == 0) {
351 struct ldb_server_sort_control **control;
359 p = &(control_strings[i][12]);
360 ret = sscanf(p, "%d:%d:%255[^:]:%127[^:]", &crit, &rev, attr, rule);
361 if ((ret < 3) || (crit < 0) || (crit > 1) || (rev < 0 ) || (rev > 1) ||attr[0] == '\0') {
362 fprintf(stderr, "invalid server_sort control syntax\n");
365 ctrl[i] = talloc(ctrl, struct ldb_control);
366 ctrl[i]->oid = LDB_CONTROL_SERVER_SORT_OID;
367 ctrl[i]->critical = crit;
368 control = talloc_array(ctrl[i], struct ldb_server_sort_control *, 2);
369 control[0] = talloc(control, struct ldb_server_sort_control);
370 control[0]->attributeName = talloc_strdup(control, attr);
372 control[0]->orderingRule = talloc_strdup(control, rule);
374 control[0]->orderingRule = NULL;
375 control[0]->reverse = rev;
377 ctrl[i]->data = control;
382 if (strncmp(control_strings[i], "notification:", 13) == 0) {
386 p = &(control_strings[i][13]);
387 ret = sscanf(p, "%d", &crit);
388 if ((ret != 1) || (crit < 0) || (crit > 1)) {
389 fprintf(stderr, "invalid notification control syntax\n");
393 ctrl[i] = talloc(ctrl, struct ldb_control);
394 ctrl[i]->oid = LDB_CONTROL_NOTIFICATION_OID;
395 ctrl[i]->critical = crit;
396 ctrl[i]->data = NULL;
401 /* no controls matched, throw an error */
402 fprintf(stderr, "Invalid control name\n");
412 /* this function check controls reply and determines if more
413 * processing is needed setting up the request controls correctly
418 * 1 all ok, more processing required
420 int handle_controls_reply(struct ldb_control **reply, struct ldb_control **request)
425 if (reply == NULL || request == NULL) return -1;
427 for (i = 0; reply[i]; i++) {
428 if (strcmp(LDB_CONTROL_ASQ_OID, reply[i]->oid) == 0) {
429 struct ldb_asq_control *rep_control;
431 rep_control = talloc_get_type(reply[i]->data, struct ldb_asq_control);
433 /* check the result */
434 if (rep_control->result != 0) {
435 fprintf(stderr, "Warning: ASQ not performed with error: %d\n", rep_control->result);
440 if (strcmp(LDB_CONTROL_PAGED_RESULTS_OID, reply[i]->oid) == 0) {
441 struct ldb_paged_control *rep_control, *req_control;
443 rep_control = talloc_get_type(reply[i]->data, struct ldb_paged_control);
444 if (rep_control->cookie_len == 0) /* we are done */
447 /* more processing required */
448 /* let's fill in the request control with the new cookie */
450 for (j = 0; request[j]; j++) {
451 if (strcmp(LDB_CONTROL_PAGED_RESULTS_OID, request[j]->oid) == 0)
454 /* if there's a reply control we must find a request
455 * control matching it */
456 if (! request[j]) return -1;
458 req_control = talloc_get_type(request[j]->data, struct ldb_paged_control);
460 if (req_control->cookie)
461 talloc_free(req_control->cookie);
462 req_control->cookie = talloc_memdup(req_control,
464 rep_control->cookie_len);
465 req_control->cookie_len = rep_control->cookie_len;
472 if (strcmp(LDB_CONTROL_SORT_RESP_OID, reply[i]->oid) == 0) {
473 struct ldb_sort_resp_control *rep_control;
475 rep_control = talloc_get_type(reply[i]->data, struct ldb_sort_resp_control);
477 /* check we have a matching control in the request */
478 for (j = 0; request[j]; j++) {
479 if (strcmp(LDB_CONTROL_SERVER_SORT_OID, request[j]->oid) == 0)
483 fprintf(stderr, "Warning Server Sort reply received but no request found\n");
487 /* check the result */
488 if (rep_control->result != 0) {
489 fprintf(stderr, "Warning: Sorting not performed with error: %d\n", rep_control->result);
495 if (strcmp(LDB_CONTROL_DIRSYNC_OID, reply[i]->oid) == 0) {
496 struct ldb_dirsync_control *rep_control, *req_control;
499 rep_control = talloc_get_type(reply[i]->data, struct ldb_dirsync_control);
500 if (rep_control->cookie_len == 0) /* we are done */
503 /* more processing required */
504 /* let's fill in the request control with the new cookie */
506 for (j = 0; request[j]; j++) {
507 if (strcmp(LDB_CONTROL_DIRSYNC_OID, request[j]->oid) == 0)
510 /* if there's a reply control we must find a request
511 * control matching it */
512 if (! request[j]) return -1;
514 req_control = talloc_get_type(request[j]->data, struct ldb_dirsync_control);
516 if (req_control->cookie)
517 talloc_free(req_control->cookie);
518 req_control->cookie = talloc_memdup(req_control,
520 rep_control->cookie_len);
521 req_control->cookie_len = rep_control->cookie_len;
523 cookie = ldb_base64_encode(req_control, rep_control->cookie, rep_control->cookie_len);
524 printf("# DIRSYNC cookie returned was:\n# %s\n", cookie);
533 /* no controls matched, throw a warning */
534 fprintf(stderr, "Unknown reply control oid: %s\n", reply[i]->oid);