.. program:: pt-eustack-resolver ============================== :program:`pt-eustack-resolver` ============================== NAME ==== :program:`pt-eustack-resolver` - Get stack traces for a selected program with ``eu-stack`` and resolve symbols. SYNOPSIS ======== Usage ----- :: pt-eustack-resolver :program:`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 =========== :program:`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 `_ 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 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 `_ 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 :option:`--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: .. code-block:: bash 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: .. code-block:: bash 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 ======= :program:`pt-eustack-resolver` 3.6.0