[lkml]   [2013]   [Feb]   [4]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
Messages in this thread
SubjectRe: [docs] /proc/irq/
On 01/30/2013 03:44:32 AM, Oleg wrote:
> Hello.
> Where can i find an info about /proc/irq/*/affinity_hint ?
> Documentation/filesystems/proc.txt says nothing about it (3.2.37
> kernel).

The general procedure is to look for the git commit, which may have a
good commit comment, and also gives you an idea when it went in so you
can look in the mailing list archives:

cd linux
find . -name '"affinity_hint"'
git annotate kernel/proc/irq.c
(search for "affinity_hint" in quotes, line 331 here, the bit on the
left edge is the commit hash.)

commit e7a297b0d7d6049bd4e423ac1e17da31e4c401b8
Author: Peter P Waskiewicz Jr <>
Date: Fri Apr 30 14:44:50 2010 -0700

genirq: Add CPU mask affinity hint

This patch adds a cpumask affinity hint to the irq_desc structure,
along with a registration function and a read-only proc entry for

This affinity_hint handle for each interrupt can be used by
drivers that need a better mechanism to control interrupt affinity.
The underlying driver can register a cpumask for the interrupt,
will allow the driver to provide the CPU mask for the interrupt to
anything that requests it. The intent is to extend the userspace
daemon, irqbalance, to help hint to it a preferred CPU mask to
the interrupt into.

[ tglx: Fixed compile warnings, added WARN_ON, made SMP only ]

Signed-off-by: Peter P Waskiewicz Jr

That doesn't clarifiy much. Grepping the source for irq_affinity it
looks like the kernel treats this as a write-only property, and never
does anything with the info. However, include/linux/irqdesc.h has
documentation for the structure containing the property, and it says
this about that field:

* @affinity_hint: hint to user space for preferred irq affinity

So this "irqbalance" daemon you're probably not running (unless it got
sucked into the systemd hairball, in which case you don't know you're
running it and can't stop it) reads this process and tells the kernel
to move the irq worker thread to this CPU while load balancing.

It sounds like you're saying Documentation/filesystems/proc.txt should
be updated to include this information?


 \ /
  Last update: 2013-02-04 17:03    [W:0.046 / U:0.300 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site