The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Squatting::With::Coro::Debug - inspect running Squatting apps with Coro::Debug

SYNOPSIS

From the command line:

  squatting --module With::Coro::Debug App

From a script:

  use App qw(On::Continuity With::Coro::Debug);
  App->init;
  App->continue();

Connect to Coro::Debug in another terminal

  socat readline unix:/tmp/squatting.with.coro.debug

A Coro::Debug session looks like this:

  > ps
                 PID SC  RSS USES Description              Where
           142161516 RC 245k   23 [main::]                 [Event.pm:164]
           142188912 -- 1404    4 [coro manager]           [Coro.pm:358]
           142189128 N-   84    0 [unblock_sub scheduler]  -
           142455240 N-   84    0 [Event idle process]     -
           146549540 -- 7340   14                          [HttpDaemon.pm:426]
           146549792 -- 2088    5                          [Continuity.pm:436]
           146552468 UC 3344    6 [Coro::Debug session]    [Coro.pm:257]

DESCRIPTION

Using this module in conjunction with a Squatting app that's running on top of Continuity will provide you with a Coro::Debug server that you can connect to using tools like socat. This will let you inspect the state of your Squatting app while its running.

CONFIG

with.coro.debug.unix_domain_socket

This should be a string that represents the path of the Unix domain socket that Coro::Debug will use. If this option is not set, the default value is /tmp/squatting.with.coro.debug.

Example

  $CONFIG{'with.coro.debug.unix_domain_socket'} = '/tmp/coro-debug-socket';

SEE ALSO

Perl Modules

Coro, Coro::Debug, Continuity, Squatting::On::Continuity

socat

http://www.dest-unreach.org/socat/