PT-EUST...RESOLVER(1)

πŸ“¦
version 3.7.1_4 Β· 4 versions
, in arch rolling

πŸ’… pt-eustack-resolver β€” get stack traces & resolve symbols

okay so bestie, this page is PT-EUST...RESOLVER(1) from the User Contributed Perl Documentation, and it's literally the glow-up guide for a lil tool that grabs stack traces for a program using eu-stack and then resolves the symbols for you. iconic behavior honestly 🫢


✨ NAME ✨

pt-eustack-resolver β€” get stack traces for a selected program with eu-stack and resolve symbols. that's the whole vibe πŸ’–

πŸŽ€ SYNOPSIS πŸŽ€

Usage: pt-eustack-resolver PID

pt-eustack-resolver collects stack traces for the process with specified PID. yeah, you just hand it a PID and it does its thing ✨

πŸ’€ RISKS πŸ’€

ngl, Percona Toolkit is mature, proven in the real world, and well tested β€” but like, all database tools can pose a risk to the system and the database server. so before you use this tool, please, for the love of everything:

  • Read the tool's documentation πŸ“–
  • Review the tool's known BUGS πŸ›
  • Test the tool on a non-production server (do NOT rawdog this in prod 😭)
  • 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. it's the companion tool for pt-pmp, called when option --dumper=pteu is specified. bestie duo energy fr fr πŸ‘‘

eu-stack is a tool from the elfutils package (https://sourceware.org/elfutils) that prints a stack for each thread in a process or core file. and the way that eu-stack is faster than gdb and has smaller overhead on the diagnosed process? obsessed. πŸ”₯

🌸 OUTPUT 🌸

Stack for each thread, formatted similarly to gdb thread apply all bt output. cute, readable, slay πŸ’…

⭐ OPTIONS ⭐

This tool accepts additional command-line arguments. Refer to the SYNOPSIS and usage information for details. iykyk πŸ‘€

  • --help β€” Show help and exit. the classic escape hatch πŸšͺ
  • --version β€” Show version and exit. know your era 🏷️

πŸ™ˆ ATTENTION πŸ™ˆ

Using <PTDEBUG> might expose passwords. when debug is enabled, all command line parameters are shown in the output. so like… careful, bestie, that's a leak waiting to happen πŸ’€

πŸ’œ SYSTEM REQUIREMENTS πŸ’œ

You need eu-stack from the elfutils package (https://sourceware.org/elfutils). no eu-stack, no stack traces, no slay. periodt ✨

πŸ› 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. receipts help everyone 🫢

🌈 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. mix and match, main character energy πŸ‘‘

🧚 AUTHORS 🧚

Alexey Stroganov β€” thank you for your service 🫑

πŸ“ ACKNOWLEDGMENTS πŸ“

Part of code for symbol resolving derived from resolve-stack-traces.pl script (https://github.com/knielsen/knielsen-pmp). credit where credit is due, always πŸ’–

πŸ‘‘ 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. lore drop πŸ“œ

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. (yes, in all caps, because that's the serious part 😀)

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 πŸ”₯

pt-eustack-resolver 3.7.1-4 ✨

😭 POD ERRORS 😭

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

Around line 1468:

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

not the doc dragging itself in public πŸ’€ but we move.


and that's the whole page, bestie πŸŽ€ this was perl v5.42.2, dated 2026-09-01, manual page PT-EUST...RESOLVER(1) β€” go forth and resolve those symbols πŸ’–βœ¨πŸ¦‹

πŸ“¦ where this page comes from