3 * Copyright 1998-2003 The OpenLDAP Foundation, All Rights Reserved.
4 * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
6 /* common.c - common routines for the ldap client tools */
12 #include <ac/stdlib.h>
13 #include <ac/signal.h>
14 #include <ac/string.h>
15 #include <ac/unistd.h>
20 #include "lutil_ldap.h"
31 char *ldaphost = NULL;
33 #ifdef HAVE_CYRUS_SASL
34 unsigned sasl_flags = LDAP_SASL_AUTOMATIC;
35 char *sasl_realm = NULL;
36 char *sasl_authc_id = NULL;
37 char *sasl_authz_id = NULL;
38 char *sasl_mech = NULL;
39 char *sasl_secprops = NULL;
49 struct berval passwd = { 0, NULL };
62 setlocale(LC_MESSAGES,"");
63 bindtextdomain(OPENLDAP_PACKAGE, LDAP_LOCALEDIR);
64 textdomain(OPENLDAP_PACKAGE);
68 tool_common_usage( void )
70 static const char *const descriptions[] = {
71 N_(" -c continuous operation mode (do not stop on errors)\n"),
72 N_(" -C chase referrals\n"),
73 N_(" -d level set LDAP debugging level to `level'\n"),
74 N_(" -D binddn bind DN\n"),
75 N_(" -e [!]<ctrl>[=<ctrlparam>] general controls (! indicates criticality)\n")
76 N_(" [!]authzid=<authzid> (\"dn:<dn>\" or \"u:<user>\")\n")
77 N_(" [!]manageDSAit (alternate form, see -M)\n")
79 N_(" -f file read operations from `file'\n"),
80 N_(" -h host LDAP server\n"),
81 N_(" -H URI LDAP Uniform Resource Indentifier(s)\n"),
82 N_(" -I use SASL Interactive mode\n"),
83 N_(" -k use Kerberos authentication\n"),
84 N_(" -K like -k, but do only step 1 of the Kerberos bind\n"),
85 N_(" -M enable Manage DSA IT control (-MM to make critical)\n"),
86 N_(" -n show what would be done but don't actually do it\n"),
87 N_(" -O props SASL security properties\n"),
88 N_(" -p port port on LDAP server\n"),
89 N_(" -P version procotol version (default: 3)\n"),
90 N_(" -Q use SASL Quiet mode\n"),
91 N_(" -R realm SASL realm\n"),
92 N_(" -U authcid SASL authentication identity\n"),
93 N_(" -v run in verbose mode (diagnostics to standard output)\n"),
94 N_(" -V print version info (-VV only)\n"),
95 N_(" -w passwd bind password (for simple authentication)\n"),
96 N_(" -W prompt for bind password\n"),
97 N_(" -x Simple authentication\n"),
98 N_(" -X authzid SASL authorization identity (\"dn:<dn>\" or \"u:<user>\")\n"),
99 N_(" -y file Read password from file\n"),
100 N_(" -Y mech SASL mechanism\n"),
101 N_(" -Z Start TLS request (-ZZ to require successful response)\n"),
104 const char *const *cpp;
106 fputs( _("Common options:\n"), stderr );
107 for( cpp = descriptions; *cpp != NULL; cpp++ ) {
108 if( strchr( options, (*cpp)[3] ) ) {
109 fputs( _(*cpp), stderr );
116 tool_args( int argc, char **argv )
120 while (( i = getopt( argc, argv, options )) != EOF ) {
122 char *control, *cvalue;
124 case 'c': /* continuous operation mode */
131 debug |= atoi( optarg );
133 case 'D': /* bind DN */
134 if( binddn != NULL ) {
135 fprintf( stderr, "%s: -D previously specified\n", prog );
136 exit( EXIT_FAILURE );
138 binddn = ber_strdup( optarg );
140 case 'e': /* general controls */
141 /* should be extended to support comma separated list of
142 * [!]key[=value] parameters, e.g. -e !foo,bar=567
147 if( optarg[0] == '!' ) {
152 control = ber_strdup( optarg );
153 if ( (cvalue = strchr( control, '=' )) != NULL ) {
157 if ( strcasecmp( control, "authzid" ) == 0 ) {
158 if( authzid != NULL ) {
159 fprintf( stderr, "authzid control previously specified\n");
160 exit( EXIT_FAILURE );
162 if( cvalue == NULL ) {
163 fprintf( stderr, "authzid: control value expected\n" );
167 fprintf( stderr, "authzid: must be marked critical\n" );
171 assert( authzid == NULL );
174 } else if ( strcasecmp( control, "manageDSAit" ) == 0 ) {
177 "manageDSAit control previously specified\n");
178 exit( EXIT_FAILURE );
180 if( cvalue != NULL ) {
182 "manageDSAit: no control value expected\n" );
186 manageDSAit = 1 + crit;
188 } else if ( strcasecmp( control, "noop" ) == 0 ) {
190 fprintf( stderr, "noop control previously specified\n");
191 exit( EXIT_FAILURE );
193 if( cvalue != NULL ) {
194 fprintf( stderr, "noop: no control value expected\n" );
201 fprintf( stderr, "Invalid general control name: %s\n",
206 case 'f': /* read from file */
207 if( infile != NULL ) {
208 fprintf( stderr, "%s: -f previously specified\n", prog );
209 exit( EXIT_FAILURE );
211 infile = ber_strdup( optarg );
213 case 'h': /* ldap host */
214 if( ldaphost != NULL ) {
215 fprintf( stderr, "%s: -h previously specified\n", prog );
216 exit( EXIT_FAILURE );
218 ldaphost = ber_strdup( optarg );
220 case 'H': /* ldap URI */
221 if( ldapuri != NULL ) {
222 fprintf( stderr, "%s: -H previously specified\n", prog );
223 exit( EXIT_FAILURE );
225 ldapuri = ber_strdup( optarg );
228 #ifdef HAVE_CYRUS_SASL
229 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
230 fprintf( stderr, "%s: incompatible previous "
231 "authentication choice\n",
233 exit( EXIT_FAILURE );
235 authmethod = LDAP_AUTH_SASL;
236 sasl_flags = LDAP_SASL_INTERACTIVE;
239 fprintf( stderr, "%s: was not compiled with SASL support\n",
241 exit( EXIT_FAILURE );
243 case 'k': /* kerberos bind */
244 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
245 if( authmethod != -1 ) {
246 fprintf( stderr, "%s: -k incompatible with previous "
247 "authentication choice\n", prog );
248 exit( EXIT_FAILURE );
250 authmethod = LDAP_AUTH_KRBV4;
252 fprintf( stderr, "%s: not compiled with Kerberos support\n", prog );
253 exit( EXIT_FAILURE );
256 case 'K': /* kerberos bind, part one only */
257 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
258 if( authmethod != -1 ) {
259 fprintf( stderr, "%s: incompatible with previous "
260 "authentication choice\n", prog );
261 exit( EXIT_FAILURE );
263 authmethod = LDAP_AUTH_KRBV41;
265 fprintf( stderr, "%s: not compiled with Kerberos support\n", prog );
266 exit( EXIT_FAILURE );
270 /* enable Manage DSA IT */
273 case 'n': /* print operations, don't actually do them */
277 #ifdef HAVE_CYRUS_SASL
278 if( sasl_secprops != NULL ) {
279 fprintf( stderr, "%s: -O previously specified\n", prog );
280 exit( EXIT_FAILURE );
282 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
283 fprintf( stderr, "%s: incompatible previous "
284 "authentication choice\n", prog );
285 exit( EXIT_FAILURE );
287 authmethod = LDAP_AUTH_SASL;
288 sasl_secprops = ber_strdup( optarg );
290 fprintf( stderr, "%s: not compiled with SASL support\n", prog );
291 exit( EXIT_FAILURE );
296 fprintf( stderr, "%s: -p previously specified\n", prog );
297 exit( EXIT_FAILURE );
299 ldapport = atoi( optarg );
302 switch( atoi(optarg) ) {
304 if( protocol == LDAP_VERSION3 ) {
305 fprintf( stderr, "%s: -P 2 incompatible with version %d\n",
307 exit( EXIT_FAILURE );
309 protocol = LDAP_VERSION2;
312 if( protocol == LDAP_VERSION2 ) {
313 fprintf( stderr, "%s: -P 2 incompatible with version %d\n",
315 exit( EXIT_FAILURE );
317 protocol = LDAP_VERSION3;
320 fprintf( stderr, "%s: protocol version should be 2 or 3\n",
326 #ifdef HAVE_CYRUS_SASL
327 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
328 fprintf( stderr, "%s: incompatible previous "
329 "authentication choice\n",
331 exit( EXIT_FAILURE );
333 authmethod = LDAP_AUTH_SASL;
334 sasl_flags = LDAP_SASL_QUIET;
337 fprintf( stderr, "%s: not compiled with SASL support\n",
339 exit( EXIT_FAILURE );
342 #ifdef HAVE_CYRUS_SASL
343 if( sasl_realm != NULL ) {
344 fprintf( stderr, "%s: -R previously specified\n", prog );
345 exit( EXIT_FAILURE );
347 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
348 fprintf( stderr, "%s: incompatible previous "
349 "authentication choice\n",
351 exit( EXIT_FAILURE );
353 authmethod = LDAP_AUTH_SASL;
354 sasl_realm = ber_strdup( optarg );
356 fprintf( stderr, "%s: not compiled with SASL support\n",
358 exit( EXIT_FAILURE );
362 #ifdef HAVE_CYRUS_SASL
363 if( sasl_authc_id != NULL ) {
364 fprintf( stderr, "%s: -U previously specified\n", prog );
365 exit( EXIT_FAILURE );
367 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
368 fprintf( stderr, "%s: incompatible previous "
369 "authentication choice\n",
371 exit( EXIT_FAILURE );
373 authmethod = LDAP_AUTH_SASL;
374 sasl_authc_id = ber_strdup( optarg );
376 fprintf( stderr, "%s: not compiled with SASL support\n",
378 exit( EXIT_FAILURE );
381 case 'v': /* verbose mode */
384 case 'V': /* version */
387 case 'w': /* password */
388 passwd.bv_val = ber_strdup( optarg );
392 for( p = optarg; *p != '\0'; p++ ) {
396 passwd.bv_len = strlen( passwd.bv_val );
405 #ifdef HAVE_CYRUS_SASL
406 if( sasl_mech != NULL ) {
407 fprintf( stderr, "%s: -Y previously specified\n", prog );
408 exit( EXIT_FAILURE );
410 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
412 "%s: incompatible with authentication choice\n", prog );
413 exit( EXIT_FAILURE );
415 authmethod = LDAP_AUTH_SASL;
416 sasl_mech = ber_strdup( optarg );
418 fprintf( stderr, "%s: not compiled with SASL support\n", prog );
419 exit( EXIT_FAILURE );
423 if( authmethod != -1 && authmethod != LDAP_AUTH_SIMPLE ) {
424 fprintf( stderr, "%s: incompatible with previous "
425 "authentication choice\n", prog );
426 exit( EXIT_FAILURE );
428 authmethod = LDAP_AUTH_SIMPLE;
431 #ifdef HAVE_CYRUS_SASL
432 if( sasl_authz_id != NULL ) {
433 fprintf( stderr, "%s: -X previously specified\n", prog );
434 exit( EXIT_FAILURE );
436 if( authmethod != -1 && authmethod != LDAP_AUTH_SASL ) {
437 fprintf( stderr, "%s: -X incompatible with "
438 "authentication choice\n", prog );
439 exit( EXIT_FAILURE );
441 authmethod = LDAP_AUTH_SASL;
442 sasl_authz_id = ber_strdup( optarg );
444 fprintf( stderr, "%s: not compiled with SASL support\n", prog );
445 exit( EXIT_FAILURE );
452 fprintf( stderr, "%s: not compiled with TLS support\n", prog );
453 exit( EXIT_FAILURE );
457 if( handle_private_option( i ) ) break;
458 fprintf( stderr, "%s: unrecognized option -%c\n",
465 /* prevent bad linking */
467 api.ldapai_info_version = LDAP_API_INFO_VERSION;
469 if ( ldap_get_option(NULL, LDAP_OPT_API_INFO, &api)
470 != LDAP_OPT_SUCCESS )
472 fprintf( stderr, "%s: ldap_get_option(API_INFO) failed\n", prog );
473 exit( EXIT_FAILURE );
476 if (api.ldapai_info_version != LDAP_API_INFO_VERSION) {
477 fprintf( stderr, "LDAP APIInfo version mismatch: "
478 "got %d, expected %d\n",
479 api.ldapai_info_version, LDAP_API_INFO_VERSION );
480 exit( EXIT_FAILURE );
483 if( api.ldapai_api_version != LDAP_API_VERSION ) {
484 fprintf( stderr, "LDAP API version mismatch: "
485 "got %d, expected %d\n",
486 api.ldapai_api_version, LDAP_API_VERSION );
487 exit( EXIT_FAILURE );
490 if( strcmp(api.ldapai_vendor_name, LDAP_VENDOR_NAME ) != 0 ) {
491 fprintf( stderr, "LDAP vendor name mismatch: "
492 "got %s, expected %s\n",
493 api.ldapai_vendor_name, LDAP_VENDOR_NAME );
494 exit( EXIT_FAILURE );
497 if( api.ldapai_vendor_version != LDAP_VENDOR_VERSION ) {
498 fprintf( stderr, "LDAP vendor version mismatch: "
499 "got %d, expected %d\n",
500 api.ldapai_vendor_version, LDAP_VENDOR_VERSION );
501 exit( EXIT_FAILURE );
505 fprintf( stderr, "%s: %s\t(LDAP library: %s %d)\n",
507 LDAP_VENDOR_NAME, LDAP_VENDOR_VERSION );
508 if (version > 1) exit( EXIT_SUCCESS );
513 protocol = LDAP_VERSION3;
515 if (authmethod == -1 && protocol > LDAP_VERSION2) {
516 #ifdef HAVE_CYRUS_SASL
517 authmethod = LDAP_AUTH_SASL;
519 authmethod = LDAP_AUTH_SIMPLE;
523 if( ldapuri == NULL ) {
524 if( ldapport && ( ldaphost == NULL )) {
525 fprintf( stderr, "%s: -p without -h is invalid.\n", prog );
526 exit( EXIT_FAILURE );
529 if( ldaphost != NULL ) {
530 fprintf( stderr, "%s: -H incompatible with -h\n", prog );
531 exit( EXIT_FAILURE );
534 fprintf( stderr, "%s: -H incompatible with -p\n", prog );
535 exit( EXIT_FAILURE );
538 if( protocol == LDAP_VERSION2 ) {
539 if( authzid || manageDSAit || noop ) {
540 fprintf( stderr, "%s: -e/-M incompatible with LDAPv2\n", prog );
541 exit( EXIT_FAILURE );
545 fprintf( stderr, "%s: -Z incompatible with LDAPv2\n", prog );
546 exit( EXIT_FAILURE );
549 #ifdef HAVE_CYRUS_SASL
550 if( authmethod == LDAP_AUTH_SASL ) {
551 fprintf( stderr, "%s: -[IOQRUXY] incompatible with LDAPv2\n",
553 exit( EXIT_FAILURE );
557 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_KBIND
558 if ( authmethod == LDAP_AUTH_KRBV4 || authmethod == LDAP_AUTH_KRBV41 ) {
559 fprintf( stderr, "%s: -k/-K incompatible with LDAPv%d\n",
561 exit( EXIT_FAILURE );
569 tool_conn_setup( int not, void (*private_setup)( LDAP * ) )
574 if( ber_set_option( NULL, LBER_OPT_DEBUG_LEVEL, &debug )
575 != LBER_OPT_SUCCESS )
577 fprintf( stderr, "Could not set LBER_OPT_DEBUG_LEVEL %d\n", debug );
579 if( ldap_set_option( NULL, LDAP_OPT_DEBUG_LEVEL, &debug )
580 != LDAP_OPT_SUCCESS )
582 fprintf( stderr, "Could not set LDAP_OPT_DEBUG_LEVEL %d\n", debug );
587 (void) SIGNAL( SIGPIPE, SIG_IGN );
591 /* connect to server */
592 if( ( ldaphost != NULL || ldapport ) && ( ldapuri == NULL ) ) {
594 fprintf( stderr, "ldap_init( %s, %d )\n",
595 ldaphost != NULL ? ldaphost : "<DEFAULT>",
599 ld = ldap_init( ldaphost, ldapport );
601 char buf[20 + sizeof(": ldap_init")];
602 sprintf( buf, "%.20s: ldap_init", prog );
604 exit( EXIT_FAILURE );
610 fprintf( stderr, "ldap_initialize( %s )\n",
611 ldapuri != NULL ? ldapuri : "<DEFAULT>" );
613 rc = ldap_initialize( &ld, ldapuri );
614 if( rc != LDAP_SUCCESS ) {
616 "Could not create LDAP session handle (%d): %s\n",
617 rc, ldap_err2string(rc) );
618 exit( EXIT_FAILURE );
622 if( private_setup ) private_setup( ld );
625 if( ldap_set_option( ld, LDAP_OPT_REFERRALS,
626 referrals ? LDAP_OPT_ON : LDAP_OPT_OFF ) != LDAP_OPT_SUCCESS )
628 fprintf( stderr, "Could not set LDAP_OPT_REFERRALS %s\n",
629 referrals ? "on" : "off" );
630 exit( EXIT_FAILURE );
633 if( ldap_set_option( ld, LDAP_OPT_PROTOCOL_VERSION, &protocol )
634 != LDAP_OPT_SUCCESS )
636 fprintf( stderr, "Could not set LDAP_OPT_PROTOCOL_VERSION %d\n",
638 exit( EXIT_FAILURE );
642 ( ldap_start_tls_s( ld, NULL, NULL ) != LDAP_SUCCESS ))
644 ldap_perror( ld, "ldap_start_tls" );
646 exit( EXIT_FAILURE );
656 tool_bind( LDAP *ld )
658 if ( authmethod == LDAP_AUTH_SASL ) {
659 #ifdef HAVE_CYRUS_SASL
663 if( sasl_secprops != NULL ) {
664 rc = ldap_set_option( ld, LDAP_OPT_X_SASL_SECPROPS,
665 (void *) sasl_secprops );
667 if( rc != LDAP_OPT_SUCCESS ) {
669 "Could not set LDAP_OPT_X_SASL_SECPROPS: %s\n",
671 exit( EXIT_FAILURE );
675 defaults = lutil_sasl_defaults( ld,
682 rc = ldap_sasl_interactive_bind_s( ld, binddn,
683 sasl_mech, NULL, NULL,
684 sasl_flags, lutil_sasl_interact, defaults );
686 lutil_sasl_freedefs( defaults );
687 if( rc != LDAP_SUCCESS ) {
688 ldap_perror( ld, "ldap_sasl_interactive_bind_s" );
689 exit( EXIT_FAILURE );
692 fprintf( stderr, "%s: not compiled with SASL support\n",
694 exit( EXIT_FAILURE );
697 if ( ldap_bind_s( ld, binddn, passwd.bv_val, authmethod )
700 ldap_perror( ld, "ldap_bind" );
701 exit( EXIT_FAILURE );
707 /* Set server controls. Add controls extra_c[0..count-1], if set. */
709 tool_server_controls( LDAP *ld, LDAPControl *extra_c, int count )
711 int i = 0, j, crit = 0, err;
712 LDAPControl c[3], **ctrls;
714 ctrls = (LDAPControl**) malloc(sizeof(c) + (count+1)*sizeof(LDAPControl*));
715 if ( ctrls == NULL ) {
716 fprintf( stderr, "No memory\n" );
717 exit( EXIT_FAILURE );
721 c[i].ldctl_oid = LDAP_CONTROL_PROXY_AUTHZ;
722 c[i].ldctl_value.bv_val = authzid;
723 c[i].ldctl_value.bv_len = strlen( authzid );
724 c[i].ldctl_iscritical = 1;
730 c[i].ldctl_oid = LDAP_CONTROL_MANAGEDSAIT;
731 c[i].ldctl_value.bv_val = NULL;
732 c[i].ldctl_value.bv_len = 0;
733 c[i].ldctl_iscritical = manageDSAit > 1;
739 c[i].ldctl_oid = LDAP_CONTROL_NOOP;
740 c[i].ldctl_value.bv_val = NULL;
741 c[i].ldctl_value.bv_len = 0;
742 c[i].ldctl_iscritical = noop > 1;
748 ctrls[i++] = extra_c++;
752 err = ldap_set_option( ld, LDAP_OPT_SERVER_CONTROLS, ctrls );
754 if ( err != LDAP_OPT_SUCCESS ) {
755 for ( j = 0; j < i; j++ ) {
756 if ( ctrls[j]->ldctl_iscritical ) crit = 1;
758 fprintf( stderr, "Could not set %scontrols\n",
759 crit ? "critical " : "" );
764 exit( EXIT_FAILURE );