diff --git a/bin/pt-archiver b/bin/pt-archiver index e9ee9378..2431362a 100755 --- a/bin/pt-archiver +++ b/bin/pt-archiver @@ -6958,10 +6958,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process ID of -the daemonized instance. The PID file is removed when the daemonized instance -exits. The program checks for the existence of the PID file when starting; if -it exists and the process with the matching PID exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --plugin diff --git a/bin/pt-deadlock-logger b/bin/pt-deadlock-logger index d7a78adc..59cd2fe5 100755 --- a/bin/pt-deadlock-logger +++ b/bin/pt-deadlock-logger @@ -5083,10 +5083,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process ID of -the daemonized instance. The PID file is removed when the daemonized instance -exits. The program checks for the existence of the PID file when starting; if -it exists and the process with the matching PID exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-duplicate-key-checker b/bin/pt-duplicate-key-checker index 97cd56ec..b4ce8d50 100755 --- a/bin/pt-duplicate-key-checker +++ b/bin/pt-duplicate-key-checker @@ -5130,14 +5130,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-fifo-split b/bin/pt-fifo-split index 06303be6..a3c7e81d 100755 --- a/bin/pt-fifo-split +++ b/bin/pt-fifo-split @@ -1456,14 +1456,11 @@ printed to the fifo. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --statistics diff --git a/bin/pt-find b/bin/pt-find index 67ba6084..100af3ef 100755 --- a/bin/pt-find +++ b/bin/pt-find @@ -4241,14 +4241,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-fk-error-logger b/bin/pt-fk-error-logger index 64491d01..4de8b6c2 100755 --- a/bin/pt-fk-error-logger +++ b/bin/pt-fk-error-logger @@ -4103,10 +4103,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process ID of -the daemonized instance. The PID file is removed when the daemonized instance -exits. The program checks for the existence of the PID file when starting; if -it exists and the process with the matching PID exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-heartbeat b/bin/pt-heartbeat index 8ba42405..4a8ccbae 100755 --- a/bin/pt-heartbeat +++ b/bin/pt-heartbeat @@ -5664,10 +5664,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process ID of -the daemonized instance. The PID file is removed when the daemonized instance -exits. The program checks for the existence of the PID file when starting; if -it exists and the process with the matching PID exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-kill b/bin/pt-kill index 39a6a6f9..a88586c7 100755 --- a/bin/pt-kill +++ b/bin/pt-kill @@ -7350,10 +7350,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process ID of -the daemonized instance. The PID file is removed when the daemonized instance -exits. The program checks for the existence of the PID file when starting; if -it exists and the process with the matching PID exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-online-schema-change b/bin/pt-online-schema-change index 598cffd2..e8884e6a 100755 --- a/bin/pt-online-schema-change +++ b/bin/pt-online-schema-change @@ -10868,10 +10868,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the tool's -instance. The PID file is removed when the tool exits. The tool checks for -the existence of the PID file when starting; if it exists and the process with -the matching PID exists, the tool exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-query-advisor b/bin/pt-query-advisor index 78d8c2fd..010f6cc1 100755 --- a/bin/pt-query-advisor +++ b/bin/pt-query-advisor @@ -9092,11 +9092,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-query-digest b/bin/pt-query-digest index 518d1891..6b671d26 100755 --- a/bin/pt-query-digest +++ b/bin/pt-query-digest @@ -14967,11 +14967,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-show-grants b/bin/pt-show-grants index 3f318ecd..9df78c0e 100755 --- a/bin/pt-show-grants +++ b/bin/pt-show-grants @@ -2093,14 +2093,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-slave-delay b/bin/pt-slave-delay index 75c9db13..b511c4a7 100755 --- a/bin/pt-slave-delay +++ b/bin/pt-slave-delay @@ -4478,11 +4478,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-slave-find b/bin/pt-slave-find index d104a4d6..730a18af 100755 --- a/bin/pt-slave-find +++ b/bin/pt-slave-find @@ -3960,14 +3960,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-slave-restart b/bin/pt-slave-restart index 71cad5b7..43efd494 100755 --- a/bin/pt-slave-restart +++ b/bin/pt-slave-restart @@ -5312,11 +5312,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-stalk b/bin/pt-stalk index 8adbd5bc..e2d5a518 100755 --- a/bin/pt-stalk +++ b/bin/pt-stalk @@ -1723,7 +1723,11 @@ Send mail to this list of addresses when data is collected. type: string; default: /var/run/pt-stalk.pid -Create a PID file when daemonized. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --plugin diff --git a/bin/pt-table-checksum b/bin/pt-table-checksum index 927563bb..558b62c2 100755 --- a/bin/pt-table-checksum +++ b/bin/pt-table-checksum @@ -11619,14 +11619,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-table-sync b/bin/pt-table-sync index 1d4ff3f7..86bf9406 100755 --- a/bin/pt-table-sync +++ b/bin/pt-table-sync @@ -12051,14 +12051,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-table-usage b/bin/pt-table-usage index 2452194f..a32eebcc 100755 --- a/bin/pt-table-usage +++ b/bin/pt-table-usage @@ -7192,11 +7192,11 @@ Password to use when connecting. type: string -Create the given PID file when running. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-upgrade b/bin/pt-upgrade index 347733d8..6f1537d3 100755 --- a/bin/pt-upgrade +++ b/bin/pt-upgrade @@ -13483,11 +13483,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-variable-advisor b/bin/pt-variable-advisor index 6aa51591..b497892c 100755 --- a/bin/pt-variable-advisor +++ b/bin/pt-variable-advisor @@ -5752,11 +5752,11 @@ Password to use when connecting. type: string -Create the given PID file when daemonized. The file contains the process -ID of the daemonized instance. The PID file is removed when the -daemonized instance exits. The program checks for the existence of the -PID file when starting; if it exists and the process with the matching PID -exists, the program exits. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port diff --git a/bin/pt-visual-explain b/bin/pt-visual-explain index 78809597..16d370c8 100755 --- a/bin/pt-visual-explain +++ b/bin/pt-visual-explain @@ -2952,14 +2952,11 @@ Password to use when connecting. type: string -Create the given PID file. The file contains the process ID of the script. -The PID file is removed when the script exits. Before starting, the script -checks if the PID file already exists. If it does not, then the script creates -and writes its own PID to it. If it does, then the script checks the following: -if the file contains a PID and a process is running with that PID, then -the script dies; or, if there is no process running with that PID, then the -script overwrites the file with its own PID and starts; else, if the file -contains no PID, then the script dies. +Create the given PID file. The tool won't start if the PID file already +exists and the PID it contains is different than the current PID. However, +if the PID file exists and the PID it contains is no longer running, the +tool will overwrite the PID file with the current PID. The PID file is +removed automatically when the tool exits. =item --port