usr/src/cmd/mdb/common/mdb/mdb_callb.c

/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License, Version 1.0 only
 * (the "License").  You may not use this file except in compliance
 * with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */
/*
 * Copyright 2005 Sun Microsystems, Inc.  All rights reserved.
 * Use is subject to license terms.
 */

#pragma ident	"%Z%%M%	%I%	%E% SMI"

/*
 * Callback facility designed to allow interested parties (dmods, targets, or
 * even the core debugger framework) to register for notification when certain
 * "interesting" events occur.
 */

#include <mdb/mdb_list.h>
#include <mdb/mdb_debug.h>
#include <mdb/mdb_callb.h>
#include <mdb/mdb_module.h>
#include <mdb/mdb.h>

mdb_callb_t *
mdb_callb_add(mdb_module_t *m, int class, mdb_callb_f fp, void *arg)
{
	mdb_callb_t *new = mdb_zalloc(sizeof (mdb_callb_t), UM_SLEEP);

	ASSERT(class == MDB_CALLB_STCHG || class == MDB_CALLB_PROMPT);

	new->cb_mod = m;
	new->cb_class = class;
	new->cb_func = fp;
	new->cb_arg = arg;

	if (m == NULL) {
		mdb_list_prepend(&mdb.m_cblist, new);
	} else {
		mdb_list_insert(&mdb.m_cblist, m->mod_cb, new);
		if (m->mod_cb == NULL)
			m->mod_cb = new;
	}

	return (new);
}

void
mdb_callb_remove(mdb_callb_t *cb)
{
	if (cb->cb_mod != NULL) {
		mdb_callb_t *next = mdb_list_next(cb);
		mdb_module_t *mod = cb->cb_mod;

		if (mod->mod_cb == cb) {
			if (next == NULL || next->cb_mod != mod)
				mod->mod_cb = NULL;
			else
				mod->mod_cb = next;
		}
	}

	mdb_list_delete(&mdb.m_cblist, cb);

	mdb_free(cb, sizeof (mdb_callb_t));
}

void
mdb_callb_remove_by_mod(mdb_module_t *m)
{
	while (m->mod_cb != NULL)
		mdb_callb_remove(m->mod_cb);
}

void
mdb_callb_remove_all(void)
{
	mdb_callb_t *cb;

	while ((cb = mdb_list_next(&mdb.m_cblist)) != NULL)
		mdb_callb_remove(cb);
}

void
mdb_callb_fire(int class)
{
	mdb_callb_t *cb, *next;

	ASSERT(class == MDB_CALLB_STCHG || class == MDB_CALLB_PROMPT);

	mdb_dprintf(MDB_DBG_CALLB, "invoking %s callbacks\n",
	    (class == MDB_CALLB_STCHG ? "state change" : "prompt"));

	for (cb = mdb_list_next(&mdb.m_cblist); cb != NULL; cb = next) {
		next = mdb_list_next(cb);
		if (cb->cb_class == class)
			cb->cb_func(cb->cb_arg);
	}
}