NAME

       App::Stacktrace - Stack trace

VERSION

       version 0.09

SYNOPSIS

         perl-stacktrace [option] pid

           -m      Prints a gdb script
           -v      Verbose debugging
           -c      Additionally, prints C stacktrace
           --help  Show this help

           --exec  exec() into gdb

DESCRIPTION

       perl-stacktrace prints Perl stack traces of Perl threads for a given Perl process. For
       each Perl frame, the full file name and line number are printed.

       For example, a stack dump of a running perl program:

           $ ps x | grep cpan
           24077 pts/12   T      0:01 /usr/local/bin/perl /usr/local/bin/cpan
           24093 pts/12   S+     0:00 grep cpan

           $ perl-stacktrace 24077
           0x00d73416 in __kernel_vsyscall ()
           /usr/local/bin/cpan:11
           /usr/local/lib/perl5/5.12.2/App/Cpan.pm:364
           /usr/local/lib/perl5/5.12.2/App/Cpan.pm:295
           /usr/local/lib/perl5/5.12.2/CPAN.pm:339
           /usr/local/lib/perl5/5.12.2/Term/ReadLine.pm:198

API

       There exists an internal API

   new
       This accepts the following parameters by applying them through Getopt::Long. This is
       actually just a front for the script perl-stacktrace's command line handling.

         App::Stacktrace->new(
             $pid,       # The process to attach to
             'm',        # Dump the generated script
             'v',        # Verbose
             'exec',     # exec() into gdb
             '--noexec', # system() into gdb
         );

   run
       Runs the app program as configured by the "->new(...)" method.

           $obj = App::Stacktrace->new( ... );
           $obj->run;