linux-kernel - Re: [PATCH] Documentation: /proc/loadavg: add 3 more field descriptions

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <87czxffrde.fsf@meer.lwn.net>
Date:   Thu, 04 Feb 2021 14:35:41 -0700
From:   Jonathan Corbet <corbet@....net>
To:     Randy Dunlap <rdunlap@...radead.org>,
        LKML <linux-kernel@...r.kernel.org>,
        "linux-doc@...r.kernel.org" <linux-doc@...r.kernel.org>
Subject: Re: [PATCH] Documentation: /proc/loadavg: add 3 more field
 descriptions

Randy Dunlap <rdunlap@...radead.org> writes:

> From: Randy Dunlap <rdunlap@...radead.org>
>
> Update contents of /proc/loadavg: add 3 more fields.

...except that two of those fields are actually a single field with a
slash in the middle.

> Signed-off-by: Randy Dunlap <rdunlap@...radead.org>
> Cc: linux-doc@...r.kernel.org
> ---
>  Documentation/filesystems/proc.rst |    5 ++++-
>  1 file changed, 4 insertions(+), 1 deletion(-)
>
> --- linux-next-20210202.orig/Documentation/filesystems/proc.rst
> +++ linux-next-20210202/Documentation/filesystems/proc.rst
> @@ -687,7 +687,10 @@ files are there, and which are missing.
>   kcore        Kernel core image (can be ELF or A.OUT(deprecated in 2.4))
>   kmsg         Kernel messages
>   ksyms        Kernel symbol table
> - loadavg      Load average of last 1, 5 & 15 minutes
> + loadavg      Load average of last 1, 5 & 15 minutes;
> +                number of processes currently runnable (running or on ready queue);
> +                total number of processes in system;

Given that those two fields (for reasons certainly unknown to me) are
different than the rest, it seems like we should actually explain how
they are formatted.

> +                last pid created.
>   locks        Kernel locks
>   meminfo      Memory info
>   misc         Miscellaneous

The patch is an improvement over what's there now, so I've applied it,
but it seems like a further tweak might be called for.

Thanks,

jon