From bb272580a6f3c192c61e307f9e341514d892d06e Mon Sep 17 00:00:00 2001 From: Craig Small Date: Wed, 8 Aug 2018 20:13:58 +1000 Subject: [PATCH] docs: Update ps.1 to warn about command name length 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 --- NEWS | 1 + ps/ps.1 | 6 +++++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index d4b15612..201e7467 100644 --- a/NEWS +++ b/NEWS @@ -1,6 +1,7 @@ procps-ng-NEXT ---------------- * docs: Use correct symbols for -h option in free.1 Debian #898774 + * docs: ps.1 now warns about command name length issue #101 * top: can now exploit 256-color terminals issue #96 * top: preserves 'other filters' in configuration file issue #99 * top: can now collapse/expand forest view children issue #99 diff --git a/ps/ps.1 b/ps/ps.1 index b358d2f1..844341c1 100644 --- 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 2018-05-31 "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 & @@ -236,6 +236,10 @@ Identical to 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