POE::Component::DebugShell 1.0411

POE::Component::DebugShell is a component to allow interactive peeking into a running POE application.

SYNOPSIS

use POE::Component::DebugShell;

POE::Component::DebugShell->spawn();

This component allows for interactive peeking into a running POE application.

spawn() creates a ReadLine enabled shell equipped with various debug commands. The following commands are available.

COMMANDS

show_sessions

debug> show_sessions
* 3 [ session 3 (POE::Component::DebugShell controller) ]
* 2 [ session 2 (PIE, PIE2) ]

Show a list of all sessions in the system. The output format is in the form of loggable session ids.

session_stats

debug> session_stats 2
Statistics for Session 2
Events coming from: 1
Events going to: 1

Display various statistics for a given session. Provide one session id as a parameter.

list_aliases

debug> list_aliases 2
Alias list for session 2
* PIE
* PIE2

List aliases for a given session id. Provide one session id as a parameter.

queue_dump

debug> queue_dump
Event Queue:
* ID: 738 - Index: 0
Priority: 1078459009.06715
Event: _sigchld_poll
* ID: 704 - Index: 1
Priority: 1078459012.42691
Event: ping

Dump the contents of the event queue. Add a -v parameter to get verbose output.

help

debug> help
The following commands are available:
...

Display help about available commands.

status

debug> status
This is POE::Component::DebugShell v1.14
running inside examples/foo.perl.
This console spawned at Thu Mar 4 22:51:51 2004.
There are 3 known sessions (including the kernel).

General shell status.

reload

debug> reload
Reloading...

Reload the shell

exit

debug> exit
Exiting...

Exit the shell