1 /* init.c - initialize monitor backend */
3 /* This work is part of OpenLDAP Software <http://www.openldap.org/>.
5 * Copyright 2001-2007 The OpenLDAP Foundation.
6 * Portions Copyright 2001-2003 Pierangelo Masarati.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted only as authorized by the OpenLDAP
13 * A copy of this license is available in file LICENSE in the
14 * top-level directory of the distribution or, alternatively, at
15 * <http://www.OpenLDAP.org/license.html>.
18 * This work was initially developed by Pierangelo Masarati for inclusion
19 * in OpenLDAP Software.
25 #include <ac/string.h>
31 #include "back-monitor.h"
35 #undef INTEGRATE_CORE_SCHEMA
38 * used by many functions to add description to entries
40 * WARNING: be_monitor may change as new databases are added,
41 * so it should not be used outside monitor_back_db_init()
42 * until monitor_back_db_open is called.
44 BackendDB *be_monitor;
46 static struct monitor_subsys_t **monitor_subsys;
47 static int monitor_subsys_opened;
48 static monitor_info_t monitor_info;
49 static const monitor_extra_t monitor_extra = {
50 monitor_back_is_configured,
51 monitor_back_get_subsys,
52 monitor_back_get_subsys_by_dn,
54 monitor_back_register_subsys,
55 monitor_back_register_entry,
56 monitor_back_register_entry_parent,
57 monitor_back_register_entry_attrs,
58 monitor_back_register_entry_callback,
60 monitor_back_unregister_entry,
61 monitor_back_unregister_entry_parent,
62 monitor_back_unregister_entry_attrs,
63 monitor_back_unregister_entry_callback
70 * the known subsystems are added to the subsystems
71 * array at backend initialization; other subsystems
72 * may be added by calling monitor_back_register_subsys()
73 * before the database is opened (e.g. by other backends
74 * or by overlays or modules).
76 static struct monitor_subsys_t known_monitor_subsys[] = {
78 SLAPD_MONITOR_BACKEND_NAME,
79 BER_BVNULL, BER_BVNULL, BER_BVNULL,
80 { BER_BVC( "This subsystem contains information about available backends." ),
82 MONITOR_F_PERSISTENT_CH,
83 monitor_subsys_backend_init,
89 SLAPD_MONITOR_CONN_NAME,
90 BER_BVNULL, BER_BVNULL, BER_BVNULL,
91 { BER_BVC( "This subsystem contains information about connections." ),
93 MONITOR_F_VOLATILE_CH,
94 monitor_subsys_conn_init,
100 SLAPD_MONITOR_DATABASE_NAME,
101 BER_BVNULL, BER_BVNULL, BER_BVNULL,
102 { BER_BVC( "This subsystem contains information about configured databases." ),
104 MONITOR_F_PERSISTENT_CH,
105 monitor_subsys_database_init,
111 SLAPD_MONITOR_LISTENER_NAME,
112 BER_BVNULL, BER_BVNULL, BER_BVNULL,
113 { BER_BVC( "This subsystem contains information about active listeners." ),
115 MONITOR_F_PERSISTENT_CH,
116 monitor_subsys_listener_init,
122 SLAPD_MONITOR_LOG_NAME,
123 BER_BVNULL, BER_BVNULL, BER_BVNULL,
124 { BER_BVC( "This subsystem contains information about logging." ),
125 BER_BVC( "Set the attribute \"managedInfo\" to the desired log levels." ),
128 monitor_subsys_log_init,
134 SLAPD_MONITOR_OPS_NAME,
135 BER_BVNULL, BER_BVNULL, BER_BVNULL,
136 { BER_BVC( "This subsystem contains information about performed operations." ),
138 MONITOR_F_PERSISTENT_CH,
139 monitor_subsys_ops_init,
145 SLAPD_MONITOR_OVERLAY_NAME,
146 BER_BVNULL, BER_BVNULL, BER_BVNULL,
147 { BER_BVC( "This subsystem contains information about available overlays." ),
149 MONITOR_F_PERSISTENT_CH,
150 monitor_subsys_overlay_init,
156 SLAPD_MONITOR_SASL_NAME,
157 BER_BVNULL, BER_BVNULL, BER_BVNULL,
158 { BER_BVC( "This subsystem contains information about SASL." ),
167 SLAPD_MONITOR_SENT_NAME,
168 BER_BVNULL, BER_BVNULL, BER_BVNULL,
169 { BER_BVC( "This subsystem contains statistics." ),
171 MONITOR_F_PERSISTENT_CH,
172 monitor_subsys_sent_init,
178 SLAPD_MONITOR_THREAD_NAME,
179 BER_BVNULL, BER_BVNULL, BER_BVNULL,
180 { BER_BVC( "This subsystem contains information about threads." ),
182 MONITOR_F_PERSISTENT_CH,
183 monitor_subsys_thread_init,
189 SLAPD_MONITOR_TIME_NAME,
190 BER_BVNULL, BER_BVNULL, BER_BVNULL,
191 { BER_BVC( "This subsystem contains information about time." ),
193 MONITOR_F_PERSISTENT_CH,
194 monitor_subsys_time_init,
200 SLAPD_MONITOR_TLS_NAME,
201 BER_BVNULL, BER_BVNULL, BER_BVNULL,
202 { BER_BVC( "This subsystem contains information about TLS." ),
211 SLAPD_MONITOR_RWW_NAME,
212 BER_BVNULL, BER_BVNULL, BER_BVNULL,
213 { BER_BVC( "This subsystem contains information about read/write waiters." ),
215 MONITOR_F_PERSISTENT_CH,
216 monitor_subsys_rww_init,
225 monitor_back_register_subsys(
226 monitor_subsys_t *ms )
230 if ( monitor_subsys ) {
231 for ( ; monitor_subsys[ i ] != NULL; i++ )
232 /* just count'em */ ;
235 monitor_subsys = ch_realloc( monitor_subsys,
236 ( 2 + i ) * sizeof( monitor_subsys_t * ) );
238 if ( monitor_subsys == NULL ) {
242 monitor_subsys[ i ] = ms;
243 monitor_subsys[ i + 1 ] = NULL;
245 /* if a subsystem is registered __AFTER__ subsystem
246 * initialization (depending on the sequence the databases
247 * are listed in slapd.conf), init it */
248 if ( monitor_subsys_opened ) {
250 /* FIXME: this should only be possible
251 * if be_monitor is already initialized */
252 assert( be_monitor != NULL );
254 if ( ms->mss_open && ( *ms->mss_open )( be_monitor, ms ) ) {
258 ms->mss_flags |= MONITOR_F_OPENED;
271 typedef struct entry_limbo_t {
275 struct berval el_ndn;
276 struct berval el_nbase;
278 struct berval el_filter;
279 monitor_callback_t *el_cb;
280 monitor_subsys_t *el_mss;
281 unsigned long el_flags;
282 struct entry_limbo_t *el_next;
286 monitor_back_is_configured( void )
288 return be_monitor != NULL;
292 monitor_back_register_entry(
294 monitor_callback_t *cb,
295 monitor_subsys_t *mss,
296 unsigned long flags )
300 if ( be_monitor == NULL ) {
301 Debug( LDAP_DEBUG_ANY,
302 "monitor_back_register_entry(\"%s\"): "
303 "monitor database not configured.\n",
304 e->e_name.bv_val, 0, 0 );
308 mi = ( monitor_info_t * )be_monitor->be_private;
310 assert( mi != NULL );
312 assert( e->e_private == NULL );
314 if ( monitor_subsys_opened ) {
315 Entry *e_parent = NULL,
318 struct berval pdn = BER_BVNULL;
319 monitor_entry_t *mp = NULL,
323 if ( monitor_cache_get( mi, &e->e_nname, &e_parent ) == 0 ) {
325 Debug( LDAP_DEBUG_ANY,
326 "monitor_back_register_entry(\"%s\"): "
328 e->e_name.bv_val, 0, 0 );
329 monitor_cache_release( mi, e_parent );
333 dnParent( &e->e_nname, &pdn );
334 if ( monitor_cache_get( mi, &pdn, &e_parent ) != 0 ) {
335 /* parent does not exist */
336 Debug( LDAP_DEBUG_ANY,
337 "monitor_back_register_entry(\"%s\"): "
338 "parent \"%s\" not found\n",
339 e->e_name.bv_val, pdn.bv_val, 0 );
343 assert( e_parent->e_private != NULL );
344 mp_parent = ( monitor_entry_t * )e_parent->e_private;
346 if ( mp_parent->mp_flags & MONITOR_F_VOLATILE ) {
347 /* entry is volatile; cannot append children */
348 Debug( LDAP_DEBUG_ANY,
349 "monitor_back_register_entry(\"%s\"): "
350 "parent \"%s\" is volatile\n",
351 e->e_name.bv_val, e_parent->e_name.bv_val, 0 );
356 mp = monitor_entrypriv_create();
358 Debug( LDAP_DEBUG_ANY,
359 "monitor_back_register_entry(\"%s\"): "
360 "monitor_entrypriv_create() failed\n",
361 e->e_name.bv_val, 0, 0 );
366 e_new = entry_dup( e );
367 if ( e_new == NULL ) {
368 Debug( LDAP_DEBUG_ANY,
369 "monitor_back_register_entry(\"%s\"): "
370 "entry_dup() failed\n",
371 e->e_name.bv_val, 0, 0 );
376 e_new->e_private = ( void * )mp;
379 mp->mp_flags = flags;
382 mp->mp_info = mp_parent->mp_info;
383 mp->mp_flags = mp_parent->mp_flags | MONITOR_F_SUB;
387 ep = &mp_parent->mp_children;
389 mp_parent = ( monitor_entry_t * )(*ep)->e_private;
390 ep = &mp_parent->mp_next;
394 if ( monitor_cache_add( mi, e_new ) ) {
395 Debug( LDAP_DEBUG_ANY,
396 "monitor_back_register_entry(\"%s\"): "
397 "unable to add entry\n",
398 e->e_name.bv_val, 0, 0 );
409 e_new->e_private = NULL;
415 monitor_cache_release( mi, e_parent );
419 entry_limbo_t **elpp, el = { 0 };
421 el.el_type = LIMBO_ENTRY;
423 el.el_e = entry_dup( e );
424 if ( el.el_e == NULL ) {
425 Debug( LDAP_DEBUG_ANY,
426 "monitor_back_register_entry(\"%s\"): "
427 "entry_dup() failed\n",
428 e->e_name.bv_val, 0, 0 );
436 for ( elpp = (entry_limbo_t **)&mi->mi_entry_limbo;
438 elpp = &(*elpp)->el_next )
441 *elpp = (entry_limbo_t *)ch_malloc( sizeof( entry_limbo_t ) );
442 if ( *elpp == NULL ) {
443 el.el_e->e_private = NULL;
444 entry_free( el.el_e );
456 monitor_back_register_entry_parent(
458 monitor_callback_t *cb,
459 monitor_subsys_t *mss,
461 struct berval *nbase,
463 struct berval *filter )
466 struct berval ndn = BER_BVNULL;
468 if ( be_monitor == NULL ) {
469 Debug( LDAP_DEBUG_ANY,
470 "monitor_back_register_entry_parent(base=\"%s\" scope=%s filter=\"%s\"): "
471 "monitor database not configured.\n",
472 BER_BVISNULL( nbase ) ? "" : nbase->bv_val,
473 ldap_pvt_scope2str( scope ),
474 BER_BVISNULL( filter ) ? "" : filter->bv_val );
478 mi = ( monitor_info_t * )be_monitor->be_private;
480 assert( mi != NULL );
482 assert( e->e_private == NULL );
484 if ( BER_BVISNULL( filter ) ) {
486 Debug( LDAP_DEBUG_ANY,
487 "monitor_back_register_entry_parent(\"\"): "
488 "need a valid filter\n",
493 if ( monitor_subsys_opened ) {
494 Entry *e_parent = NULL,
497 struct berval e_name = BER_BVNULL,
498 e_nname = BER_BVNULL;
499 monitor_entry_t *mp = NULL,
503 if ( monitor_search2ndn( nbase, scope, filter, &ndn ) ) {
504 /* entry does not exist */
505 Debug( LDAP_DEBUG_ANY,
506 "monitor_back_register_entry_parent(\"\"): "
507 "base=\"%s\" scope=%s filter=\"%s\": "
508 "unable to find entry\n",
509 nbase->bv_val ? nbase->bv_val : "\"\"",
510 ldap_pvt_scope2str( scope ),
515 if ( monitor_cache_get( mi, &ndn, &e_parent ) != 0 ) {
516 /* entry does not exist */
517 Debug( LDAP_DEBUG_ANY,
518 "monitor_back_register_entry_parent(\"%s\"): "
519 "parent entry does not exist\n",
525 assert( e_parent->e_private != NULL );
526 mp_parent = ( monitor_entry_t * )e_parent->e_private;
528 if ( mp_parent->mp_flags & MONITOR_F_VOLATILE ) {
529 /* entry is volatile; cannot append callback */
530 Debug( LDAP_DEBUG_ANY,
531 "monitor_back_register_entry_parent(\"%s\"): "
532 "entry is volatile\n",
533 e_parent->e_name.bv_val, 0, 0 );
538 build_new_dn( &e_name, &e_parent->e_name, &e->e_name, NULL );
539 build_new_dn( &e_nname, &e_parent->e_nname, &e->e_nname, NULL );
541 if ( monitor_cache_get( mi, &e_nname, &e_new ) == 0 ) {
542 /* entry already exists */
543 Debug( LDAP_DEBUG_ANY,
544 "monitor_back_register_entry_parent(\"%s\"): "
545 "entry already exists\n",
546 e_name.bv_val, 0, 0 );
547 monitor_cache_release( mi, e_new );
553 mp = monitor_entrypriv_create();
555 Debug( LDAP_DEBUG_ANY,
556 "monitor_back_register_entry_parent(\"%s\"): "
557 "monitor_entrypriv_create() failed\n",
558 e->e_name.bv_val, 0, 0 );
563 e_new = entry_dup( e );
564 if ( e_new == NULL ) {
565 Debug( LDAP_DEBUG_ANY,
566 "monitor_back_register_entry(\"%s\"): "
567 "entry_dup() failed\n",
568 e->e_name.bv_val, 0, 0 );
572 ch_free( e_new->e_name.bv_val );
573 ch_free( e_new->e_nname.bv_val );
574 e_new->e_name = e_name;
575 e_new->e_nname = e_nname;
577 e_new->e_private = ( void * )mp;
580 mp->mp_flags = flags;
583 mp->mp_info = mp_parent->mp_info;
584 mp->mp_flags = mp_parent->mp_flags | MONITOR_F_SUB;
588 ep = &mp_parent->mp_children;
590 mp_parent = ( monitor_entry_t * )(*ep)->e_private;
591 ep = &mp_parent->mp_next;
595 if ( monitor_cache_add( mi, e_new ) ) {
596 Debug( LDAP_DEBUG_ANY,
597 "monitor_back_register_entry(\"%s\"): "
598 "unable to add entry\n",
599 e->e_name.bv_val, 0, 0 );
605 if ( !BER_BVISNULL( &ndn ) ) {
606 ch_free( ndn.bv_val );
614 e_new->e_private = NULL;
620 monitor_cache_release( mi, e_parent );
624 entry_limbo_t **elpp = NULL, el = { 0 };
626 el.el_type = LIMBO_ENTRY_PARENT;
628 el.el_e = entry_dup( e );
629 if ( el.el_e == NULL ) {
630 Debug( LDAP_DEBUG_ANY,
631 "monitor_back_register_entry(\"%s\"): "
632 "entry_dup() failed\n",
633 e->e_name.bv_val, 0, 0 );
637 if ( !BER_BVISNULL( nbase ) ) {
638 ber_dupbv( &el.el_nbase, nbase );
642 if ( !BER_BVISNULL( filter ) ) {
643 ber_dupbv( &el.el_filter, filter );
650 for ( elpp = (entry_limbo_t **)&mi->mi_entry_limbo;
652 elpp = &(*elpp)->el_next )
655 *elpp = (entry_limbo_t *)ch_malloc( sizeof( entry_limbo_t ) );
656 if ( *elpp == NULL ) {
661 if ( *elpp != NULL ) {
666 if ( !BER_BVISNULL( &el.el_filter ) ) {
667 ch_free( el.el_filter.bv_val );
669 if ( !BER_BVISNULL( &el.el_nbase ) ) {
670 ch_free( el.el_nbase.bv_val );
672 entry_free( el.el_e );
681 monitor_search2ndn_cb( Operation *op, SlapReply *rs )
683 if ( rs->sr_type == REP_SEARCH ) {
684 struct berval *ndn = op->o_callback->sc_private;
686 if ( !BER_BVISNULL( ndn ) ) {
687 rs->sr_err = LDAP_SIZELIMIT_EXCEEDED;
688 ch_free( ndn->bv_val );
693 ber_dupbv( ndn, &rs->sr_entry->e_nname );
701 struct berval *nbase,
703 struct berval *filter,
706 Connection conn = { 0 };
707 OperationBuffer opbuf;
710 SlapReply rs = { 0 };
711 slap_callback cb = { NULL, monitor_search2ndn_cb, NULL, NULL };
716 if ( be_monitor == NULL ) {
720 op = (Operation *) &opbuf;
721 thrctx = ldap_pvt_thread_pool_context();
722 connection_fake_init( &conn, op, thrctx );
724 op->o_tag = LDAP_REQ_SEARCH;
726 /* use global malloc for now */
727 if ( op->o_tmpmemctx ) {
728 /* FIXME: connection_fake_init() calls slap_sl_mem_create, so we destroy it for now */
729 slap_sl_mem_destroy( NULL, op->o_tmpmemctx );
730 op->o_tmpmemctx = NULL;
732 op->o_tmpmfuncs = &ch_mfuncs;
734 op->o_bd = be_monitor;
735 if ( nbase == NULL || BER_BVISNULL( nbase ) ) {
736 ber_dupbv_x( &op->o_req_dn, &op->o_bd->be_suffix[ 0 ],
738 ber_dupbv_x( &op->o_req_ndn, &op->o_bd->be_nsuffix[ 0 ],
742 if ( dnPrettyNormal( NULL, nbase, &op->o_req_dn, &op->o_req_ndn,
743 op->o_tmpmemctx ) ) {
748 op->o_callback = &cb;
749 cb.sc_private = (void *)ndn;
751 op->ors_scope = scope;
752 op->ors_filter = str2filter_x( op, filter->bv_val );
753 if ( op->ors_filter == NULL ) {
757 ber_dupbv_x( &op->ors_filterstr, filter, op->o_tmpmemctx );
758 op->ors_attrs = slap_anlist_no_attrs;
759 op->ors_attrsonly = 0;
760 op->ors_tlimit = SLAP_NO_LIMIT;
762 op->ors_limit = NULL;
763 op->ors_deref = LDAP_DEREF_NEVER;
766 op->o_managedsait = SLAP_CONTROL_NONCRITICAL;
768 op->o_dn = be_monitor->be_rootdn;
769 op->o_ndn = be_monitor->be_rootndn;
771 rc = op->o_bd->be_search( op, &rs );
774 if ( op->ors_filter != NULL ) {
775 filter_free_x( op, op->ors_filter );
777 if ( !BER_BVISNULL( &op->ors_filterstr ) ) {
778 op->o_tmpfree( op->ors_filterstr.bv_val, op->o_tmpmemctx );
780 if ( !BER_BVISNULL( &op->o_req_dn ) ) {
781 op->o_tmpfree( op->o_req_dn.bv_val, op->o_tmpmemctx );
783 if ( !BER_BVISNULL( &op->o_req_ndn ) ) {
784 op->o_tmpfree( op->o_req_ndn.bv_val, op->o_tmpmemctx );
791 switch ( rs.sr_err ) {
793 if ( BER_BVISNULL( ndn ) ) {
798 case LDAP_SIZELIMIT_EXCEEDED:
800 if ( !BER_BVISNULL( ndn ) ) {
801 ber_memfree( ndn->bv_val );
812 monitor_back_register_entry_attrs(
813 struct berval *ndn_in,
815 monitor_callback_t *cb,
816 struct berval *nbase,
818 struct berval *filter )
821 struct berval ndn = BER_BVNULL;
822 char *fname = ( a == NULL ? "callback" : "attrs" );
824 if ( be_monitor == NULL ) {
825 char buf[ SLAP_TEXT_BUFLEN ];
827 snprintf( buf, sizeof( buf ),
828 "monitor_back_register_entry_%s(base=\"%s\" scope=%s filter=\"%s\"): "
829 "monitor database not configured.\n",
831 BER_BVISNULL( nbase ) ? "" : nbase->bv_val,
832 ldap_pvt_scope2str( scope ),
833 BER_BVISNULL( filter ) ? "" : filter->bv_val );
834 Debug( LDAP_DEBUG_ANY, "%s\n", buf, 0, 0 );
839 mi = ( monitor_info_t * )be_monitor->be_private;
841 assert( mi != NULL );
843 if ( ndn_in != NULL ) {
847 if ( a == NULL && cb == NULL ) {
852 if ( ( ndn_in == NULL || BER_BVISNULL( &ndn ) )
853 && BER_BVISNULL( filter ) )
856 Debug( LDAP_DEBUG_ANY,
857 "monitor_back_register_entry_%s(\"\"): "
858 "need a valid filter\n",
863 if ( monitor_subsys_opened ) {
865 Attribute **atp = NULL;
866 monitor_entry_t *mp = NULL;
867 monitor_callback_t **mcp = NULL;
871 if ( BER_BVISNULL( &ndn ) ) {
872 if ( monitor_search2ndn( nbase, scope, filter, &ndn ) ) {
873 char buf[ SLAP_TEXT_BUFLEN ];
875 snprintf( buf, sizeof( buf ),
876 "monitor_back_register_entry_%s(\"\"): "
877 "base=\"%s\" scope=%s filter=\"%s\": "
878 "unable to find entry\n",
880 nbase->bv_val ? nbase->bv_val : "\"\"",
881 ldap_pvt_scope2str( scope ),
884 /* entry does not exist */
885 Debug( LDAP_DEBUG_ANY, "%s\n", buf, 0, 0 );
892 if ( monitor_cache_get( mi, &ndn, &e ) != 0 ) {
893 /* entry does not exist */
894 Debug( LDAP_DEBUG_ANY,
895 "monitor_back_register_entry_%s(\"%s\"): "
896 "entry does not exist\n",
897 fname, ndn.bv_val, 0 );
902 assert( e->e_private != NULL );
903 mp = ( monitor_entry_t * )e->e_private;
905 if ( mp->mp_flags & MONITOR_F_VOLATILE ) {
906 /* entry is volatile; cannot append callback */
907 Debug( LDAP_DEBUG_ANY,
908 "monitor_back_register_entry_%s(\"%s\"): "
909 "entry is volatile\n",
910 fname, e->e_name.bv_val, 0 );
916 for ( atp = &e->e_attrs; *atp; atp = &(*atp)->a_next )
917 /* just get to last */ ;
919 for ( ; a != NULL; a = a->a_next ) {
920 assert( a->a_desc != NULL );
921 assert( a->a_vals != NULL );
923 if ( attr_find( e->e_attrs, a->a_desc ) ) {
924 attr_merge( e, a->a_desc, a->a_vals,
925 a->a_nvals == a->a_vals ? NULL : a->a_nvals );
928 *atp = attr_dup( a );
929 if ( *atp == NULL ) {
930 Debug( LDAP_DEBUG_ANY,
931 "monitor_back_register_entry_%s(\"%s\"): "
932 "attr_dup() failed\n",
933 fname, e->e_name.bv_val, 0 );
937 atp = &(*atp)->a_next;
943 for ( mcp = &mp->mp_cb; *mcp; mcp = &(*mcp)->mc_next )
946 /* NOTE: we do not clear cb->mc_next, so this function
947 * can be used to append a list of callbacks */
960 ber_memfree( ndn.bv_val );
964 monitor_cache_release( mi, e );
968 entry_limbo_t **elpp, el = { 0 };
970 el.el_type = LIMBO_ATTRS;
971 if ( !BER_BVISNULL( &ndn ) ) {
972 ber_dupbv( &el.el_ndn, &ndn );
974 if ( !BER_BVISNULL( nbase ) ) {
975 ber_dupbv( &el.el_nbase, nbase);
978 if ( !BER_BVISNULL( filter ) ) {
979 ber_dupbv( &el.el_filter, filter );
982 el.el_a = attrs_dup( a );
985 for ( elpp = (entry_limbo_t **)&mi->mi_entry_limbo;
987 elpp = &(*elpp)->el_next )
990 *elpp = (entry_limbo_t *)ch_malloc( sizeof( entry_limbo_t ) );
991 if ( *elpp == NULL ) {
992 el.el_e->e_private = NULL;
993 entry_free( el.el_e );
997 if ( *elpp != NULL ) {
1002 if ( !BER_BVISNULL( &el.el_filter ) ) {
1003 ch_free( el.el_filter.bv_val );
1005 if ( el.el_a != NULL ) {
1006 attrs_free( el.el_a );
1008 if ( !BER_BVISNULL( &el.el_nbase ) ) {
1009 ch_free( &el.el_nbase.bv_val );
1011 if ( !BER_BVISNULL( &el.el_ndn ) ) {
1012 ch_free( el.el_ndn.bv_val );
1022 monitor_back_register_entry_callback(
1024 monitor_callback_t *cb,
1025 struct berval *nbase,
1027 struct berval *filter )
1029 return monitor_back_register_entry_attrs( ndn, NULL, cb,
1030 nbase, scope, filter );
1034 * TODO: add corresponding calls to remove installed callbacks, entries
1035 * and so, in case the entity that installed them is removed (e.g. a
1036 * database, via back-config)
1039 monitor_back_unregister_entry(
1040 struct berval *ndn )
1044 if ( be_monitor == NULL ) {
1045 Debug( LDAP_DEBUG_ANY,
1046 "monitor_back_unregister_entry(\"%s\"): "
1047 "monitor database not configured.\n",
1048 ndn->bv_val, 0, 0 );
1053 /* entry will be regularly freed, and resources released
1054 * according to callbacks */
1055 if ( slapd_shutdown ) {
1059 mi = ( monitor_info_t * )be_monitor->be_private;
1061 assert( mi != NULL );
1063 if ( monitor_subsys_opened ) {
1065 monitor_entry_t *mp = NULL;
1066 monitor_callback_t *cb = NULL;
1068 if ( monitor_cache_remove( mi, ndn, &e ) != 0 ) {
1069 /* entry does not exist */
1070 Debug( LDAP_DEBUG_ANY,
1071 "monitor_back_unregister_entry(\"%s\"): "
1072 "entry removal failed.\n",
1073 ndn->bv_val, 0, 0 );
1077 mp = (monitor_entry_t *)e->e_private;
1078 assert( mp != NULL );
1080 for ( cb = mp->mp_cb; cb != NULL; ) {
1081 monitor_callback_t *next = cb->mc_next;
1083 if ( cb->mc_free ) {
1084 (void)cb->mc_free( e, &cb->mc_private );
1092 e->e_private = NULL;
1096 entry_limbo_t **elpp;
1098 for ( elpp = (entry_limbo_t **)&mi->mi_entry_limbo;
1100 elpp = &(*elpp)->el_next )
1102 entry_limbo_t *elp = *elpp;
1104 if ( elp->el_type == LIMBO_ENTRY
1105 && dn_match( ndn, &elp->el_e->e_nname ) )
1107 monitor_callback_t *cb, *next;
1109 for ( cb = elp->el_cb; cb; cb = next ) {
1110 /* FIXME: call callbacks? */
1114 assert( elp->el_e != NULL );
1115 elp->el_e->e_private = NULL;
1116 entry_free( elp->el_e );
1117 *elpp = elp->el_next;
1124 if ( elpp != NULL ) {
1125 /* not found! where did it go? */
1134 monitor_back_unregister_entry_parent(
1135 struct berval *nrdn,
1136 monitor_callback_t *target_cb,
1137 struct berval *nbase,
1139 struct berval *filter )
1142 struct berval ndn = BER_BVNULL;
1144 if ( be_monitor == NULL ) {
1145 Debug( LDAP_DEBUG_ANY,
1146 "monitor_back_unregister_entry_parent(base=\"%s\" scope=%s filter=\"%s\"): "
1147 "monitor database not configured.\n",
1148 BER_BVISNULL( nbase ) ? "" : nbase->bv_val,
1149 ldap_pvt_scope2str( scope ),
1150 BER_BVISNULL( filter ) ? "" : filter->bv_val );
1155 /* entry will be regularly freed, and resources released
1156 * according to callbacks */
1157 if ( slapd_shutdown ) {
1161 mi = ( monitor_info_t * )be_monitor->be_private;
1163 assert( mi != NULL );
1165 if ( ( nrdn == NULL || BER_BVISNULL( nrdn ) )
1166 && BER_BVISNULL( filter ) )
1169 Debug( LDAP_DEBUG_ANY,
1170 "monitor_back_unregister_entry_parent(\"\"): "
1171 "need a valid filter\n",
1176 if ( monitor_subsys_opened ) {
1178 monitor_entry_t *mp = NULL;
1180 if ( monitor_search2ndn( nbase, scope, filter, &ndn ) ) {
1181 /* entry does not exist */
1182 Debug( LDAP_DEBUG_ANY,
1183 "monitor_back_unregister_entry_parent(\"\"): "
1184 "base=\"%s\" scope=%s filter=\"%s\": "
1185 "unable to find entry\n",
1186 nbase->bv_val ? nbase->bv_val : "\"\"",
1187 ldap_pvt_scope2str( scope ),
1192 if ( monitor_cache_remove( mi, &ndn, &e ) != 0 ) {
1193 /* entry does not exist */
1194 Debug( LDAP_DEBUG_ANY,
1195 "monitor_back_unregister_entry(\"%s\"): "
1196 "entry removal failed.\n",
1198 ber_memfree( ndn.bv_val );
1201 ber_memfree( ndn.bv_val );
1203 mp = (monitor_entry_t *)e->e_private;
1204 assert( mp != NULL );
1206 if ( target_cb != NULL ) {
1207 monitor_callback_t **cbp;
1209 for ( cbp = &mp->mp_cb; *cbp != NULL; cbp = &(*cbp)->mc_next ) {
1210 if ( *cbp == target_cb ) {
1211 if ( (*cbp)->mc_free ) {
1212 (void)(*cbp)->mc_free( e, &(*cbp)->mc_private );
1214 *cbp = (*cbp)->mc_next;
1215 ch_free( target_cb );
1223 e->e_private = NULL;
1227 entry_limbo_t **elpp;
1229 for ( elpp = (entry_limbo_t **)&mi->mi_entry_limbo;
1231 elpp = &(*elpp)->el_next )
1233 entry_limbo_t *elp = *elpp;
1235 if ( elp->el_type == LIMBO_ENTRY_PARENT
1236 && dn_match( nrdn, &elp->el_e->e_nname )
1237 && dn_match( nbase, &elp->el_nbase )
1238 && scope == elp->el_scope
1239 && bvmatch( filter, &elp->el_filter ) )
1241 monitor_callback_t *cb, *next;
1243 for ( cb = elp->el_cb; cb; cb = next ) {
1244 /* FIXME: call callbacks? */
1248 assert( elp->el_e != NULL );
1249 elp->el_e->e_private = NULL;
1250 entry_free( elp->el_e );
1251 if ( !BER_BVISNULL( &elp->el_nbase ) ) {
1252 ch_free( elp->el_nbase.bv_val );
1254 if ( !BER_BVISNULL( &elp->el_filter ) ) {
1255 ch_free( elp->el_filter.bv_val );
1257 *elpp = elp->el_next;
1264 if ( elpp != NULL ) {
1265 /* not found! where did it go? */
1274 monitor_back_unregister_entry_attrs(
1275 struct berval *ndn_in,
1276 Attribute *target_a,
1277 monitor_callback_t *target_cb,
1278 struct berval *nbase,
1280 struct berval *filter )
1283 struct berval ndn = BER_BVNULL;
1284 char *fname = ( target_a == NULL ? "callback" : "attrs" );
1286 if ( be_monitor == NULL ) {
1287 char buf[ SLAP_TEXT_BUFLEN ];
1289 snprintf( buf, sizeof( buf ),
1290 "monitor_back_unregister_entry_%s(base=\"%s\" scope=%s filter=\"%s\"): "
1291 "monitor database not configured.\n",
1293 BER_BVISNULL( nbase ) ? "" : nbase->bv_val,
1294 ldap_pvt_scope2str( scope ),
1295 BER_BVISNULL( filter ) ? "" : filter->bv_val );
1296 Debug( LDAP_DEBUG_ANY, "%s\n", buf, 0, 0 );
1301 /* entry will be regularly freed, and resources released
1302 * according to callbacks */
1303 if ( slapd_shutdown ) {
1307 mi = ( monitor_info_t * )be_monitor->be_private;
1309 assert( mi != NULL );
1311 if ( ndn_in != NULL ) {
1315 if ( target_a == NULL && target_cb == NULL ) {
1320 if ( ( ndn_in == NULL || BER_BVISNULL( &ndn ) )
1321 && BER_BVISNULL( filter ) )
1324 Debug( LDAP_DEBUG_ANY,
1325 "monitor_back_unregister_entry_%s(\"\"): "
1326 "need a valid filter\n",
1331 if ( monitor_subsys_opened ) {
1333 monitor_entry_t *mp = NULL;
1336 if ( BER_BVISNULL( &ndn ) ) {
1337 if ( monitor_search2ndn( nbase, scope, filter, &ndn ) ) {
1338 char buf[ SLAP_TEXT_BUFLEN ];
1340 snprintf( buf, sizeof( buf ),
1341 "monitor_back_unregister_entry_%s(\"\"): "
1342 "base=\"%s\" scope=%d filter=\"%s\": "
1343 "unable to find entry\n",
1345 nbase->bv_val ? nbase->bv_val : "\"\"",
1346 scope, filter->bv_val );
1348 /* entry does not exist */
1349 Debug( LDAP_DEBUG_ANY, "%s\n", buf, 0, 0 );
1356 if ( monitor_cache_get( mi, &ndn, &e ) != 0 ) {
1357 /* entry does not exist */
1358 Debug( LDAP_DEBUG_ANY,
1359 "monitor_back_unregister_entry(\"%s\"): "
1360 "entry removal failed.\n",
1365 mp = (monitor_entry_t *)e->e_private;
1366 assert( mp != NULL );
1368 if ( target_cb != NULL ) {
1369 monitor_callback_t **cbp;
1371 for ( cbp = &mp->mp_cb; *cbp != NULL; cbp = &(*cbp)->mc_next ) {
1372 if ( *cbp == target_cb ) {
1373 if ( (*cbp)->mc_free ) {
1374 (void)(*cbp)->mc_free( e, &(*cbp)->mc_private );
1376 *cbp = (*cbp)->mc_next;
1377 ch_free( target_cb );
1383 if ( target_a != NULL ) {
1386 for ( a = target_a; a != NULL; a = a->a_next ) {
1387 Modification mod = { 0 };
1389 char textbuf[ SLAP_TEXT_BUFLEN ];
1391 mod.sm_op = LDAP_MOD_DELETE;
1392 mod.sm_desc = a->a_desc;
1393 mod.sm_values = a->a_vals;
1394 mod.sm_nvalues = a->a_nvals;
1396 (void)modify_delete_values( e, &mod, 1,
1397 &text, textbuf, sizeof( textbuf ) );
1402 ber_memfree( ndn.bv_val );
1406 monitor_cache_release( mi, e );
1410 entry_limbo_t **elpp;
1412 for ( elpp = (entry_limbo_t **)&mi->mi_entry_limbo;
1414 elpp = &(*elpp)->el_next )
1416 entry_limbo_t *elp = *elpp;
1418 if ( elp->el_type == LIMBO_ATTRS
1419 && dn_match( nbase, &elp->el_nbase )
1420 && scope == elp->el_scope
1421 && bvmatch( filter, &elp->el_filter ) )
1423 monitor_callback_t *cb, *next;
1425 for ( cb = elp->el_cb; cb; cb = next ) {
1426 /* FIXME: call callbacks? */
1430 assert( elp->el_e == NULL );
1431 if ( elp->el_a != NULL ) {
1432 attrs_free( elp->el_a );
1434 if ( !BER_BVISNULL( &elp->el_nbase ) ) {
1435 ch_free( elp->el_nbase.bv_val );
1437 if ( !BER_BVISNULL( &elp->el_filter ) ) {
1438 ch_free( elp->el_filter.bv_val );
1440 *elpp = elp->el_next;
1447 if ( elpp != NULL ) {
1448 /* not found! where did it go? */
1457 monitor_back_unregister_entry_callback(
1459 monitor_callback_t *cb,
1460 struct berval *nbase,
1462 struct berval *filter )
1464 /* TODO: lookup entry (by ndn, if not NULL, and/or by callback);
1465 * unregister the callback; if a is not null, unregister the
1466 * given attrs. In any case, call cb->cb_free */
1467 return monitor_back_unregister_entry_attrs( ndn,
1468 NULL, cb, nbase, scope, filter );
1472 monitor_back_get_subsys( const char *name )
1474 if ( monitor_subsys != NULL ) {
1477 for ( i = 0; monitor_subsys[ i ] != NULL; i++ ) {
1478 if ( strcasecmp( monitor_subsys[ i ]->mss_name, name ) == 0 ) {
1479 return monitor_subsys[ i ];
1488 monitor_back_get_subsys_by_dn(
1492 if ( monitor_subsys != NULL ) {
1496 for ( i = 0; monitor_subsys[ i ] != NULL; i++ ) {
1497 if ( dnIsSuffix( ndn, &monitor_subsys[ i ]->mss_ndn ) ) {
1498 return monitor_subsys[ i ];
1503 for ( i = 0; monitor_subsys[ i ] != NULL; i++ ) {
1504 if ( dn_match( ndn, &monitor_subsys[ i ]->mss_ndn ) ) {
1505 return monitor_subsys[ i ];
1515 monitor_back_initialize(
1518 static char *controls[] = {
1519 LDAP_CONTROL_MANAGEDSAIT,
1523 static ConfigTable monitorcfg[] = {
1524 { NULL, NULL, 0, 0, 0, ARG_IGNORED,
1525 NULL, NULL, NULL, NULL }
1528 static ConfigOCs monitorocs[] = {
1529 { "( OLcfgDbOc:4.1 "
1530 "NAME 'olcMonitorConfig' "
1531 "DESC 'Monitor backend configuration' "
1532 "SUP olcDatabaseConfig "
1534 Cft_Database, monitorcfg },
1543 { "( 1.3.6.1.4.1.4203.666.3.16.1 "
1545 "DESC 'OpenLDAP system monitoring' "
1546 "SUP top STRUCTURAL "
1555 ") )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1556 offsetof(monitor_info_t, mi_oc_monitor) },
1557 { "( 1.3.6.1.4.1.4203.666.3.16.2 "
1558 "NAME 'monitorServer' "
1559 "DESC 'Server monitoring root entry' "
1560 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1561 offsetof(monitor_info_t, mi_oc_monitorServer) },
1562 { "( 1.3.6.1.4.1.4203.666.3.16.3 "
1563 "NAME 'monitorContainer' "
1564 "DESC 'monitor container class' "
1565 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1566 offsetof(monitor_info_t, mi_oc_monitorContainer) },
1567 { "( 1.3.6.1.4.1.4203.666.3.16.4 "
1568 "NAME 'monitorCounterObject' "
1569 "DESC 'monitor counter class' "
1570 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1571 offsetof(monitor_info_t, mi_oc_monitorCounterObject) },
1572 { "( 1.3.6.1.4.1.4203.666.3.16.5 "
1573 "NAME 'monitorOperation' "
1574 "DESC 'monitor operation class' "
1575 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1576 offsetof(monitor_info_t, mi_oc_monitorOperation) },
1577 { "( 1.3.6.1.4.1.4203.666.3.16.6 "
1578 "NAME 'monitorConnection' "
1579 "DESC 'monitor connection class' "
1580 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1581 offsetof(monitor_info_t, mi_oc_monitorConnection) },
1582 { "( 1.3.6.1.4.1.4203.666.3.16.7 "
1583 "NAME 'managedObject' "
1584 "DESC 'monitor managed entity class' "
1585 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1586 offsetof(monitor_info_t, mi_oc_managedObject) },
1587 { "( 1.3.6.1.4.1.4203.666.3.16.8 "
1588 "NAME 'monitoredObject' "
1589 "DESC 'monitor monitored entity class' "
1590 "SUP monitor STRUCTURAL )", SLAP_OC_OPERATIONAL|SLAP_OC_HIDE,
1591 offsetof(monitor_info_t, mi_oc_monitoredObject) },
1594 { "( 1.3.6.1.4.1.4203.666.1.55.1 "
1595 "NAME 'monitoredInfo' "
1596 "DESC 'monitored info' "
1598 "EQUALITY caseIgnoreMatch "
1599 "SUBSTR caseIgnoreSubstringsMatch "
1600 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.15{32768} "
1601 "NO-USER-MODIFICATION "
1602 "USAGE dSAOperation )", SLAP_AT_HIDE,
1603 offsetof(monitor_info_t, mi_ad_monitoredInfo) },
1604 { "( 1.3.6.1.4.1.4203.666.1.55.2 "
1605 "NAME 'managedInfo' "
1606 "DESC 'monitor managed info' "
1607 "SUP name )", SLAP_AT_HIDE,
1608 offsetof(monitor_info_t, mi_ad_managedInfo) },
1609 { "( 1.3.6.1.4.1.4203.666.1.55.3 "
1610 "NAME 'monitorCounter' "
1611 "DESC 'monitor counter' "
1612 "EQUALITY integerMatch "
1613 "ORDERING integerOrderingMatch "
1614 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.27 "
1615 "NO-USER-MODIFICATION "
1616 "USAGE dSAOperation )", SLAP_AT_HIDE,
1617 offsetof(monitor_info_t, mi_ad_monitorCounter) },
1618 { "( 1.3.6.1.4.1.4203.666.1.55.4 "
1619 "NAME 'monitorOpCompleted' "
1620 "DESC 'monitor completed operations' "
1621 "SUP monitorCounter "
1622 "NO-USER-MODIFICATION "
1623 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1624 offsetof(monitor_info_t, mi_ad_monitorOpCompleted) },
1625 { "( 1.3.6.1.4.1.4203.666.1.55.5 "
1626 "NAME 'monitorOpInitiated' "
1627 "DESC 'monitor initiated operations' "
1628 "SUP monitorCounter "
1629 "NO-USER-MODIFICATION "
1630 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1631 offsetof(monitor_info_t, mi_ad_monitorOpInitiated) },
1632 { "( 1.3.6.1.4.1.4203.666.1.55.6 "
1633 "NAME 'monitorConnectionNumber' "
1634 "DESC 'monitor connection number' "
1635 "SUP monitorCounter "
1636 "NO-USER-MODIFICATION "
1637 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1638 offsetof(monitor_info_t, mi_ad_monitorConnectionNumber) },
1639 { "( 1.3.6.1.4.1.4203.666.1.55.7 "
1640 "NAME 'monitorConnectionAuthzDN' "
1641 "DESC 'monitor connection authorization DN' "
1642 /* "SUP distinguishedName " */
1643 "EQUALITY distinguishedNameMatch "
1644 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.12 "
1645 "NO-USER-MODIFICATION "
1646 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1647 offsetof(monitor_info_t, mi_ad_monitorConnectionAuthzDN) },
1648 { "( 1.3.6.1.4.1.4203.666.1.55.8 "
1649 "NAME 'monitorConnectionLocalAddress' "
1650 "DESC 'monitor connection local address' "
1651 "SUP monitoredInfo "
1652 "NO-USER-MODIFICATION "
1653 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1654 offsetof(monitor_info_t, mi_ad_monitorConnectionLocalAddress) },
1655 { "( 1.3.6.1.4.1.4203.666.1.55.9 "
1656 "NAME 'monitorConnectionPeerAddress' "
1657 "DESC 'monitor connection peer address' "
1658 "SUP monitoredInfo "
1659 "NO-USER-MODIFICATION "
1660 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1661 offsetof(monitor_info_t, mi_ad_monitorConnectionPeerAddress) },
1662 { "( 1.3.6.1.4.1.4203.666.1.55.10 "
1663 "NAME 'monitorTimestamp' "
1664 "DESC 'monitor timestamp' "
1665 "EQUALITY generalizedTimeMatch "
1666 "ORDERING generalizedTimeOrderingMatch "
1667 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.24 "
1669 "NO-USER-MODIFICATION "
1670 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1671 offsetof(monitor_info_t, mi_ad_monitorTimestamp) },
1672 { "( 1.3.6.1.4.1.4203.666.1.55.11 "
1673 "NAME 'monitorOverlay' "
1674 "DESC 'name of overlays defined for a given database' "
1675 "SUP monitoredInfo "
1676 "NO-USER-MODIFICATION "
1677 "USAGE dSAOperation )", SLAP_AT_HIDE,
1678 offsetof(monitor_info_t, mi_ad_monitorOverlay) },
1679 { "( 1.3.6.1.4.1.4203.666.1.55.12 "
1681 "DESC 'read/write status of a given database' "
1682 "EQUALITY booleanMatch "
1683 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 "
1685 "USAGE dSAOperation )", SLAP_AT_HIDE,
1686 offsetof(monitor_info_t, mi_ad_readOnly) },
1687 { "( 1.3.6.1.4.1.4203.666.1.55.13 "
1688 "NAME 'restrictedOperation' "
1689 "DESC 'name of restricted operation for a given database' "
1690 "SUP managedInfo )", SLAP_AT_HIDE,
1691 offsetof(monitor_info_t, mi_ad_restrictedOperation ) },
1692 { "( 1.3.6.1.4.1.4203.666.1.55.14 "
1693 "NAME 'monitorConnectionProtocol' "
1694 "DESC 'monitor connection protocol' "
1695 "SUP monitoredInfo "
1696 "NO-USER-MODIFICATION "
1697 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1698 offsetof(monitor_info_t, mi_ad_monitorConnectionProtocol) },
1699 { "( 1.3.6.1.4.1.4203.666.1.55.15 "
1700 "NAME 'monitorConnectionOpsReceived' "
1701 "DESC 'monitor number of operations received by the connection' "
1702 "SUP monitorCounter "
1703 "NO-USER-MODIFICATION "
1704 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1705 offsetof(monitor_info_t, mi_ad_monitorConnectionOpsReceived) },
1706 { "( 1.3.6.1.4.1.4203.666.1.55.16 "
1707 "NAME 'monitorConnectionOpsExecuting' "
1708 "DESC 'monitor number of operations in execution within the connection' "
1709 "SUP monitorCounter "
1710 "NO-USER-MODIFICATION "
1711 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1712 offsetof(monitor_info_t, mi_ad_monitorConnectionOpsExecuting) },
1713 { "( 1.3.6.1.4.1.4203.666.1.55.17 "
1714 "NAME 'monitorConnectionOpsPending' "
1715 "DESC 'monitor number of pending operations within the connection' "
1716 "SUP monitorCounter "
1717 "NO-USER-MODIFICATION "
1718 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1719 offsetof(monitor_info_t, mi_ad_monitorConnectionOpsPending) },
1720 { "( 1.3.6.1.4.1.4203.666.1.55.18 "
1721 "NAME 'monitorConnectionOpsCompleted' "
1722 "DESC 'monitor number of operations completed within the connection' "
1723 "SUP monitorCounter "
1724 "NO-USER-MODIFICATION "
1725 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1726 offsetof(monitor_info_t, mi_ad_monitorConnectionOpsCompleted) },
1727 { "( 1.3.6.1.4.1.4203.666.1.55.19 "
1728 "NAME 'monitorConnectionGet' "
1729 "DESC 'number of times connection_get() was called so far' "
1730 "SUP monitorCounter "
1731 "NO-USER-MODIFICATION "
1732 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1733 offsetof(monitor_info_t, mi_ad_monitorConnectionGet) },
1734 { "( 1.3.6.1.4.1.4203.666.1.55.20 "
1735 "NAME 'monitorConnectionRead' "
1736 "DESC 'number of times connection_read() was called so far' "
1737 "SUP monitorCounter "
1738 "NO-USER-MODIFICATION "
1739 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1740 offsetof(monitor_info_t, mi_ad_monitorConnectionRead) },
1741 { "( 1.3.6.1.4.1.4203.666.1.55.21 "
1742 "NAME 'monitorConnectionWrite' "
1743 "DESC 'number of times connection_write() was called so far' "
1744 "SUP monitorCounter "
1745 "NO-USER-MODIFICATION "
1746 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1747 offsetof(monitor_info_t, mi_ad_monitorConnectionWrite) },
1748 { "( 1.3.6.1.4.1.4203.666.1.55.22 "
1749 "NAME 'monitorConnectionMask' "
1750 "DESC 'monitor connection mask' "
1751 "SUP monitoredInfo "
1752 "NO-USER-MODIFICATION "
1753 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1754 offsetof(monitor_info_t, mi_ad_monitorConnectionMask) },
1755 { "( 1.3.6.1.4.1.4203.666.1.55.23 "
1756 "NAME 'monitorConnectionListener' "
1757 "DESC 'monitor connection listener' "
1758 "SUP monitoredInfo "
1759 "NO-USER-MODIFICATION "
1760 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1761 offsetof(monitor_info_t, mi_ad_monitorConnectionListener) },
1762 { "( 1.3.6.1.4.1.4203.666.1.55.24 "
1763 "NAME 'monitorConnectionPeerDomain' "
1764 "DESC 'monitor connection peer domain' "
1765 "SUP monitoredInfo "
1766 "NO-USER-MODIFICATION "
1767 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1768 offsetof(monitor_info_t, mi_ad_monitorConnectionPeerDomain) },
1769 { "( 1.3.6.1.4.1.4203.666.1.55.25 "
1770 "NAME 'monitorConnectionStartTime' "
1771 "DESC 'monitor connection start time' "
1772 "SUP monitorTimestamp "
1774 "NO-USER-MODIFICATION "
1775 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1776 offsetof(monitor_info_t, mi_ad_monitorConnectionStartTime) },
1777 { "( 1.3.6.1.4.1.4203.666.1.55.26 "
1778 "NAME 'monitorConnectionActivityTime' "
1779 "DESC 'monitor connection activity time' "
1780 "SUP monitorTimestamp "
1782 "NO-USER-MODIFICATION "
1783 "USAGE dSAOperation )", SLAP_AT_FINAL|SLAP_AT_HIDE,
1784 offsetof(monitor_info_t, mi_ad_monitorConnectionActivityTime) },
1785 { "( 1.3.6.1.4.1.4203.666.1.55.27 "
1786 "NAME 'monitorIsShadow' "
1787 "DESC 'TRUE if the database is shadow' "
1788 "EQUALITY booleanMatch "
1789 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 "
1791 "USAGE dSAOperation )", SLAP_AT_HIDE,
1792 offsetof(monitor_info_t, mi_ad_monitorIsShadow) },
1793 { "( 1.3.6.1.4.1.4203.666.1.55.28 "
1794 "NAME 'monitorUpdateRef' "
1795 "DESC 'update referral for shadow databases' "
1796 "SUP monitoredInfo "
1798 "USAGE dSAOperation )", SLAP_AT_HIDE,
1799 offsetof(monitor_info_t, mi_ad_monitorUpdateRef) },
1800 { "( 1.3.6.1.4.1.4203.666.1.55.29 "
1801 "NAME 'monitorRuntimeConfig' "
1802 "DESC 'TRUE if component allows runtime configuration' "
1803 "EQUALITY booleanMatch "
1804 "SYNTAX 1.3.6.1.4.1.1466.115.121.1.7 "
1806 "USAGE dSAOperation )", SLAP_AT_HIDE,
1807 offsetof(monitor_info_t, mi_ad_monitorRuntimeConfig) },
1815 { "olmAttributes", "1.3.6.1.4.1.4203.666.1.55" },
1816 { "olmSubSystemAttributes", "olmAttributes:0" },
1817 { "olmGenericAttributes", "olmSubSystemAttributes:0" },
1818 { "olmDatabaseAttributes", "olmSubSystemAttributes:1" },
1820 /* for example, back-bdb specific attrs
1821 * are in "olmDatabaseAttributes:1"
1823 * NOTE: developers, please record here OID assignments
1824 * for other modules */
1826 { "olmObjectClasses", "1.3.6.1.4.1.4203.666.3.16" },
1827 { "olmSubSystemObjectClasses", "olmObjectClasses:0" },
1828 { "olmGenericObjectClasses", "olmSubSystemObjectClasses:0" },
1829 { "olmDatabaseObjectClasses", "olmSubSystemObjectClasses:1" },
1831 /* for example, back-bdb specific objectClasses
1832 * are in "olmDatabaseObjectClasses:1"
1834 * NOTE: developers, please record here OID assignments
1835 * for other modules */
1841 monitor_info_t *mi = &monitor_info;
1845 argv[ 0 ] = "monitor";
1850 for ( i = 0; s_oid[ i ].name; i++ ) {
1851 argv[ 1 ] = s_oid[ i ].name;
1852 argv[ 2 ] = s_oid[ i ].oid;
1854 if ( parse_oidm( &c, 0, NULL ) != 0 ) {
1855 Debug( LDAP_DEBUG_ANY,
1856 "monitor_back_initialize: unable to add "
1857 "objectIdentifier \"%s=%s\"\n",
1858 s_oid[ i ].name, s_oid[ i ].oid, 0 );
1863 /* schema integration */
1864 for ( i = 0; mat[ i ].schema; i++ ) {
1866 AttributeDescription **ad =
1867 ((AttributeDescription **)&(((char *)mi)[ mat[ i ].offset ]));
1870 code = register_at( mat[ i ].schema, ad, 0 );
1873 Debug( LDAP_DEBUG_ANY,
1874 "monitor_back_db_init: register_at failed\n", 0, 0, 0 );
1877 (*ad)->ad_type->sat_flags |= mat[ i ].flags;
1880 for ( i = 0; moc[ i ].schema; i++ ) {
1883 ((ObjectClass **)&(((char *)mi)[ moc[ i ].offset ]));
1885 code = register_oc( moc[ i ].schema, Oc, 0 );
1887 Debug( LDAP_DEBUG_ANY,
1888 "monitor_back_db_init: register_oc failed\n", 0, 0, 0 );
1891 (*Oc)->soc_flags |= moc[ i ].flags;
1894 bi->bi_controls = controls;
1898 bi->bi_config = monitor_back_config;
1902 bi->bi_db_init = monitor_back_db_init;
1904 bi->bi_db_config = monitor_back_db_config;
1906 bi->bi_db_open = monitor_back_db_open;
1907 bi->bi_db_close = 0;
1908 bi->bi_db_destroy = monitor_back_db_destroy;
1910 bi->bi_op_bind = monitor_back_bind;
1911 bi->bi_op_unbind = 0;
1912 bi->bi_op_search = monitor_back_search;
1913 bi->bi_op_compare = monitor_back_compare;
1914 bi->bi_op_modify = monitor_back_modify;
1915 bi->bi_op_modrdn = 0;
1917 bi->bi_op_delete = 0;
1918 bi->bi_op_abandon = 0;
1920 bi->bi_extended = 0;
1922 bi->bi_entry_release_rw = 0;
1923 bi->bi_chk_referrals = 0;
1924 bi->bi_operational = monitor_back_operational;
1927 * hooks for slap tools
1929 bi->bi_tool_entry_open = 0;
1930 bi->bi_tool_entry_close = 0;
1931 bi->bi_tool_entry_first = 0;
1932 bi->bi_tool_entry_next = 0;
1933 bi->bi_tool_entry_get = 0;
1934 bi->bi_tool_entry_put = 0;
1935 bi->bi_tool_entry_reindex = 0;
1936 bi->bi_tool_sync = 0;
1937 bi->bi_tool_dn2id_get = 0;
1938 bi->bi_tool_id2entry_get = 0;
1939 bi->bi_tool_entry_modify = 0;
1941 bi->bi_connection_init = 0;
1942 bi->bi_connection_destroy = 0;
1944 bi->bi_extra = (void *)&monitor_extra;
1947 * configuration objectClasses (fake)
1949 bi->bi_cf_ocs = monitorocs;
1951 rc = config_register_schema( monitorcfg, monitorocs );
1960 monitor_back_db_init(
1964 struct berval dn = BER_BVC( SLAPD_MONITOR_DN ),
1969 monitor_subsys_t *ms;
1974 for ( ms = known_monitor_subsys; ms->mss_name != NULL; ms++ ) {
1975 if ( monitor_back_register_subsys( ms ) ) {
1981 * database monitor can be defined once only
1983 if ( be_monitor != NULL ) {
1984 Debug( LDAP_DEBUG_ANY,
1985 "only one monitor database is allowed\n", 0, 0, 0 );
1990 /* indicate system schema supported */
1991 SLAP_BFLAGS(be) |= SLAP_BFLAG_MONITOR;
1993 rc = dnPrettyNormal( NULL, &dn, &pdn, &ndn, NULL );
1994 if( rc != LDAP_SUCCESS ) {
1995 Debug( LDAP_DEBUG_ANY,
1996 "unable to normalize/pretty monitor DN \"%s\" (%d)\n",
2001 ber_bvarray_add( &be->be_suffix, &pdn );
2002 ber_bvarray_add( &be->be_nsuffix, &ndn );
2004 /* NOTE: only one monitor database is allowed,
2005 * so we use static storage */
2006 ldap_pvt_thread_mutex_init( &monitor_info.mi_cache_mutex );
2008 be->be_private = &monitor_info;
2010 be2 = select_backend( &ndn, 0, 0 );
2012 char *type = be2->bd_info->bi_type;
2014 if ( overlay_is_over( be2 ) ) {
2015 slap_overinfo *oi = (slap_overinfo *)be2->bd_info->bi_private;
2016 type = oi->oi_orig->bi_type;
2019 Debug( LDAP_DEBUG_ANY,
2020 "\"monitor\" database serving namingContext \"%s\" "
2021 "is hidden by \"%s\" database serving namingContext \"%s\".\n",
2022 pdn.bv_val, type, be2->be_nsuffix[ 0 ].bv_val );
2030 monitor_back_db_open(
2033 monitor_info_t *mi = (monitor_info_t *)be->be_private;
2034 struct monitor_subsys_t **ms;
2035 Entry *e, **ep, *root;
2036 monitor_entry_t *mp;
2038 struct berval bv, rdn = BER_BVC(SLAPD_MONITOR_DN);
2040 #ifdef HAVE_GMTIME_R
2043 static char tmbuf[ LDAP_LUTIL_GENTIME_BUFSIZE ];
2044 struct berval desc[] = {
2045 BER_BVC("This subtree contains monitoring/managing objects."),
2046 BER_BVC("This object contains information about this server."),
2047 BER_BVC("Most of the information is held in operational"
2048 " attributes, which must be explicitly requested."),
2051 assert( be_monitor != NULL );
2052 if ( be != be_monitor ) {
2059 #ifndef HAVE_GMTIME_R
2060 ldap_pvt_thread_mutex_lock( &gmtime_mutex );
2062 #ifdef HACK_LOCAL_TIME
2063 # ifdef HAVE_LOCALTIME_R
2064 tms = localtime_r( &starttime, &tm_buf );
2066 tms = localtime( &starttime );
2067 # endif /* HAVE_LOCALTIME_R */
2068 lutil_localtime( tmbuf, sizeof(tmbuf), tms, -timezone );
2069 #else /* !HACK_LOCAL_TIME */
2070 # ifdef HAVE_GMTIME_R
2071 tms = gmtime_r( &starttime, &tm_buf );
2073 tms = gmtime( &starttime );
2074 # endif /* HAVE_GMTIME_R */
2075 lutil_gentime( tmbuf, sizeof(tmbuf), tms );
2076 #endif /* !HACK_LOCAL_TIME */
2077 #ifndef HAVE_GMTIME_R
2078 ldap_pvt_thread_mutex_unlock( &gmtime_mutex );
2081 mi->mi_startTime.bv_val = tmbuf;
2082 mi->mi_startTime.bv_len = strlen( tmbuf );
2084 if ( BER_BVISEMPTY( &be->be_rootdn ) ) {
2085 BER_BVSTR( &mi->mi_creatorsName, SLAPD_ANONYMOUS );
2086 BER_BVSTR( &mi->mi_ncreatorsName, SLAPD_ANONYMOUS );
2088 mi->mi_creatorsName = be->be_rootdn;
2089 mi->mi_ncreatorsName = be->be_rootndn;
2093 * creates the "cn=Monitor" entry
2095 e = monitor_entry_stub( NULL, NULL, &rdn, mi->mi_oc_monitorServer, mi,
2099 Debug( LDAP_DEBUG_ANY,
2100 "unable to create \"%s\" entry\n",
2101 SLAPD_MONITOR_DN, 0, 0 );
2105 attr_merge_normalize( e, slap_schema.si_ad_description, desc, NULL );
2107 bv.bv_val = strchr( (char *) Versionstr, '$' );
2108 if ( bv.bv_val != NULL ) {
2112 for ( ; bv.bv_val[ 0 ] == ' '; bv.bv_val++ )
2115 end = strchr( bv.bv_val, '$' );
2116 if ( end != NULL ) {
2119 for ( ; end > bv.bv_val && end[ 0 ] == ' '; end-- )
2124 bv.bv_len = end - bv.bv_val;
2127 bv.bv_len = strlen( bv.bv_val );
2130 if ( attr_merge_normalize_one( e, mi->mi_ad_monitoredInfo,
2132 Debug( LDAP_DEBUG_ANY,
2133 "unable to add monitoredInfo to \"%s\" entry\n",
2134 SLAPD_MONITOR_DN, 0, 0 );
2139 mp = monitor_entrypriv_create();
2143 e->e_private = ( void * )mp;
2144 ep = &mp->mp_children;
2146 if ( monitor_cache_add( mi, e ) ) {
2147 Debug( LDAP_DEBUG_ANY,
2148 "unable to add entry \"%s\" to cache\n",
2149 SLAPD_MONITOR_DN, 0, 0 );
2155 * Create all the subsystem specific entries
2157 for ( i = 0; monitor_subsys[ i ] != NULL; i++ ) {
2158 int len = strlen( monitor_subsys[ i ]->mss_name );
2162 dn.bv_len = len + sizeof( "cn=" ) - 1;
2163 dn.bv_val = ch_calloc( sizeof( char ), dn.bv_len + 1 );
2164 strcpy( dn.bv_val, "cn=" );
2165 strcat( dn.bv_val, monitor_subsys[ i ]->mss_name );
2166 rc = dnPretty( NULL, &dn, &monitor_subsys[ i ]->mss_rdn, NULL );
2168 if ( rc != LDAP_SUCCESS ) {
2169 Debug( LDAP_DEBUG_ANY,
2170 "monitor RDN \"%s\" is invalid\n",
2175 e = monitor_entry_stub( &root->e_name, &root->e_nname,
2176 &monitor_subsys[ i ]->mss_rdn, mi->mi_oc_monitorContainer, mi,
2180 Debug( LDAP_DEBUG_ANY,
2181 "unable to create \"%s\" entry\n",
2182 monitor_subsys[ i ]->mss_dn.bv_val, 0, 0 );
2185 monitor_subsys[i]->mss_dn = e->e_name;
2186 monitor_subsys[i]->mss_ndn = e->e_nname;
2188 if ( !BER_BVISNULL( &monitor_subsys[ i ]->mss_desc[ 0 ] ) ) {
2189 attr_merge_normalize( e, slap_schema.si_ad_description,
2190 monitor_subsys[ i ]->mss_desc, NULL );
2193 mp = monitor_entrypriv_create();
2197 e->e_private = ( void * )mp;
2198 mp->mp_info = monitor_subsys[ i ];
2199 mp->mp_flags = monitor_subsys[ i ]->mss_flags;
2201 if ( monitor_cache_add( mi, e ) ) {
2202 Debug( LDAP_DEBUG_ANY,
2203 "unable to add entry \"%s\" to cache\n",
2204 monitor_subsys[ i ]->mss_dn.bv_val, 0, 0 );
2212 assert( be != NULL );
2214 be->be_private = mi;
2217 * opens the monitor backend subsystems
2219 for ( ms = monitor_subsys; ms[ 0 ] != NULL; ms++ ) {
2220 if ( ms[ 0 ]->mss_open && ( *ms[ 0 ]->mss_open )( be, ms[ 0 ] ) )
2224 ms[ 0 ]->mss_flags |= MONITOR_F_OPENED;
2227 monitor_subsys_opened = 1;
2229 if ( mi->mi_entry_limbo ) {
2230 entry_limbo_t *el = (entry_limbo_t *)mi->mi_entry_limbo;
2236 switch ( el->el_type ) {
2238 rc = monitor_back_register_entry(
2245 case LIMBO_ENTRY_PARENT:
2246 rc = monitor_back_register_entry_parent(
2258 rc = monitor_back_register_entry_attrs(
2268 rc = monitor_back_register_entry_callback(
2281 entry_free( el->el_e );
2284 attrs_free( el->el_a );
2286 if ( !BER_BVISNULL( &el->el_ndn ) ) {
2287 ber_memfree( el->el_ndn.bv_val );
2289 if ( !BER_BVISNULL( &el->el_nbase ) ) {
2290 ber_memfree( el->el_nbase.bv_val );
2292 if ( !BER_BVISNULL( &el->el_filter ) ) {
2293 ber_memfree( el->el_filter.bv_val );
2295 if ( el->el_cb && rc != 0 ) {
2296 if ( el->el_cb->mc_dispose ) {
2297 el->el_cb->mc_dispose( &el->el_cb->mc_private );
2299 ch_free( el->el_cb );
2307 mi->mi_entry_limbo = NULL;
2314 monitor_back_config(
2322 * eventually, will hold backend specific configuration parameters
2324 return SLAP_CONF_UNKNOWN;
2329 monitor_back_db_config(
2336 monitor_info_t *mi = ( monitor_info_t * )be->be_private;
2339 * eventually, will hold database specific configuration parameters
2341 return SLAP_CONF_UNKNOWN;
2346 monitor_back_db_destroy(
2349 monitor_info_t *mi = ( monitor_info_t * )be->be_private;
2356 * FIXME: destroys all the data
2358 /* NOTE: mi points to static storage; don't free it */
2360 (void)monitor_cache_destroy( mi );
2362 if ( monitor_subsys ) {
2365 for ( i = 0; monitor_subsys[ i ] != NULL; i++ ) {
2366 if ( monitor_subsys[ i ]->mss_destroy ) {
2367 monitor_subsys[ i ]->mss_destroy( be, monitor_subsys[ i ] );
2370 if ( !BER_BVISNULL( &monitor_subsys[ i ]->mss_rdn ) ) {
2371 ch_free( monitor_subsys[ i ]->mss_rdn.bv_val );
2375 ch_free( monitor_subsys );
2378 ldap_pvt_thread_mutex_destroy( &monitor_info.mi_cache_mutex );
2380 be->be_private = NULL;
2385 #if SLAPD_MONITOR == SLAPD_MOD_DYNAMIC
2387 /* conditionally define the init_module() function */
2388 SLAP_BACKEND_INIT_MODULE( monitor )
2390 #endif /* SLAPD_MONITOR == SLAPD_MOD_DYNAMIC */