diff --git a/bin/pt-align b/bin/pt-align index 03038735..8ba11199 100755 --- a/bin/pt-align +++ b/bin/pt-align @@ -66,6 +66,25 @@ Usage: pt-align [FILES] pt-align reads lines in files and splits them into words. This is useful for things like aligning the output of vmstat or iostat so it is easier to read. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-align is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION pt-align counts how many words each line has, and if there is one number that diff --git a/bin/pt-archiver b/bin/pt-archiver index 673f1e67..0b04fa15 100755 --- a/bin/pt-archiver +++ b/bin/pt-archiver @@ -5536,24 +5536,6 @@ A sample module might look like this: 1; -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -5593,6 +5575,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-checksum-filter b/bin/pt-checksum-filter index b5a3cbf8..2e4c9ce4 100755 --- a/bin/pt-checksum-filter +++ b/bin/pt-checksum-filter @@ -1301,24 +1301,6 @@ Show version and exit. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -1358,6 +1340,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-collect b/bin/pt-collect index 3c9a892d..51b0968f 100755 --- a/bin/pt-collect +++ b/bin/pt-collect @@ -283,6 +283,25 @@ of time. It is typically executed when the stalk tool detects a condition and wants to collect information to assist in diagnosis. Four options must be specified on the command line: -dgios. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-collect is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION pt-collect creates a lock to ensure that only one instance runs at a time, diff --git a/bin/pt-config-diff b/bin/pt-config-diff index 9f0be33b..cc5b35f2 100755 --- a/bin/pt-config-diff +++ b/bin/pt-config-diff @@ -3162,24 +3162,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3219,6 +3201,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-deadlock-logger b/bin/pt-deadlock-logger index 335e56a8..491d3406 100755 --- a/bin/pt-deadlock-logger +++ b/bin/pt-deadlock-logger @@ -2641,24 +2641,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2698,6 +2680,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-diskstats b/bin/pt-diskstats index a80cd73b..2149f633 100755 --- a/bin/pt-diskstats +++ b/bin/pt-diskstats @@ -634,6 +634,25 @@ Usage: pt-diskstats [OPTIONS] [FILES] pt-diskstats reads F periodically, or files with the contents of F, aggregates the data, and prints it nicely. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-diskstats is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION pt-diskstats tool is similar to iostat, but has some advantages. It separates diff --git a/bin/pt-duplicate-key-checker b/bin/pt-duplicate-key-checker index 047b039c..f6d797e8 100755 --- a/bin/pt-duplicate-key-checker +++ b/bin/pt-duplicate-key-checker @@ -4175,24 +4175,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -4232,6 +4214,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-fifo-split b/bin/pt-fifo-split index 26d4cdf0..af576c38 100755 --- a/bin/pt-fifo-split +++ b/bin/pt-fifo-split @@ -1448,24 +1448,6 @@ Show version and exit. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -1505,6 +1487,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-find b/bin/pt-find index 4cc2118a..99395db3 100755 --- a/bin/pt-find +++ b/bin/pt-find @@ -3723,24 +3723,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3780,6 +3762,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-fk-error-logger b/bin/pt-fk-error-logger index 7925fc56..936c2b77 100755 --- a/bin/pt-fk-error-logger +++ b/bin/pt-fk-error-logger @@ -2361,24 +2361,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2418,6 +2400,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Daniel Nichter diff --git a/bin/pt-heartbeat b/bin/pt-heartbeat index e84b2e97..f94e2cd7 100755 --- a/bin/pt-heartbeat +++ b/bin/pt-heartbeat @@ -4206,24 +4206,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -4263,6 +4245,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Proven Scaling LLC, SixApart Ltd, Baron Schwartz, and Daniel Nichter diff --git a/bin/pt-index-usage b/bin/pt-index-usage index 47614307..6076a6b9 100755 --- a/bin/pt-index-usage +++ b/bin/pt-index-usage @@ -6091,24 +6091,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -6148,6 +6130,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-kill b/bin/pt-kill index d6c3eb63..75cefacb 100755 --- a/bin/pt-kill +++ b/bin/pt-kill @@ -4581,24 +4581,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -4638,6 +4620,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-log-player b/bin/pt-log-player index fa5d961f..d8f68fa9 100755 --- a/bin/pt-log-player +++ b/bin/pt-log-player @@ -3437,18 +3437,6 @@ This option is disabled by L<"--quiet">. Show version and exit. -=item --wait-between-sessions - -type: array; default: 0; group: Play - -Not implemented yet. - -The wait time is given in seconds with microsecond precision and can be either -a single value or a range. A single value causes an exact wait; example: -0.010 = wait 10 milliseconds. A range causes a random wait between -the given value times; example: 0.001,1 = random wait from 1 millisecond to -1 second. - =item --[no]warnings default: no; group: Play @@ -3517,24 +3505,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3574,6 +3544,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Daniel Nichter diff --git a/bin/pt-mext b/bin/pt-mext index 66014a8a..37957293 100755 --- a/bin/pt-mext +++ b/bin/pt-mext @@ -109,11 +109,30 @@ pt-mext columnizes repeated output from a program like mysqladmin extended. Get output from C: - mext -r -- mysqladmin ext -i10 -c3" + pt-mext -r -- mysqladmin ext -i10 -c3" Get output from a file: - mext -r -- cat mysqladmin-output.txt + pt-mext -r -- cat mysqladmin-output.txt + +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-mext is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. =head1 DESCRIPTION diff --git a/bin/pt-mysql-summary b/bin/pt-mysql-summary index 44abc002..d3ba68ee 100755 --- a/bin/pt-mysql-summary +++ b/bin/pt-mysql-summary @@ -1292,6 +1292,25 @@ a tuning tool or diagnosis tool. It produces a report that is easy to diff and can be pasted into emails without losing the formatting. It should work well on any modern UNIX systems. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-mysql-summary is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION pt-mysql-summary works by connecting to a MySQL database server and querying diff --git a/bin/pt-online-schema-change b/bin/pt-online-schema-change index 8d0062e8..aa201867 100755 --- a/bin/pt-online-schema-change +++ b/bin/pt-online-schema-change @@ -5203,24 +5203,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -5260,6 +5242,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-pmp b/bin/pt-pmp index 394b0595..9bdb7584 100755 --- a/bin/pt-pmp +++ b/bin/pt-pmp @@ -195,6 +195,25 @@ It can create and summarize full stack traces of processes on Linux. Summaries of stack traces can be an invaluable tool for diagnosing what a process is waiting for. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-pmp is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION pt-pmp performs two tasks: it gets a stack trace, and it summarizes the stack diff --git a/bin/pt-profile-compact b/bin/pt-profile-compact index d2dc5c5c..e1fe6129 100755 --- a/bin/pt-profile-compact +++ b/bin/pt-profile-compact @@ -1266,24 +1266,6 @@ Show version and exit. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -1323,6 +1305,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-query-advisor b/bin/pt-query-advisor index 65efe878..6fc9fb00 100755 --- a/bin/pt-query-advisor +++ b/bin/pt-query-advisor @@ -7191,24 +7191,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -7248,6 +7230,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-query-digest b/bin/pt-query-digest index 7c9e4ea5..8b9cd22c 100755 --- a/bin/pt-query-digest +++ b/bin/pt-query-digest @@ -15518,24 +15518,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -15575,6 +15557,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-query-profiler b/bin/pt-query-profiler index 39e51ca6..a5319d25 100755 --- a/bin/pt-query-profiler +++ b/bin/pt-query-profiler @@ -2750,24 +2750,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2807,6 +2789,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Bart van Bragt diff --git a/bin/pt-rel b/bin/pt-rel index bac1cc8c..44743781 100755 --- a/bin/pt-rel +++ b/bin/pt-rel @@ -70,6 +70,25 @@ pt-rel matches lines and subtracts the value of the previous line's values from the current line's values. The lines must be text with numeric values that repeat, varying only the values. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-rel is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION For example, if the text is this: diff --git a/bin/pt-show-grants b/bin/pt-show-grants index e8fee33f..5ac55e48 100755 --- a/bin/pt-show-grants +++ b/bin/pt-show-grants @@ -2128,24 +2128,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2185,6 +2167,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-sift b/bin/pt-sift index 87a532bb..4b79fa39 100755 --- a/bin/pt-sift +++ b/bin/pt-sift @@ -477,6 +477,25 @@ pt-sift browses the files created by L. If you specify a FILE or PREFIX, it browses only files with that prefix. If you specify a DIRECTORY, then it browses all files within that directory. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-sift is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION pt-sift downloads other tools that it might need, such as L, diff --git a/bin/pt-slave-delay b/bin/pt-slave-delay index 9726b64f..cec81ae4 100755 --- a/bin/pt-slave-delay +++ b/bin/pt-slave-delay @@ -2613,24 +2613,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2670,6 +2652,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Sergey Zhuravlev and Baron Schwartz diff --git a/bin/pt-slave-find b/bin/pt-slave-find index 533169da..1cb6ad6b 100755 --- a/bin/pt-slave-find +++ b/bin/pt-slave-find @@ -3093,24 +3093,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3150,6 +3132,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-slave-restart b/bin/pt-slave-restart index f19d299c..611ee448 100755 --- a/bin/pt-slave-restart +++ b/bin/pt-slave-restart @@ -3264,24 +3264,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3321,6 +3303,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-stalk b/bin/pt-stalk index 2f872f40..51e9417d 100755 --- a/bin/pt-stalk +++ b/bin/pt-stalk @@ -178,6 +178,25 @@ a script. By default it executes L, but that can be customized. This tool is useful for gathering diagnostic data when an infrequent event occurs, so an expert person can review the data later. +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-stalk is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. + =head1 DESCRIPTION Although pt-stalk comes pre-configured to do a specific thing, in general diff --git a/bin/pt-summary b/bin/pt-summary index 5351db4a..95b656e7 100755 --- a/bin/pt-summary +++ b/bin/pt-summary @@ -1196,12 +1196,31 @@ tool works well on Linux systems. Download and run: - wget http://aspersa.googlecode.com/svn/trunk/summary - bash ./summary + wget http://percona.com/get/pt-summary + bash ./pt-summary Download and run in a single step: - wget -O- http://aspersa.googlecode.com/svn/trunk/summary | bash + wget -O- http://percona.com/get/summary | bash + +=head1 RISKS + +The following section is included to inform users about the potential risks, +whether known or unknown, of using this tool. The two main categories of risks +are those created by the nature of the tool (e.g. read-only tools vs. read-write +tools) and those created by bugs. + +pt-summary is a read-only tool. It should be very low-risk. + +At the time of this release, we know of no bugs that could cause serious harm +to users. + +The authoritative source for updated information is always the online issue +tracking system. Issues that affect this tool will be marked as such. You can +see a list of such issues at the following URL: +L. + +See also L<"BUGS"> for more information on filing bugs and getting help. =head1 DESCRIPTION diff --git a/bin/pt-table-checksum b/bin/pt-table-checksum index 1495466b..c3994ed9 100755 --- a/bin/pt-table-checksum +++ b/bin/pt-table-checksum @@ -8646,24 +8646,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -8703,6 +8685,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-table-sync b/bin/pt-table-sync index d2e3144c..572e536c 100755 --- a/bin/pt-table-sync +++ b/bin/pt-table-sync @@ -9970,24 +9970,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -10027,6 +10009,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-tcp-model b/bin/pt-tcp-model index 0bc76fbd..cee4c4af 100755 --- a/bin/pt-tcp-model +++ b/bin/pt-tcp-model @@ -2317,24 +2317,6 @@ number. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2374,6 +2356,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-trend b/bin/pt-trend index 8136c6e0..c33c04ce 100755 --- a/bin/pt-trend +++ b/bin/pt-trend @@ -1980,36 +1980,12 @@ parts. The first part can be percentage, time, or iterations; the second part specifies how often an update should be printed, in percentage, seconds, or number of iterations. -=item --quiet - -short form: -q - -Disables L<"--progress">. - =item --version Show version and exit. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -2049,6 +2025,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz diff --git a/bin/pt-upgrade b/bin/pt-upgrade index 6bbf6193..809f5a34 100755 --- a/bin/pt-upgrade +++ b/bin/pt-upgrade @@ -11588,12 +11588,6 @@ Execute and compare this single query; ignores files on command line. This option allows you to supply a single query on the command line. Any slowlogs also specified on the command line are ignored. -=item --[no]report - -default: yes - -Print the L<"--reports">. - =item --reports type: Hash; default: queries,differences,errors,statistics @@ -11732,24 +11726,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -11789,6 +11765,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Daniel Nichter diff --git a/bin/pt-variable-advisor b/bin/pt-variable-advisor index fd639d94..2e8c50b4 100755 --- a/bin/pt-variable-advisor +++ b/bin/pt-variable-advisor @@ -3646,12 +3646,6 @@ type: Array Read this comma-separated list of config files; if specified, this must be the first option on the command line. -=item --[no]continue-on-error - -default: yes - -Continue working even if there is an error. - =item --daemonize Fork to the background and detach from the shell. POSIX @@ -3806,24 +3800,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3863,6 +3839,25 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + + =head1 AUTHORS Baron Schwartz and Daniel Nichter diff --git a/bin/pt-visual-explain b/bin/pt-visual-explain index 69da0252..6b164f4d 100755 --- a/bin/pt-visual-explain +++ b/bin/pt-visual-explain @@ -2996,24 +2996,6 @@ User for login if not current user. =back -=head1 DOWNLOADING - -Visit L 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 C with the name of any tool. - =head1 ENVIRONMENT The environment variable C enables verbose debugging output to STDERR. @@ -3053,6 +3035,24 @@ Include the following information in your bug report: If possible, include debugging output by running the tool with C; see L<"ENVIRONMENT">. +=head1 DOWNLOADING + +Visit L 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 C with the name of any tool. + =head1 AUTHORS Baron Schwartz