3 * Copyright 1998-2000 The OpenLDAP Foundation, All Rights Reserved.
4 * COPYING RESTRICTIONS APPLY, see COPYRIGHT file
6 /* backend.c - routines for dealing with back-end databases */
13 #include <ac/string.h>
14 #include <ac/socket.h>
22 #include "back-dnssrv/external.h"
25 #include "back-ldap/external.h"
28 #include "back-ldbm/external.h"
31 #include "back-passwd/external.h"
34 #include "back-perl/external.h"
37 #include "back-shell/external.h"
40 #include "back-tcl/external.h"
43 #include "back-sql/external.h"
46 #include "private/external.h"
49 static BackendInfo binfo[] = {
50 #if defined(SLAPD_DNSSRV) && !defined(SLAPD_DNSSRV_DYNAMIC)
51 {"dnssrv", dnssrv_back_initialize},
53 #if defined(SLAPD_LDAP) && !defined(SLAPD_LDAP_DYNAMIC)
54 {"ldap", ldap_back_initialize},
56 #if defined(SLAPD_LDBM) && !defined(SLAPD_LDBM_DYNAMIC)
57 {"ldbm", ldbm_back_initialize},
59 #if defined(SLAPD_PASSWD) && !defined(SLAPD_PASSWD_DYNAMIC)
60 {"passwd", passwd_back_initialize},
62 #if defined(SLAPD_PERL) && !defined(SLAPD_PERL_DYNAMIC)
63 {"perl", perl_back_initialize},
65 #if defined(SLAPD_SHELL) && !defined(SLAPD_SHELL_DYNAMIC)
66 {"shell", shell_back_initialize},
68 #if defined(SLAPD_TCL) && !defined(SLAPD_TCL_DYNAMIC)
69 {"tcl", tcl_back_initialize},
71 #if defined(SLAPD_SQL) && !defined(SLAPD_SQL_DYNAMIC)
72 {"sql", sql_back_initialize},
74 /* for any private backend */
75 #if defined(SLAPD_PRIVATE) && !defined(SLAPD_PRIVATE_DYNAMIC)
76 {"private", private_back_initialize},
82 BackendInfo *backendInfo = NULL;
85 BackendDB *backendDB = NULL;
87 int backend_init(void)
91 if((nBackendInfo != 0) || (backendInfo != NULL)) {
92 /* already initialized */
93 Debug( LDAP_DEBUG_ANY,
94 "backend_init: already initialized.\n", 0, 0, 0 );
99 binfo[nBackendInfo].bi_type != NULL;
102 rc = binfo[nBackendInfo].bi_init( &binfo[nBackendInfo] );
105 Debug( LDAP_DEBUG_ANY,
106 "backend_init: initialized for type \"%s\"\n",
107 binfo[nBackendInfo].bi_type, 0, 0 );
109 /* destroy those we've already inited */
114 if ( binfo[nBackendInfo].bi_destroy ) {
115 binfo[nBackendInfo].bi_destroy(
116 &binfo[nBackendInfo] );
123 if ( nBackendInfo > 0) {
131 Debug( LDAP_DEBUG_ANY,
132 "backend_init: failed\n",
136 #endif /* SLAPD_MODULES */
139 int backend_add(BackendInfo *aBackendInfo)
143 if ((rc = aBackendInfo->bi_init(aBackendInfo)) != 0) {
144 Debug( LDAP_DEBUG_ANY,
145 "backend_add: initialization for type \"%s\" failed\n",
146 aBackendInfo->bi_type, 0, 0 );
150 /* now add the backend type to the Backend Info List */
152 BackendInfo *newBackendInfo = 0;
154 /* if backendInfo == binfo no deallocation of old backendInfo */
155 if (backendInfo == binfo) {
156 newBackendInfo = ch_calloc(nBackendInfo + 1, sizeof(BackendInfo));
157 AC_MEMCPY(newBackendInfo, backendInfo, sizeof(BackendInfo) *
160 newBackendInfo = ch_realloc(backendInfo, sizeof(BackendInfo) *
163 AC_MEMCPY(&newBackendInfo[nBackendInfo], aBackendInfo,
164 sizeof(BackendInfo));
165 backendInfo = newBackendInfo;
172 int backend_startup(Backend *be)
177 if( ! ( nBackendDB > 0 ) ) {
179 Debug( LDAP_DEBUG_ANY,
180 "backend_startup: %d databases to startup.\n",
186 /* startup a specific backend database */
187 Debug( LDAP_DEBUG_TRACE,
188 "backend_startup: starting database\n",
191 if ( be->bd_info->bi_open ) {
192 rc = be->bd_info->bi_open( be->bd_info );
196 Debug( LDAP_DEBUG_ANY,
197 "backend_startup: bi_open failed!\n",
202 if ( be->bd_info->bi_db_open ) {
203 rc = be->bd_info->bi_db_open( be );
207 Debug( LDAP_DEBUG_ANY,
208 "backend_startup: bi_db_open failed!\n",
216 /* open each backend type */
217 for( i = 0; i < nBackendInfo; i++ ) {
218 if( backendInfo[i].bi_nDB == 0) {
219 /* no database of this type, don't open */
223 if( backendInfo[i].bi_open ) {
224 rc = backendInfo[i].bi_open(
229 Debug( LDAP_DEBUG_ANY,
230 "backend_startup: bi_open %d failed!\n",
236 /* open each backend database */
237 for( i = 0; i < nBackendDB; i++ ) {
238 /* append global access controls */
239 acl_append( &backendDB[i].be_acl, global_acl );
241 if ( backendDB[i].bd_info->bi_db_open ) {
242 rc = backendDB[i].bd_info->bi_db_open(
247 Debug( LDAP_DEBUG_ANY,
248 "backend_startup: bi_db_open %d failed!\n",
257 int backend_num( Backend *be )
261 if( be == NULL ) return -1;
263 for( i = 0; i < nBackendDB; i++ ) {
264 if( be == &backendDB[i] ) return i;
269 int backend_shutdown( Backend *be )
275 /* shutdown a specific backend database */
277 if ( be->bd_info->bi_nDB == 0 ) {
278 /* no database of this type, we never opened it */
282 if ( be->bd_info->bi_db_close ) {
283 be->bd_info->bi_db_close( be );
286 if( be->bd_info->bi_close ) {
287 be->bd_info->bi_close( be->bd_info );
293 /* close each backend database */
294 for( i = 0; i < nBackendDB; i++ ) {
295 if ( backendDB[i].bd_info->bi_db_close ) {
296 backendDB[i].bd_info->bi_db_close(
301 Debug( LDAP_DEBUG_ANY,
302 "backend_close: bi_close %s failed!\n",
303 backendDB[i].be_type, 0, 0 );
307 /* close each backend type */
308 for( i = 0; i < nBackendInfo; i++ ) {
309 if( backendInfo[i].bi_nDB == 0 ) {
310 /* no database of this type */
314 if( backendInfo[i].bi_close ) {
315 backendInfo[i].bi_close(
323 int backend_destroy(void)
327 /* destroy each backend database */
328 for( i = 0; i < nBackendDB; i++ ) {
329 if ( backendDB[i].bd_info->bi_db_destroy ) {
330 backendDB[i].bd_info->bi_db_destroy(
335 /* destroy each backend type */
336 for( i = 0; i < nBackendInfo; i++ ) {
337 if( backendInfo[i].bi_destroy ) {
338 backendInfo[i].bi_destroy(
344 if (backendInfo != binfo) {
347 #endif /* SLAPD_MODULES */
355 BackendInfo* backend_info(const char *type)
359 /* search for the backend type */
360 for( i = 0; i < nBackendInfo; i++ ) {
361 if( strcasecmp(backendInfo[i].bi_type, type) == 0 ) {
362 return &backendInfo[i];
376 BackendInfo *bi = backend_info(type);
380 fprintf( stderr, "Unrecognized database type (%s)\n", type );
384 backendDB = (BackendDB *) ch_realloc(
386 (nBackendDB + 1) * sizeof(Backend) );
388 memset( &backendDB[nbackends], '\0', sizeof(Backend) );
390 be = &backends[nbackends++];
393 be->be_sizelimit = defsize;
394 be->be_timelimit = deftime;
395 be->be_dfltaccess = global_default_access;
397 be->be_restrictops = global_restrictops;
398 be->be_requires = global_requires;
400 /* assign a default depth limit for alias deref */
401 be->be_max_deref_depth = SLAPD_DEFAULT_MAXDEREFDEPTH;
404 rc = bi->bi_db_init( be );
408 fprintf( stderr, "database init failed (%s)\n", type );
422 for ( i = 0; i < nbackends; i++ ) {
423 if ( backends[i].bd_info->bi_db_close ) {
424 (*backends[i].bd_info->bi_db_close)( &backends[i] );
434 int i, j, len, dnlen;
437 dnlen = strlen( dn );
438 for ( i = 0; i < nbackends; i++ ) {
439 for ( j = 0; backends[i].be_nsuffix != NULL &&
440 backends[i].be_nsuffix[j] != NULL; j++ )
442 len = strlen( backends[i].be_nsuffix[j] );
445 /* suffix is longer than DN */
449 if ( len < dnlen && DN_SEPARATOR( dn[(dnlen-len)-1] ) ) {
450 /* make sure we have a separator */
454 if ( strcmp( backends[i].be_nsuffix[j], &dn[dnlen-len] ) == 0 ) {
458 if( manageDSAit && len == dnlen ) {
480 for ( i = 0; be->be_nsuffix != NULL && be->be_nsuffix[i] != NULL; i++ ) {
481 if ( strcmp( be->be_nsuffix[i], suffix ) == 0 ) {
490 be_isroot( Backend *be, const char *ndn )
494 if ( ndn == NULL || *ndn == '\0' ) {
498 if ( be->be_root_ndn == NULL || *be->be_root_ndn == '\0' ) {
502 rc = strcmp( be->be_root_ndn, ndn ) ? 0 : 1;
508 be_root_dn( Backend *be )
510 if ( be->be_root_dn == NULL ) {
514 return be->be_root_dn;
518 be_isroot_pw( Backend *be,
521 struct berval *cred )
525 if ( ! be_isroot( be, ndn ) ) {
529 if( be->be_root_pw.bv_len == 0 ) {
533 #if defined( SLAPD_CRYPT ) || defined( SLAPD_SPASSWD )
534 ldap_pvt_thread_mutex_lock( &passwd_mutex );
536 lutil_passwd_sasl_conn = conn->c_sasl_context;
540 result = lutil_passwd( &be->be_root_pw, cred, NULL );
542 #if defined( SLAPD_CRYPT ) || defined( SLAPD_SPASSWD )
544 lutil_passwd_sasl_conn = NULL;
546 ldap_pvt_thread_mutex_unlock( &passwd_mutex );
553 be_entry_release_rw( Backend *be, Entry *e, int rw )
555 if ( be->be_release ) {
556 /* free and release entry from backend */
557 return be->be_release( be, e, rw );
573 for ( i = 0; i < nbackends; i++ ) {
574 if ( backends[i].be_unbind ) {
575 (*backends[i].be_unbind)( &backends[i], conn, op );
583 backend_connection_init(
589 for ( i = 0; i < nbackends; i++ ) {
590 if ( backends[i].be_connection_init ) {
591 (*backends[i].be_connection_init)( &backends[i], conn);
599 backend_connection_destroy(
605 for ( i = 0; i < nbackends; i++ ) {
606 if ( backends[i].be_connection_destroy ) {
607 (*backends[i].be_connection_destroy)( &backends[i], conn);
615 backend_check_controls(
623 if( ctrls == NULL ) {
627 for( ; *ctrls != NULL ; ctrls++ ) {
628 if( (*ctrls)->ldctl_iscritical &&
629 !charray_inlist( be->be_controls, (*ctrls)->ldctl_oid ) )
631 *text = "control unavailable in NamingContext";
632 return LDAP_UNAVAILABLE_CRITICAL_EXTENSION;
640 backend_check_restrictions(
648 slap_mask_t restrictops;
649 slap_mask_t requires;
655 rc = backend_check_controls( be, conn, op, text );
657 if( rc != LDAP_SUCCESS ) {
661 restrictops = be->be_restrictops;
662 requires = be->be_requires;
663 ssf = &be->be_ssf_set;
666 restrictops = global_restrictops;
667 requires = global_requires;
668 ssf = &global_ssf_set;
671 switch( op->o_tag ) {
673 opflag = SLAP_RESTRICT_OP_ADD;
677 opflag = SLAP_RESTRICT_OP_BIND;
679 case LDAP_REQ_COMPARE:
680 opflag = SLAP_RESTRICT_OP_COMPARE;
682 case LDAP_REQ_DELETE:
684 opflag = SLAP_RESTRICT_OP_DELETE;
686 case LDAP_REQ_EXTENDED:
687 opflag = SLAP_RESTRICT_OP_EXTENDED;
689 case LDAP_REQ_MODIFY:
691 opflag = SLAP_RESTRICT_OP_MODIFY;
693 case LDAP_REQ_RENAME:
695 opflag = SLAP_RESTRICT_OP_RENAME;
697 case LDAP_REQ_SEARCH:
698 opflag = SLAP_RESTRICT_OP_SEARCH;
700 case LDAP_REQ_UNBIND:
704 *text = "restrict operations internal error";
708 if ( op->o_tag != LDAP_REQ_EXTENDED
709 || strcmp( (const char *) opdata, LDAP_EXOP_START_TLS ) )
711 /* these checks don't apply to StartTLS */
713 if( op->o_tag == LDAP_REQ_EXTENDED ) {
714 /* threat other extended operations as update ops */
718 if( op->o_transport_ssf < ssf->sss_transport ) {
719 *text = "transport confidentiality required";
720 return LDAP_CONFIDENTIALITY_REQUIRED;
723 if( op->o_tls_ssf < ssf->sss_tls ) {
724 *text = "TLS confidentiality required";
725 return LDAP_CONFIDENTIALITY_REQUIRED;
728 if( op->o_tag != LDAP_REQ_BIND || opdata == NULL ) {
729 /* these checks don't apply to SASL bind */
731 if( op->o_sasl_ssf < ssf->sss_sasl ) {
732 *text = "SASL confidentiality required";
733 return LDAP_CONFIDENTIALITY_REQUIRED;
736 if( op->o_ssf < ssf->sss_ssf ) {
737 *text = "confidentiality required";
738 return LDAP_CONFIDENTIALITY_REQUIRED;
743 if( op->o_transport_ssf < ssf->sss_update_transport ) {
744 *text = "transport update confidentiality required";
745 return LDAP_CONFIDENTIALITY_REQUIRED;
748 if( op->o_tls_ssf < ssf->sss_update_tls ) {
749 *text = "TLS update confidentiality required";
750 return LDAP_CONFIDENTIALITY_REQUIRED;
753 if( op->o_sasl_ssf < ssf->sss_update_sasl ) {
754 *text = "SASL update confidentiality required";
755 return LDAP_CONFIDENTIALITY_REQUIRED;
758 if( op->o_ssf < ssf->sss_update_ssf ) {
759 *text = "update confidentiality required";
760 return LDAP_CONFIDENTIALITY_REQUIRED;
765 if ( op->o_tag != LDAP_REQ_BIND && ( op->o_tag != LDAP_REQ_EXTENDED ||
766 strcmp( (const char *) opdata, LDAP_EXOP_START_TLS ) ) )
768 /* these checks don't apply to Bind or StartTLS */
770 if( requires & SLAP_REQUIRE_STRONG ) {
771 /* should check mechanism */
772 if( op->o_authmech == NULL ||
773 op->o_dn == NULL || *op->o_dn == '\0' )
775 *text = "strong authentication required";
776 return LDAP_STRONG_AUTH_REQUIRED;
780 if( requires & SLAP_REQUIRE_SASL ) {
781 if( op->o_authmech == NULL ||
782 op->o_dn == NULL || *op->o_dn == '\0' )
784 *text = "SASL authentication required";
785 return LDAP_STRONG_AUTH_REQUIRED;
789 if( requires & SLAP_REQUIRE_AUTHC ) {
790 if( op->o_dn == NULL || *op->o_dn == '\0' ) {
791 *text = "authentication required";
792 return LDAP_UNWILLING_TO_PERFORM;
796 if( requires & SLAP_REQUIRE_BIND ) {
798 ldap_pvt_thread_mutex_lock( &conn->c_mutex );
799 version = conn->c_protocol;
800 ldap_pvt_thread_mutex_unlock( &conn->c_mutex );
803 /* no bind has occurred */
804 *text = "BIND required";
805 return LDAP_OPERATIONS_ERROR;
809 if( requires & SLAP_REQUIRE_LDAP_V3 ) {
810 if( op->o_protocol < LDAP_VERSION3 ) {
811 /* no bind has occurred */
812 *text = "operation restricted to LDAPv3 clients";
813 return LDAP_OPERATIONS_ERROR;
818 if( restrictops & opflag ) {
819 if( restrictops == SLAP_RESTRICT_OP_READS ) {
820 *text = "read operations restricted";
822 *text = "operation restricted";
824 return LDAP_UNWILLING_TO_PERFORM;
830 int backend_check_referrals(
837 int rc = LDAP_SUCCESS;
839 if( be->be_chk_referrals ) {
842 rc = be->be_chk_referrals( be,
843 conn, op, dn, ndn, &text );
845 if( rc != LDAP_SUCCESS && rc != LDAP_REFERRAL ) {
846 send_ldap_result( conn, op, rc,
847 NULL, text, NULL, NULL );
860 ObjectClass *group_oc,
861 AttributeDescription *group_at
864 if( strcmp( target->e_ndn, gr_ndn ) != 0 ) {
865 /* we won't attempt to send it to a different backend */
867 be = select_backend(gr_ndn, 0);
870 return LDAP_NO_SUCH_OBJECT;
875 return be->be_group( be, target, gr_ndn, op_ndn,
876 group_oc, group_at );
879 return LDAP_UNWILLING_TO_PERFORM;
889 AttributeDescription *entry_at,
890 struct berval ***vals
893 if( target == NULL || strcmp( target->e_ndn, e_ndn ) != 0 ) {
894 /* we won't attempt to send it to a different backend */
896 be = select_backend(e_ndn, 0);
899 return LDAP_NO_SUCH_OBJECT;
903 if( be->be_attribute ) {
904 return be->be_attribute( be, conn, op, target, e_ndn,
908 return LDAP_UNWILLING_TO_PERFORM;
911 Attribute *backend_operational(
917 #ifdef SLAPD_SCHEMA_DN
918 a = ch_malloc( sizeof( Attribute ) );
919 a->a_desc = ad_dup( slap_schema.si_ad_subschemaSubentry );
921 /* Should be backend specific */
922 a->a_vals = ch_malloc( 2 * sizeof( struct berval * ) );
923 a->a_vals[0] = ber_bvstrdup( SLAPD_SCHEMA_DN );