handler Command

The handler command modifies event handlers (enable, disable, and such). It has identical syntax and identical functionality in native mode and in Java mode.

A handler is created for each event that needs to be managed in a debugging session. The commands trace, stop, and whencreate handlers. Each of these commands returns a number known as the handler ID (handler_id). The handler, status, anddelete commands manipulate or provide information about handlers in a generic fashion.

Syntax

handler -enable handler_id ...

Enable given handlers, specify handler_id as all for all handlers.

handler -disable handler_id ...

Disable given handlers, specify handler_id as all for all handlers. Use $firedhandlers instead of handler_id to disable the handlers that caused the most recent stoppage.

handler -count handler_id

Print value of trip counter for given handler.

handler -count handler_id new_limit

Set new count limit for given event.

handler -reset handler_id

Reset trip counter for given handler.

where:

handler_id is the identifier of a handler.