2 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
4 * Copyright 1999-2010 The OpenLDAP Foundation.
5 * Portions Copyright 2001-2003 Pierangelo Masarati.
6 * Portions Copyright 1999-2003 Howard Chu.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted only as authorized by the OpenLDAP
13 * A copy of this license is available in the file LICENSE in the
14 * top-level directory of the distribution or, alternatively, at
15 * <http://www.OpenLDAP.org/license.html>.
18 * This work was initially developed by the Howard Chu for inclusion
19 * in OpenLDAP Software and subsequently enhanced by Pierangelo
28 #include <ac/socket.h>
29 #include <ac/string.h>
34 #include "../back-ldap/back-ldap.h"
35 #include "back-meta.h"
36 #undef ldap_debug /* silence a warning in ldap-int.h */
37 #include "../../../libraries/libldap/ldap-int.h"
39 #include "lutil_ldap.h"
42 meta_back_proxy_authz_bind(
47 ldap_back_send_t sendok );
50 meta_back_single_bind(
57 meta_back_bind( Operation *op, SlapReply *rs )
59 metainfo_t *mi = ( metainfo_t * )op->o_bd->be_private;
60 metaconn_t *mc = NULL;
67 SlapReply *candidates;
69 rs->sr_err = LDAP_SUCCESS;
71 Debug( LDAP_DEBUG_ARGS, "%s meta_back_bind: dn=\"%s\".\n",
72 op->o_log_prefix, op->o_req_dn.bv_val, 0 );
74 /* the test on the bind method should be superfluous */
75 switch ( be_rootdn_bind( op, rs ) ) {
77 if ( META_BACK_DEFER_ROOTDN_BIND( mi ) ) {
78 /* frontend will return success */
85 case SLAP_CB_CONTINUE:
89 /* be_rootdn_bind() sent result */
93 /* we need meta_back_getconn() not send result even on error,
94 * because we want to intercept the error and make it
95 * invalidCredentials */
96 mc = meta_back_getconn( op, rs, NULL, LDAP_BACK_BIND_DONTSEND );
98 if ( LogTest( LDAP_DEBUG_ANY ) ) {
99 char buf[ SLAP_TEXT_BUFLEN ];
101 snprintf( buf, sizeof( buf ),
102 "meta_back_bind: no target "
103 "for dn \"%s\" (%d%s%s).",
104 op->o_req_dn.bv_val, rs->sr_err,
105 rs->sr_text ? ". " : "",
106 rs->sr_text ? rs->sr_text : "" );
107 Debug( LDAP_DEBUG_ANY,
109 op->o_log_prefix, buf, 0 );
112 /* FIXME: there might be cases where we don't want
113 * to map the error onto invalidCredentials */
114 switch ( rs->sr_err ) {
115 case LDAP_NO_SUCH_OBJECT:
116 case LDAP_UNWILLING_TO_PERFORM:
117 rs->sr_err = LDAP_INVALID_CREDENTIALS;
121 send_ldap_result( op, rs );
125 candidates = meta_back_candidates_get( op );
128 * Each target is scanned ...
130 mc->mc_authz_target = META_BOUND_NONE;
131 for ( i = 0; i < mi->mi_ntargets; i++ ) {
132 metatarget_t *mt = mi->mi_targets[ i ];
136 * Skip non-candidates
138 if ( !META_IS_CANDIDATE( &candidates[ i ] ) ) {
143 /* set rc to LDAP_SUCCESS only if at least
144 * one candidate has been tried */
148 } else if ( !isroot ) {
150 * A bind operation is expected to have
151 * ONE CANDIDATE ONLY!
153 Debug( LDAP_DEBUG_ANY,
154 "### %s meta_back_bind: more than one"
155 " candidate selected...\n",
156 op->o_log_prefix, 0, 0 );
160 if ( mt->mt_idassert_authmethod == LDAP_AUTH_NONE
161 || BER_BVISNULL( &mt->mt_idassert_authcDN ) )
163 metasingleconn_t *msc = &mc->mc_conns[ i ];
165 /* skip the target if no pseudorootdn is provided */
166 if ( !BER_BVISNULL( &msc->msc_bound_ndn ) ) {
167 ch_free( msc->msc_bound_ndn.bv_val );
168 BER_BVZERO( &msc->msc_bound_ndn );
171 if ( !BER_BVISNULL( &msc->msc_cred ) ) {
172 /* destroy sensitive data */
173 memset( msc->msc_cred.bv_val, 0,
174 msc->msc_cred.bv_len );
175 ch_free( msc->msc_cred.bv_val );
176 BER_BVZERO( &msc->msc_cred );
183 (void)meta_back_proxy_authz_bind( mc, i, op, rs, LDAP_BACK_DONTSEND );
187 lerr = meta_back_single_bind( op, rs, mc, i );
190 if ( lerr != LDAP_SUCCESS ) {
191 rc = rs->sr_err = lerr;
193 /* FIXME: in some cases (e.g. unavailable)
194 * do not assume it's not candidate; rather
195 * mark this as an error to be eventually
196 * reported to client */
197 META_CANDIDATE_CLEAR( &candidates[ i ] );
202 /* must re-insert if local DN changed as result of bind */
203 if ( rc == LDAP_SUCCESS ) {
205 mc->mc_authz_target = META_BOUND_ALL;
208 if ( !LDAP_BACK_PCONN_ISPRIV( mc )
209 && !dn_match( &op->o_req_ndn, &mc->mc_local_ndn ) )
213 /* wait for all other ops to release the connection */
214 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
215 assert( mc->mc_refcnt == 1 );
216 #if META_BACK_PRINT_CONNTREE > 0
217 meta_back_print_conntree( mi, ">>> meta_back_bind" );
218 #endif /* META_BACK_PRINT_CONNTREE */
220 /* delete all cached connections with the current connection */
221 if ( LDAP_BACK_SINGLECONN( mi ) ) {
224 while ( ( tmpmc = avl_delete( &mi->mi_conninfo.lai_tree, (caddr_t)mc, meta_back_conn_cmp ) ) != NULL )
226 assert( !LDAP_BACK_PCONN_ISPRIV( mc ) );
227 Debug( LDAP_DEBUG_TRACE,
228 "=>meta_back_bind: destroying conn %lu (refcnt=%u)\n",
229 mc->mc_conn->c_connid, mc->mc_refcnt, 0 );
231 if ( tmpmc->mc_refcnt != 0 ) {
233 LDAP_BACK_CONN_TAINTED_SET( tmpmc );
237 * Needs a test because the handler may be corrupted,
238 * and calling ldap_unbind on a corrupted header results
239 * in a segmentation fault
241 meta_back_conn_free( tmpmc );
246 ber_bvreplace( &mc->mc_local_ndn, &op->o_req_ndn );
247 lerr = avl_insert( &mi->mi_conninfo.lai_tree, (caddr_t)mc,
248 meta_back_conndn_cmp, meta_back_conndn_dup );
249 #if META_BACK_PRINT_CONNTREE > 0
250 meta_back_print_conntree( mi, "<<< meta_back_bind" );
251 #endif /* META_BACK_PRINT_CONNTREE */
254 /* NOTE: a connection cannot be privileged
255 * and be in the avl tree at the same time
258 LDAP_BACK_CONN_ISPRIV_SET( mc );
259 LDAP_BACK_PCONN_SET( mc, op );
262 LDAP_BACK_CONN_CACHED_SET( mc );
265 LDAP_BACK_CONN_CACHED_CLEAR( mc );
267 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
272 meta_back_release_conn( mi, mc );
276 * rc is LDAP_SUCCESS if at least one bind succeeded,
277 * err is the last error that occurred during a bind;
278 * if at least (and at most?) one bind succeeds, fine.
280 if ( rc != LDAP_SUCCESS ) {
283 * deal with bind failure ...
287 * no target was found within the naming context,
288 * so bind must fail with invalid credentials
290 if ( rs->sr_err == LDAP_SUCCESS && gotit == 0 ) {
291 rs->sr_err = LDAP_INVALID_CREDENTIALS;
293 rs->sr_err = slap_map_api2result( rs );
295 send_ldap_result( op, rs );
304 meta_back_bind_op_result(
310 ldap_back_send_t sendok )
312 metainfo_t *mi = ( metainfo_t * )op->o_bd->be_private;
313 metatarget_t *mt = mi->mi_targets[ candidate ];
314 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
318 int nretries = mt->mt_nretries;
319 char buf[ SLAP_TEXT_BUFLEN ];
321 Debug( LDAP_DEBUG_TRACE,
322 ">>> %s meta_back_bind_op_result[%d]\n",
323 op->o_log_prefix, candidate, 0 );
325 /* make sure this is clean */
326 assert( rs->sr_ctrls == NULL );
328 if ( rs->sr_err == LDAP_SUCCESS ) {
329 time_t stoptime = (time_t)(-1),
331 int timeout_err = op->o_protocol >= LDAP_VERSION3 ?
332 LDAP_ADMINLIMIT_EXCEEDED : LDAP_OTHER;
333 const char *timeout_text = "Operation timed out";
334 slap_op_t opidx = slap_req2op( op->o_tag );
336 /* since timeout is not specified, compute and use
337 * the one specific to the ongoing operation */
338 if ( opidx == LDAP_REQ_SEARCH ) {
339 if ( op->ors_tlimit <= 0 ) {
343 timeout = op->ors_tlimit;
344 timeout_err = LDAP_TIMELIMIT_EXCEEDED;
349 timeout = mt->mt_timeout[ opidx ];
352 /* better than nothing :) */
353 if ( timeout == 0 ) {
354 if ( mi->mi_idle_timeout ) {
355 timeout = mi->mi_idle_timeout;
357 } else if ( mi->mi_conn_ttl ) {
358 timeout = mi->mi_conn_ttl;
363 stoptime = op->o_time + timeout;
366 LDAP_BACK_TV_SET( &tv );
372 rc = ldap_result( msc->msc_ld, msgid, LDAP_MSG_ALL, &tv, &res );
375 if ( nretries != META_RETRY_NEVER
376 || ( timeout && slap_get_time() <= stoptime ) )
378 ldap_pvt_thread_yield();
379 if ( nretries > 0 ) {
382 tv = mt->mt_bind_timeout;
386 /* don't let anyone else use this handler,
387 * because there's a pending bind that will not
389 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
390 assert( LDAP_BACK_CONN_BINDING( msc ) );
393 Debug( LDAP_DEBUG_ANY, "### %s meta_back_bind_op_result ldap_unbind_ext[%d] ld=%p\n",
394 op->o_log_prefix, candidate, (void *)msc->msc_ld );
395 #endif /* DEBUG_205 */
397 meta_clear_one_candidate( op, mc, candidate );
398 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
400 rs->sr_err = timeout_err;
401 rs->sr_text = timeout_text;
405 ldap_get_option( msc->msc_ld, LDAP_OPT_ERROR_NUMBER,
408 snprintf( buf, sizeof( buf ),
409 "err=%d (%s) nretries=%d",
410 rs->sr_err, ldap_err2string( rs->sr_err ), nretries );
411 Debug( LDAP_DEBUG_ANY,
412 "### %s meta_back_bind_op_result[%d]: %s.\n",
413 op->o_log_prefix, candidate, buf );
417 /* only touch when activity actually took place... */
418 if ( mi->mi_idle_timeout != 0 && msc->msc_time < op->o_time ) {
419 msc->msc_time = op->o_time;
422 /* FIXME: matched? referrals? response controls? */
423 rc = ldap_parse_result( msc->msc_ld, res, &rs->sr_err,
424 NULL, NULL, NULL, NULL, 1 );
425 if ( rc != LDAP_SUCCESS ) {
428 rs->sr_err = slap_map_api2result( rs );
433 rs->sr_err = slap_map_api2result( rs );
435 Debug( LDAP_DEBUG_TRACE,
436 "<<< %s meta_back_bind_op_result[%d] err=%d\n",
437 op->o_log_prefix, candidate, rs->sr_err );
443 * meta_back_single_bind
445 * attempts to perform a bind with creds
448 meta_back_single_bind(
454 metainfo_t *mi = ( metainfo_t * )op->o_bd->be_private;
455 metatarget_t *mt = mi->mi_targets[ candidate ];
456 struct berval mdn = BER_BVNULL;
457 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
460 struct berval save_o_dn;
461 int save_o_do_not_cache;
462 LDAPControl **ctrls = NULL;
464 if ( !BER_BVISNULL( &msc->msc_bound_ndn ) ) {
465 ch_free( msc->msc_bound_ndn.bv_val );
466 BER_BVZERO( &msc->msc_bound_ndn );
469 if ( !BER_BVISNULL( &msc->msc_cred ) ) {
470 /* destroy sensitive data */
471 memset( msc->msc_cred.bv_val, 0, msc->msc_cred.bv_len );
472 ch_free( msc->msc_cred.bv_val );
473 BER_BVZERO( &msc->msc_cred );
477 * Rewrite the bind dn if needed
480 dc.conn = op->o_conn;
484 if ( ldap_back_dn_massage( &dc, &op->o_req_dn, &mdn ) ) {
485 rs->sr_text = "DN rewrite error";
486 rs->sr_err = LDAP_OTHER;
490 /* don't add proxyAuthz; set the bindDN */
491 save_o_dn = op->o_dn;
492 save_o_do_not_cache = op->o_do_not_cache;
493 op->o_do_not_cache = 1;
494 op->o_dn = op->o_req_dn;
497 rs->sr_err = meta_back_controls_add( op, rs, mc, candidate, &ctrls );
498 op->o_dn = save_o_dn;
499 op->o_do_not_cache = save_o_do_not_cache;
500 if ( rs->sr_err != LDAP_SUCCESS ) {
504 /* FIXME: this fixes the bind problem right now; we need
505 * to use the asynchronous version to get the "matched"
506 * and more in case of failure ... */
507 /* FIXME: should we check if at least some of the op->o_ctrls
508 * can/should be passed? */
510 rs->sr_err = ldap_sasl_bind( msc->msc_ld, mdn.bv_val,
511 LDAP_SASL_SIMPLE, &op->orb_cred,
512 ctrls, NULL, &msgid );
513 if ( rs->sr_err != LDAP_X_CONNECTING ) {
516 ldap_pvt_thread_yield();
519 mi->mi_ldap_extra->controls_free( op, rs, &ctrls );
521 meta_back_bind_op_result( op, rs, mc, candidate, msgid, LDAP_BACK_DONTSEND );
522 if ( rs->sr_err != LDAP_SUCCESS ) {
526 /* If defined, proxyAuthz will be used also when
527 * back-ldap is the authorizing backend; for this
528 * purpose, a successful bind is followed by a
529 * bind with the configured identity assertion */
530 /* NOTE: use with care */
531 if ( mt->mt_idassert_flags & LDAP_BACK_AUTH_OVERRIDE ) {
532 meta_back_proxy_authz_bind( mc, candidate, op, rs, LDAP_BACK_SENDERR );
533 if ( !LDAP_BACK_CONN_ISBOUND( msc ) ) {
539 ber_bvreplace( &msc->msc_bound_ndn, &op->o_req_ndn );
540 LDAP_BACK_CONN_ISBOUND_SET( msc );
541 mc->mc_authz_target = candidate;
543 if ( META_BACK_TGT_SAVECRED( mt ) ) {
544 if ( !BER_BVISNULL( &msc->msc_cred ) ) {
545 memset( msc->msc_cred.bv_val, 0,
546 msc->msc_cred.bv_len );
548 ber_bvreplace( &msc->msc_cred, &op->orb_cred );
549 ldap_set_rebind_proc( msc->msc_ld, mt->mt_rebind_f, msc );
553 if ( mi->mi_cache.ttl != META_DNCACHE_DISABLED
554 && !BER_BVISEMPTY( &op->o_req_ndn ) )
556 ( void )meta_dncache_update_entry( &mi->mi_cache,
557 &op->o_req_ndn, candidate );
561 if ( mdn.bv_val != op->o_req_dn.bv_val ) {
565 if ( META_BACK_TGT_QUARANTINE( mt ) ) {
566 meta_back_quarantine( op, rs, candidate );
573 * meta_back_single_dobind
576 meta_back_single_dobind(
581 ldap_back_send_t sendok,
585 metainfo_t *mi = ( metainfo_t * )op->o_bd->be_private;
586 metatarget_t *mt = mi->mi_targets[ candidate ];
587 metaconn_t *mc = *mcp;
588 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
589 static struct berval cred = BER_BVC( "" );
592 assert( !LDAP_BACK_CONN_ISBOUND( msc ) );
594 /* NOTE: this obsoletes pseudorootdn */
595 if ( op->o_conn != NULL &&
596 !op->o_do_not_cache &&
597 ( BER_BVISNULL( &msc->msc_bound_ndn ) ||
598 BER_BVISEMPTY( &msc->msc_bound_ndn ) ||
599 ( LDAP_BACK_CONN_ISPRIV( mc ) && dn_match( &msc->msc_bound_ndn, &mt->mt_idassert_authcDN ) ) ||
600 ( mt->mt_idassert_flags & LDAP_BACK_AUTH_OVERRIDE ) ) )
602 (void)meta_back_proxy_authz_bind( mc, candidate, op, rs, sendok );
606 /* FIXME: should we check if at least some of the op->o_ctrls
607 * can/should be passed? */
609 rs->sr_err = ldap_sasl_bind( msc->msc_ld,
610 "", LDAP_SASL_SIMPLE, &cred,
611 NULL, NULL, &msgid );
612 if ( rs->sr_err != LDAP_X_CONNECTING ) {
615 ldap_pvt_thread_yield();
618 rs->sr_err = meta_back_bind_op_result( op, rs, mc, candidate, msgid, sendok );
621 if ( rs->sr_err != LDAP_SUCCESS ) {
623 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
625 LDAP_BACK_CONN_BINDING_CLEAR( msc );
626 if ( META_BACK_ONERR_STOP( mi ) ) {
627 LDAP_BACK_CONN_TAINTED_SET( mc );
628 meta_back_release_conn_lock( mi, mc, 0 );
632 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
636 if ( META_BACK_TGT_QUARANTINE( mt ) ) {
637 meta_back_quarantine( op, rs, candidate );
651 ldap_back_send_t sendok )
653 metainfo_t *mi = ( metainfo_t * )op->o_bd->be_private;
659 SlapReply *candidates;
661 if ( be_isroot( op ) ) {
665 if ( LogTest( LDAP_DEBUG_TRACE ) ) {
666 char buf[STRLENOF("4294967295U") + 1] = { 0 };
667 mi->mi_ldap_extra->connid2str( &mc->mc_base, buf, sizeof(buf) );
669 Debug( LDAP_DEBUG_TRACE,
670 "%s meta_back_dobind: conn=%s%s\n",
671 op->o_log_prefix, buf,
672 isroot ? " (isroot)" : "" );
676 * all the targets are bound as pseudoroot
678 if ( mc->mc_authz_target == META_BOUND_ALL ) {
683 candidates = meta_back_candidates_get( op );
685 for ( i = 0; i < mi->mi_ntargets; i++ ) {
686 metatarget_t *mt = mi->mi_targets[ i ];
687 metasingleconn_t *msc = &mc->mc_conns[ i ];
693 if ( !META_IS_CANDIDATE( &candidates[ i ] ) ) {
697 assert( msc->msc_ld != NULL );
700 * If the target is already bound it is skipped
704 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
705 if ( LDAP_BACK_CONN_ISBOUND( msc )
706 || ( LDAP_BACK_CONN_ISANON( msc )
707 && mt->mt_idassert_authmethod == LDAP_AUTH_NONE ) )
709 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
713 } else if ( META_BACK_CONN_CREATING( msc ) || LDAP_BACK_CONN_BINDING( msc ) )
715 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
716 ldap_pvt_thread_yield();
721 LDAP_BACK_CONN_BINDING_SET( msc );
722 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
724 rc = meta_back_single_dobind( op, rs, &mc, i,
725 LDAP_BACK_DONTSEND, mt->mt_nretries, 1 );
727 * NOTE: meta_back_single_dobind() already retries;
728 * in case of failure, it resets mc...
730 if ( rc != LDAP_SUCCESS ) {
731 char buf[ SLAP_TEXT_BUFLEN ];
734 /* meta_back_single_dobind() already sent
735 * response and released connection */
740 if ( rc == LDAP_UNAVAILABLE ) {
741 /* FIXME: meta_back_retry() already re-calls
742 * meta_back_single_dobind() */
743 if ( meta_back_retry( op, rs, &mc, i, sendok ) ) {
748 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
749 LDAP_BACK_CONN_BINDING_CLEAR( msc );
750 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
751 meta_back_release_conn( mi, mc );
757 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
758 LDAP_BACK_CONN_BINDING_CLEAR( msc );
759 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
761 snprintf( buf, sizeof( buf ),
762 "meta_back_dobind[%d]: (%s) err=%d (%s).",
763 i, isroot ? op->o_bd->be_rootdn.bv_val : "anonymous",
764 rc, ldap_err2string( rc ) );
765 Debug( LDAP_DEBUG_ANY,
767 op->o_log_prefix, buf, 0 );
770 * null cred bind should always succeed
771 * as anonymous, so a failure means
772 * the target is no longer candidate possibly
773 * due to technical reasons (remote host down?)
774 * so better clear the handle
776 /* leave the target candidate, but record the error for later use */
777 candidates[ i ].sr_err = rc;
778 if ( META_BACK_ONERR_STOP( mi ) ) {
787 Debug( LDAP_DEBUG_TRACE,
788 "%s meta_back_dobind[%d]: "
791 isroot ? op->o_bd->be_rootdn.bv_val : "anonymous" );
793 ldap_pvt_thread_mutex_lock( &mi->mi_conninfo.lai_mutex );
794 LDAP_BACK_CONN_BINDING_CLEAR( msc );
796 LDAP_BACK_CONN_ISBOUND_SET( msc );
798 LDAP_BACK_CONN_ISANON_SET( msc );
800 ldap_pvt_thread_mutex_unlock( &mi->mi_conninfo.lai_mutex );
805 if ( LogTest( LDAP_DEBUG_TRACE ) ) {
806 char buf[STRLENOF("4294967295U") + 1] = { 0 };
807 mi->mi_ldap_extra->connid2str( &mc->mc_base, buf, sizeof(buf) );
809 Debug( LDAP_DEBUG_TRACE,
810 "%s meta_back_dobind: conn=%s bound=%d\n",
811 op->o_log_prefix, buf, bound );
815 meta_back_release_conn( mi, mc );
818 if ( sendok & LDAP_BACK_SENDERR ) {
819 if ( rs->sr_err == LDAP_SUCCESS ) {
820 rs->sr_err = LDAP_BUSY;
822 send_ldap_result( op, rs );
828 return ( bound > 0 );
832 * meta_back_default_rebind
834 * This is a callback used for chasing referrals using the same
835 * credentials as the original user on this session.
838 meta_back_default_rebind(
840 LDAP_CONST char *url,
845 metasingleconn_t *msc = ( metasingleconn_t * )params;
847 return ldap_sasl_bind_s( ld, msc->msc_bound_ndn.bv_val,
848 LDAP_SASL_SIMPLE, &msc->msc_cred,
853 * meta_back_default_urllist
855 * This is a callback used for mucking with the urllist
858 meta_back_default_urllist(
860 LDAPURLDesc **urllist,
864 metatarget_t *mt = (metatarget_t *)params;
865 LDAPURLDesc **urltail;
867 if ( urllist == url ) {
871 for ( urltail = &(*url)->lud_next; *urltail; urltail = &(*urltail)->lud_next )
878 ldap_pvt_thread_mutex_lock( &mt->mt_uri_mutex );
880 ch_free( mt->mt_uri );
883 ldap_get_option( ld, LDAP_OPT_URI, (void *)&mt->mt_uri );
884 ldap_pvt_thread_mutex_unlock( &mt->mt_uri_mutex );
896 ldap_back_send_t sendok )
898 metainfo_t *mi = (metainfo_t *)op->o_bd->be_private;
900 metatarget_t *mt = mi->mi_targets[ candidate ];
901 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
905 Debug( LDAP_DEBUG_TRACE, ">>> %s meta_back_cancel[%d] msgid=%d\n",
906 op->o_log_prefix, candidate, msgid );
908 /* default behavior */
909 if ( META_BACK_TGT_ABANDON( mt ) ) {
910 rc = ldap_abandon_ext( msc->msc_ld, msgid, NULL, NULL );
912 } else if ( META_BACK_TGT_IGNORE( mt ) ) {
913 rc = ldap_pvt_discard( msc->msc_ld, msgid );
915 } else if ( META_BACK_TGT_CANCEL( mt ) ) {
916 rc = ldap_cancel_s( msc->msc_ld, msgid, NULL, NULL );
922 Debug( LDAP_DEBUG_TRACE, "<<< %s meta_back_cancel[%d] err=%d\n",
923 op->o_log_prefix, candidate, rc );
931 * FIXME: error return must be handled in a cleaner way ...
941 ldap_back_send_t sendok )
943 metainfo_t *mi = ( metainfo_t * )op->o_bd->be_private;
945 const char *save_text = rs->sr_text,
946 *save_matched = rs->sr_matched;
947 BerVarray save_ref = rs->sr_ref;
948 LDAPControl **save_ctrls = rs->sr_ctrls;
949 void *matched_ctx = NULL;
951 char *matched = NULL;
954 LDAPControl **ctrls = NULL;
956 assert( mc != NULL );
959 rs->sr_matched = NULL;
963 if ( candidate != META_TARGET_NONE ) {
964 metatarget_t *mt = mi->mi_targets[ candidate ];
965 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
967 if ( LDAP_ERR_OK( rs->sr_err ) ) {
970 LDAPMessage *res = NULL;
971 time_t stoptime = (time_t)(-1);
972 int timeout_err = op->o_protocol >= LDAP_VERSION3 ?
973 LDAP_ADMINLIMIT_EXCEEDED : LDAP_OTHER;
974 const char *timeout_text = "Operation timed out";
976 /* if timeout is not specified, compute and use
977 * the one specific to the ongoing operation */
978 if ( timeout == (time_t)(-1) ) {
979 slap_op_t opidx = slap_req2op( op->o_tag );
981 if ( opidx == SLAP_OP_SEARCH ) {
982 if ( op->ors_tlimit <= 0 ) {
986 timeout = op->ors_tlimit;
987 timeout_err = LDAP_TIMELIMIT_EXCEEDED;
992 timeout = mt->mt_timeout[ opidx ];
996 /* better than nothing :) */
997 if ( timeout == 0 ) {
998 if ( mi->mi_idle_timeout ) {
999 timeout = mi->mi_idle_timeout;
1001 } else if ( mi->mi_conn_ttl ) {
1002 timeout = mi->mi_conn_ttl;
1007 stoptime = op->o_time + timeout;
1010 LDAP_BACK_TV_SET( &tv );
1013 rc = ldap_result( msc->msc_ld, msgid, LDAP_MSG_ALL, &tv, &res );
1016 if ( timeout && slap_get_time() > stoptime ) {
1017 (void)meta_back_cancel( mc, op, rs, msgid, candidate, sendok );
1018 rs->sr_err = timeout_err;
1019 rs->sr_text = timeout_text;
1023 LDAP_BACK_TV_SET( &tv );
1024 ldap_pvt_thread_yield();
1028 ldap_get_option( msc->msc_ld, LDAP_OPT_RESULT_CODE,
1033 /* otherwise get the result; if it is not
1034 * LDAP_SUCCESS, record it in the reply
1035 * structure (this includes
1036 * LDAP_COMPARE_{TRUE|FALSE}) */
1038 /* only touch when activity actually took place... */
1039 if ( mi->mi_idle_timeout != 0 && msc->msc_time < op->o_time ) {
1040 msc->msc_time = op->o_time;
1043 rc = ldap_parse_result( msc->msc_ld, res, &rs->sr_err,
1044 &matched, &text, &refs, &ctrls, 1 );
1046 if ( rc == LDAP_SUCCESS ) {
1051 rs->sr_err = slap_map_api2result( rs );
1053 /* RFC 4511: referrals can only appear
1054 * if result code is LDAP_REFERRAL */
1056 && refs[ 0 ] != NULL
1057 && refs[ 0 ][ 0 ] != '\0' )
1059 if ( rs->sr_err != LDAP_REFERRAL ) {
1060 Debug( LDAP_DEBUG_ANY,
1061 "%s meta_back_op_result[%d]: "
1062 "got referrals with err=%d\n",
1064 candidate, rs->sr_err );
1069 for ( i = 0; refs[ i ] != NULL; i++ )
1071 rs->sr_ref = op->o_tmpalloc( sizeof( struct berval ) * ( i + 1 ),
1073 for ( i = 0; refs[ i ] != NULL; i++ ) {
1074 ber_str2bv( refs[ i ], 0, 0, &rs->sr_ref[ i ] );
1076 BER_BVZERO( &rs->sr_ref[ i ] );
1079 } else if ( rs->sr_err == LDAP_REFERRAL ) {
1080 Debug( LDAP_DEBUG_ANY,
1081 "%s meta_back_op_result[%d]: "
1082 "got err=%d with null "
1083 "or empty referrals\n",
1085 candidate, rs->sr_err );
1087 rs->sr_err = LDAP_NO_SUCH_OBJECT;
1090 if ( ctrls != NULL ) {
1091 rs->sr_ctrls = ctrls;
1095 assert( res == NULL );
1098 /* if the error in the reply structure is not
1099 * LDAP_SUCCESS, try to map it from client
1100 * to server error */
1101 if ( !LDAP_ERR_OK( rs->sr_err ) ) {
1102 rs->sr_err = slap_map_api2result( rs );
1104 /* internal ops ( op->o_conn == NULL )
1105 * must not reply to client */
1106 if ( op->o_conn && !op->o_do_not_cache && matched ) {
1108 /* record the (massaged) matched
1109 * DN into the reply structure */
1110 rs->sr_matched = matched;
1114 if ( META_BACK_TGT_QUARANTINE( mt ) ) {
1115 meta_back_quarantine( op, rs, candidate );
1122 for ( i = 0; i < mi->mi_ntargets; i++ ) {
1123 metasingleconn_t *msc = &mc->mc_conns[ i ];
1125 char *xmatched = NULL;
1127 rs->sr_err = LDAP_SUCCESS;
1129 ldap_get_option( msc->msc_ld, LDAP_OPT_RESULT_CODE, &rs->sr_err );
1130 if ( rs->sr_err != LDAP_SUCCESS ) {
1132 * better check the type of error. In some cases
1133 * (search ?) it might be better to return a
1134 * success if at least one of the targets gave
1135 * positive result ...
1137 ldap_get_option( msc->msc_ld,
1138 LDAP_OPT_DIAGNOSTIC_MESSAGE, &xtext );
1139 if ( xtext != NULL && xtext [ 0 ] == '\0' ) {
1140 ldap_memfree( xtext );
1144 ldap_get_option( msc->msc_ld,
1145 LDAP_OPT_MATCHED_DN, &xmatched );
1146 if ( xmatched != NULL && xmatched[ 0 ] == '\0' ) {
1147 ldap_memfree( xmatched );
1151 rs->sr_err = slap_map_api2result( rs );
1153 if ( LogTest( LDAP_DEBUG_ANY ) ) {
1154 char buf[ SLAP_TEXT_BUFLEN ];
1156 snprintf( buf, sizeof( buf ),
1157 "meta_back_op_result[%d] "
1158 "err=%d text=\"%s\" matched=\"%s\"",
1160 ( xtext ? xtext : "" ),
1161 ( xmatched ? xmatched : "" ) );
1162 Debug( LDAP_DEBUG_ANY, "%s %s.\n",
1163 op->o_log_prefix, buf, 0 );
1167 * FIXME: need to rewrite "match" (need rwinfo)
1169 switch ( rs->sr_err ) {
1172 if ( xtext != NULL ) {
1174 ldap_memfree( text );
1179 if ( xmatched != NULL ) {
1181 ldap_memfree( matched );
1190 ldap_memfree( xtext );
1194 ldap_memfree( xmatched );
1198 if ( META_BACK_TGT_QUARANTINE( mi->mi_targets[ i ] ) ) {
1199 meta_back_quarantine( op, rs, i );
1203 if ( err != LDAP_SUCCESS ) {
1208 if ( matched != NULL ) {
1209 struct berval dn, pdn;
1211 ber_str2bv( matched, 0, 0, &dn );
1212 if ( dnPretty( NULL, &dn, &pdn, op->o_tmpmemctx ) == LDAP_SUCCESS ) {
1213 ldap_memfree( matched );
1214 matched_ctx = op->o_tmpmemctx;
1215 matched = pdn.bv_val;
1217 rs->sr_matched = matched;
1220 if ( rs->sr_err == LDAP_UNAVAILABLE ) {
1221 if ( !( sendok & LDAP_BACK_RETRYING ) ) {
1222 if ( op->o_conn && ( sendok & LDAP_BACK_SENDERR ) ) {
1223 if ( rs->sr_text == NULL ) rs->sr_text = "Proxy operation retry failed";
1224 send_ldap_result( op, rs );
1228 } else if ( op->o_conn &&
1229 ( ( ( sendok & LDAP_BACK_SENDOK ) && LDAP_ERR_OK( rs->sr_err ) )
1230 || ( ( sendok & LDAP_BACK_SENDERR ) && !LDAP_ERR_OK( rs->sr_err ) ) ) )
1232 send_ldap_result( op, rs );
1235 op->o_tmpfree( (char *)rs->sr_matched, matched_ctx );
1238 ldap_memfree( text );
1241 op->o_tmpfree( rs->sr_ref, op->o_tmpmemctx );
1245 ber_memvfree( (void **)refs );
1248 assert( rs->sr_ctrls != NULL );
1249 ldap_controls_free( ctrls );
1252 rs->sr_text = save_text;
1253 rs->sr_matched = save_matched;
1254 rs->sr_ref = save_ref;
1255 rs->sr_ctrls = save_ctrls;
1257 return( LDAP_ERR_OK( rs->sr_err ) ? LDAP_SUCCESS : rs->sr_err );
1261 * meta_back_proxy_authz_cred()
1263 * prepares credentials & method for meta_back_proxy_authz_bind();
1264 * or, if method is SASL, performs the SASL bind directly.
1267 meta_back_proxy_authz_cred(
1272 ldap_back_send_t sendok,
1273 struct berval *binddn,
1274 struct berval *bindcred,
1277 metainfo_t *mi = (metainfo_t *)op->o_bd->be_private;
1278 metatarget_t *mt = mi->mi_targets[ candidate ];
1279 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
1283 /* don't proxyAuthz if protocol is not LDAPv3 */
1284 switch ( mt->mt_version ) {
1289 if ( op->o_protocol == 0 || op->o_protocol == LDAP_VERSION3 ) {
1295 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1296 if ( sendok & LDAP_BACK_SENDERR ) {
1297 send_ldap_result( op, rs );
1299 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1303 if ( op->o_tag == LDAP_REQ_BIND ) {
1304 ndn = op->o_req_ndn;
1306 } else if ( !BER_BVISNULL( &op->o_conn->c_ndn ) ) {
1307 ndn = op->o_conn->c_ndn;
1314 * FIXME: we need to let clients use proxyAuthz
1315 * otherwise we cannot do symmetric pools of servers;
1316 * we have to live with the fact that a user can
1317 * authorize itself as any ID that is allowed
1318 * by the authzTo directive of the "proxyauthzdn".
1321 * NOTE: current Proxy Authorization specification
1322 * and implementation do not allow proxy authorization
1323 * control to be provided with Bind requests
1326 * if no bind took place yet, but the connection is bound
1327 * and the "proxyauthzdn" is set, then bind as
1328 * "proxyauthzdn" and explicitly add the proxyAuthz
1329 * control to every operation with the dn bound
1330 * to the connection as control value.
1333 /* bind as proxyauthzdn only if no idassert mode
1334 * is requested, or if the client's identity
1336 switch ( mt->mt_idassert_mode ) {
1337 case LDAP_BACK_IDASSERT_LEGACY:
1338 if ( !BER_BVISNULL( &ndn ) && !BER_BVISEMPTY( &ndn ) ) {
1339 if ( !BER_BVISNULL( &mt->mt_idassert_authcDN ) && !BER_BVISEMPTY( &mt->mt_idassert_authcDN ) )
1341 *binddn = mt->mt_idassert_authcDN;
1342 *bindcred = mt->mt_idassert_passwd;
1349 /* NOTE: rootdn can always idassert */
1350 if ( BER_BVISNULL( &ndn )
1351 && mt->mt_idassert_authz == NULL
1352 && !( mt->mt_idassert_flags & LDAP_BACK_AUTH_AUTHZ_ALL ) )
1354 if ( mt->mt_idassert_flags & LDAP_BACK_AUTH_PRESCRIPTIVE ) {
1355 rs->sr_err = LDAP_INAPPROPRIATE_AUTH;
1356 if ( sendok & LDAP_BACK_SENDERR ) {
1357 send_ldap_result( op, rs );
1359 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1364 rs->sr_err = LDAP_SUCCESS;
1365 *binddn = slap_empty_bv;
1366 *bindcred = slap_empty_bv;
1369 } else if ( mt->mt_idassert_authz && !be_isroot( op ) ) {
1370 struct berval authcDN;
1372 if ( BER_BVISNULL( &ndn ) ) {
1373 authcDN = slap_empty_bv;
1378 rs->sr_err = slap_sasl_matches( op, mt->mt_idassert_authz,
1379 &authcDN, &authcDN );
1380 if ( rs->sr_err != LDAP_SUCCESS ) {
1381 if ( mt->mt_idassert_flags & LDAP_BACK_AUTH_PRESCRIPTIVE ) {
1382 if ( sendok & LDAP_BACK_SENDERR ) {
1383 send_ldap_result( op, rs );
1385 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1389 rs->sr_err = LDAP_SUCCESS;
1390 *binddn = slap_empty_bv;
1391 *bindcred = slap_empty_bv;
1396 *binddn = mt->mt_idassert_authcDN;
1397 *bindcred = mt->mt_idassert_passwd;
1402 if ( dobind && mt->mt_idassert_authmethod == LDAP_AUTH_SASL ) {
1403 #ifdef HAVE_CYRUS_SASL
1404 void *defaults = NULL;
1405 struct berval authzID = BER_BVNULL;
1408 /* if SASL supports native authz, prepare for it */
1409 if ( ( !op->o_do_not_cache || !op->o_is_auth_check ) &&
1410 ( mt->mt_idassert_flags & LDAP_BACK_AUTH_NATIVE_AUTHZ ) )
1412 switch ( mt->mt_idassert_mode ) {
1413 case LDAP_BACK_IDASSERT_OTHERID:
1414 case LDAP_BACK_IDASSERT_OTHERDN:
1415 authzID = mt->mt_idassert_authzID;
1418 case LDAP_BACK_IDASSERT_ANONYMOUS:
1419 BER_BVSTR( &authzID, "dn:" );
1422 case LDAP_BACK_IDASSERT_SELF:
1423 if ( BER_BVISNULL( &ndn ) ) {
1424 /* connection is not authc'd, so don't idassert */
1425 BER_BVSTR( &authzID, "dn:" );
1428 authzID.bv_len = STRLENOF( "dn:" ) + ndn.bv_len;
1429 authzID.bv_val = slap_sl_malloc( authzID.bv_len + 1, op->o_tmpmemctx );
1430 AC_MEMCPY( authzID.bv_val, "dn:", STRLENOF( "dn:" ) );
1431 AC_MEMCPY( authzID.bv_val + STRLENOF( "dn:" ),
1432 ndn.bv_val, ndn.bv_len + 1 );
1441 if ( mt->mt_idassert_secprops != NULL ) {
1442 rs->sr_err = ldap_set_option( msc->msc_ld,
1443 LDAP_OPT_X_SASL_SECPROPS,
1444 (void *)mt->mt_idassert_secprops );
1446 if ( rs->sr_err != LDAP_OPT_SUCCESS ) {
1447 rs->sr_err = LDAP_OTHER;
1448 if ( sendok & LDAP_BACK_SENDERR ) {
1449 send_ldap_result( op, rs );
1451 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1456 defaults = lutil_sasl_defaults( msc->msc_ld,
1457 mt->mt_idassert_sasl_mech.bv_val,
1458 mt->mt_idassert_sasl_realm.bv_val,
1459 mt->mt_idassert_authcID.bv_val,
1460 mt->mt_idassert_passwd.bv_val,
1462 if ( defaults == NULL ) {
1463 rs->sr_err = LDAP_OTHER;
1464 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1465 if ( sendok & LDAP_BACK_SENDERR ) {
1466 send_ldap_result( op, rs );
1471 rs->sr_err = ldap_sasl_interactive_bind_s( msc->msc_ld, binddn->bv_val,
1472 mt->mt_idassert_sasl_mech.bv_val, NULL, NULL,
1473 LDAP_SASL_QUIET, lutil_sasl_interact,
1476 rs->sr_err = slap_map_api2result( rs );
1477 if ( rs->sr_err != LDAP_SUCCESS ) {
1478 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1479 if ( sendok & LDAP_BACK_SENDERR ) {
1480 send_ldap_result( op, rs );
1484 LDAP_BACK_CONN_ISBOUND_SET( msc );
1487 lutil_sasl_freedefs( defaults );
1489 slap_sl_free( authzID.bv_val, op->o_tmpmemctx );
1493 #endif /* HAVE_CYRUS_SASL */
1496 *method = mt->mt_idassert_authmethod;
1497 switch ( mt->mt_idassert_authmethod ) {
1498 case LDAP_AUTH_NONE:
1499 BER_BVSTR( binddn, "" );
1500 BER_BVSTR( bindcred, "" );
1503 case LDAP_AUTH_SIMPLE:
1508 LDAP_BACK_CONN_ISBOUND_CLEAR( msc );
1509 rs->sr_err = LDAP_AUTH_METHOD_NOT_SUPPORTED;
1510 if ( sendok & LDAP_BACK_SENDERR ) {
1511 send_ldap_result( op, rs );
1521 meta_back_proxy_authz_bind( metaconn_t *mc, int candidate, Operation *op, SlapReply *rs, ldap_back_send_t sendok )
1523 metainfo_t *mi = (metainfo_t *)op->o_bd->be_private;
1524 metatarget_t *mt = mi->mi_targets[ candidate ];
1525 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
1526 struct berval binddn = BER_BVC( "" ),
1527 cred = BER_BVC( "" );
1528 int method = LDAP_AUTH_NONE,
1531 rc = meta_back_proxy_authz_cred( mc, candidate, op, rs, sendok, &binddn, &cred, &method );
1532 if ( rc == LDAP_SUCCESS && !LDAP_BACK_CONN_ISBOUND( msc ) ) {
1536 case LDAP_AUTH_NONE:
1537 case LDAP_AUTH_SIMPLE:
1539 rs->sr_err = ldap_sasl_bind( msc->msc_ld,
1540 binddn.bv_val, LDAP_SASL_SIMPLE,
1541 &cred, NULL, NULL, &msgid );
1542 if ( rs->sr_err != LDAP_X_CONNECTING ) {
1545 ldap_pvt_thread_yield();
1547 rc = meta_back_bind_op_result( op, rs, mc, candidate, msgid, sendok );
1548 if ( rc == LDAP_SUCCESS ) {
1549 /* set rebind stuff in case of successful proxyAuthz bind,
1550 * so that referral chasing is attempted using the right
1552 LDAP_BACK_CONN_ISBOUND_SET( msc );
1553 ber_bvreplace( &msc->msc_bound_ndn, &binddn );
1555 if ( META_BACK_TGT_SAVECRED( mt ) ) {
1556 if ( !BER_BVISNULL( &msc->msc_cred ) ) {
1557 memset( msc->msc_cred.bv_val, 0,
1558 msc->msc_cred.bv_len );
1560 ber_bvreplace( &msc->msc_cred, &cred );
1561 ldap_set_rebind_proc( msc->msc_ld, mt->mt_rebind_f, msc );
1572 return LDAP_BACK_CONN_ISBOUND( msc );
1578 * if any needs to be added, it is prepended to existing ones,
1579 * in a newly allocated array. The companion function
1580 * mi->mi_ldap_extra->controls_free() must be used to restore the original
1581 * status of op->o_ctrls.
1584 meta_back_controls_add(
1589 LDAPControl ***pctrls )
1591 metainfo_t *mi = (metainfo_t *)op->o_bd->be_private;
1592 metatarget_t *mt = mi->mi_targets[ candidate ];
1593 metasingleconn_t *msc = &mc->mc_conns[ candidate ];
1595 LDAPControl **ctrls = NULL;
1596 /* set to the maximum number of controls this backend can add */
1597 LDAPControl c[ 2 ] = {{ 0 }};
1598 int n = 0, i, j1 = 0, j2 = 0;
1602 rs->sr_err = LDAP_SUCCESS;
1604 /* don't add controls if protocol is not LDAPv3 */
1605 switch ( mt->mt_version ) {
1610 if ( op->o_protocol == 0 || op->o_protocol == LDAP_VERSION3 ) {
1619 /* put controls that go __before__ existing ones here */
1621 /* proxyAuthz for identity assertion */
1622 switch ( mi->mi_ldap_extra->proxy_authz_ctrl( op, rs, &msc->msc_bound_ndn,
1623 mt->mt_version, &mt->mt_idassert, &c[ j1 ] ) )
1625 case SLAP_CB_CONTINUE:
1636 /* put controls that go __after__ existing ones here */
1638 #ifdef SLAP_CONTROL_X_SESSION_TRACKING
1639 /* session tracking */
1640 if ( META_BACK_TGT_ST_REQUEST( mt ) ) {
1641 switch ( slap_ctrl_session_tracking_request_add( op, rs, &c[ j1 + j2 ] ) ) {
1642 case SLAP_CB_CONTINUE:
1653 #endif /* SLAP_CONTROL_X_SESSION_TRACKING */
1655 if ( rs->sr_err == SLAP_CB_CONTINUE ) {
1656 rs->sr_err = LDAP_SUCCESS;
1659 /* if nothing to do, just bail out */
1660 if ( j1 == 0 && j2 == 0 ) {
1664 assert( j1 + j2 <= (int) (sizeof( c )/sizeof( c[0] )) );
1666 if ( op->o_ctrls ) {
1667 for ( n = 0; op->o_ctrls[ n ]; n++ )
1668 /* just count ctrls */ ;
1671 ctrls = op->o_tmpalloc( (n + j1 + j2 + 1) * sizeof( LDAPControl * ) + ( j1 + j2 ) * sizeof( LDAPControl ),
1674 ctrls[ 0 ] = (LDAPControl *)&ctrls[ n + j1 + j2 + 1 ];
1675 *ctrls[ 0 ] = c[ 0 ];
1676 for ( i = 1; i < j1; i++ ) {
1677 ctrls[ i ] = &ctrls[ 0 ][ i ];
1678 *ctrls[ i ] = c[ i ];
1683 if ( op->o_ctrls ) {
1684 for ( i = 0; op->o_ctrls[ i ]; i++ ) {
1685 ctrls[ i + j1 ] = op->o_ctrls[ i ];
1691 ctrls[ n ] = (LDAPControl *)&ctrls[ n + j2 + 1 ] + j1;
1692 *ctrls[ n ] = c[ j1 ];
1693 for ( i = 1; i < j2; i++ ) {
1694 ctrls[ n + i ] = &ctrls[ n ][ i ];
1695 *ctrls[ n + i ] = c[ i ];
1699 ctrls[ n + j2 ] = NULL;
1702 if ( ctrls == NULL ) {
1703 ctrls = op->o_ctrls;