linux-kernel - Re: [PATCH] proc: fix documentation for /proc/stat, line "intr"

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] [thread-next>] [day] [month] [year] [list]

Date:	Tue, 22 Apr 2014 15:35:39 -0700
From:	Randy Dunlap <rdunlap@...radead.org>
To:	"Michael Kerrisk (man-pages)" <mtk.manpages@...il.com>,
	Jan Moskyto Matejka <mq@...e.cz>
CC:	linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH] proc: fix documentation for /proc/stat, line "intr"

On 04/22/14 11:19, Michael Kerrisk (man-pages) wrote:
> On 04/22/2014 05:29 PM, Jan Moskyto Matejka wrote:
>> The sum at the beginning of line "intr" includes also unnumbered interrupts.
>> It implies that the sum at the beginning isn't the sum of the remainder of the
>> line, not even an estimation.
>>
>> Fixed the documentation to mention that.
> 
> I'm not really doubting what you claim, Jan, but it would be really
> helpful if you provided some data to support the proposed change
> (Kernel source references, or notes about testing you've done, or 
> pointers to mailing list threads, authoritative note that you are
> the maintainer of some relevant kernel subsystem...). Do you have
> something like that? (It's also useful for the change log.)

I wouldn't mind more of a changelog, but the additional text is
certainly correct.

Thanks.  I'll apply the patch, but more changelog comments are welcome.

> Thanks,
> 
> Michael
> 
>> Signed-off-by: Jan Moskyto Matejka <mq@...e.cz>
>> ---
>>  Documentation/filesystems/proc.txt | 5 +++--
>>  1 file changed, 3 insertions(+), 2 deletions(-)
>>
>> diff --git a/Documentation/filesystems/proc.txt b/Documentation/filesystems/proc.txt
>> index f00bee1..4e6f9d0 100644
>> --- a/Documentation/filesystems/proc.txt
>> +++ b/Documentation/filesystems/proc.txt
>> @@ -1245,8 +1245,9 @@ second).  The meanings of the columns are as follows, from left to right:
>>  
>>  The "intr" line gives counts of interrupts  serviced since boot time, for each
>>  of the  possible system interrupts.   The first  column  is the  total of  all
>> -interrupts serviced; each  subsequent column is the  total for that particular
>> -interrupt.
>> +interrupts serviced  including  unnumbered  architecture specific  interrupts;
>> +each  subsequent column is the  total for that particular numbered interrupt.
>> +Unnumbered interrupts are not shown, only summed into the total.
>>  
>>  The "ctxt" line gives the total number of context switches across all CPUs.
>>  
>>
> 
> 


-- 
~Randy
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/