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-2007 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>
41 * If a module is configured as dynamic, its header should not
42 * get included into slapd. While this is a general rule and does
43 * not have much of an effect in UNIX, this rule should be adhered
44 * to for Windows, where dynamic object code should not be implicitly
45 * imported into slapd without appropriate __declspec(dllimport) directives.
49 slap_bi_head backendInfo = LDAP_STAILQ_HEAD_INITIALIZER(backendInfo);
52 slap_be_head backendDB = LDAP_STAILQ_HEAD_INITIALIZER(backendDB);
55 backend_init_controls( BackendInfo *bi )
57 if ( bi->bi_controls ) {
60 for ( i = 0; bi->bi_controls[ i ]; i++ ) {
63 if ( slap_find_control_id( bi->bi_controls[ i ], &cid )
64 == LDAP_CONTROL_NOT_FOUND )
66 if ( !( slapMode & SLAP_TOOL_MODE ) ) {
73 bi->bi_ctrls[ cid ] = 1;
80 int backend_init(void)
85 if((nBackendInfo != 0) || !LDAP_STAILQ_EMPTY(&backendInfo)) {
86 /* already initialized */
87 Debug( LDAP_DEBUG_ANY,
88 "backend_init: already initialized\n", 0, 0, 0 );
92 for( bi=slap_binfo; bi->bi_type != NULL; bi++,nBackendInfo++ ) {
93 assert( bi->bi_init != 0 );
95 rc = bi->bi_init( bi );
98 Debug( LDAP_DEBUG_ANY,
99 "backend_init: initialized for type \"%s\"\n",
101 /* destroy those we've already inited */
106 if ( slap_binfo[nBackendInfo].bi_destroy ) {
107 slap_binfo[nBackendInfo].bi_destroy(
108 &slap_binfo[nBackendInfo] );
114 LDAP_STAILQ_INSERT_TAIL(&backendInfo, bi, bi_next);
117 if ( nBackendInfo > 0) {
125 Debug( LDAP_DEBUG_ANY,
126 "backend_init: failed\n",
130 #endif /* SLAPD_MODULES */
133 int backend_add(BackendInfo *aBackendInfo)
137 if ( aBackendInfo->bi_init == NULL ) {
138 Debug( LDAP_DEBUG_ANY, "backend_add: "
139 "backend type \"%s\" does not have the (mandatory)init function\n",
140 aBackendInfo->bi_type, 0, 0 );
144 rc = aBackendInfo->bi_init(aBackendInfo);
146 Debug( LDAP_DEBUG_ANY,
147 "backend_add: initialization for type \"%s\" failed\n",
148 aBackendInfo->bi_type, 0, 0 );
152 (void)backend_init_controls( aBackendInfo );
154 /* now add the backend type to the Backend Info List */
155 LDAP_STAILQ_INSERT_TAIL( &backendInfo, aBackendInfo, bi_next );
161 backend_set_controls( BackendDB *be )
163 BackendInfo *bi = be->bd_info;
165 /* back-relay takes care of itself; so may do other */
166 if ( overlay_is_over( be ) ) {
167 bi = ((slap_overinfo *)be->bd_info->bi_private)->oi_orig;
170 if ( bi->bi_controls ) {
171 if ( be->be_ctrls[ SLAP_MAX_CIDS ] == 0 ) {
172 AC_MEMCPY( be->be_ctrls, bi->bi_ctrls,
173 sizeof( be->be_ctrls ) );
174 be->be_ctrls[ SLAP_MAX_CIDS ] = 1;
179 for ( i = 0; i < SLAP_MAX_CIDS; i++ ) {
180 if ( bi->bi_ctrls[ i ] ) {
181 be->be_ctrls[ i ] = bi->bi_ctrls[ i ];
191 /* startup a specific backend database */
192 int backend_startup_one(Backend *be)
196 assert( be != NULL );
198 be->be_pending_csn_list = (struct be_pcl *)
199 ch_calloc( 1, sizeof( struct be_pcl ) );
201 LDAP_TAILQ_INIT( be->be_pending_csn_list );
203 Debug( LDAP_DEBUG_TRACE,
204 "backend_startup_one: starting \"%s\"\n",
205 be->be_suffix ? be->be_suffix[0].bv_val : "(unknown)",
208 /* set database controls */
209 (void)backend_set_controls( be );
211 if ( be->bd_info->bi_db_open ) {
212 rc = be->bd_info->bi_db_open( be );
214 (void)backend_set_controls( be );
217 Debug( LDAP_DEBUG_ANY,
218 "backend_startup_one: bi_db_open failed! (%d)\n",
226 int backend_startup(Backend *be)
232 if( ! ( nBackendDB > 0 ) ) {
234 Debug( LDAP_DEBUG_ANY,
235 "backend_startup: %d databases to startup.\n",
241 if ( be->bd_info->bi_open ) {
242 rc = be->bd_info->bi_open( be->bd_info );
244 Debug( LDAP_DEBUG_ANY,
245 "backend_startup: bi_open failed!\n",
251 /* append global access controls */
252 acl_append( &be->be_acl, frontendDB->be_acl, -1 );
254 return backend_startup_one( be );
257 /* open frontend, if required */
258 if ( frontendDB->bd_info->bi_db_open ) {
259 rc = frontendDB->bd_info->bi_db_open( frontendDB );
261 Debug( LDAP_DEBUG_ANY,
262 "backend_startup: bi_db_open(frontend) failed! (%d)\n",
268 /* open each backend type */
270 LDAP_STAILQ_FOREACH(bi, &backendInfo, bi_next) {
272 if( bi->bi_nDB == 0) {
273 /* no database of this type, don't open */
278 rc = bi->bi_open( bi );
280 Debug( LDAP_DEBUG_ANY,
281 "backend_startup: bi_open %d (%s) failed!\n",
287 (void)backend_init_controls( bi );
290 /* open each backend database */
292 LDAP_STAILQ_FOREACH(be, &backendDB, be_next) {
294 if ( be->be_suffix == NULL ) {
295 Debug( LDAP_DEBUG_ANY,
296 "backend_startup: warning, database %d (%s) "
298 i, be->bd_info->bi_type, 0 );
300 /* append global access controls */
301 acl_append( &be->be_acl, frontendDB->be_acl, -1 );
303 rc = backend_startup_one( be );
311 int backend_num( Backend *be )
316 if( be == NULL ) return -1;
318 LDAP_STAILQ_FOREACH( b2, &backendDB, be_next ) {
319 if( be == b2 ) return i;
325 int backend_shutdown( Backend *be )
331 /* shutdown a specific backend database */
333 if ( be->bd_info->bi_nDB == 0 ) {
334 /* no database of this type, we never opened it */
338 if ( be->bd_info->bi_db_close ) {
339 be->bd_info->bi_db_close( be );
342 if( be->bd_info->bi_close ) {
343 be->bd_info->bi_close( be->bd_info );
349 /* close each backend database */
350 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
351 if ( be->bd_info->bi_db_close ) {
352 be->bd_info->bi_db_close( be );
356 Debug( LDAP_DEBUG_ANY,
357 "backend_close: bi_db_close %s failed!\n",
362 /* close each backend type */
363 LDAP_STAILQ_FOREACH( bi, &backendInfo, bi_next ) {
364 if( bi->bi_nDB == 0 ) {
365 /* no database of this type */
374 /* close frontend, if required */
375 if ( frontendDB->bd_info->bi_db_close ) {
376 rc = frontendDB->bd_info->bi_db_close ( frontendDB );
378 Debug( LDAP_DEBUG_ANY,
379 "backend_startup: bi_db_close(frontend) failed! (%d)\n",
388 * This function is supposed to be the exact counterpart
389 * of backend_startup_one(), although this one calls bi_db_destroy()
390 * while backend_startup_one() calls bi_db_open().
392 * Make sure backend_stopdown_one() destroys resources allocated
393 * by backend_startup_one(); only call backend_destroy_one() when
394 * all stuff in a BackendDB needs to be destroyed
397 backend_stopdown_one( BackendDB *bd )
399 if ( bd->be_pending_csn_list ) {
400 struct slap_csn_entry *csne;
401 csne = LDAP_TAILQ_FIRST( bd->be_pending_csn_list );
403 struct slap_csn_entry *tmp_csne = csne;
405 LDAP_TAILQ_REMOVE( bd->be_pending_csn_list, csne, ce_csn_link );
406 ch_free( csne->ce_csn.bv_val );
407 csne = LDAP_TAILQ_NEXT( csne, ce_csn_link );
410 ch_free( bd->be_pending_csn_list );
413 if ( bd->bd_info->bi_db_destroy ) {
414 bd->bd_info->bi_db_destroy( bd );
418 void backend_destroy_one( BackendDB *bd, int dynamic )
421 LDAP_STAILQ_REMOVE(&backendDB, bd, BackendDB, be_next );
424 if ( bd->be_syncinfo ) {
425 syncinfo_free( bd->be_syncinfo, 1 );
428 backend_stopdown_one( bd );
430 ber_bvarray_free( bd->be_suffix );
431 ber_bvarray_free( bd->be_nsuffix );
432 if ( !BER_BVISNULL( &bd->be_rootdn ) ) {
433 free( bd->be_rootdn.bv_val );
435 if ( !BER_BVISNULL( &bd->be_rootndn ) ) {
436 free( bd->be_rootndn.bv_val );
438 if ( !BER_BVISNULL( &bd->be_rootpw ) ) {
439 free( bd->be_rootpw.bv_val );
441 acl_destroy( bd->be_acl, frontendDB->be_acl );
442 limits_destroy( bd->be_limits );
443 if ( !BER_BVISNULL( &bd->be_update_ndn ) ) {
444 ch_free( bd->be_update_ndn.bv_val );
446 if ( bd->be_update_refs ) {
447 ber_bvarray_free( bd->be_update_refs );
455 int backend_destroy(void)
460 /* destroy each backend database */
461 while (( bd = LDAP_STAILQ_FIRST(&backendDB))) {
462 backend_destroy_one( bd, 1 );
465 /* destroy each backend type */
466 LDAP_STAILQ_FOREACH( bi, &backendInfo, bi_next ) {
467 if( bi->bi_destroy ) {
468 bi->bi_destroy( bi );
473 LDAP_STAILQ_INIT(&backendInfo);
475 /* destroy frontend database */
478 if ( bd->bd_info->bi_db_destroy ) {
479 bd->bd_info->bi_db_destroy( bd );
481 ber_bvarray_free( bd->be_suffix );
482 ber_bvarray_free( bd->be_nsuffix );
483 if ( !BER_BVISNULL( &bd->be_rootdn ) ) {
484 free( bd->be_rootdn.bv_val );
486 if ( !BER_BVISNULL( &bd->be_rootndn ) ) {
487 free( bd->be_rootndn.bv_val );
489 if ( !BER_BVISNULL( &bd->be_rootpw ) ) {
490 free( bd->be_rootpw.bv_val );
492 acl_destroy( bd->be_acl, frontendDB->be_acl );
498 BackendInfo* backend_info(const char *type)
502 /* search for the backend type */
503 LDAP_STAILQ_FOREACH(bi,&backendInfo,bi_next) {
504 if( strcasecmp(bi->bi_type, type) == 0 ) {
518 /* If idx < 0, just add to end of list */
520 LDAP_STAILQ_INSERT_TAIL(&backendDB, be, be_next);
521 } else if ( idx == 0 ) {
522 LDAP_STAILQ_INSERT_HEAD(&backendDB, be, be_next);
527 b2 = LDAP_STAILQ_FIRST(&backendDB);
529 for (i=0; i<idx; i++) {
530 b2 = LDAP_STAILQ_NEXT(b2, be_next);
532 LDAP_STAILQ_INSERT_AFTER(&backendDB, b2, be, be_next);
542 LDAP_STAILQ_REMOVE(&backendDB, be, BackendDB, be_next);
543 backend_db_insert(be, idx);
552 BackendInfo *bi = backend_info(type);
557 fprintf( stderr, "Unrecognized database type (%s)\n", type );
561 /* If be is provided, treat it as private. Otherwise allocate
562 * one and add it to the global list.
565 be = ch_calloc( 1, sizeof(Backend) );
567 if ( idx >= nbackends )
570 backend_db_insert( be, idx );
575 be->be_def_limit = frontendDB->be_def_limit;
576 be->be_dfltaccess = frontendDB->be_dfltaccess;
578 be->be_restrictops = frontendDB->be_restrictops;
579 be->be_requires = frontendDB->be_requires;
580 be->be_ssf_set = frontendDB->be_ssf_set;
582 be->be_pcl_mutexp = &be->be_pcl_mutex;
583 ldap_pvt_thread_mutex_init( be->be_pcl_mutexp );
585 /* assign a default depth limit for alias deref */
586 be->be_max_deref_depth = SLAPD_DEFAULT_MAXDEREFDEPTH;
588 if ( bi->bi_db_init ) {
589 rc = bi->bi_db_init( be );
593 fprintf( stderr, "database init failed (%s)\n", type );
594 /* If we created and linked this be, remove it and free it */
596 LDAP_STAILQ_REMOVE(&backendDB, be, BackendDB, be_next);
612 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
613 if ( be->bd_info->bi_db_close ) {
614 be->bd_info->bi_db_close( be );
618 if ( frontendDB->bd_info->bi_db_close ) {
619 frontendDB->bd_info->bi_db_close( frontendDB );
630 ber_len_t len, dnlen = dn->bv_len;
633 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
634 if ( be->be_nsuffix == NULL || SLAP_DBHIDDEN( be )) {
638 for ( j = 0; !BER_BVISNULL( &be->be_nsuffix[j] ); j++ )
640 if ( ( SLAP_GLUE_SUBORDINATE( be ) ) && noSubs )
645 len = be->be_nsuffix[j].bv_len;
648 /* suffix is longer than DN */
653 * input DN is normalized, so the separator check
654 * need not look at escaping
656 if ( len && len < dnlen &&
657 !DN_SEPARATOR( dn->bv_val[(dnlen-len)-1] ))
662 if ( strcmp( be->be_nsuffix[j].bv_val,
663 &dn->bv_val[dnlen-len] ) == 0 )
676 struct berval *bvsuffix )
680 if ( be->be_nsuffix == NULL ) {
684 for ( i = 0; !BER_BVISNULL( &be->be_nsuffix[i] ); i++ ) {
685 if ( bvmatch( &be->be_nsuffix[i], bvsuffix ) ) {
694 be_isroot_dn( Backend *be, struct berval *ndn )
696 if ( BER_BVISEMPTY( ndn ) || BER_BVISEMPTY( &be->be_rootndn ) ) {
700 return dn_match( &be->be_rootndn, ndn );
704 be_slurp_update( Operation *op )
706 return ( SLAP_SLURP_SHADOW( op->o_bd ) &&
707 be_isupdate_dn( op->o_bd, &op->o_ndn ) );
711 be_shadow_update( Operation *op )
713 /* This assumes that all internal ops (connid == -1) on a syncrepl
714 * database are syncrepl operations.
716 return (( SLAP_SYNC_SHADOW( op->o_bd ) && op->o_connid == -1 ) ||
717 ( SLAP_SHADOW( op->o_bd ) && be_isupdate_dn( op->o_bd, &op->o_ndn ) ) );
721 be_isupdate_dn( Backend *be, struct berval *ndn )
723 if ( BER_BVISEMPTY( ndn ) || BER_BVISEMPTY( &be->be_update_ndn ) ) {
727 return dn_match( &be->be_update_ndn, ndn );
731 be_root_dn( Backend *be )
733 return &be->be_rootdn;
737 be_isroot( Operation *op )
739 return be_isroot_dn( op->o_bd, &op->o_ndn );
743 be_isroot_pw( Operation *op )
747 if ( ! be_isroot_dn( op->o_bd, &op->o_req_ndn ) ) {
751 if ( BER_BVISEMPTY( &op->o_bd->be_rootpw ) ) {
756 ldap_pvt_thread_pool_setkey( op->o_threadctx, slap_sasl_bind,
757 op->o_conn->c_sasl_authctx, NULL );
760 result = lutil_passwd( &op->o_bd->be_rootpw, &op->orb_cred, NULL, NULL );
763 ldap_pvt_thread_pool_setkey( op->o_threadctx, slap_sasl_bind, NULL, NULL );
775 if ( op->o_bd->be_release ) {
776 /* free and release entry from backend */
777 return op->o_bd->be_release( op, e, rw );
786 backend_unbind( Operation *op, SlapReply *rs )
790 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
791 if ( be->be_unbind ) {
793 be->be_unbind( op, rs );
801 backend_connection_init(
806 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
807 if ( be->be_connection_init ) {
808 be->be_connection_init( be, conn );
816 backend_connection_destroy(
821 LDAP_STAILQ_FOREACH( be, &backendDB, be_next ) {
822 if ( be->be_connection_destroy ) {
823 be->be_connection_destroy( be, conn);
831 backend_check_controls(
835 LDAPControl **ctrls = op->o_ctrls;
836 rs->sr_err = LDAP_SUCCESS;
839 for( ; *ctrls != NULL ; ctrls++ ) {
842 switch ( slap_global_control( op, (*ctrls)->ldctl_oid, &cid ) ) {
843 case LDAP_CONTROL_NOT_FOUND:
844 /* unrecognized control */
845 if ( (*ctrls)->ldctl_iscritical ) {
846 /* should not be reachable */
847 Debug( LDAP_DEBUG_ANY, "backend_check_controls: "
848 "unrecognized critical control: %s\n",
849 (*ctrls)->ldctl_oid, 0, 0 );
852 Debug( LDAP_DEBUG_TRACE, "backend_check_controls: "
853 "unrecognized non-critical control: %s\n",
854 (*ctrls)->ldctl_oid, 0, 0 );
858 case LDAP_COMPARE_FALSE:
859 if ( !op->o_bd->be_ctrls[cid] && (*ctrls)->ldctl_iscritical ) {
860 /* RFC 4511 allows unavailableCriticalExtension to be
861 * returned when the server is unwilling to perform
862 * an operation extended by a recognized critical
865 rs->sr_text = "critical control unavailable in context";
866 rs->sr_err = LDAP_UNAVAILABLE_CRITICAL_EXTENSION;
871 case LDAP_COMPARE_TRUE:
876 Debug( LDAP_DEBUG_ANY,
877 "backend_check_controls: unable to check control: %s\n",
878 (*ctrls)->ldctl_oid, 0, 0 );
881 rs->sr_text = "unable to check control";
882 rs->sr_err = LDAP_OTHER;
888 #if 0 /* temporarily removed */
889 /* check should be generalized */
890 if( get_relax(op) && !be_isroot(op)) {
891 rs->sr_text = "requires manager authorization";
892 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
901 backend_check_restrictions(
904 struct berval *opdata )
906 slap_mask_t restrictops;
907 slap_mask_t requires;
909 slap_mask_t exopflag = 0;
916 int rc = SLAP_CB_CONTINUE;
918 if ( op->o_bd->be_chk_controls ) {
919 rc = ( *op->o_bd->be_chk_controls )( op, rs );
922 if ( rc == SLAP_CB_CONTINUE ) {
923 rc = backend_check_controls( op, rs );
926 if ( rc != LDAP_SUCCESS ) {
930 restrictops = op->o_bd->be_restrictops;
931 requires = op->o_bd->be_requires;
932 ssf = &op->o_bd->be_ssf_set;
935 restrictops = frontendDB->be_restrictops;
936 requires = frontendDB->be_requires;
937 ssf = &frontendDB->be_ssf_set;
940 switch( op->o_tag ) {
942 opflag = SLAP_RESTRICT_OP_ADD;
946 opflag = SLAP_RESTRICT_OP_BIND;
949 case LDAP_REQ_COMPARE:
950 opflag = SLAP_RESTRICT_OP_COMPARE;
952 case LDAP_REQ_DELETE:
954 opflag = SLAP_RESTRICT_OP_DELETE;
956 case LDAP_REQ_EXTENDED:
957 opflag = SLAP_RESTRICT_OP_EXTENDED;
960 /* treat unspecified as a modify */
961 opflag = SLAP_RESTRICT_OP_MODIFY;
966 if( bvmatch( opdata, &slap_EXOP_START_TLS ) ) {
969 exopflag = SLAP_RESTRICT_EXOP_START_TLS;
973 if( bvmatch( opdata, &slap_EXOP_WHOAMI ) ) {
974 exopflag = SLAP_RESTRICT_EXOP_WHOAMI;
978 if ( bvmatch( opdata, &slap_EXOP_CANCEL ) ) {
979 exopflag = SLAP_RESTRICT_EXOP_CANCEL;
983 if ( bvmatch( opdata, &slap_EXOP_MODIFY_PASSWD ) ) {
984 exopflag = SLAP_RESTRICT_EXOP_MODIFY_PASSWD;
989 /* treat everything else as a modify */
990 opflag = SLAP_RESTRICT_OP_MODIFY;
994 case LDAP_REQ_MODIFY:
996 opflag = SLAP_RESTRICT_OP_MODIFY;
998 case LDAP_REQ_RENAME:
1000 opflag = SLAP_RESTRICT_OP_RENAME;
1002 case LDAP_REQ_SEARCH:
1003 opflag = SLAP_RESTRICT_OP_SEARCH;
1005 case LDAP_REQ_UNBIND:
1010 rs->sr_text = "restrict operations internal error";
1011 rs->sr_err = LDAP_OTHER;
1016 /* these checks don't apply to StartTLS */
1018 rs->sr_err = LDAP_CONFIDENTIALITY_REQUIRED;
1019 if( op->o_transport_ssf < ssf->sss_transport ) {
1020 rs->sr_text = op->o_transport_ssf
1021 ? "stronger transport confidentiality required"
1022 : "transport confidentiality required";
1026 if( op->o_tls_ssf < ssf->sss_tls ) {
1027 rs->sr_text = op->o_tls_ssf
1028 ? "stronger TLS confidentiality required"
1029 : "TLS confidentiality required";
1034 if( op->o_tag == LDAP_REQ_BIND && opdata == NULL ) {
1035 /* simple bind specific check */
1036 if( op->o_ssf < ssf->sss_simple_bind ) {
1037 rs->sr_text = op->o_ssf
1038 ? "stronger confidentiality required"
1039 : "confidentiality required";
1044 if( op->o_tag != LDAP_REQ_BIND || opdata == NULL ) {
1045 /* these checks don't apply to SASL bind */
1047 if( op->o_sasl_ssf < ssf->sss_sasl ) {
1048 rs->sr_text = op->o_sasl_ssf
1049 ? "stronger SASL confidentiality required"
1050 : "SASL confidentiality required";
1054 if( op->o_ssf < ssf->sss_ssf ) {
1055 rs->sr_text = op->o_ssf
1056 ? "stronger confidentiality required"
1057 : "confidentiality required";
1063 if( op->o_transport_ssf < ssf->sss_update_transport ) {
1064 rs->sr_text = op->o_transport_ssf
1065 ? "stronger transport confidentiality required for update"
1066 : "transport confidentiality required for update";
1070 if( op->o_tls_ssf < ssf->sss_update_tls ) {
1071 rs->sr_text = op->o_tls_ssf
1072 ? "stronger TLS confidentiality required for update"
1073 : "TLS confidentiality required for update";
1077 if( op->o_sasl_ssf < ssf->sss_update_sasl ) {
1078 rs->sr_text = op->o_sasl_ssf
1079 ? "stronger SASL confidentiality required for update"
1080 : "SASL confidentiality required for update";
1084 if( op->o_ssf < ssf->sss_update_ssf ) {
1085 rs->sr_text = op->o_ssf
1086 ? "stronger confidentiality required for update"
1087 : "confidentiality required for update";
1091 if( !( global_allows & SLAP_ALLOW_UPDATE_ANON ) &&
1092 BER_BVISEMPTY( &op->o_ndn ) )
1094 rs->sr_text = "modifications require authentication";
1095 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1099 #ifdef SLAP_X_LISTENER_MOD
1100 if ( op->o_conn->c_listener &&
1101 ! ( op->o_conn->c_listener->sl_perms & ( !BER_BVISEMPTY( &op->o_ndn )
1102 ? (S_IWUSR|S_IWOTH) : S_IWOTH ) ) )
1104 /* no "w" mode means readonly */
1105 rs->sr_text = "modifications not allowed on this listener";
1106 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1109 #endif /* SLAP_X_LISTENER_MOD */
1114 /* these checks don't apply to Bind, StartTLS, or Unbind */
1116 if( requires & SLAP_REQUIRE_STRONG ) {
1117 /* should check mechanism */
1118 if( ( op->o_transport_ssf < ssf->sss_transport
1119 && op->o_authtype == LDAP_AUTH_SIMPLE )
1120 || BER_BVISEMPTY( &op->o_dn ) )
1122 rs->sr_text = "strong(er) authentication required";
1123 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1128 if( requires & SLAP_REQUIRE_SASL ) {
1129 if( op->o_authtype != LDAP_AUTH_SASL || BER_BVISEMPTY( &op->o_dn ) ) {
1130 rs->sr_text = "SASL authentication required";
1131 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1136 if( requires & SLAP_REQUIRE_AUTHC ) {
1137 if( BER_BVISEMPTY( &op->o_dn ) ) {
1138 rs->sr_text = "authentication required";
1139 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1144 if( requires & SLAP_REQUIRE_BIND ) {
1146 ldap_pvt_thread_mutex_lock( &op->o_conn->c_mutex );
1147 version = op->o_conn->c_protocol;
1148 ldap_pvt_thread_mutex_unlock( &op->o_conn->c_mutex );
1151 /* no bind has occurred */
1152 rs->sr_text = "BIND required";
1153 rs->sr_err = LDAP_OPERATIONS_ERROR;
1158 if( requires & SLAP_REQUIRE_LDAP_V3 ) {
1159 if( op->o_protocol < LDAP_VERSION3 ) {
1160 /* no bind has occurred */
1161 rs->sr_text = "operation restricted to LDAPv3 clients";
1162 rs->sr_err = LDAP_OPERATIONS_ERROR;
1167 #ifdef SLAP_X_LISTENER_MOD
1168 if ( !starttls && BER_BVISEMPTY( &op->o_dn ) ) {
1169 if ( op->o_conn->c_listener &&
1170 !( op->o_conn->c_listener->sl_perms & S_IXOTH ))
1172 /* no "x" mode means bind required */
1173 rs->sr_text = "bind required on this listener";
1174 rs->sr_err = LDAP_STRONG_AUTH_REQUIRED;
1179 if ( !starttls && !updateop ) {
1180 if ( op->o_conn->c_listener &&
1181 !( op->o_conn->c_listener->sl_perms &
1182 ( !BER_BVISEMPTY( &op->o_dn )
1183 ? (S_IRUSR|S_IROTH) : S_IROTH )))
1185 /* no "r" mode means no read */
1186 rs->sr_text = "read not allowed on this listener";
1187 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1191 #endif /* SLAP_X_LISTENER_MOD */
1195 if( ( restrictops & opflag )
1196 || ( exopflag && ( restrictops & exopflag ) ) ) {
1197 if( ( restrictops & SLAP_RESTRICT_OP_MASK) == SLAP_RESTRICT_OP_READS ) {
1198 rs->sr_text = "read operations restricted";
1199 } else if ( restrictops & exopflag ) {
1200 rs->sr_text = "extended operation restricted";
1202 rs->sr_text = "operation restricted";
1204 rs->sr_err = LDAP_UNWILLING_TO_PERFORM;
1208 rs->sr_err = LDAP_SUCCESS;
1212 int backend_check_referrals( Operation *op, SlapReply *rs )
1214 rs->sr_err = LDAP_SUCCESS;
1216 if( op->o_bd->be_chk_referrals ) {
1217 rs->sr_err = op->o_bd->be_chk_referrals( op, rs );
1219 if( rs->sr_err != LDAP_SUCCESS && rs->sr_err != LDAP_REFERRAL ) {
1220 send_ldap_result( op, rs );
1232 AttributeDescription *at,
1238 if ( op->o_bd == NULL ) {
1239 return LDAP_NO_SUCH_OBJECT;
1242 if ( op->o_bd->be_fetch ) {
1243 return op->o_bd->be_fetch( op, ndn, oc, at, rw, e );
1246 return LDAP_UNWILLING_TO_PERFORM;
1253 struct berval *gr_ndn,
1254 struct berval *op_ndn,
1255 ObjectClass *group_oc,
1256 AttributeDescription *group_at )
1259 void *o_priv = op->o_private, *e_priv = NULL;
1263 Backend *be = op->o_bd;
1265 op->o_bd = select_backend( gr_ndn, 0 );
1267 for ( g = op->o_groups; g; g = g->ga_next ) {
1268 if ( g->ga_be != op->o_bd || g->ga_oc != group_oc ||
1269 g->ga_at != group_at || g->ga_len != gr_ndn->bv_len )
1273 if ( strcmp( g->ga_ndn, gr_ndn->bv_val ) == 0 ) {
1283 if ( target && dn_match( &target->e_nname, gr_ndn ) ) {
1288 op->o_private = NULL;
1289 rc = be_entry_get_rw( op, gr_ndn, group_oc, group_at, 0, &e );
1290 e_priv = op->o_private;
1291 op->o_private = o_priv;
1295 a = attr_find( e->e_attrs, group_at );
1297 /* If the attribute is a subtype of labeledURI,
1298 * treat this as a dynamic group ala groupOfURLs
1300 if ( is_at_subtype( group_at->ad_type,
1301 slap_schema.si_ad_labeledURI->ad_type ) )
1305 struct berval bv, nbase;
1308 void *user_priv = NULL;
1309 Backend *b2 = op->o_bd;
1311 if ( target && dn_match( &target->e_nname, op_ndn ) ) {
1315 rc = LDAP_COMPARE_FALSE;
1316 for ( i = 0; !BER_BVISNULL( &a->a_vals[i] ); i++ ) {
1317 if ( ldap_url_parse( a->a_vals[i].bv_val, &ludp ) !=
1323 BER_BVZERO( &nbase );
1325 /* host, attrs and extensions parts must be empty */
1326 if ( ( ludp->lud_host && *ludp->lud_host )
1333 ber_str2bv( ludp->lud_dn, 0, 0, &bv );
1334 if ( dnNormalize( 0, NULL, NULL, &bv, &nbase,
1335 op->o_tmpmemctx ) != LDAP_SUCCESS )
1340 switch ( ludp->lud_scope ) {
1341 case LDAP_SCOPE_BASE:
1342 if ( !dn_match( &nbase, op_ndn ) ) {
1346 case LDAP_SCOPE_ONELEVEL:
1347 dnParent( op_ndn, &bv );
1348 if ( !dn_match( &nbase, &bv ) ) {
1352 case LDAP_SCOPE_SUBTREE:
1353 if ( !dnIsSuffix( op_ndn, &nbase ) ) {
1357 case LDAP_SCOPE_SUBORDINATE:
1358 if ( dn_match( &nbase, op_ndn ) ||
1359 !dnIsSuffix( op_ndn, &nbase ) )
1365 /* NOTE: this could be NULL
1366 * if no filter is provided,
1367 * or if filter parsing fails.
1368 * In the latter case,
1369 * we should give up. */
1370 if ( ludp->lud_filter != NULL && ludp->lud_filter != '\0') {
1371 filter = str2filter_x( op, ludp->lud_filter );
1372 if ( filter == NULL ) {
1378 /* only get user if required
1379 * and not available yet */
1380 if ( user == NULL ) {
1383 op->o_bd = select_backend( op_ndn, 0 );
1384 op->o_private = NULL;
1385 rc2 = be_entry_get_rw( op, op_ndn, NULL, NULL, 0, &user );
1386 user_priv = op->o_private;
1387 op->o_private = o_priv;
1395 if ( test_filter( NULL, user, filter ) ==
1400 filter_free_x( op, filter );
1403 ldap_free_urldesc( ludp );
1404 if ( !BER_BVISNULL( &nbase ) ) {
1405 op->o_tmpfree( nbase.bv_val, op->o_tmpmemctx );
1407 if ( rc != LDAP_COMPARE_FALSE ) {
1412 if ( user != NULL && user != target ) {
1413 op->o_private = user_priv;
1414 be_entry_release_r( op, user );
1415 op->o_private = o_priv;
1420 rc = value_find_ex( group_at,
1421 SLAP_MR_ATTRIBUTE_VALUE_NORMALIZED_MATCH |
1422 SLAP_MR_ASSERTED_VALUE_NORMALIZED_MATCH,
1423 a->a_nvals, op_ndn, op->o_tmpmemctx );
1424 if ( rc == LDAP_NO_SUCH_ATTRIBUTE ) {
1425 rc = LDAP_COMPARE_FALSE;
1430 rc = LDAP_NO_SUCH_ATTRIBUTE;
1433 if ( e != target ) {
1434 op->o_private = e_priv;
1435 be_entry_release_r( op, e );
1436 op->o_private = o_priv;
1440 rc = LDAP_NO_SUCH_OBJECT;
1443 if ( op->o_tag != LDAP_REQ_BIND && !op->o_do_not_cache ) {
1444 g = op->o_tmpalloc( sizeof( GroupAssertion ) + gr_ndn->bv_len,
1446 g->ga_be = op->o_bd;
1447 g->ga_oc = group_oc;
1448 g->ga_at = group_at;
1450 g->ga_len = gr_ndn->bv_len;
1451 strcpy( g->ga_ndn, gr_ndn->bv_val );
1452 g->ga_next = op->o_groups;
1465 struct berval *gr_ndn,
1466 struct berval *op_ndn,
1467 ObjectClass *group_oc,
1468 AttributeDescription *group_at )
1473 if ( op->o_abandon ) {
1474 return SLAPD_ABANDON;
1478 op->o_bd = frontendDB;
1479 rc = frontendDB->be_group( op, target, gr_ndn,
1480 op_ndn, group_oc, group_at );
1491 AttributeDescription *entry_at,
1493 slap_access_t access )
1496 void *o_priv = op->o_private, *e_priv = NULL;
1497 Attribute *a = NULL;
1498 int freeattr = 0, i, j, rc = LDAP_SUCCESS;
1499 AccessControlState acl_state = ACL_STATE_INIT;
1500 Backend *be = op->o_bd;
1502 op->o_bd = select_backend( edn, 0 );
1504 if ( target && dn_match( &target->e_nname, edn ) ) {
1508 op->o_private = NULL;
1509 rc = be_entry_get_rw( op, edn, NULL, entry_at, 0, &e );
1510 e_priv = op->o_private;
1511 op->o_private = o_priv;
1515 if ( entry_at == slap_schema.si_ad_entry || entry_at == slap_schema.si_ad_children ) {
1516 assert( vals == NULL );
1519 if ( op->o_conn && access > ACL_NONE &&
1520 access_allowed( op, e, entry_at, NULL,
1521 access, &acl_state ) == 0 )
1523 rc = LDAP_INSUFFICIENT_ACCESS;
1528 a = attr_find( e->e_attrs, entry_at );
1530 SlapReply rs = { 0 };
1531 AttributeName anlist[ 2 ];
1533 anlist[ 0 ].an_name = entry_at->ad_cname;
1534 anlist[ 0 ].an_desc = entry_at;
1535 BER_BVZERO( &anlist[ 1 ].an_name );
1536 rs.sr_attrs = anlist;
1538 /* NOTE: backend_operational() is also called
1539 * when returning results, so it's supposed
1540 * to do no harm to entries */
1542 rc = backend_operational( op, &rs );
1545 if ( rc == LDAP_SUCCESS ) {
1546 if ( rs.sr_operational_attrs ) {
1548 a = rs.sr_operational_attrs;
1551 rc = LDAP_NO_SUCH_ATTRIBUTE;
1559 if ( op->o_conn && access > ACL_NONE &&
1560 access_allowed( op, e, entry_at, NULL,
1561 access, &acl_state ) == 0 )
1563 rc = LDAP_INSUFFICIENT_ACCESS;
1567 for ( i = 0; !BER_BVISNULL( &a->a_vals[i] ); i++ )
1570 v = op->o_tmpalloc( sizeof(struct berval) * ( i + 1 ),
1572 for ( i = 0, j = 0; !BER_BVISNULL( &a->a_vals[i] ); i++ )
1574 if ( op->o_conn && access > ACL_NONE &&
1575 access_allowed( op, e, entry_at,
1582 ber_dupbv_x( &v[j], &a->a_nvals[i],
1584 if ( !BER_BVISNULL( &v[j] ) ) {
1589 op->o_tmpfree( v, op->o_tmpmemctx );
1591 rc = LDAP_INSUFFICIENT_ACCESS;
1594 BER_BVZERO( &v[j] );
1599 freeit: if ( e != target ) {
1600 op->o_private = e_priv;
1601 be_entry_release_r( op, e );
1602 op->o_private = o_priv;
1618 AttributeDescription *entry_at,
1620 slap_access_t access )
1626 op->o_bd = frontendDB;
1627 rc = frontendDB->be_attribute( op, target, edn,
1628 entry_at, vals, access );
1639 AttributeDescription *entry_at,
1640 struct berval *nval,
1641 slap_access_t access,
1645 void *o_priv = op->o_private, *e_priv = NULL;
1646 int rc = LDAP_INSUFFICIENT_ACCESS;
1647 Backend *be = op->o_bd;
1650 assert( op != NULL );
1651 assert( op->o_conn != NULL );
1652 assert( edn != NULL );
1653 assert( access > ACL_NONE );
1655 op->o_bd = select_backend( edn, 0 );
1657 if ( target && dn_match( &target->e_nname, edn ) ) {
1661 op->o_private = NULL;
1662 rc = be_entry_get_rw( op, edn, NULL, entry_at, 0, &e );
1663 e_priv = op->o_private;
1664 op->o_private = o_priv;
1668 Attribute *a = NULL;
1671 if ( entry_at == NULL ) {
1672 entry_at = slap_schema.si_ad_entry;
1675 if ( entry_at == slap_schema.si_ad_entry || entry_at == slap_schema.si_ad_children )
1677 if ( access_allowed_mask( op, e, entry_at,
1678 NULL, access, NULL, mask ) == 0 )
1680 rc = LDAP_INSUFFICIENT_ACCESS;
1687 a = attr_find( e->e_attrs, entry_at );
1689 SlapReply rs = { 0 };
1690 AttributeName anlist[ 2 ];
1692 anlist[ 0 ].an_name = entry_at->ad_cname;
1693 anlist[ 0 ].an_desc = entry_at;
1694 BER_BVZERO( &anlist[ 1 ].an_name );
1695 rs.sr_attrs = anlist;
1697 rs.sr_attr_flags = slap_attr_flags( rs.sr_attrs );
1699 /* NOTE: backend_operational() is also called
1700 * when returning results, so it's supposed
1701 * to do no harm to entries */
1703 rc = backend_operational( op, &rs );
1706 if ( rc == LDAP_SUCCESS ) {
1707 if ( rs.sr_operational_attrs ) {
1709 a = rs.sr_operational_attrs;
1712 rc = LDAP_NO_SUCH_OBJECT;
1718 if ( access_allowed_mask( op, e, entry_at,
1719 nval, access, NULL, mask ) == 0 )
1721 rc = LDAP_INSUFFICIENT_ACCESS;
1727 freeit: if ( e != target ) {
1728 op->o_private = e_priv;
1729 be_entry_release_r( op, e );
1730 op->o_private = o_priv;
1749 for ( ap = &rs->sr_operational_attrs; *ap; ap = &(*ap)->a_next )
1750 /* just count them */ ;
1753 * If operational attributes (allegedly) are required,
1754 * and the backend supports specific operational attributes,
1755 * add them to the attribute list
1757 if ( !( rs->sr_flags & REP_NO_ENTRYDN )
1758 && ( SLAP_OPATTRS( rs->sr_attr_flags ) || ( rs->sr_attrs &&
1759 ad_inlist( slap_schema.si_ad_entryDN, rs->sr_attrs ) ) ) )
1761 *ap = slap_operational_entryDN( rs->sr_entry );
1762 ap = &(*ap)->a_next;
1765 if ( !( rs->sr_flags & REP_NO_SUBSCHEMA)
1766 && ( SLAP_OPATTRS( rs->sr_attr_flags ) || ( rs->sr_attrs &&
1767 ad_inlist( slap_schema.si_ad_subschemaSubentry, rs->sr_attrs ) ) ) )
1769 *ap = slap_operational_subschemaSubentry( op->o_bd );
1770 ap = &(*ap)->a_next;
1773 if ( op->o_bd != NULL ) {
1774 BackendDB *be_orig = op->o_bd;
1776 /* Let the overlays have a chance at this */
1777 op->o_bd = select_backend( &op->o_req_ndn, 0 );
1778 if ( op->o_bd != NULL && !be_match( op->o_bd, frontendDB ) &&
1779 ( SLAP_OPATTRS( rs->sr_attr_flags ) || rs->sr_attrs ) &&
1780 op->o_bd->be_operational != NULL )
1782 rc = op->o_bd->be_operational( op, rs );
1790 int backend_operational( Operation *op, SlapReply *rs )
1795 /* Moved this into the frontend so global overlays are called */
1798 op->o_bd = frontendDB;
1799 rc = frontendDB->be_operational( op, rs );