Port improved pt-pmp

- Updated documentation for pt-eustack-resolver and pt-pmp
- Added pt-eustack-resolver, pt-pmp and other missed tools into docs/percona-toolkit.pod
- Removed quickstack support from pt-pmp. We do not need to port this
  improvement, because quickstack is not actively developed and does not
  create useful stack traces for Percona Server for MySQL 8.0.
This commit is contained in:
Sveta Smirnova
2024-01-18 02:57:03 +03:00
parent 56eea61dae
commit 83ba87cc0c
3 changed files with 67 additions and 19 deletions

View File

@@ -113,16 +113,20 @@ foreach $lwp (sort {$a<=>$b} keys %sf)
# ############################################################################
# Documentation
# ############################################################################
=pod
=head1 NAME
pt-eustack-resover - Get stack traces for a selected program with eu-stack and resolve symbols
pt-eustack-resolver - Get stack traces for a selected program with C<eu-stack>
and resolve symbols.
=head1 SYNOPSIS
Usage: pt-eustack-resolver <pid>
pt-eustack-resolver collects stack traces for the process with specified C<pid>.
=head1 RISKS
Percona Toolkit is mature, proven in the real world, and well tested,
@@ -143,17 +147,17 @@ server. Before using this tool, please:
=head1 DESCRIPTION
pt-eustack-resover is the tool that gets stack traces for a selected program
with eu-stack and resolves symbols. This is companion tool for L<pt-pmp>, called
when option --dumper=pteu is specified.
pt-eustack-resolver is the tool that gets stack traces for a selected program
with C<eu-stack> and resolves symbols. This is companion tool for L<pt-pmp|pt-pmp.html>, called
when option C<--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 smaller overhead on the
diagnosed process.
C<eu-stack> is a tool from L<elfutils|https://sourceware.org/elfutils> package that
prints a stack for each thread in a process or core file. C<eu-stack> is faster
than gdb and have smaller overhead on the diagnosed process.
=head1 OUTPUT
Stack for each thread, formatted similarly to `gdb thread apply all bt` output.
Stack for each thread, formatted similarly to C<gdb thread apply all bt> output.
=head1 ATTENTION
@@ -162,7 +166,7 @@ parameters are shown in the output.
=head1 SYSTEM REQUIREMENTS
You need eu-stack from the elfutils package.
You need C<eu-stack> from the L<elfutils|https://sourceware.org/elfutils> package.
=head1 BUGS