---
name: "App::Stacktrace"
section: "3pm"
platform: "linux"
package: "perl-stacktrace"
version: "0.09-5+b4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/App::Stacktrace"
---

# App::Stacktrace(3pm)

Stack trace

## 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;
```