]> granicus.if.org Git - procps-ng/commitdiff
docs: Update ps.1 to warn about command name length
authorCraig Small <csmall@enc.com.au>
Wed, 8 Aug 2018 10:13:58 +0000 (20:13 +1000)
committerCraig Small <csmall@enc.com.au>
Mon, 13 Aug 2018 10:53:56 +0000 (20:53 +1000)
Previous versions of ps used to only match on the first 15 characters
because that's what the kernel used to provide. Newer kernels have a
longer length for this field so procps has been updated to suit.

References:
 procps-ng/procps#101
 https://bugzilla.suse.com/show_bug.cgi?id=1099091

ps/ps.1

diff --git a/ps/ps.1 b/ps/ps.1
index 82f973b99b091c3c6c93ce19d45c5078b012d6a1..e651143e2135d5031b13fb7e4397294c8646cd70 100644 (file)
--- a/ps/ps.1
+++ b/ps/ps.1
@@ -4,7 +4,7 @@
 .\" Quick hack conversion by Albert Cahalan, 1998.
 .\" Licensed under version 2 of the Gnu General Public License.
 .\"
-.TH PS 1 "February, 2018" "procps-ng" "User Commands"
+.TH PS 1 2018-08-08 "procps-ng" "User Commands"
 .\"
 .\" To render this page:
 .\"    groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
@@ -240,6 +240,10 @@ Identical to \fB\-\-pid\ \fI123\fR.
 Select by command name.  This selects the processes whose executable name is
 given in
 .IR cmdlist .
+NOTE: The command name is not the same as the command line. Previous versions
+of procps and the kernel truncated this command name to 15 characters. This
+limitation is no longer present in both. If you depended on matching only
+15 characters, you may no longer get a match.
 .TP
 .BI \-G \ grplist
 Select by real group ID (RGID) or name.  This selects the processes whose