]> granicus.if.org Git - procps-ng/commitdiff
docs: Note limitation of pidof find scripts (catch up)
authorJim Warner <james.warner@comcast.net>
Wed, 11 Apr 2018 05:00:00 +0000 (00:00 -0500)
committerCraig Small <csmall@enc.com.au>
Sat, 5 May 2018 21:19:38 +0000 (07:19 +1000)
--------------- Original Master Branch Commit Message:
pidof will miss scripts that are run a certain way due to how
they appear in procfs. This is just a note to say it might miss
them.

References:
 procps-ng/procps#17

Signed-off-by: Jim Warner <james.warner@comcast.net>
pidof.1

diff --git a/pidof.1 b/pidof.1
index 15b40317a6c384e36c6ff02c62bae8a751f2e015..1368704c0b3bc4feb391e927675e77624aa3643b 100644 (file)
--- a/pidof.1
+++ b/pidof.1
@@ -15,7 +15,7 @@
 .\" along with this program; if not, write to the Free Software
 .\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
 .\"
-.TH PIDOF 1 "24 Jul 2013" "" "User Commands"
+.TH PIDOF 1 "2018-03-03" "" "User Commands"
 .SH NAME
 pidof -- find the process ID of a running program.
 .SH SYNOPSIS
@@ -60,6 +60,13 @@ At least one program was found with the requested name.
 .B 1
 No program was found with the requested name.
 
+.SH BUGS
+When using the \fI\-x\fP option,
+.B pidof
+only has a simple method for detecting scripts and will miss scripts that,
+for example, use env. This limitation is due to how the scripts look in
+the proc filesystem.
+
 .SH SEE ALSO
 .BR pgrep (1),
 .BR pkill (1)