illumos: manual page: ldi_ev_remove

LDI_EV_REMOVE_CALLBACKS(9F) Kernel Functions for Drivers

NAME

ldi_ev_remove_callbacks - remove all callbacks for a given callback ID

SYNOPSIS

#include <sys/sunldi.h>

int ldi_ev_remove_callbacks(ldi_callback_id_t id);

INTERFACE LEVEL

illumos DDI specific (illumos 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

Upon successful completion, the ldi_ev_remove_callback() function returns
LDI_EV_SUCCESS. Otherwise, if an invalid callback ID of 0 is supplied, or
if the underlying call to ddi_remove_event_handler(9F) failed,
LDI_EV_FAILURE is returned.

CONTEXT

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