[PATCH] proc.5: Inform that comm in /proc/pid/{stat,status} might also be truncated

[PATCH] proc.5: Inform that comm in /proc/pid/{stat,status} might also be truncated

[Arkadiusz Drabczyk]

pgrep for example searches for a process name in /proc/pid/status and
therefore cannot find processes whose names are longer than 15
characters unless -f is specified.

Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>
---
 man5/proc.5 | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index 538c6c6..edaf281 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2089,6 +2089,9 @@ The process ID.
 .TP
 (2) \fIcomm\fP \ %s
 The filename of the executable, in parentheses.
+Strings longer than
+.B TASK_COMM_LEN
+(16) characters (including the terminating null byte) are silently truncated.
 This is visible whether or not the executable is swapped out.
 .TP
 (3) \fIstate\fP \ %c
@@ -2504,6 +2507,9 @@ The fields are as follows:
 .IP * 2
 .IR Name :
 Command run by this process.
+Strings longer than
+.B TASK_COMM_LEN
+(16) characters (including the terminating null byte) are silently truncated.
 .IP *
 .IR Umask :
 Process umask, expressed in octal with a leading zero; see
-- 
2.9.0

Re: [PATCH] proc.5: Inform that comm in /proc/pid/{stat,status} might also be truncated

[Michael Kerrisk (man-pages)]

Hello Arkadiusz,

On 6/17/20 10:51 PM, Arkadiusz Drabczyk wrote:
> pgrep for example searches for a process name in /proc/pid/status and
> therefore cannot find processes whose names are longer than 15
> characters unless -f is specified.
> 
> Signed-off-by: Arkadiusz Drabczyk <arkadiusz@drabczyk.org>

Thanks. Patch applied.

Cheers,

Michael

> ---
>  man5/proc.5 | 6 ++++++
>  1 file changed, 6 insertions(+)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 538c6c6..edaf281 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -2089,6 +2089,9 @@ The process ID.
>  .TP
>  (2) \fIcomm\fP \ %s
>  The filename of the executable, in parentheses.
> +Strings longer than
> +.B TASK_COMM_LEN
> +(16) characters (including the terminating null byte) are silently truncated.
>  This is visible whether or not the executable is swapped out.
>  .TP
>  (3) \fIstate\fP \ %c
> @@ -2504,6 +2507,9 @@ The fields are as follows:
>  .IP * 2
>  .IR Name :
>  Command run by this process.
> +Strings longer than
> +.B TASK_COMM_LEN
> +(16) characters (including the terminating null byte) are silently truncated.
>  .IP *
>  .IR Umask :
>  Process umask, expressed in octal with a leading zero; see
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/