3 * Copyright 1998-2002 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 * If a module is configured as dynamic, its header should not
23 * get included into slapd. While this is a general rule and does
24 * not have much of an effect in UNIX, this rule should be adhered
25 * to for Windows, where dynamic object code should not be implicitly
26 * imported into slapd without appropriate __declspec(dllimport) directives.
29 #if defined(SLAPD_BDB) && !defined(SLAPD_BDB_DYNAMIC)
30 #include "back-bdb/external.h"
32 #if defined(SLAPD_DNSSRV) && !defined(SLAPD_DNSSRV_DYNAMIC)
33 #include "back-dnssrv/external.h"
35 #if defined(SLAPD_LDAP) && !defined(SLAPD_LDAP_DYNAMIC)
36 #include "back-ldap/external.h"
38 #if defined(SLAPD_LDBM) && !defined(SLAPD_LDBM_DYNAMIC)
39 #include "back-ldbm/external.h"
41 #if defined(SLAPD_META) && !defined(SLAPD_META_DYNAMIC)
42 #include "back-meta/external.h"
44 #if defined(SLAPD_MONITOR) && !defined(SLAPD_MONITOR_DYNAMIC)
45 #include "back-monitor/external.h"
47 #if defined(SLAPD_PASSWD) && !defined(SLAPD_PASSWD_DYNAMIC)
48 #include "back-passwd/external.h"
50 #if defined(SLAPD_PERL) && !defined(SLAPD_PERL_DYNAMIC)
51 #include "back-perl/external.h"
53 #if defined(SLAPD_SHELL) && !defined(SLAPD_SHELL_DYNAMIC)
54 #include "back-shell/external.h"
56 #if defined(SLAPD_TCL) && !defined(SLAPD_TCL_DYNAMIC)
57 #include "back-tcl/external.h"
59 #if defined(SLAPD_SQL) && !defined(SLAPD_SQL_DYNAMIC)
60 #include "back-sql/external.h"
62 #if defined(SLAPD_PRIVATE) && !defined(SLAPD_PRIVATE_DYNAMIC)
63 #include "private/external.h"
66 static BackendInfo binfo[] = {
67 #if defined(SLAPD_BDB) && !defined(SLAPD_BDB_DYNAMIC)
68 {"bdb", bdb_initialize},
70 #if defined(SLAPD_DNSSRV) && !defined(SLAPD_DNSSRV_DYNAMIC)
71 {"dnssrv", dnssrv_back_initialize},
73 #if defined(SLAPD_LDAP) && !defined(SLAPD_LDAP_DYNAMIC)
74 {"ldap", ldap_back_initialize},
76 #if defined(SLAPD_LDBM) && !defined(SLAPD_LDBM_DYNAMIC)
77 {"ldbm", ldbm_back_initialize},
79 #if defined(SLAPD_META) && !defined(SLAPD_META_DYNAMIC)
80 {"meta", meta_back_initialize},
82 #if defined(SLAPD_MONITOR) && !defined(SLAPD_MONITOR_DYNAMIC)
83 {"monitor", monitor_back_initialize},
85 #if defined(SLAPD_PASSWD) && !defined(SLAPD_PASSWD_DYNAMIC)
86 {"passwd", passwd_back_initialize},
88 #if defined(SLAPD_PERL) && !defined(SLAPD_PERL_DYNAMIC)
89 {"perl", perl_back_initialize},
91 #if defined(SLAPD_SHELL) && !defined(SLAPD_SHELL_DYNAMIC)
92 {"shell", shell_back_initialize},
94 #if defined(SLAPD_TCL) && !defined(SLAPD_TCL_DYNAMIC)
95 {"tcl", tcl_back_initialize},
97 #if defined(SLAPD_SQL) && !defined(SLAPD_SQL_DYNAMIC)
98 {"sql", sql_back_initialize},
100 /* for any private backend */
101 #if defined(SLAPD_PRIVATE) && !defined(SLAPD_PRIVATE_DYNAMIC)
102 {"private", private_back_initialize},
107 int nBackendInfo = 0;
108 BackendInfo *backendInfo = NULL;
111 BackendDB *backendDB = NULL;
113 int backend_init(void)
117 if((nBackendInfo != 0) || (backendInfo != NULL)) {
118 /* already initialized */
120 LDAP_LOG(( "backend", LDAP_LEVEL_ERR,
121 "backend_init: backend already initialized\n" ));
123 Debug( LDAP_DEBUG_ANY,
124 "backend_init: already initialized.\n", 0, 0, 0 );
130 binfo[nBackendInfo].bi_type != NULL;
133 rc = binfo[nBackendInfo].bi_init( &binfo[nBackendInfo] );
137 LDAP_LOG(( "backend", LDAP_LEVEL_INFO,
138 "backend_init: initialized for type \"%s\"\n",
139 binfo[nBackendInfo].bi_type ));
141 Debug( LDAP_DEBUG_ANY,
142 "backend_init: initialized for type \"%s\"\n",
143 binfo[nBackendInfo].bi_type, 0, 0 );
145 /* destroy those we've already inited */
150 if ( binfo[nBackendInfo].bi_destroy ) {
151 binfo[nBackendInfo].bi_destroy(
152 &binfo[nBackendInfo] );
159 if ( nBackendInfo > 0) {
169 LDAP_LOG(( "backend", LDAP_LEVEL_ERR,
170 "backend_init: failed\n" ));
172 Debug( LDAP_DEBUG_ANY,
173 "backend_init: failed\n",
178 #endif /* SLAPD_MODULES */
181 int backend_add(BackendInfo *aBackendInfo)
185 if ((rc = aBackendInfo->bi_init(aBackendInfo)) != 0) {
187 LDAP_LOG(( "backend", LDAP_LEVEL_ERR,
188 "backend_add: initialization for type \"%s\" failed\n",
189 aBackendInfo->bi_type ));
191 Debug( LDAP_DEBUG_ANY,
192 "backend_add: initialization for type \"%s\" failed\n",
193 aBackendInfo->bi_type, 0, 0 );
198 /* now add the backend type to the Backend Info List */
200 BackendInfo *newBackendInfo = 0;
202 /* if backendInfo == binfo no deallocation of old backendInfo */
203 if (backendInfo == binfo) {
204 newBackendInfo = ch_calloc(nBackendInfo + 1, sizeof(BackendInfo));
205 AC_MEMCPY(newBackendInfo, backendInfo, sizeof(BackendInfo) *
208 newBackendInfo = ch_realloc(backendInfo, sizeof(BackendInfo) *
211 AC_MEMCPY(&newBackendInfo[nBackendInfo], aBackendInfo,
212 sizeof(BackendInfo));
213 backendInfo = newBackendInfo;
220 int backend_startup(Backend *be)
225 if( ! ( nBackendDB > 0 ) ) {
228 LDAP_LOG(( "backend", LDAP_LEVEL_INFO,
229 "backend_startup: %d databases to startup. \n",
232 Debug( LDAP_DEBUG_ANY,
233 "backend_startup: %d databases to startup.\n",
240 /* startup a specific backend database */
242 LDAP_LOG(( "backend", LDAP_LEVEL_DETAIL1,
243 "backend_startup: starting \"%s\"\n",
244 be->be_suffix[0]->bv_val ));
246 Debug( LDAP_DEBUG_TRACE,
247 "backend_startup: starting \"%s\"\n",
248 be->be_suffix[0]->bv_val, 0, 0 );
251 if ( be->bd_info->bi_open ) {
252 rc = be->bd_info->bi_open( be->bd_info );
257 LDAP_LOG(( "backend", LDAP_LEVEL_CRIT,
258 "backend_startup: bi_open failed!\n" ));
260 Debug( LDAP_DEBUG_ANY,
261 "backend_startup: bi_open failed!\n",
268 if ( be->bd_info->bi_db_open ) {
269 rc = be->bd_info->bi_db_open( be );
274 LDAP_LOG(( "backend", LDAP_LEVEL_CRIT,
275 "backend_startup: bi_db_open failed! (%d)\n", rc ));
277 Debug( LDAP_DEBUG_ANY,
278 "backend_startup: bi_db_open failed! (%d)\n",
287 /* open each backend type */
288 for( i = 0; i < nBackendInfo; i++ ) {
289 if( backendInfo[i].bi_nDB == 0) {
290 /* no database of this type, don't open */
294 if( backendInfo[i].bi_open ) {
295 rc = backendInfo[i].bi_open(
301 LDAP_LOG(( "backend", LDAP_LEVEL_CRIT,
302 "backend_startup: bi_open %d failed!\n", i ));
304 Debug( LDAP_DEBUG_ANY,
305 "backend_startup: bi_open %d failed!\n",
312 /* open each backend database */
313 for( i = 0; i < nBackendDB; i++ ) {
314 /* append global access controls */
315 acl_append( &backendDB[i].be_acl, global_acl );
317 if ( backendDB[i].bd_info->bi_db_open ) {
318 rc = backendDB[i].bd_info->bi_db_open(
324 LDAP_LOG(( "backend", LDAP_LEVEL_CRIT,
325 "backend_startup: bi_db_open(%d) failed! (%d)\n",
328 Debug( LDAP_DEBUG_ANY,
329 "backend_startup: bi_db_open(%d) failed! (%d)\n",
339 int backend_num( Backend *be )
343 if( be == NULL ) return -1;
345 for( i = 0; i < nBackendDB; i++ ) {
346 if( be == &backendDB[i] ) return i;
351 int backend_shutdown( Backend *be )
357 /* shutdown a specific backend database */
359 if ( be->bd_info->bi_nDB == 0 ) {
360 /* no database of this type, we never opened it */
364 if ( be->bd_info->bi_db_close ) {
365 be->bd_info->bi_db_close( be );
368 if( be->bd_info->bi_close ) {
369 be->bd_info->bi_close( be->bd_info );
375 /* close each backend database */
376 for( i = 0; i < nBackendDB; i++ ) {
377 if ( backendDB[i].bd_info->bi_db_close ) {
378 backendDB[i].bd_info->bi_db_close(
384 LDAP_LOG(( "backend", LDAP_LEVEL_NOTICE,
385 "backend_shutdown: bi_close %s failed!\n",
386 backendDB[i].be_type ));
388 Debug( LDAP_DEBUG_ANY,
389 "backend_close: bi_close %s failed!\n",
390 backendDB[i].be_type, 0, 0 );
395 /* close each backend type */
396 for( i = 0; i < nBackendInfo; i++ ) {
397 if( backendInfo[i].bi_nDB == 0 ) {
398 /* no database of this type */
402 if( backendInfo[i].bi_close ) {
403 backendInfo[i].bi_close(
411 int backend_destroy(void)
416 /* destroy each backend database */
417 for( i = 0, bd = backendDB; i < nBackendDB; i++, bd++ ) {
418 if ( bd->bd_info->bi_db_destroy ) {
419 bd->bd_info->bi_db_destroy( bd );
421 ber_bvecfree( bd->be_suffix );
422 ber_bvecfree( bd->be_nsuffix );
423 if ( bd->be_rootdn.bv_val ) free( bd->be_rootdn.bv_val );
424 if ( bd->be_rootndn.bv_val ) free( bd->be_rootndn.bv_val );
425 if ( bd->be_rootpw.bv_val ) free( bd->be_rootpw.bv_val );
426 acl_destroy( bd->be_acl, global_acl );
430 /* destroy each backend type */
431 for( i = 0; i < nBackendInfo; i++ ) {
432 if( backendInfo[i].bi_destroy ) {
433 backendInfo[i].bi_destroy(
439 if (backendInfo != binfo) {
442 #endif /* SLAPD_MODULES */
450 BackendInfo* backend_info(const char *type)
454 /* search for the backend type */
455 for( i = 0; i < nBackendInfo; i++ ) {
456 if( strcasecmp(backendInfo[i].bi_type, type) == 0 ) {
457 return &backendInfo[i];
471 BackendInfo *bi = backend_info(type);
475 fprintf( stderr, "Unrecognized database type (%s)\n", type );
479 backendDB = (BackendDB *) ch_realloc(
481 (nBackendDB + 1) * sizeof(Backend) );
483 memset( &backendDB[nbackends], '\0', sizeof(Backend) );
485 be = &backends[nbackends++];
488 be->be_def_limit = deflimit;
489 be->be_dfltaccess = global_default_access;
491 be->be_restrictops = global_restrictops;
492 be->be_requires = global_requires;
493 be->be_ssf_set = global_ssf_set;
495 /* assign a default depth limit for alias deref */
496 be->be_max_deref_depth = SLAPD_DEFAULT_MAXDEREFDEPTH;
499 rc = bi->bi_db_init( be );
503 fprintf( stderr, "database init failed (%s)\n", type );
517 for ( i = 0; i < nbackends; i++ ) {
518 if ( backends[i].bd_info->bi_db_close ) {
519 (*backends[i].bd_info->bi_db_close)( &backends[i] );
531 ber_len_t len, dnlen = dn->bv_len;
534 for ( i = 0; i < nbackends; i++ ) {
535 for ( j = 0; backends[i].be_nsuffix != NULL &&
536 backends[i].be_nsuffix[j] != NULL; j++ )
538 if (( backends[i].be_flags & SLAP_BFLAG_GLUE_SUBORDINATE )
544 len = backends[i].be_nsuffix[j]->bv_len;
547 /* suffix is longer than DN */
551 if ( len && len < dnlen &&
552 ( !DN_SEPARATOR( dn->bv_val[(dnlen-len)-1] ) ||
553 DN_ESCAPE( dn->bv_val[(dnlen-len)-2] ) ) )
555 /* make sure we have a separator */
559 if ( strcmp( backends[i].be_nsuffix[j]->bv_val,
560 &dn->bv_val[dnlen-len] ) == 0 )
565 if( manageDSAit && len == dnlen ) {
572 assert( !be->be_ssf_set.sss_tls );
578 assert( be == NULL || !be->be_ssf_set.sss_tls );
585 struct berval *bvsuffix
590 for ( i = 0; be->be_nsuffix != NULL && be->be_nsuffix[i] != NULL; i++ ) {
591 if ( ber_bvcmp( be->be_nsuffix[i], bvsuffix ) == 0 ) {
600 be_isroot( Backend *be, struct berval *ndn )
602 if ( !ndn->bv_len ) {
606 if ( !be->be_rootndn.bv_len ) {
610 return dn_match( &be->be_rootndn, ndn );
614 be_isupdate( Backend *be, struct berval *ndn )
616 if ( !ndn->bv_len ) {
620 if ( !be->be_update_ndn.bv_len ) {
624 return dn_match( &be->be_update_ndn, ndn );
628 be_root_dn( Backend *be )
630 return &be->be_rootdn;
634 be_isroot_pw( Backend *be,
637 struct berval *cred )
641 if ( ! be_isroot( be, ndn ) ) {
645 if( be->be_rootpw.bv_len == 0 ) {
649 #if defined( SLAPD_CRYPT ) || defined( SLAPD_SPASSWD )
650 ldap_pvt_thread_mutex_lock( &passwd_mutex );
652 lutil_passwd_sasl_conn = conn->c_sasl_context;
656 result = lutil_passwd( &be->be_rootpw, cred, NULL );
658 #if defined( SLAPD_CRYPT ) || defined( SLAPD_SPASSWD )
660 lutil_passwd_sasl_conn = NULL;
662 ldap_pvt_thread_mutex_unlock( &passwd_mutex );
676 if ( be->be_release ) {
677 /* free and release entry from backend */
678 return be->be_release( be, conn, op, e, rw );
694 for ( i = 0; i < nbackends; i++ ) {
695 if ( backends[i].be_unbind ) {
696 (*backends[i].be_unbind)( &backends[i], conn, op );
704 backend_connection_init(
710 for ( i = 0; i < nbackends; i++ ) {
711 if ( backends[i].be_connection_init ) {
712 (*backends[i].be_connection_init)( &backends[i], conn);
720 backend_connection_destroy(
726 for ( i = 0; i < nbackends; i++ ) {
727 if ( backends[i].be_connection_destroy ) {
728 (*backends[i].be_connection_destroy)( &backends[i], conn);
736 backend_check_controls(
744 if( ctrls == NULL ) {
748 for( ; *ctrls != NULL ; ctrls++ ) {
749 if( (*ctrls)->ldctl_iscritical &&
750 !charray_inlist( be->be_controls, (*ctrls)->ldctl_oid ) )
752 *text = "control unavailable in context";
753 return LDAP_UNAVAILABLE_CRITICAL_EXTENSION;
761 backend_check_restrictions(
769 slap_mask_t restrictops;
770 slap_mask_t requires;
776 rc = backend_check_controls( be, conn, op, text );
778 if( rc != LDAP_SUCCESS ) {
782 restrictops = be->be_restrictops;
783 requires = be->be_requires;
784 ssf = &be->be_ssf_set;
787 restrictops = global_restrictops;
788 requires = global_requires;
789 ssf = &global_ssf_set;
792 switch( op->o_tag ) {
794 opflag = SLAP_RESTRICT_OP_ADD;
798 opflag = SLAP_RESTRICT_OP_BIND;
800 case LDAP_REQ_COMPARE:
801 opflag = SLAP_RESTRICT_OP_COMPARE;
803 case LDAP_REQ_DELETE:
805 opflag = SLAP_RESTRICT_OP_DELETE;
807 case LDAP_REQ_EXTENDED:
808 opflag = SLAP_RESTRICT_OP_EXTENDED;
810 case LDAP_REQ_MODIFY:
812 opflag = SLAP_RESTRICT_OP_MODIFY;
814 case LDAP_REQ_RENAME:
816 opflag = SLAP_RESTRICT_OP_RENAME;
818 case LDAP_REQ_SEARCH:
819 opflag = SLAP_RESTRICT_OP_SEARCH;
821 case LDAP_REQ_UNBIND:
825 *text = "restrict operations internal error";
829 if ( op->o_tag != LDAP_REQ_EXTENDED
830 || strcmp( (const char *) opdata, LDAP_EXOP_START_TLS ) )
832 /* these checks don't apply to StartTLS */
834 if( op->o_tag == LDAP_REQ_EXTENDED ) {
835 /* threat other extended operations as update ops */
839 if( op->o_transport_ssf < ssf->sss_transport ) {
840 *text = "transport confidentiality required";
841 return LDAP_CONFIDENTIALITY_REQUIRED;
844 if( op->o_tls_ssf < ssf->sss_tls ) {
846 *text = "TLS confidentiality required";
847 return LDAP_CONFIDENTIALITY_REQUIRED;
850 if( op->o_tag != LDAP_REQ_BIND || opdata == NULL ) {
851 /* these checks don't apply to SASL bind */
853 if( op->o_sasl_ssf < ssf->sss_sasl ) {
854 *text = "SASL confidentiality required";
855 return LDAP_CONFIDENTIALITY_REQUIRED;
858 if( op->o_ssf < ssf->sss_ssf ) {
859 *text = "confidentiality required";
860 return LDAP_CONFIDENTIALITY_REQUIRED;
865 if( op->o_transport_ssf < ssf->sss_update_transport ) {
866 *text = "transport update confidentiality required";
867 return LDAP_CONFIDENTIALITY_REQUIRED;
870 if( op->o_tls_ssf < ssf->sss_update_tls ) {
871 *text = "TLS update confidentiality required";
872 return LDAP_CONFIDENTIALITY_REQUIRED;
875 if( op->o_sasl_ssf < ssf->sss_update_sasl ) {
876 *text = "SASL update confidentiality required";
877 return LDAP_CONFIDENTIALITY_REQUIRED;
880 if( op->o_ssf < ssf->sss_update_ssf ) {
881 *text = "update confidentiality required";
882 return LDAP_CONFIDENTIALITY_REQUIRED;
885 if( op->o_ndn.bv_len == 0 ) {
886 *text = "modifications require authentication";
887 return LDAP_OPERATIONS_ERROR;
892 if ( op->o_tag != LDAP_REQ_BIND && ( op->o_tag != LDAP_REQ_EXTENDED ||
893 strcmp( (const char *) opdata, LDAP_EXOP_START_TLS ) ) )
895 /* these checks don't apply to Bind or StartTLS */
897 if( requires & SLAP_REQUIRE_STRONG ) {
898 /* should check mechanism */
899 if( op->o_authmech.bv_len == 0 || op->o_dn.bv_len == 0 )
901 *text = "strong authentication required";
902 return LDAP_STRONG_AUTH_REQUIRED;
906 if( requires & SLAP_REQUIRE_SASL ) {
907 if( op->o_authmech.bv_len == 0 || op->o_dn.bv_len == 0 )
909 *text = "SASL authentication required";
910 return LDAP_STRONG_AUTH_REQUIRED;
914 if( requires & SLAP_REQUIRE_AUTHC ) {
915 if( op->o_dn.bv_len == 0 ) {
916 *text = "authentication required";
917 return LDAP_UNWILLING_TO_PERFORM;
921 if( requires & SLAP_REQUIRE_BIND ) {
923 ldap_pvt_thread_mutex_lock( &conn->c_mutex );
924 version = conn->c_protocol;
925 ldap_pvt_thread_mutex_unlock( &conn->c_mutex );
928 /* no bind has occurred */
929 *text = "BIND required";
930 return LDAP_OPERATIONS_ERROR;
934 if( requires & SLAP_REQUIRE_LDAP_V3 ) {
935 if( op->o_protocol < LDAP_VERSION3 ) {
936 /* no bind has occurred */
937 *text = "operation restricted to LDAPv3 clients";
938 return LDAP_OPERATIONS_ERROR;
943 if( restrictops & opflag ) {
944 if( restrictops == SLAP_RESTRICT_OP_READS ) {
945 *text = "read operations restricted";
947 *text = "operation restricted";
949 return LDAP_UNWILLING_TO_PERFORM;
955 int backend_check_referrals(
962 int rc = LDAP_SUCCESS;
964 if( be->be_chk_referrals ) {
967 rc = be->be_chk_referrals( be,
968 conn, op, dn, ndn, &text );
970 if( rc != LDAP_SUCCESS && rc != LDAP_REFERRAL ) {
971 send_ldap_result( conn, op, rc,
972 NULL, text, NULL, NULL );
985 struct berval *gr_ndn,
986 struct berval *op_ndn,
987 ObjectClass *group_oc,
988 AttributeDescription *group_at
994 ldap_pvt_thread_mutex_lock( &op->o_abandonmutex );
996 ldap_pvt_thread_mutex_unlock( &op->o_abandonmutex );
997 if (i) return SLAPD_ABANDON;
999 if ( !dn_match( &target->e_nname, gr_ndn ) ) {
1000 /* we won't attempt to send it to a different backend */
1002 be = select_backend( gr_ndn, 0,
1003 (be->be_flags & SLAP_BFLAG_GLUE_INSTANCE));
1006 return LDAP_NO_SUCH_OBJECT;
1010 ldap_pvt_thread_mutex_lock( &conn->c_mutex );
1011 for (g = conn->c_groups; g; g=g->next) {
1012 if (g->be != be || g->oc != group_oc || g->at != group_at ||
1013 g->len != gr_ndn->bv_len)
1015 if (strcmp( g->ndn, gr_ndn->bv_val ) == 0)
1018 ldap_pvt_thread_mutex_unlock( &conn->c_mutex );
1022 if( be->be_group ) {
1023 int res = be->be_group( be, conn, op,
1024 target, gr_ndn, op_ndn,
1025 group_oc, group_at );
1027 if (op->o_tag != LDAP_REQ_BIND) {
1028 g = ch_malloc(sizeof(GroupAssertion) + gr_ndn->bv_len);
1033 g->len = gr_ndn->bv_len;
1034 strcpy(g->ndn, gr_ndn->bv_val);
1035 ldap_pvt_thread_mutex_lock( &conn->c_mutex );
1036 g->next = conn->c_groups;
1038 ldap_pvt_thread_mutex_unlock( &conn->c_mutex );
1044 return LDAP_UNWILLING_TO_PERFORM;
1054 AttributeDescription *entry_at,
1058 if ( target == NULL || !dn_match( &target->e_nname, edn ) ) {
1059 /* we won't attempt to send it to a different backend */
1061 be = select_backend( edn, 0,
1062 (be->be_flags & SLAP_BFLAG_GLUE_INSTANCE));
1065 return LDAP_NO_SUCH_OBJECT;
1069 if( be->be_attribute ) {
1070 return be->be_attribute( be, conn, op, target, edn,
1074 return LDAP_UNWILLING_TO_PERFORM;
1077 Attribute *backend_operational(
1082 AttributeName *attrs,
1085 Attribute *a = NULL, **ap = &a;
1087 #ifdef SLAPD_SCHEMA_DN
1088 *ap = slap_operational_subschemaSubentry();
1089 ap = &(*ap)->a_next;
1093 * If operational attributes (allegedly) are required,
1094 * and the backend supports specific operational attributes,
1095 * add them to the attribute list
1097 if ( ( opattrs || attrs ) && be && be->be_operational != NULL ) {
1098 ( void )be->be_operational( be, conn, op, e, attrs, opattrs, ap );