Perl in a Nutshell, 2nd Edition

Client Callback Methods

The following “virtual” methods are called by the API at appropriate points. The API provides only empty versions of these methods by default, but they can be defined by the client as needed.

CLIENT->init( )

Called after debug API initializes itself.

CLIENT->prestop([ STRING ])

Usually inherited from DB package. If no arguments are passed, returns the prestop action string.

CLIENT->stop( )

Called when execution stops, with the filename and line number as arguments.

CLIENT->idle( )

Called while stopped, e.g., in a client event loop.

CLIENT->poststop([ STRING ])

Usually inherited from DB package. If no arguments are passed, returns the poststop action string.

CLIENT->evalcode( STRING )

Usually inherited from DB package. Asks for a STRING to be evaled in executing code context.

CLIENT->cleanup( )

Called just before exit.

CLIENT->output( LIST )

Called when API must show a message (warnings, errors etc.).