PT-EUSTACK-RESOLVER(1) | User Contributed Perl Documentation | PT-EUSTACK-RESOLVER(1) |
NAME
pt-eustack-resolver - Get stack traces for a selected program with "eu-stack" and resolve symbols.
SYNOPSIS
Usage: pt-eustack-resolver <pid>
pt-eustack-resolver collects stack traces for the process with specified "pid".
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
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
Stack for each thread, formatted similarly to "gdb thread apply all bt" output.
ATTENTION
Using <PTDEBUG> might expose passwords. When debug is enabled, all command line parameters are shown in the output.
SYSTEM REQUIREMENTS
You need "eu-stack" from the elfutils https://sourceware.org/elfutils package.
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
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
Alexey Stroganov
ACKNOWLEDGMENTS
Part of code for symbol resolving derived from resolve-stack-traces.pl script (https://github.com/knielsen/knielsen-pmp)
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
This program is copyright 2017-2024 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 along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
VERSION
pt-eustack-resolver 3.7.0
2025-01-01 | perl v5.40.0 |