PT-EUSTACK-RESOLVER(1) User Contributed Perl Documentation PT-EUSTACK-RESOLVER(1)

# [NAME](#NAME)

pt-eustack-resolver - Get stack traces for a selected program with "eu-stack" and resolve symbols.

# [SYNOPSIS](#SYNOPSIS)

Usage: pt-eustack-resolver PID

pt-eustack-resolver collects stack traces for the process with specified "PID".

# [RISKS](#RISKS)

Percona Toolkit is mature, proven in the real world, and well tested, but all database tools can pose a risk to the system and the database server. Before using this tool, please:

- Read the tool's documentation
- Review the tool's known "BUGS"
- Test the tool on a non-production server
- Backup your production server and verify the backups

# [DESCRIPTION](#DESCRIPTION)

pt-eustack-resolver is the tool that gets stack traces for a selected program with "eu-stack" and resolves symbols. This is companion tool for pt-pmp, called when option "--dumper=pteu" is specified.

"eu-stack" is a tool from elfutils <https://sourceware.org/elfutils> package that prints a stack for each thread in a process or core file. "eu-stack" is faster than gdb and have smaller overhead on the diagnosed process.

# [OUTPUT](#OUTPUT)

Stack for each thread, formatted similarly to "gdb thread apply all bt" output.

# [OPTIONS](#OPTIONS)

This tool accepts additional command-line arguments. Refer to the "SYNOPSIS" and usage information for details.

[--help](#help)

Show help and exit.

[--version](#version)

Show version and exit.

# [ATTENTION](#ATTENTION)

Using <PTDEBUG> might expose passwords. When debug is enabled, all command line parameters are shown in the output.

# [SYSTEM REQUIREMENTS](#SYSTEM_REQUIREMENTS)

You need "eu-stack" from the elfutils <https://sourceware.org/elfutils> package.

# [BUGS](#BUGS)

For a list of known bugs, see <https://jira.percona.com/projects/PT/issues>.

Please report bugs at <https://jira.percona.com/projects/PT>. Include the following information in your bug report:

- Complete command-line used to run the tool
- Tool "--version"
- MySQL version of all servers involved
- Output from the tool including STDERR
- Input files (log/dump/config files, etc.)

If possible, include debugging output by running the tool with "PTDEBUG"; see "ENVIRONMENT".

# [DOWNLOADING](#DOWNLOADING)

Visit <http://www.percona.com/software/percona-toolkit/> to download the latest release of Percona Toolkit. Or, get the latest release from the command line:

```
   wget percona.com/get/percona-toolkit.tar.gz
   wget percona.com/get/percona-toolkit.rpm
   wget percona.com/get/percona-toolkit.deb
```

You can also get individual tools from the latest release:

```
   wget percona.com/get/TOOL
```

Replace "TOOL" with the name of any tool.

# [AUTHORS](#AUTHORS)

Alexey Stroganov

# [ACKNOWLEDGMENTS](#ACKNOWLEDGMENTS)

Part of code for symbol resolving derived from resolve-stack-traces.pl script (https://github.com/knielsen/knielsen-pmp)

# [ABOUT PERCONA TOOLKIT](#ABOUT_PERCONA_TOOLKIT)

This tool is part of Percona Toolkit, a collection of advanced command-line tools for MySQL developed by Percona. Percona Toolkit was forked from two projects in June, 2011: Maatkit and Aspersa. Those projects were created by Baron Schwartz and primarily developed by him and Daniel Nichter. Visit <http://www.percona.com/software/> to learn about other free, open-source software from Percona.

# [COPYRIGHT, LICENSE, AND WARRANTY](#COPYRIGHT,_LICENSE,_AND_WARRANTY)

This program is copyright 2017-2026 Percona LLC and/or its affiliates.

THIS PROGRAM IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2; OR the Perl Artistic License. On UNIX and similar systems, you can issue \`man perlgpl' or \`man perlartistic' to read these licenses.

You should have received a copy of the GNU General Public License, version 2 along with this program; if not, see <https://www.gnu.org/licenses/>.

# [VERSION](#VERSION)

pt-eustack-resolver 3.7.2

# [POD ERRORS](#POD_ERRORS)

Hey! **The above document had some coding errors, which are explained below:**

[Around line 1468:](#Around)

You forgot a '=back' before '=head1'

2026-10-26 perl v5.44.0

---

Document: pt-eustack-resolver(1p) from percona-toolkit 3.7.2-r0 (Chainguard OS)
Source: https://github.com/percona/percona-toolkit