2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1998-2008 The OpenLDAP Foundation.
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted only as authorized by the OpenLDAP
11 * A copy of this license is available in the file LICENSE in the
12 * top-level directory of the distribution or, alternatively, at
13 * <http://www.OpenLDAP.org/license.html>.
20 #include <ac/stdlib.h>
22 #include <ac/socket.h>
23 #include <ac/string.h>
28 #define LDAP_OPT_REBIND_PROC 0x4e814d
29 #define LDAP_OPT_REBIND_PARAMS 0x4e814e
31 #define LDAP_OPT_NEXTREF_PROC 0x4e815d
32 #define LDAP_OPT_NEXTREF_PARAMS 0x4e815e
34 #define LDAP_OPT_URLLIST_PROC 0x4e816d
35 #define LDAP_OPT_URLLIST_PARAMS 0x4e816e
37 static const LDAPAPIFeatureInfo features[] = {
38 #ifdef LDAP_API_FEATURE_X_OPENLDAP
39 { /* OpenLDAP Extensions API Feature */
40 LDAP_FEATURE_INFO_VERSION,
42 LDAP_API_FEATURE_X_OPENLDAP
46 #ifdef LDAP_API_FEATURE_THREAD_SAFE
47 { /* Basic Thread Safe */
48 LDAP_FEATURE_INFO_VERSION,
50 LDAP_API_FEATURE_THREAD_SAFE
53 #ifdef LDAP_API_FEATURE_SESSION_THREAD_SAFE
54 { /* Session Thread Safe */
55 LDAP_FEATURE_INFO_VERSION,
56 "SESSION_THREAD_SAFE",
57 LDAP_API_FEATURE_SESSION_THREAD_SAFE
60 #ifdef LDAP_API_FEATURE_OPERATION_THREAD_SAFE
61 { /* Operation Thread Safe */
62 LDAP_FEATURE_INFO_VERSION,
63 "OPERATION_THREAD_SAFE",
64 LDAP_API_FEATURE_OPERATION_THREAD_SAFE
67 #ifdef LDAP_API_FEATURE_X_OPENLDAP_REENTRANT
68 { /* OpenLDAP Reentrant */
69 LDAP_FEATURE_INFO_VERSION,
70 "X_OPENLDAP_REENTRANT",
71 LDAP_API_FEATURE_X_OPENLDAP_REENTRANT
74 #if defined( LDAP_API_FEATURE_X_OPENLDAP_THREAD_SAFE ) && \
75 defined( LDAP_THREAD_SAFE )
76 { /* OpenLDAP Thread Safe */
77 LDAP_FEATURE_INFO_VERSION,
78 "X_OPENLDAP_THREAD_SAFE",
79 LDAP_API_FEATURE_X_OPENLDAP_THREAD_SAFE
82 #ifdef LDAP_API_FEATURE_X_OPENLDAP_V2_REFERRALS
84 LDAP_FEATURE_INFO_VERSION,
85 "X_OPENLDAP_V2_REFERRALS",
86 LDAP_API_FEATURE_X_OPENLDAP_V2_REFERRALS
98 struct ldapoptions *lo;
100 /* Get pointer to global option structure */
101 lo = LDAP_INT_GLOBAL_OPT();
103 return LDAP_NO_MEMORY;
106 if( lo->ldo_valid != LDAP_INITIALIZED ) {
107 ldap_int_initialize(lo, NULL);
111 assert( LDAP_VALID( ld ) );
113 if( !LDAP_VALID( ld ) ) {
114 return LDAP_OPT_ERROR;
117 lo = &ld->ld_options;
120 if(outvalue == NULL) {
121 /* no place to get to */
122 return LDAP_OPT_ERROR;
126 case LDAP_OPT_API_INFO: {
127 struct ldapapiinfo *info = (struct ldapapiinfo *) outvalue;
130 /* outvalue must point to an apiinfo structure */
131 return LDAP_OPT_ERROR;
134 if(info->ldapai_info_version != LDAP_API_INFO_VERSION) {
135 /* api info version mismatch */
136 info->ldapai_info_version = LDAP_API_INFO_VERSION;
137 return LDAP_OPT_ERROR;
140 info->ldapai_api_version = LDAP_API_VERSION;
141 info->ldapai_protocol_version = LDAP_VERSION_MAX;
143 if(features[0].ldapaif_name == NULL) {
144 info->ldapai_extensions = NULL;
147 info->ldapai_extensions = LDAP_MALLOC(sizeof(char *) *
148 sizeof(features)/sizeof(LDAPAPIFeatureInfo));
150 for(i=0; features[i].ldapaif_name != NULL; i++) {
151 info->ldapai_extensions[i] =
152 LDAP_STRDUP(features[i].ldapaif_name);
155 info->ldapai_extensions[i] = NULL;
158 info->ldapai_vendor_name = LDAP_STRDUP(LDAP_VENDOR_NAME);
159 info->ldapai_vendor_version = LDAP_VENDOR_VERSION;
161 return LDAP_OPT_SUCCESS;
165 if( ld == NULL || ld->ld_sb == NULL ) {
170 ber_sockbuf_ctrl( ld->ld_sb, LBER_SB_OPT_GET_FD, outvalue );
171 return LDAP_OPT_SUCCESS;
173 case LDAP_OPT_SOCKBUF:
174 if( ld == NULL ) break;
175 *(Sockbuf **)outvalue = ld->ld_sb;
176 return LDAP_OPT_SUCCESS;
178 case LDAP_OPT_TIMEOUT:
179 /* the caller has to free outvalue ! */
180 if ( lo->ldo_tm_api.tv_sec < 0 ) {
181 *(void **)outvalue = NULL;
182 } else if ( ldap_int_timeval_dup( outvalue, &lo->ldo_tm_api ) != 0 ) {
183 return LDAP_OPT_ERROR;
185 return LDAP_OPT_SUCCESS;
187 case LDAP_OPT_NETWORK_TIMEOUT:
188 /* the caller has to free outvalue ! */
189 if ( lo->ldo_tm_net.tv_sec < 0 ) {
190 *(void **)outvalue = NULL;
191 } else if ( ldap_int_timeval_dup( outvalue, &lo->ldo_tm_net ) != 0 ) {
192 return LDAP_OPT_ERROR;
194 return LDAP_OPT_SUCCESS;
197 * (int *) outvalue = lo->ldo_deref;
198 return LDAP_OPT_SUCCESS;
200 case LDAP_OPT_SIZELIMIT:
201 * (int *) outvalue = lo->ldo_sizelimit;
202 return LDAP_OPT_SUCCESS;
204 case LDAP_OPT_TIMELIMIT:
205 * (int *) outvalue = lo->ldo_timelimit;
206 return LDAP_OPT_SUCCESS;
208 case LDAP_OPT_REFERRALS:
209 * (int *) outvalue = (int) LDAP_BOOL_GET(lo, LDAP_BOOL_REFERRALS);
210 return LDAP_OPT_SUCCESS;
212 case LDAP_OPT_RESTART:
213 * (int *) outvalue = (int) LDAP_BOOL_GET(lo, LDAP_BOOL_RESTART);
214 return LDAP_OPT_SUCCESS;
216 case LDAP_OPT_PROTOCOL_VERSION:
217 * (int *) outvalue = lo->ldo_version;
218 return LDAP_OPT_SUCCESS;
220 case LDAP_OPT_SERVER_CONTROLS:
221 * (LDAPControl ***) outvalue =
222 ldap_controls_dup( lo->ldo_sctrls );
224 return LDAP_OPT_SUCCESS;
226 case LDAP_OPT_CLIENT_CONTROLS:
227 * (LDAPControl ***) outvalue =
228 ldap_controls_dup( lo->ldo_cctrls );
230 return LDAP_OPT_SUCCESS;
232 case LDAP_OPT_HOST_NAME:
233 * (char **) outvalue = ldap_url_list2hosts(lo->ldo_defludp);
234 return LDAP_OPT_SUCCESS;
237 * (char **) outvalue = ldap_url_list2urls(lo->ldo_defludp);
238 return LDAP_OPT_SUCCESS;
240 case LDAP_OPT_DEFBASE:
241 if( lo->ldo_defbase == NULL ) {
242 * (char **) outvalue = NULL;
244 * (char **) outvalue = LDAP_STRDUP(lo->ldo_defbase);
247 return LDAP_OPT_SUCCESS;
249 case LDAP_OPT_CONNECT_ASYNC:
250 * (int *) outvalue = (int) LDAP_BOOL_GET(lo, LDAP_BOOL_CONNECT_ASYNC);
251 return LDAP_OPT_SUCCESS;
253 case LDAP_OPT_CONNECT_CB:
255 /* Getting deletes the specified callback */
256 ldaplist **ll = &lo->ldo_conn_cbs;
257 for (;*ll;ll = &(*ll)->ll_next) {
258 if ((*ll)->ll_data == outvalue) {
266 return LDAP_OPT_SUCCESS;
268 case LDAP_OPT_RESULT_CODE:
273 * (int *) outvalue = ld->ld_errno;
274 return LDAP_OPT_SUCCESS;
276 case LDAP_OPT_DIAGNOSTIC_MESSAGE:
282 if( ld->ld_error == NULL ) {
283 * (char **) outvalue = NULL;
285 * (char **) outvalue = LDAP_STRDUP(ld->ld_error);
288 return LDAP_OPT_SUCCESS;
290 case LDAP_OPT_MATCHED_DN:
296 if( ld->ld_matched == NULL ) {
297 * (char **) outvalue = NULL;
299 * (char **) outvalue = LDAP_STRDUP( ld->ld_matched );
302 return LDAP_OPT_SUCCESS;
304 case LDAP_OPT_REFERRAL_URLS:
310 if( ld->ld_referrals == NULL ) {
311 * (char ***) outvalue = NULL;
313 * (char ***) outvalue = ldap_value_dup(ld->ld_referrals);
316 return LDAP_OPT_SUCCESS;
318 case LDAP_OPT_API_FEATURE_INFO: {
319 LDAPAPIFeatureInfo *info = (LDAPAPIFeatureInfo *) outvalue;
322 if(info == NULL) return LDAP_OPT_ERROR;
324 if(info->ldapaif_info_version != LDAP_FEATURE_INFO_VERSION) {
325 /* api info version mismatch */
326 info->ldapaif_info_version = LDAP_FEATURE_INFO_VERSION;
327 return LDAP_OPT_ERROR;
330 if(info->ldapaif_name == NULL) return LDAP_OPT_ERROR;
332 for(i=0; features[i].ldapaif_name != NULL; i++) {
333 if(!strcmp(info->ldapaif_name, features[i].ldapaif_name)) {
334 info->ldapaif_version =
335 features[i].ldapaif_version;
336 return LDAP_OPT_SUCCESS;
342 case LDAP_OPT_DEBUG_LEVEL:
343 * (int *) outvalue = lo->ldo_debug;
344 return LDAP_OPT_SUCCESS;
348 if ( ldap_pvt_tls_get_option( ld, option, outvalue ) == 0 ) {
349 return LDAP_OPT_SUCCESS;
352 #ifdef HAVE_CYRUS_SASL
353 if ( ldap_int_sasl_get_option( ld, option, outvalue ) == 0 ) {
354 return LDAP_OPT_SUCCESS;
361 return LDAP_OPT_ERROR;
368 LDAP_CONST void *invalue)
370 struct ldapoptions *lo;
373 /* Get pointer to global option structure */
374 lo = LDAP_INT_GLOBAL_OPT();
376 return LDAP_NO_MEMORY;
380 * The architecture to turn on debugging has a chicken and egg
381 * problem. Thus, we introduce a fix here.
384 if (option == LDAP_OPT_DEBUG_LEVEL) {
385 dbglvl = (int *) invalue;
388 if( lo->ldo_valid != LDAP_INITIALIZED ) {
389 ldap_int_initialize(lo, dbglvl);
393 assert( LDAP_VALID( ld ) );
395 if( !LDAP_VALID( ld ) ) {
396 return LDAP_OPT_ERROR;
399 lo = &ld->ld_options;
403 case LDAP_OPT_REFERRALS:
404 if(invalue == LDAP_OPT_OFF) {
405 LDAP_BOOL_CLR(lo, LDAP_BOOL_REFERRALS);
407 LDAP_BOOL_SET(lo, LDAP_BOOL_REFERRALS);
409 return LDAP_OPT_SUCCESS;
411 case LDAP_OPT_RESTART:
412 if(invalue == LDAP_OPT_OFF) {
413 LDAP_BOOL_CLR(lo, LDAP_BOOL_RESTART);
415 LDAP_BOOL_SET(lo, LDAP_BOOL_RESTART);
417 return LDAP_OPT_SUCCESS;
419 case LDAP_OPT_CONNECT_ASYNC:
420 if(invalue == LDAP_OPT_OFF) {
421 LDAP_BOOL_CLR(lo, LDAP_BOOL_CONNECT_ASYNC);
423 LDAP_BOOL_SET(lo, LDAP_BOOL_CONNECT_ASYNC);
425 return LDAP_OPT_SUCCESS;
428 /* options which can withstand invalue == NULL */
430 case LDAP_OPT_SERVER_CONTROLS: {
431 LDAPControl *const *controls =
432 (LDAPControl *const *) invalue;
435 ldap_controls_free( lo->ldo_sctrls );
437 if( controls == NULL || *controls == NULL ) {
438 lo->ldo_sctrls = NULL;
439 return LDAP_OPT_SUCCESS;
442 lo->ldo_sctrls = ldap_controls_dup( controls );
444 if(lo->ldo_sctrls == NULL) {
445 /* memory allocation error ? */
448 } return LDAP_OPT_SUCCESS;
450 case LDAP_OPT_CLIENT_CONTROLS: {
451 LDAPControl *const *controls =
452 (LDAPControl *const *) invalue;
455 ldap_controls_free( lo->ldo_cctrls );
457 if( controls == NULL || *controls == NULL ) {
458 lo->ldo_cctrls = NULL;
459 return LDAP_OPT_SUCCESS;
462 lo->ldo_cctrls = ldap_controls_dup( controls );
464 if(lo->ldo_cctrls == NULL) {
465 /* memory allocation error ? */
468 } return LDAP_OPT_SUCCESS;
471 case LDAP_OPT_HOST_NAME: {
472 const char *host = (const char *) invalue;
473 LDAPURLDesc *ludlist = NULL;
474 int rc = LDAP_OPT_SUCCESS;
477 rc = ldap_url_parsehosts( &ludlist, host,
478 lo->ldo_defport ? lo->ldo_defport : LDAP_PORT );
480 } else if(ld == NULL) {
482 * must want global default returned
483 * to initial condition.
485 rc = ldap_url_parselist_ext(&ludlist, "ldap://localhost/", NULL,
486 LDAP_PVT_URL_PARSE_NOEMPTY_HOST
487 | LDAP_PVT_URL_PARSE_DEF_PORT );
491 * must want the session default
492 * updated to the current global default
494 ludlist = ldap_url_duplist(
495 ldap_int_global_options.ldo_defludp);
500 if (rc == LDAP_OPT_SUCCESS) {
501 if (lo->ldo_defludp != NULL)
502 ldap_free_urllist(lo->ldo_defludp);
503 lo->ldo_defludp = ludlist;
509 const char *urls = (const char *) invalue;
510 LDAPURLDesc *ludlist = NULL;
511 int rc = LDAP_OPT_SUCCESS;
514 rc = ldap_url_parselist_ext(&ludlist, urls, NULL,
515 LDAP_PVT_URL_PARSE_NOEMPTY_HOST
516 | LDAP_PVT_URL_PARSE_DEF_PORT );
517 } else if(ld == NULL) {
519 * must want global default returned
520 * to initial condition.
522 rc = ldap_url_parselist_ext(&ludlist, "ldap://localhost/", NULL,
523 LDAP_PVT_URL_PARSE_NOEMPTY_HOST
524 | LDAP_PVT_URL_PARSE_DEF_PORT );
528 * must want the session default
529 * updated to the current global default
531 ludlist = ldap_url_duplist(
532 ldap_int_global_options.ldo_defludp);
534 rc = LDAP_URL_ERR_MEM;
538 case LDAP_URL_SUCCESS: /* Success */
542 case LDAP_URL_ERR_MEM: /* can't allocate memory space */
546 case LDAP_URL_ERR_PARAM: /* parameter is bad */
547 case LDAP_URL_ERR_BADSCHEME: /* URL doesn't begin with "ldap[si]://" */
548 case LDAP_URL_ERR_BADENCLOSURE: /* URL is missing trailing ">" */
549 case LDAP_URL_ERR_BADURL: /* URL is bad */
550 case LDAP_URL_ERR_BADHOST: /* host port is bad */
551 case LDAP_URL_ERR_BADATTRS: /* bad (or missing) attributes */
552 case LDAP_URL_ERR_BADSCOPE: /* scope string is invalid (or missing) */
553 case LDAP_URL_ERR_BADFILTER: /* bad or missing filter */
554 case LDAP_URL_ERR_BADEXTS: /* bad or missing extensions */
555 rc = LDAP_PARAM_ERROR;
559 if (rc == LDAP_SUCCESS) {
560 if (lo->ldo_defludp != NULL)
561 ldap_free_urllist(lo->ldo_defludp);
562 lo->ldo_defludp = ludlist;
567 case LDAP_OPT_DEFBASE: {
568 const char *newbase = (const char *) invalue;
569 char *defbase = NULL;
571 if ( newbase != NULL ) {
572 defbase = LDAP_STRDUP( newbase );
573 if ( defbase == NULL ) return LDAP_NO_MEMORY;
575 } else if ( ld != NULL ) {
576 defbase = LDAP_STRDUP( ldap_int_global_options.ldo_defbase );
577 if ( defbase == NULL ) return LDAP_NO_MEMORY;
580 if ( lo->ldo_defbase != NULL )
581 LDAP_FREE( lo->ldo_defbase );
582 lo->ldo_defbase = defbase;
583 } return LDAP_OPT_SUCCESS;
585 case LDAP_OPT_DIAGNOSTIC_MESSAGE: {
586 const char *err = (const char *) invalue;
589 /* need a struct ldap */
590 return LDAP_OPT_ERROR;
594 LDAP_FREE(ld->ld_error);
599 ld->ld_error = LDAP_STRDUP(err);
601 } return LDAP_OPT_SUCCESS;
603 case LDAP_OPT_MATCHED_DN: {
604 const char *matched = (const char *) invalue;
607 /* need a struct ldap */
608 return LDAP_OPT_ERROR;
611 if( ld->ld_matched ) {
612 LDAP_FREE(ld->ld_matched);
613 ld->ld_matched = NULL;
617 ld->ld_matched = LDAP_STRDUP( matched );
619 } return LDAP_OPT_SUCCESS;
621 case LDAP_OPT_REFERRAL_URLS: {
622 char *const *referrals = (char *const *) invalue;
625 /* need a struct ldap */
626 return LDAP_OPT_ERROR;
629 if( ld->ld_referrals ) {
630 LDAP_VFREE(ld->ld_referrals);
634 ld->ld_referrals = ldap_value_dup(referrals);
636 } return LDAP_OPT_SUCCESS;
638 /* Only accessed from inside this function by ldap_set_rebind_proc() */
639 case LDAP_OPT_REBIND_PROC: {
640 lo->ldo_rebind_proc = (LDAP_REBIND_PROC *)invalue;
641 } return LDAP_OPT_SUCCESS;
642 case LDAP_OPT_REBIND_PARAMS: {
643 lo->ldo_rebind_params = (void *)invalue;
644 } return LDAP_OPT_SUCCESS;
646 /* Only accessed from inside this function by ldap_set_nextref_proc() */
647 case LDAP_OPT_NEXTREF_PROC: {
648 lo->ldo_nextref_proc = (LDAP_NEXTREF_PROC *)invalue;
649 } return LDAP_OPT_SUCCESS;
650 case LDAP_OPT_NEXTREF_PARAMS: {
651 lo->ldo_nextref_params = (void *)invalue;
652 } return LDAP_OPT_SUCCESS;
654 /* Only accessed from inside this function by ldap_set_urllist_proc() */
655 case LDAP_OPT_URLLIST_PROC: {
656 lo->ldo_urllist_proc = (LDAP_URLLIST_PROC *)invalue;
657 } return LDAP_OPT_SUCCESS;
658 case LDAP_OPT_URLLIST_PARAMS: {
659 lo->ldo_urllist_params = (void *)invalue;
660 } return LDAP_OPT_SUCCESS;
662 /* read-only options */
663 case LDAP_OPT_API_INFO:
665 case LDAP_OPT_SOCKBUF:
666 case LDAP_OPT_API_FEATURE_INFO:
667 return LDAP_OPT_ERROR;
669 /* options which cannot withstand invalue == NULL */
671 case LDAP_OPT_SIZELIMIT:
672 case LDAP_OPT_TIMELIMIT:
673 case LDAP_OPT_PROTOCOL_VERSION:
674 case LDAP_OPT_RESULT_CODE:
675 case LDAP_OPT_DEBUG_LEVEL:
676 case LDAP_OPT_TIMEOUT:
677 case LDAP_OPT_NETWORK_TIMEOUT:
678 case LDAP_OPT_CONNECT_CB:
679 if(invalue == NULL) {
680 /* no place to set from */
681 return LDAP_OPT_ERROR;
687 if ( ldap_pvt_tls_set_option( ld, option, (void *)invalue ) == 0 )
688 return LDAP_OPT_SUCCESS;
690 #ifdef HAVE_CYRUS_SASL
691 if ( ldap_int_sasl_set_option( ld, option, (void *)invalue ) == 0 )
692 return LDAP_OPT_SUCCESS;
695 return LDAP_OPT_ERROR;
698 /* options which cannot withstand invalue == NULL */
702 /* FIXME: check value for protocol compliance? */
703 lo->ldo_deref = * (const int *) invalue;
704 return LDAP_OPT_SUCCESS;
706 case LDAP_OPT_SIZELIMIT:
707 /* FIXME: check value for protocol compliance? */
708 lo->ldo_sizelimit = * (const int *) invalue;
709 return LDAP_OPT_SUCCESS;
711 case LDAP_OPT_TIMELIMIT:
712 /* FIXME: check value for protocol compliance? */
713 lo->ldo_timelimit = * (const int *) invalue;
714 return LDAP_OPT_SUCCESS;
716 case LDAP_OPT_TIMEOUT: {
717 const struct timeval *tv =
718 (const struct timeval *) invalue;
720 lo->ldo_tm_api = *tv;
721 } return LDAP_OPT_SUCCESS;
723 case LDAP_OPT_NETWORK_TIMEOUT: {
724 const struct timeval *tv =
725 (const struct timeval *) invalue;
727 lo->ldo_tm_net = *tv;
728 } return LDAP_OPT_SUCCESS;
730 case LDAP_OPT_PROTOCOL_VERSION: {
731 int vers = * (const int *) invalue;
732 if (vers < LDAP_VERSION_MIN || vers > LDAP_VERSION_MAX) {
736 lo->ldo_version = vers;
737 } return LDAP_OPT_SUCCESS;
739 case LDAP_OPT_RESULT_CODE: {
740 int err = * (const int *) invalue;
743 /* need a struct ldap */
748 } return LDAP_OPT_SUCCESS;
750 case LDAP_OPT_DEBUG_LEVEL:
751 lo->ldo_debug = * (const int *) invalue;
752 return LDAP_OPT_SUCCESS;
754 case LDAP_OPT_CONNECT_CB:
756 /* setting pushes the callback */
758 ll = LDAP_MALLOC( sizeof( *ll ));
759 ll->ll_data = (void *)invalue;
760 ll->ll_next = lo->ldo_conn_cbs;
761 lo->ldo_conn_cbs = ll;
763 return LDAP_OPT_SUCCESS;
765 return LDAP_OPT_ERROR;
769 ldap_set_rebind_proc( LDAP *ld, LDAP_REBIND_PROC *proc, void *params )
772 rc = ldap_set_option( ld, LDAP_OPT_REBIND_PROC, (void *)proc );
773 if( rc != LDAP_OPT_SUCCESS ) return rc;
775 rc = ldap_set_option( ld, LDAP_OPT_REBIND_PARAMS, (void *)params );
780 ldap_set_nextref_proc( LDAP *ld, LDAP_NEXTREF_PROC *proc, void *params )
783 rc = ldap_set_option( ld, LDAP_OPT_NEXTREF_PROC, (void *)proc );
784 if( rc != LDAP_OPT_SUCCESS ) return rc;
786 rc = ldap_set_option( ld, LDAP_OPT_NEXTREF_PARAMS, (void *)params );
791 ldap_set_urllist_proc( LDAP *ld, LDAP_URLLIST_PROC *proc, void *params )
794 rc = ldap_set_option( ld, LDAP_OPT_URLLIST_PROC, (void *)proc );
795 if( rc != LDAP_OPT_SUCCESS ) return rc;
797 rc = ldap_set_option( ld, LDAP_OPT_URLLIST_PARAMS, (void *)params );