Index for Section 9

Alphabetical listing for H

Bottom of page

handler_del(9r)
NAME
  handler_del - Deregisters a device driver's interrupt handler

SYNOPSIS
  int handler_del(
	  ihandler_id_t *id );

ARGUMENTS
  id  Specifies a pointer to the interrupt handler's entry in the interrupt
      table.

DESCRIPTION
  The handler_del interface deregisters a device driver's interrupt handler
  from the bus-specific interrupt-dispatching algorithm. In addition, the
  interface unlinks the handler_key structure associated with the interrupt
  handler. Prior to deleting the interrupt handler, the device driver should
  have disabled it by calling handler_disable. If the interrupt handler was
  not disabled, handler_del returns an error.

  The handler_del interface uses the id argument to call a bus-specific
  adp_handler_del interface to remove the driver's interrupt handler.
  Deregistration of an interrupt handler can consist of replacing it with the
  stray interface to indicate that interrupts are no longer expected from
  this device. The stray interface is a generic interface used as the
  interrupt handler when there is no corresponding interrupt handler.

NOTES
  Device drivers that are dynamically configured into the kernel call the
  handler_del interface to deregister a device driver's interrupt handler. It
  is not necessary for device drivers that are statically configured into the
  kernel to call the handler_del interface.

RETURN VALUES
  Upon successful completion, handler_del returns the value zero (0).
  Otherwise, it returns the value -1.

EXAMPLE
  See Writing Device Drivers: Tutorial for a code example of the handler_del
  interface.








SEE ALSO
  Kernel Interfaces: handler_add(9r), handler_disable(9r), handler_enable(9r)


  Data Structures: ihandler_t(9s)

Index for Section 9

Alphabetical listing for H

Top of page