1 /* backend.c - routines for dealing with back-end databases */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 1998-2012 The OpenLDAP Foundation.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted only as authorized by the OpenLDAP
12 * A copy of this license is available in the file LICENSE in the
13 * top-level directory of the distribution or, alternatively, at
14 * <http://www.OpenLDAP.org/license.html>.
16 /* Portions Copyright (c) 1995 Regents of the University of Michigan.
17 * All rights reserved.
19 * Redistribution and use in source and binary forms are permitted
20 * provided that this notice is preserved and that due credit is given
21 * to the University of Michigan at Ann Arbor. The name of the University
22 * may not be used to endorse or promote products derived from this
23 * software without specific prior written permission. This software
24 * is provided ``as is'' without express or implied warranty.
32 #include <ac/string.h>
33 #include <ac/socket.h>
42 * If a module is configured as dynamic, its header should not
43 * get included into slapd. While this is a general rule and does
44 * not have much of an effect in UNIX, this rule should be adhered
45 * to for Windows, where dynamic object code should not be implicitly
46 * imported into slapd without appropriate __declspec(dllimport) directives.
50 slap_bi_head backendInfo = LDAP_STAILQ_HEAD_INITIALIZER(backendInfo);
53 slap_be_head backendDB = LDAP_STAILQ_HEAD_INITIALIZER(backendDB);
56 backend_init_controls( BackendInfo *bi )
58 if ( bi->bi_controls ) {
61 for ( i = 0; bi->bi_controls[ i ]; i++ ) {
64 if ( slap_find_control_id( bi->bi_controls[ i ], &cid )
65 == LDAP_CONTROL_NOT_FOUND )
67 if ( !( slapMode & SLAP_TOOL_MODE ) ) {
74 bi->bi_ctrls[ cid ] = 1;
81 int backend_init(void)
86 if((nBackendInfo != 0) || !LDAP_STAILQ_EMPTY(&backendInfo)) {
87 /* already initialized */
88 Debug( LDAP_DEBUG_ANY,
89 "backend_init: already initialized\n", 0, 0, 0 );
93 for( bi=slap_binfo; bi->bi_type != NULL; bi++,nBackendInfo++ ) {
94 assert( bi->bi_init != 0 );
96 rc = bi->bi_init( bi );
99 Debug( LDAP_DEBUG_ANY,
100 "backend_init: initialized for type \"%s\"\n",
102 /* destroy those we've already inited */
107 if ( slap_binfo[nBackendInfo].bi_destroy ) {
108 slap_binfo[nBackendInfo].bi_destroy(
109 &slap_binfo[nBackendInfo] );
115 LDAP_STAILQ_INSERT_TAIL(&backendInfo, bi, bi_next);
118 if ( nBackendInfo > 0) {
126 Debug( LDAP_DEBUG_ANY,
127 "backend_init: failed\n",
131 #endif /* SLAPD_MODULES */
134 int backend_add(BackendInfo *aBackendInfo)
138 if ( aBackendInfo->bi_init == NULL ) {
139 Debug( LDAP_DEBUG_ANY, "backend_add: "
140 "backend type \"%s\" does not have the (mandatory)init function\n",
141 aBackendInfo->bi_type, 0, 0 );
145 rc = aBackendInfo->bi_init(aBackendInfo);
147 Debug( LDAP_DEBUG_ANY,
148 "backend_add: initialization for type \"%s\" failed\n",
149 aBackendInfo->bi_type, 0, 0 );
153 (void)backend_init_controls( aBackendInfo );
155 /* now add the backend type to the Backend Info List */
156 LDAP_STAILQ_INSERT_TAIL( &backendInfo, aBackendInfo, bi_next );
162 backend_set_controls( BackendDB *be )
164 BackendInfo *bi = be->bd_info;
166 /* back-relay takes care of itself; so may do other */
167 if ( overlay_is_over( be ) ) {
168 bi = ((slap_overinfo *)be->bd_info->bi_private)->oi_orig;
171 if ( bi->bi_controls ) {
172 if ( be->be_ctrls[ SLAP_MAX_CIDS ] == 0 ) {
173 AC_MEMCPY( be->be_ctrls, bi->bi_ctrls,
174 sizeof( be->be_ctrls ) );
175 be->be_ctrls[ SLAP_MAX_CIDS ] = 1;
180 for ( i = 0; i < SLAP_MAX_CIDS; i++ ) {
181 if ( bi->bi_ctrls[ i ] ) {
182 be->be_ctrls[ i ] = bi->bi_ctrls[ i ];
192 /* startup a specific backend database */
193 int backend_startup_one(Backend *be, ConfigReply *cr)
197 assert( be != NULL );
199 be->be_pending_csn_list = (struct be_pcl *)
200 ch_calloc( 1, sizeof( struct be_pcl ) );
202 LDAP_TAILQ_INIT( be->be_pending_csn_list );
204 Debug( LDAP_DEBUG_TRACE,
205 "backend_startup_one: starting \"%s\"\n",
206 be->be_suffix ? be->be_suffix[0].bv_val : "(unknown)",
209 /* set database controls */
210 (void)backend_set_controls( be );
213 if ( !BER_BVISEMPTY( &be->be_rootndn )
214 && select_backend( &be->be_rootndn, 0 ) == be
215 && BER_BVISNULL( &be->be_rootpw ) )
217 /* warning: if rootdn entry is created,
218 * it can take rootdn privileges;
219 * set empty rootpw to prevent */
223 if ( be->bd_info->bi_db_open ) {
224 rc = be->bd_info->bi_db_open( be, cr );
226 (void)backend_set_controls( be );
229 char *type = be->bd_info->bi_type;
230 char *suffix = "(null)";
232 if ( overlay_is_over( be ) ) {
233 slap_overinfo *oi = (slap_overinfo *)be->bd_info->bi_private;
234 type = oi->oi_orig->bi_type;
237 if ( be->be_suffix != NULL && !BER_BVISNULL( &be->be_suffix[0] ) ) {
238 suffix = be->be_suffix[0].bv_val;
241 Debug( LDAP_DEBUG_ANY,
242 "backend_startup_one (type=%s, suffix=\"%s\"): "
243 "bi_db_open failed! (%d)\n",
251 int backend_startup(Backend *be)
256 ConfigReply cr={0, ""};
258 if( ! ( nBackendDB > 0 ) ) {
260 Debug( LDAP_DEBUG_ANY,
261 "backend_startup: %d databases to startup.\n",
267 if ( be->bd_info->bi_open ) {
268 rc = be->bd_info->bi_open( be->bd_info );
270 Debug( LDAP_DEBUG_ANY,
271 "backend_startup: bi_open failed!\n",
278 return backend_startup_one( be, &cr );
281 /* open frontend, if required */
282 if ( frontendDB->bd_info->bi_db_open ) {
283 rc = frontendDB->bd_info->bi_db_open( frontendDB, &cr );
285 Debug( LDAP_DEBUG_ANY,
286 "backend_startup: bi_db_open(frontend) failed! (%d)\n",
292 /* open each backend type */
294 LDAP_STAILQ_FOREACH(bi, &backendInfo, bi_next) {
296 if( bi->bi_nDB == 0) {
297 /* no database of this type, don't open */
302 rc = bi->bi_open( bi );
304 Debug( LDAP_DEBUG_ANY,
305 "backend_startup: bi_open %d (%s) failed!\n",
311 (void)backend_init_controls( bi );
314 /* open each backend database */
316 LDAP_STAILQ_FOREACH(be, &backendDB, be_next) {
318 if ( be->be_suffix == NULL ) {
319 Debug( LDAP_DEBUG_ANY,
320 "backend_startup: warning, database %d (%s) "
322 i, be->bd_info->bi_type, 0 );
325 rc = backend_startup_one( be, &cr );
333 int backend_num( Backend *be )
338 if( be == NULL ) return -1;
340 LDAP_STAILQ_FOREACH( b2, &backendDB, be_next ) {
341 if( be == b2 ) return i;
347 int backend_shutdown( Backend *be )
353 /* shutdown a specific backend database */
355 if ( be->bd_info->bi_nDB == 0 ) {
356 /* no database of this type, we never opened it */
360 if ( be->bd_info->bi_db_close ) {
361 rc = be->bd_info->bi_db_close( be, NULL );
365 if( be->bd_info->bi_close ) {
366 rc = be->bd_info->bi_close( be->bd_info );
373 /* close each backend database */
374 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
375 if ( be->bd_info->bi_db_close ) {
376 be->bd_info->bi_db_close( be, NULL );
380 Debug( LDAP_DEBUG_ANY,
381 "backend_close: bi_db_close %s failed!\n",
386 /* close each backend type */
387 LDAP_STAILQ_FOREACH( bi, &backendInfo, bi_next ) {
388 if( bi->bi_nDB == 0 ) {
389 /* no database of this type */
398 /* close frontend, if required */
399 if ( frontendDB->bd_info->bi_db_close ) {
400 rc = frontendDB->bd_info->bi_db_close ( frontendDB, NULL );
402 Debug( LDAP_DEBUG_ANY,
403 "backend_startup: bi_db_close(frontend) failed! (%d)\n",
412 * This function is supposed to be the exact counterpart
413 * of backend_startup_one(), although this one calls bi_db_destroy()
414 * while backend_startup_one() calls bi_db_open().
416 * Make sure backend_stopdown_one() destroys resources allocated
417 * by backend_startup_one(); only call backend_destroy_one() when
418 * all stuff in a BackendDB needs to be destroyed
421 backend_stopdown_one( BackendDB *bd )
423 if ( bd->be_pending_csn_list ) {
424 struct slap_csn_entry *csne;
425 csne = LDAP_TAILQ_FIRST( bd->be_pending_csn_list );
427 struct slap_csn_entry *tmp_csne = csne;
429 LDAP_TAILQ_REMOVE( bd->be_pending_csn_list, csne, ce_csn_link );
430 ch_free( csne->ce_csn.bv_val );
431 csne = LDAP_TAILQ_NEXT( csne, ce_csn_link );
434 ch_free( bd->be_pending_csn_list );
437 if ( bd->bd_info->bi_db_destroy ) {
438 bd->bd_info->bi_db_destroy( bd, NULL );
442 void backend_destroy_one( BackendDB *bd, int dynamic )
445 LDAP_STAILQ_REMOVE(&backendDB, bd, BackendDB, be_next );
448 if ( bd->be_syncinfo ) {
449 syncinfo_free( bd->be_syncinfo, 1 );
452 backend_stopdown_one( bd );
454 ber_bvarray_free( bd->be_suffix );
455 ber_bvarray_free( bd->be_nsuffix );
456 if ( !BER_BVISNULL( &bd->be_rootdn ) ) {
457 free( bd->be_rootdn.bv_val );
459 if ( !BER_BVISNULL( &bd->be_rootndn ) ) {
460 free( bd->be_rootndn.bv_val );
462 if ( !BER_BVISNULL( &bd->be_rootpw ) ) {
463 free( bd->be_rootpw.bv_val );
465 acl_destroy( bd->be_acl );
466 limits_destroy( bd->be_limits );
467 if ( bd->be_extra_anlist ) {
468 anlist_free( bd->be_extra_anlist, 1, NULL );
470 if ( !BER_BVISNULL( &bd->be_update_ndn ) ) {
471 ch_free( bd->be_update_ndn.bv_val );
473 if ( bd->be_update_refs ) {
474 ber_bvarray_free( bd->be_update_refs );
477 ldap_pvt_thread_mutex_destroy( &bd->be_pcl_mutex );
484 int backend_destroy(void)
489 /* destroy each backend database */
490 while (( bd = LDAP_STAILQ_FIRST(&backendDB))) {
491 backend_destroy_one( bd, 1 );
494 /* destroy each backend type */
495 LDAP_STAILQ_FOREACH( bi, &backendInfo, bi_next ) {
496 if( bi->bi_destroy ) {
497 bi->bi_destroy( bi );
502 LDAP_STAILQ_INIT(&backendInfo);
504 /* destroy frontend database */
507 if ( bd->bd_info->bi_db_destroy ) {
508 bd->bd_info->bi_db_destroy( bd, NULL );
510 ber_bvarray_free( bd->be_suffix );
511 ber_bvarray_free( bd->be_nsuffix );
512 if ( !BER_BVISNULL( &bd->be_rootdn ) ) {
513 free( bd->be_rootdn.bv_val );
515 if ( !BER_BVISNULL( &bd->be_rootndn ) ) {
516 free( bd->be_rootndn.bv_val );
518 if ( !BER_BVISNULL( &bd->be_rootpw ) ) {
519 free( bd->be_rootpw.bv_val );
521 acl_destroy( bd->be_acl );
528 BackendInfo* backend_info(const char *type)
532 /* search for the backend type */
533 LDAP_STAILQ_FOREACH(bi,&backendInfo,bi_next) {
534 if( strcasecmp(bi->bi_type, type) == 0 ) {
548 /* If idx < 0, just add to end of list */
550 LDAP_STAILQ_INSERT_TAIL(&backendDB, be, be_next);
551 } else if ( idx == 0 ) {
552 LDAP_STAILQ_INSERT_HEAD(&backendDB, be, be_next);
557 b2 = LDAP_STAILQ_FIRST(&backendDB);
559 for (i=0; i<idx; i++) {
560 b2 = LDAP_STAILQ_NEXT(b2, be_next);
562 LDAP_STAILQ_INSERT_AFTER(&backendDB, b2, be, be_next);
572 LDAP_STAILQ_REMOVE(&backendDB, be, BackendDB, be_next);
573 backend_db_insert(be, idx);
583 BackendInfo *bi = backend_info(type);
588 fprintf( stderr, "Unrecognized database type (%s)\n", type );
592 /* If be is provided, treat it as private. Otherwise allocate
593 * one and add it to the global list.
596 be = ch_calloc( 1, sizeof(Backend) );
598 if ( idx >= nbackends )
601 backend_db_insert( be, idx );
607 be->be_def_limit = frontendDB->be_def_limit;
608 be->be_dfltaccess = frontendDB->be_dfltaccess;
610 be->be_restrictops = frontendDB->be_restrictops;
611 be->be_requires = frontendDB->be_requires;
612 be->be_ssf_set = frontendDB->be_ssf_set;
614 ldap_pvt_thread_mutex_init( &be->be_pcl_mutex );
616 /* assign a default depth limit for alias deref */
617 be->be_max_deref_depth = SLAPD_DEFAULT_MAXDEREFDEPTH;
619 if ( bi->bi_db_init ) {
620 rc = bi->bi_db_init( be, cr );
624 fprintf( stderr, "database init failed (%s)\n", type );
625 /* If we created and linked this be, remove it and free it */
627 LDAP_STAILQ_REMOVE(&backendDB, be, BackendDB, be_next);
628 ldap_pvt_thread_mutex_destroy( &be->be_pcl_mutex );
635 backend_init_controls( bi );
647 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
648 if ( be->bd_info->bi_db_close ) {
649 be->bd_info->bi_db_close( be, NULL );
653 if ( frontendDB->bd_info->bi_db_close ) {
654 frontendDB->bd_info->bi_db_close( frontendDB, NULL );
665 ber_len_t len, dnlen = dn->bv_len;
668 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
669 if ( be->be_nsuffix == NULL || SLAP_DBHIDDEN( be )) {
673 for ( j = 0; !BER_BVISNULL( &be->be_nsuffix[j] ); j++ )
675 if ( ( SLAP_GLUE_SUBORDINATE( be ) ) && noSubs )
680 len = be->be_nsuffix[j].bv_len;
683 /* suffix is longer than DN */
688 * input DN is normalized, so the separator check
689 * need not look at escaping
691 if ( len && len < dnlen &&
692 !DN_SEPARATOR( dn->bv_val[(dnlen-len)-1] ))
697 if ( strcmp( be->be_nsuffix[j].bv_val,
698 &dn->bv_val[dnlen-len] ) == 0 )
711 struct berval *bvsuffix )
715 if ( be->be_nsuffix == NULL ) {
719 for ( i = 0; !BER_BVISNULL( &be->be_nsuffix[i] ); i++ ) {
720 if ( bvmatch( &be->be_nsuffix[i], bvsuffix ) ) {
731 struct berval *bvsubordinate )
735 if ( be->be_nsuffix == NULL ) {
739 for ( i = 0; !BER_BVISNULL( &be->be_nsuffix[i] ); i++ ) {
740 if ( dnIsSuffix( bvsubordinate, &be->be_nsuffix[i] ) ) {
749 be_isroot_dn( Backend *be, struct berval *ndn )
751 if ( BER_BVISEMPTY( ndn ) || BER_BVISEMPTY( &be->be_rootndn ) ) {
755 return dn_match( &be->be_rootndn, ndn );
759 be_slurp_update( Operation *op )
761 return ( SLAP_SLURP_SHADOW( op->o_bd ) &&
762 be_isupdate_dn( op->o_bd, &op->o_ndn ) );
766 be_shadow_update( Operation *op )
768 /* This assumes that all internal ops (connid <= -1000) on a syncrepl
769 * database are syncrepl operations.
771 return ( ( SLAP_SYNC_SHADOW( op->o_bd ) && SLAPD_SYNC_IS_SYNCCONN( op->o_connid ) ) ||
772 ( SLAP_SHADOW( op->o_bd ) && be_isupdate_dn( op->o_bd, &op->o_ndn ) ) );
776 be_isupdate_dn( Backend *be, struct berval *ndn )
778 if ( BER_BVISEMPTY( ndn ) || BER_BVISEMPTY( &be->be_update_ndn ) ) {
782 return dn_match( &be->be_update_ndn, ndn );
786 be_root_dn( Backend *be )
788 return &be->be_rootdn;
792 be_isroot( Operation *op )
794 return be_isroot_dn( op->o_bd, &op->o_ndn );
798 be_isroot_pw( Operation *op )
800 return be_rootdn_bind( op, NULL ) == LDAP_SUCCESS;
804 * checks if binding as rootdn
807 * SLAP_CB_CONTINUE if not the rootdn, or if rootpw is null
808 * LDAP_SUCCESS if rootdn & rootpw
809 * LDAP_INVALID_CREDENTIALS if rootdn & !rootpw
812 * if LDAP_SUCCESS, op->orb_edn is set
813 * if LDAP_INVALID_CREDENTIALS, response is sent to client
816 be_rootdn_bind( Operation *op, SlapReply *rs )
820 void *old_authctx = NULL;
823 assert( op->o_tag == LDAP_REQ_BIND );
824 assert( op->orb_method == LDAP_AUTH_SIMPLE );
826 if ( !be_isroot_dn( op->o_bd, &op->o_req_ndn ) ) {
827 return SLAP_CB_CONTINUE;
830 if ( BER_BVISNULL( &op->o_bd->be_rootpw ) ) {
831 /* give the database a chance */
832 return SLAP_CB_CONTINUE;
835 if ( BER_BVISEMPTY( &op->o_bd->be_rootpw ) ) {
836 /* rootdn bind explicitly disallowed */
837 rc = LDAP_INVALID_CREDENTIALS;
846 ldap_pvt_thread_pool_setkey( op->o_threadctx, (void *)slap_sasl_bind,
847 op->o_conn->c_sasl_authctx, 0, &old_authctx, NULL );
850 rc = lutil_passwd( &op->o_bd->be_rootpw, &op->orb_cred, NULL, NULL );
853 ldap_pvt_thread_pool_setkey( op->o_threadctx, (void *)slap_sasl_bind,
854 old_authctx, 0, NULL, NULL );
857 rc = ( rc == 0 ? LDAP_SUCCESS : LDAP_INVALID_CREDENTIALS );
862 Debug( LDAP_DEBUG_TRACE, "%s: rootdn=\"%s\" bind%s\n",
863 op->o_log_prefix, op->o_bd->be_rootdn.bv_val,
864 rc == LDAP_SUCCESS ? " succeeded" : " failed" );
866 if ( rc == LDAP_SUCCESS ) {
867 /* Set to the pretty rootdn */
868 ber_dupbv( &op->orb_edn, &op->o_bd->be_rootdn );
871 send_ldap_result( op, rs );
884 if ( op->o_bd->be_release ) {
885 /* free and release entry from backend */
886 return op->o_bd->be_release( op, e, rw );
895 backend_unbind( Operation *op, SlapReply *rs )
899 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
900 if ( be->be_unbind ) {
902 be->be_unbind( op, rs );
910 backend_connection_init(
915 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
916 if ( be->be_connection_init ) {
917 be->be_connection_init( be, conn );
925 backend_connection_destroy(
930 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
931 if ( be->be_connection_destroy ) {
932 be->be_connection_destroy( be, conn);
940 backend_check_controls(
944 LDAPControl **ctrls = op->o_ctrls;
945 rs->sr_err = LDAP_SUCCESS;
948 for( ; *ctrls != NULL ; ctrls++ ) {
951 switch ( slap_global_control( op, (*ctrls)->ldctl_oid, &cid ) ) {
952 case LDAP_CONTROL_NOT_FOUND:
953 /* unrecognized control */
954 if ( (*ctrls)->ldctl_iscritical ) {
955 /* should not be reachable */
956 Debug( LDAP_DEBUG_ANY, "backend_check_controls: "
957 "unrecognized critical control: %s\n",
958 (*ctrls)->ldctl_oid, 0, 0 );
961 Debug( LDAP_DEBUG_TRACE, "backend_check_controls: "
962 "unrecognized non-critical control: %s\n",
963 (*ctrls)->ldctl_oid, 0, 0 );
967 case LDAP_COMPARE_FALSE:
968 if ( !op->o_bd->be_ctrls[cid] && (*ctrls)->ldctl_iscritical ) {
969 #ifdef SLAP_CONTROL_X_WHATFAILED
970 if ( get_whatFailed( op ) ) {
972 oids[ 0 ] = (*ctrls)->ldctl_oid;
974 slap_ctrl_whatFailed_add( op, rs, oids );
977 /* RFC 4511 allows unavailableCriticalExtension to be
978 * returned when the server is unwilling to perform
979 * an operation extended by a recognized critical
982 rs->sr_text = "critical control unavailable in context";
983 rs->sr_err = LDAP_UNAVAILABLE_CRITICAL_EXTENSION;
988 case LDAP_COMPARE_TRUE:
993 Debug( LDAP_DEBUG_ANY,
994 "backend_check_controls: unable to check control: %s\n",
995 (*ctrls)->ldctl_oid, 0, 0 );
998 rs->sr_text = "unable to check control";
999 rs->sr_err = LDAP_OTHER;
1005 #if 0 /* temporarily removed */
1006 /* check should be generalized */
1007 if( get_relax(op) && !be_isroot(op)) {
1008 rs->sr_text = "requires manager authorization";
1009 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1018 backend_check_restrictions(
1021 struct berval *opdata )
1023 slap_mask_t restrictops;
1024 slap_mask_t requires;
1026 slap_mask_t exopflag = 0;
1027 slap_ssf_set_t ssfs, *ssf;
1032 restrictops = frontendDB->be_restrictops;
1033 requires = frontendDB->be_requires;
1034 ssfs = frontendDB->be_ssf_set;
1038 slap_ssf_t *fssf, *bssf;
1039 int rc = SLAP_CB_CONTINUE, i;
1041 if ( op->o_bd->be_chk_controls ) {
1042 rc = ( *op->o_bd->be_chk_controls )( op, rs );
1045 if ( rc == SLAP_CB_CONTINUE ) {
1046 rc = backend_check_controls( op, rs );
1049 if ( rc != LDAP_SUCCESS ) {
1053 restrictops |= op->o_bd->be_restrictops;
1054 requires |= op->o_bd->be_requires;
1055 bssf = &op->o_bd->be_ssf_set.sss_ssf;
1056 fssf = &ssfs.sss_ssf;
1057 for ( i=0; i < (int)(sizeof(ssfs)/sizeof(slap_ssf_t)); i++ ) {
1058 if ( bssf[i] ) fssf[i] = bssf[i];
1062 switch( op->o_tag ) {
1064 opflag = SLAP_RESTRICT_OP_ADD;
1068 opflag = SLAP_RESTRICT_OP_BIND;
1071 case LDAP_REQ_COMPARE:
1072 opflag = SLAP_RESTRICT_OP_COMPARE;
1074 case LDAP_REQ_DELETE:
1076 opflag = SLAP_RESTRICT_OP_DELETE;
1078 case LDAP_REQ_EXTENDED:
1079 opflag = SLAP_RESTRICT_OP_EXTENDED;
1082 /* treat unspecified as a modify */
1083 opflag = SLAP_RESTRICT_OP_MODIFY;
1088 if( bvmatch( opdata, &slap_EXOP_START_TLS ) ) {
1091 exopflag = SLAP_RESTRICT_EXOP_START_TLS;
1095 if( bvmatch( opdata, &slap_EXOP_WHOAMI ) ) {
1096 exopflag = SLAP_RESTRICT_EXOP_WHOAMI;
1100 if ( bvmatch( opdata, &slap_EXOP_CANCEL ) ) {
1101 exopflag = SLAP_RESTRICT_EXOP_CANCEL;
1105 if ( bvmatch( opdata, &slap_EXOP_MODIFY_PASSWD ) ) {
1106 exopflag = SLAP_RESTRICT_EXOP_MODIFY_PASSWD;
1111 /* treat everything else as a modify */
1112 opflag = SLAP_RESTRICT_OP_MODIFY;
1116 case LDAP_REQ_MODIFY:
1118 opflag = SLAP_RESTRICT_OP_MODIFY;
1120 case LDAP_REQ_RENAME:
1122 opflag = SLAP_RESTRICT_OP_RENAME;
1124 case LDAP_REQ_SEARCH:
1125 opflag = SLAP_RESTRICT_OP_SEARCH;
1127 case LDAP_REQ_UNBIND:
1132 rs->sr_text = "restrict operations internal error";
1133 rs->sr_err = LDAP_OTHER;
1138 /* these checks don't apply to StartTLS */
1140 rs->sr_err = LDAP_CONFIDENTIALITY_REQUIRED;
1141 if( op->o_transport_ssf < ssf->sss_transport ) {
1142 rs->sr_text = op->o_transport_ssf
1143 ? "stronger transport confidentiality required"
1144 : "transport confidentiality required";
1148 if( op->o_tls_ssf < ssf->sss_tls ) {
1149 rs->sr_text = op->o_tls_ssf
1150 ? "stronger TLS confidentiality required"
1151 : "TLS confidentiality required";
1156 if( op->o_tag == LDAP_REQ_BIND && opdata == NULL ) {
1157 /* simple bind specific check */
1158 if( op->o_ssf < ssf->sss_simple_bind ) {
1159 rs->sr_text = op->o_ssf
1160 ? "stronger confidentiality required"
1161 : "confidentiality required";
1166 if( op->o_tag != LDAP_REQ_BIND || opdata == NULL ) {
1167 /* these checks don't apply to SASL bind */
1169 if( op->o_sasl_ssf < ssf->sss_sasl ) {
1170 rs->sr_text = op->o_sasl_ssf
1171 ? "stronger SASL confidentiality required"
1172 : "SASL confidentiality required";
1176 if( op->o_ssf < ssf->sss_ssf ) {
1177 rs->sr_text = op->o_ssf
1178 ? "stronger confidentiality required"
1179 : "confidentiality required";
1185 if( op->o_transport_ssf < ssf->sss_update_transport ) {
1186 rs->sr_text = op->o_transport_ssf
1187 ? "stronger transport confidentiality required for update"
1188 : "transport confidentiality required for update";
1192 if( op->o_tls_ssf < ssf->sss_update_tls ) {
1193 rs->sr_text = op->o_tls_ssf
1194 ? "stronger TLS confidentiality required for update"
1195 : "TLS confidentiality required for update";
1199 if( op->o_sasl_ssf < ssf->sss_update_sasl ) {
1200 rs->sr_text = op->o_sasl_ssf
1201 ? "stronger SASL confidentiality required for update"
1202 : "SASL confidentiality required for update";
1206 if( op->o_ssf < ssf->sss_update_ssf ) {
1207 rs->sr_text = op->o_ssf
1208 ? "stronger confidentiality required for update"
1209 : "confidentiality required for update";
1213 if( !( global_allows & SLAP_ALLOW_UPDATE_ANON ) &&
1214 BER_BVISEMPTY( &op->o_ndn ) )
1216 rs->sr_text = "modifications require authentication";
1217 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1221 #ifdef SLAP_X_LISTENER_MOD
1222 if ( op->o_conn->c_listener &&
1223 ! ( op->o_conn->c_listener->sl_perms & ( !BER_BVISEMPTY( &op->o_ndn )
1224 ? (S_IWUSR|S_IWOTH) : S_IWOTH ) ) )
1226 /* no "w" mode means readonly */
1227 rs->sr_text = "modifications not allowed on this listener";
1228 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1231 #endif /* SLAP_X_LISTENER_MOD */
1236 /* these checks don't apply to Bind, StartTLS, or Unbind */
1238 if( requires & SLAP_REQUIRE_STRONG ) {
1239 /* should check mechanism */
1240 if( ( op->o_transport_ssf < ssf->sss_transport
1241 && op->o_authtype == LDAP_AUTH_SIMPLE )
1242 || BER_BVISEMPTY( &op->o_dn ) )
1244 rs->sr_text = "strong(er) authentication required";
1245 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1250 if( requires & SLAP_REQUIRE_SASL ) {
1251 if( op->o_authtype != LDAP_AUTH_SASL || BER_BVISEMPTY( &op->o_dn ) ) {
1252 rs->sr_text = "SASL authentication required";
1253 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1258 if( requires & SLAP_REQUIRE_AUTHC ) {
1259 if( BER_BVISEMPTY( &op->o_dn ) ) {
1260 rs->sr_text = "authentication required";
1261 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1266 if( requires & SLAP_REQUIRE_BIND ) {
1268 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
1269 version = op->o_conn->c_protocol;
1270 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
1273 /* no bind has occurred */
1274 rs->sr_text = "BIND required";
1275 rs->sr_err = LDAP_OPERATIONS_ERROR;
1280 if( requires & SLAP_REQUIRE_LDAP_V3 ) {
1281 if( op->o_protocol < LDAP_VERSION3 ) {
1282 /* no bind has occurred */
1283 rs->sr_text = "operation restricted to LDAPv3 clients";
1284 rs->sr_err = LDAP_OPERATIONS_ERROR;
1289 #ifdef SLAP_X_LISTENER_MOD
1290 if ( !starttls && BER_BVISEMPTY( &op->o_dn ) ) {
1291 if ( op->o_conn->c_listener &&
1292 !( op->o_conn->c_listener->sl_perms & S_IXOTH ))
1294 /* no "x" mode means bind required */
1295 rs->sr_text = "bind required on this listener";
1296 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1301 if ( !starttls && !updateop ) {
1302 if ( op->o_conn->c_listener &&
1303 !( op->o_conn->c_listener->sl_perms &
1304 ( !BER_BVISEMPTY( &op->o_dn )
1305 ? (S_IRUSR|S_IROTH) : S_IROTH )))
1307 /* no "r" mode means no read */
1308 rs->sr_text = "read not allowed on this listener";
1309 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1313 #endif /* SLAP_X_LISTENER_MOD */
1317 if( ( restrictops & opflag )
1318 || ( exopflag && ( restrictops & exopflag ) )
1319 || (( restrictops & SLAP_RESTRICT_READONLY ) && updateop )) {
1320 if( ( restrictops & SLAP_RESTRICT_OP_MASK) == SLAP_RESTRICT_OP_READS ) {
1321 rs->sr_text = "read operations restricted";
1322 } else if ( restrictops & exopflag ) {
1323 rs->sr_text = "extended operation restricted";
1325 rs->sr_text = "operation restricted";
1327 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1331 rs->sr_err = LDAP_SUCCESS;
1335 int backend_check_referrals( Operation *op, SlapReply *rs )
1337 rs->sr_err = LDAP_SUCCESS;
1339 if( op->o_bd->be_chk_referrals ) {
1340 rs->sr_err = op->o_bd->be_chk_referrals( op, rs );
1342 if( rs->sr_err != LDAP_SUCCESS && rs->sr_err != LDAP_REFERRAL ) {
1343 send_ldap_result( op, rs );
1355 AttributeDescription *at,
1361 if ( op->o_bd == NULL ) {
1362 return LDAP_NO_SUCH_OBJECT;
1365 if ( op->o_bd->be_fetch ) {
1366 return op->o_bd->be_fetch( op, ndn, oc, at, rw, e );
1369 return LDAP_UNWILLING_TO_PERFORM;
1376 struct berval *gr_ndn,
1377 struct berval *op_ndn,
1378 ObjectClass *group_oc,
1379 AttributeDescription *group_at )
1382 void *o_priv = op->o_private, *e_priv = NULL;
1386 Backend *be = op->o_bd;
1389 LDAP_SLIST_FOREACH(oex, &op->o_extra, oe_next) {
1390 if ( oex->oe_key == (void *)backend_group )
1394 if ( oex && ((OpExtraDB *)oex)->oe_db )
1395 op->o_bd = ((OpExtraDB *)oex)->oe_db;
1397 if ( !op->o_bd || !SLAP_DBHIDDEN( op->o_bd ))
1398 op->o_bd = select_backend( gr_ndn, 0 );
1400 for ( g = op->o_groups; g; g = g->ga_next ) {
1401 if ( g->ga_be != op->o_bd || g->ga_oc != group_oc ||
1402 g->ga_at != group_at || g->ga_len != gr_ndn->bv_len )
1406 if ( strcmp( g->ga_ndn, gr_ndn->bv_val ) == 0 ) {
1416 if ( target && dn_match( &target->e_nname, gr_ndn ) ) {
1421 op->o_private = NULL;
1422 rc = be_entry_get_rw( op, gr_ndn, group_oc, group_at, 0, &e );
1423 e_priv = op->o_private;
1424 op->o_private = o_priv;
1428 a = attr_find( e->e_attrs, group_at );
1430 /* If the attribute is a subtype of labeledURI,
1431 * treat this as a dynamic group ala groupOfURLs
1433 if ( is_at_subtype( group_at->ad_type,
1434 slap_schema.si_ad_labeledURI->ad_type ) )
1438 struct berval bv, nbase;
1441 void *user_priv = NULL;
1442 Backend *b2 = op->o_bd;
1444 if ( target && dn_match( &target->e_nname, op_ndn ) ) {
1448 rc = LDAP_COMPARE_FALSE;
1449 for ( i = 0; !BER_BVISNULL( &a->a_vals[i] ); i++ ) {
1450 if ( ldap_url_parse( a->a_vals[i].bv_val, &ludp ) !=
1456 BER_BVZERO( &nbase );
1458 /* host, attrs and extensions parts must be empty */
1459 if ( ( ludp->lud_host && *ludp->lud_host )
1466 ber_str2bv( ludp->lud_dn, 0, 0, &bv );
1467 if ( dnNormalize( 0, NULL, NULL, &bv, &nbase,
1468 op->o_tmpmemctx ) != LDAP_SUCCESS )
1473 switch ( ludp->lud_scope ) {
1474 case LDAP_SCOPE_BASE:
1475 if ( !dn_match( &nbase, op_ndn ) ) {
1479 case LDAP_SCOPE_ONELEVEL:
1480 dnParent( op_ndn, &bv );
1481 if ( !dn_match( &nbase, &bv ) ) {
1485 case LDAP_SCOPE_SUBTREE:
1486 if ( !dnIsSuffix( op_ndn, &nbase ) ) {
1490 case LDAP_SCOPE_SUBORDINATE:
1491 if ( dn_match( &nbase, op_ndn ) ||
1492 !dnIsSuffix( op_ndn, &nbase ) )
1498 /* NOTE: this could be NULL
1499 * if no filter is provided,
1500 * or if filter parsing fails.
1501 * In the latter case,
1502 * we should give up. */
1503 if ( ludp->lud_filter != NULL && ludp->lud_filter != '\0') {
1504 filter = str2filter_x( op, ludp->lud_filter );
1505 if ( filter == NULL ) {
1511 /* only get user if required
1512 * and not available yet */
1513 if ( user == NULL ) {
1516 op->o_bd = select_backend( op_ndn, 0 );
1517 op->o_private = NULL;
1518 rc2 = be_entry_get_rw( op, op_ndn, NULL, NULL, 0, &user );
1519 user_priv = op->o_private;
1520 op->o_private = o_priv;
1528 if ( test_filter( NULL, user, filter ) ==
1533 filter_free_x( op, filter, 1 );
1536 ldap_free_urldesc( ludp );
1537 if ( !BER_BVISNULL( &nbase ) ) {
1538 op->o_tmpfree( nbase.bv_val, op->o_tmpmemctx );
1540 if ( rc != LDAP_COMPARE_FALSE ) {
1545 if ( user != NULL && user != target ) {
1546 op->o_private = user_priv;
1547 be_entry_release_r( op, user );
1548 op->o_private = o_priv;
1553 rc = attr_valfind( a,
1554 SLAP_MR_ATTRIBUTE_VALUE_NORMALIZED_MATCH |
1555 SLAP_MR_ASSERTED_VALUE_NORMALIZED_MATCH,
1556 op_ndn, NULL, op->o_tmpmemctx );
1557 if ( rc == LDAP_NO_SUCH_ATTRIBUTE ) {
1558 rc = LDAP_COMPARE_FALSE;
1563 rc = LDAP_NO_SUCH_ATTRIBUTE;
1566 if ( e != target ) {
1567 op->o_private = e_priv;
1568 be_entry_release_r( op, e );
1569 op->o_private = o_priv;
1573 rc = LDAP_NO_SUCH_OBJECT;
1576 if ( op->o_tag != LDAP_REQ_BIND && !op->o_do_not_cache ) {
1577 g = op->o_tmpalloc( sizeof( GroupAssertion ) + gr_ndn->bv_len,
1579 g->ga_be = op->o_bd;
1580 g->ga_oc = group_oc;
1581 g->ga_at = group_at;
1583 g->ga_len = gr_ndn->bv_len;
1584 strcpy( g->ga_ndn, gr_ndn->bv_val );
1585 g->ga_next = op->o_groups;
1598 struct berval *gr_ndn,
1599 struct berval *op_ndn,
1600 ObjectClass *group_oc,
1601 AttributeDescription *group_at )
1607 if ( op->o_abandon ) {
1608 return SLAPD_ABANDON;
1611 oex.oe_db = op->o_bd;
1612 oex.oe.oe_key = (void *)backend_group;
1613 LDAP_SLIST_INSERT_HEAD(&op->o_extra, &oex.oe, oe_next);
1616 op->o_bd = frontendDB;
1617 rc = frontendDB->be_group( op, target, gr_ndn,
1618 op_ndn, group_oc, group_at );
1620 LDAP_SLIST_REMOVE(&op->o_extra, &oex.oe, OpExtra, oe_next);
1630 AttributeDescription *entry_at,
1632 slap_access_t access )
1635 void *o_priv = op->o_private, *e_priv = NULL;
1636 Attribute *a = NULL;
1637 int freeattr = 0, i, j, rc = LDAP_SUCCESS;
1638 AccessControlState acl_state = ACL_STATE_INIT;
1639 Backend *be = op->o_bd;
1642 LDAP_SLIST_FOREACH(oex, &op->o_extra, oe_next) {
1643 if ( oex->oe_key == (void *)backend_attribute )
1647 if ( oex && ((OpExtraDB *)oex)->oe_db )
1648 op->o_bd = ((OpExtraDB *)oex)->oe_db;
1650 if ( !op->o_bd || !SLAP_DBHIDDEN( op->o_bd ))
1651 op->o_bd = select_backend( edn, 0 );
1653 if ( target && dn_match( &target->e_nname, edn ) ) {
1657 op->o_private = NULL;
1658 rc = be_entry_get_rw( op, edn, NULL, entry_at, 0, &e );
1659 e_priv = op->o_private;
1660 op->o_private = o_priv;
1664 if ( entry_at == slap_schema.si_ad_entry || entry_at == slap_schema.si_ad_children ) {
1665 assert( vals == NULL );
1668 if ( op->o_conn && access > ACL_NONE &&
1669 access_allowed( op, e, entry_at, NULL,
1670 access, &acl_state ) == 0 )
1672 rc = LDAP_INSUFFICIENT_ACCESS;
1677 a = attr_find( e->e_attrs, entry_at );
1679 SlapReply rs = { REP_SEARCH };
1680 AttributeName anlist[ 2 ];
1682 anlist[ 0 ].an_name = entry_at->ad_cname;
1683 anlist[ 0 ].an_desc = entry_at;
1684 BER_BVZERO( &anlist[ 1 ].an_name );
1685 rs.sr_attrs = anlist;
1687 /* NOTE: backend_operational() is also called
1688 * when returning results, so it's supposed
1689 * to do no harm to entries */
1691 rc = backend_operational( op, &rs );
1693 if ( rc == LDAP_SUCCESS ) {
1694 if ( rs.sr_operational_attrs ) {
1696 a = rs.sr_operational_attrs;
1699 rc = LDAP_NO_SUCH_ATTRIBUTE;
1707 if ( op->o_conn && access > ACL_NONE &&
1708 access_allowed( op, e, entry_at, NULL,
1709 access, &acl_state ) == 0 )
1711 rc = LDAP_INSUFFICIENT_ACCESS;
1716 v = op->o_tmpalloc( sizeof(struct berval) * ( i + 1 ),
1718 for ( i = 0, j = 0; !BER_BVISNULL( &a->a_vals[i] ); i++ )
1720 if ( op->o_conn && access > ACL_NONE &&
1721 access_allowed( op, e, entry_at,
1728 ber_dupbv_x( &v[j], &a->a_nvals[i],
1730 if ( !BER_BVISNULL( &v[j] ) ) {
1735 op->o_tmpfree( v, op->o_tmpmemctx );
1737 rc = LDAP_INSUFFICIENT_ACCESS;
1740 BER_BVZERO( &v[j] );
1745 freeit: if ( e != target ) {
1746 op->o_private = e_priv;
1747 be_entry_release_r( op, e );
1748 op->o_private = o_priv;
1764 AttributeDescription *entry_at,
1766 slap_access_t access )
1772 oex.oe_db = op->o_bd;
1773 oex.oe.oe_key = (void *)backend_attribute;
1774 LDAP_SLIST_INSERT_HEAD(&op->o_extra, &oex.oe, oe_next);
1777 op->o_bd = frontendDB;
1778 rc = frontendDB->be_attribute( op, target, edn,
1779 entry_at, vals, access );
1781 LDAP_SLIST_REMOVE(&op->o_extra, &oex.oe, OpExtra, oe_next);
1791 AttributeDescription *entry_at,
1792 struct berval *nval,
1793 slap_access_t access,
1797 void *o_priv, *e_priv = NULL;
1798 int rc = LDAP_INSUFFICIENT_ACCESS;
1802 assert( op != NULL );
1803 assert( op->o_conn != NULL );
1804 assert( edn != NULL );
1805 assert( access > ACL_NONE );
1808 o_priv = op->o_private;
1811 op->o_bd = select_backend( edn, 0 );
1814 if ( target && dn_match( &target->e_nname, edn ) ) {
1818 op->o_private = NULL;
1819 rc = be_entry_get_rw( op, edn, NULL, entry_at, 0, &e );
1820 e_priv = op->o_private;
1821 op->o_private = o_priv;
1825 Attribute *a = NULL;
1828 if ( entry_at == NULL ) {
1829 entry_at = slap_schema.si_ad_entry;
1832 if ( entry_at == slap_schema.si_ad_entry || entry_at == slap_schema.si_ad_children )
1834 if ( access_allowed_mask( op, e, entry_at,
1835 NULL, access, NULL, mask ) == 0 )
1837 rc = LDAP_INSUFFICIENT_ACCESS;
1844 a = attr_find( e->e_attrs, entry_at );
1846 SlapReply rs = { REP_SEARCH };
1847 AttributeName anlist[ 2 ];
1849 anlist[ 0 ].an_name = entry_at->ad_cname;
1850 anlist[ 0 ].an_desc = entry_at;
1851 BER_BVZERO( &anlist[ 1 ].an_name );
1852 rs.sr_attrs = anlist;
1854 rs.sr_attr_flags = slap_attr_flags( rs.sr_attrs );
1856 /* NOTE: backend_operational() is also called
1857 * when returning results, so it's supposed
1858 * to do no harm to entries */
1860 rc = backend_operational( op, &rs );
1862 if ( rc == LDAP_SUCCESS ) {
1863 if ( rs.sr_operational_attrs ) {
1865 a = rs.sr_operational_attrs;
1868 rc = LDAP_NO_SUCH_OBJECT;
1874 if ( access_allowed_mask( op, e, entry_at,
1875 nval, access, NULL, mask ) == 0 )
1877 rc = LDAP_INSUFFICIENT_ACCESS;
1883 freeit: if ( e != target ) {
1884 op->o_private = e_priv;
1885 be_entry_release_r( op, e );
1886 op->o_private = o_priv;
1903 int rc = LDAP_SUCCESS;
1904 BackendDB *be_orig = op->o_bd;
1907 LDAP_SLIST_FOREACH(oex, &op->o_extra, oe_next) {
1908 if ( oex->oe_key == (void *)backend_operational )
1912 for ( ap = &rs->sr_operational_attrs; *ap; ap = &(*ap)->a_next )
1913 /* just count them */ ;
1916 * If operational attributes (allegedly) are required,
1917 * and the backend supports specific operational attributes,
1918 * add them to the attribute list
1920 if ( !( rs->sr_flags & REP_NO_ENTRYDN )
1921 && ( SLAP_OPATTRS( rs->sr_attr_flags ) || ( rs->sr_attrs &&
1922 ad_inlist( slap_schema.si_ad_entryDN, rs->sr_attrs ) ) ) )
1924 *ap = slap_operational_entryDN( rs->sr_entry );
1925 ap = &(*ap)->a_next;
1928 if ( !( rs->sr_flags & REP_NO_SUBSCHEMA)
1929 && ( SLAP_OPATTRS( rs->sr_attr_flags ) || ( rs->sr_attrs &&
1930 ad_inlist( slap_schema.si_ad_subschemaSubentry, rs->sr_attrs ) ) ) )
1932 *ap = slap_operational_subschemaSubentry( op->o_bd );
1933 ap = &(*ap)->a_next;
1936 /* Let the overlays have a chance at this */
1937 if ( oex && ((OpExtraDB *)oex)->oe_db )
1938 op->o_bd = ((OpExtraDB *)oex)->oe_db;
1940 if ( !op->o_bd || !SLAP_DBHIDDEN( op->o_bd ))
1941 op->o_bd = select_backend( &op->o_req_ndn, 0 );
1943 if ( op->o_bd != NULL && !be_match( op->o_bd, frontendDB ) &&
1944 ( SLAP_OPATTRS( rs->sr_attr_flags ) || rs->sr_attrs ) &&
1945 op->o_bd->be_operational != NULL )
1947 rc = op->o_bd->be_operational( op, rs );
1954 int backend_operational( Operation *op, SlapReply *rs )
1960 oex.oe_db = op->o_bd;
1961 oex.oe.oe_key = (void *)backend_operational;
1962 LDAP_SLIST_INSERT_HEAD(&op->o_extra, &oex.oe, oe_next);
1964 /* Moved this into the frontend so global overlays are called */
1967 op->o_bd = frontendDB;
1968 rc = frontendDB->be_operational( op, rs );
1970 LDAP_SLIST_REMOVE(&op->o_extra, &oex.oe, OpExtra, oe_next);
1975 /* helper that calls the bi_tool_entry_first_x() variant with default args;
1976 * use to initialize a backend's bi_tool_entry_first() when appropriate
1979 backend_tool_entry_first( BackendDB *be )
1981 return be->bd_info->bi_tool_entry_first_x( be,
1982 NULL, LDAP_SCOPE_DEFAULT, NULL );