xref: /illumos-gate/usr/src/man/man9f/ldi_ev_remove_callbacks.9f (revision 2aeafac3612e19716bf8164f89c3c9196342979c)
te
Copyright (c) 2007, Sun Microsystems, Inc., All Rights Reserved
The contents of this file are subject to the terms of the Common Development and Distribution License (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]
LDI_EV_REMOVE_CALLBACKS 9F "Oct 24, 2012"
NAME
ldi_ev_remove_callbacks - remove all callbacks for a given callback ID
SYNOPSIS

#include <sys/sunldi.h>

void ldi_ev_remove_callbacks(ldi_callback_id_t id);
INTERFACE LEVEL

Solaris DDI specific (Solaris DDI)

PARAMETERS
ldi_callback_id_t id

An opaque data structure returned on successful calls to ldi_ev_register_callbacks(9F).

DESCRIPTION

The ldi_ev_remove_callback() function unregisters any callbacks that were registered via ldi_ev_register_callbacks(9F). Once this function returns, the callback ID is no longer valid.

The finalize and notify callbacks exist independently of the LDI handle and are not automatically removed when the LDI handle is closed. The layered driver removes these callbacks via ldi_ev_remove_callbacks()() when the callbacks are no longer needed. The LDI framework may panic the system if the entity registering the callback (a dev_t, dip or module) no longer exists on the system and the callbacks have not been unregistered.

RETURN VALUES

None.

CONTEXT

This function can be called from user and kernel contexts only.

SEE ALSO

ldi_ev_get_cookie(9F), ldi_ev_register_callbacks(9F)