Thread (2 messages) 2 messages, 2 authors, 2021-03-24

Re: /proc/<pid>/stat file documentation

From: Stefan Puiu <hidden>
Date: 2021-03-24 18:20:27

Hi Ákos,

On Mon, Mar 22, 2021 at 10:50 AM Szőts Ákos [off-list ref] wrote:
Dear Michael,

I found a documentation deficiency on [1] in /proc/<pid>/stat file (Table
1-4). May I ask you to indicate in this table that ESP and EIP have non-zero
values only when the process is exiting or dumping core and the calling
process has the permission for PTRACE_MODE_READ_FSCREDS | PTRACE_MODE_NOAUDIT.
For implementation reference see [2].
You're pointing to the in-kernel documentation (link [1]). As far as I
know, that's not maintained by the man-pages project, so they might
not be able to help with changing that.

The man page for proc is here though:
https://man7.org/linux/man-pages/man5/procfs.5.html, maybe the info
can be added there?
Please, also note that for many of the reported numbers in this table the
aforementioned permissions are needed to be displayed correctly (as non-
zeroes). They are start_code, end_code, start_stack, esp, eip, wchan,
start_data, end_data, start_brk, arg_start, arg_end, env_start, env_end, and
exit_code.

A small addition: I also observed that on [3] the "blog" points to 404.
I get an SSL error in Firefox ("Secure Connection Failed" and
"PR_END_OF_FILE_ERROR") when trying to click the blog link
(https://blog.man7.org/).

Stefan.
Thank you and all the best,

Ákos

[1]: https://www.kernel.org/doc/html/latest/filesystems/proc.html
[2]: https://github.com/torvalds/linux/blob/master/fs/proc/array.c#L481-L502
[3]: https://www.kernel.org/doc/man-pages/maintaining.html
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help