{"id":4164,"date":"2022-12-20T17:39:35","date_gmt":"2022-12-20T20:39:35","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/probe_irq_on-man9\/"},"modified":"2022-12-20T17:39:35","modified_gmt":"2022-12-20T20:39:35","slug":"probe_irq_on-man9","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/probe_irq_on-man9\/","title":{"rendered":"PROBE_IRQ_ON (man9)"},"content":{"rendered":"

PROBE_IRQ_ON<\/h1>\n

NAME<\/a>
SYNOPSIS<\/a>
DESCRIPTION<\/a>
RETURN VALUE<\/a>
AVAILABILITY<\/a>
SEE ALSO<\/a>
AUTHOR<\/a>
BUGS<\/a> <\/p>\n

\n

NAME <\/a> <\/h2>\n

probe_irq_on, probe_irq_off \u2212 safe probing for IRQs<\/p>\n

SYNOPSIS <\/a> <\/h2>\n

#include <\/b><\/p>\n\n\n\n
<\/td>\n\n

unsigned\u00a0long\u00a0probe_irq_on(void)<\/b><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n
<\/td>\n\n

int\u00a0probe_irq_off(unsigned\u00a0long<\/b> irqs<\/i>);<\/b><\/p>\n<\/td>\n

 <\/td>\n<\/tr>\n<\/table>\n

DESCRIPTION <\/a> <\/h2>\n

Usage
probe_irq_on()<\/b> turns on IRQ detection. It operates by enabling all interrupts which have no handlers, while keeping the handlers for those interrupts NULL. The kernel\u2019s generic interrupt handling routine will disable these IRQs when an interrupt is received on them. probe_irq_on()<\/b> adds each of these IRQ numbers to a vector which it will return. It waits approximately 100ms for any spurious interrupts that may occur, and masks these from its vector; it then returns this vector to its caller.<\/p>\n

probe_irq_off()<\/b> tests an internal list of enabled IRQs against its irqs<\/i> parameter, which should be the value returned by the last probe_irq_on()<\/b>. This function basically detects which IRQs have been switched off, and thus which ones have received interrupts.<\/p>\n

Example<\/b>
This explanation may seem a bit confusing, so here is an example of code the mythical FUBAR 2000 driver could use to probe for IRQs:<\/p>\n

unsigned long irqs;
int irq;<\/p>\n

irqs = probe_irq_on();<\/p>\n

outb(FB2K_GIVE_ME_AN_INTERRUPT_OR_GIVE_ME_DEATH,
FB2K_CONTROL_PORT);
\/bin \/boot \/dead.letter \/dev \/etc \/home \/initrd \/lib \/lib64 \/lost+found \/media \/mnt \/opt \/proc \/release-notes.html \/release-notes.txt \/root \/run \/sbin \/srv \/sys \/tmp \/usr \/var the interrupt could take a while to occur bodies\/ usr\/
udelay(1000);<\/p>\n

irq = probe_irq_off(irqs);<\/p>\n

if (irq == 0) {<\/p>\n\n\n\n
<\/td>\n\n

printk(“fb2k: could not detect IRQ.n”);<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

printk(“fb2k: Installation failed.n”);<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

} else if (irq == -1) {<\/p>\n\n\n\n
<\/td>\n\n

printk(“fb2k: multiple IRQs detected.n”);<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

printk(“fb2k: Installation failed.n”);<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

} else {<\/p>\n\n\n\n
<\/td>\n\n

fb2k_dev->irq = irq;<\/p>\n<\/td>\n<\/tr>\n

<\/td>\n\n

printk(“fb2k: using probed IRQ %d.n”, irq);<\/p>\n<\/td>\n<\/tr>\n<\/table>\n

}<\/p>\n

RETURN VALUE <\/a> <\/h2>\n

probe_irq_on()<\/b> returns a bitmap of all unhandled IRQs (except those which are receiving spurious interrupts). This value should only be used as a parameter to the next call to probe_irq_off()<\/b>.<\/p>\n

probe_irq_off()<\/b> returns the IRQ number of whichever unhandled interrupt has occurred since the last probe_irq_on()<\/b>. If no interrupts have occurred on any of the marked IRQs, 0 is returned; if interrupts have occurred on more than one of these IRQs, -1 is returned.<\/p>\n

AVAILABILITY <\/a> <\/h2>\n

Linux 1.2+. These functions are not available on m68k-based machines.<\/p>\n

SEE ALSO <\/a> <\/h2>\n

request_irq<\/b>(9)<\/p>\n

arch\/*\/kernel\/irq.c<\/i><\/p>\n

AUTHOR <\/a> <\/h2>\n

Neil Moore <amethyst@maxwell.ml.org<\/i>><\/p>\n

BUGS <\/a> <\/h2>\n

As mentioned above, these functions are not available on m68k-based machines.<\/p>\n

This manpage is way too confusing.<\/p>\n

\n","protected":false},"excerpt":{"rendered":"

probe_irq_on, probe_irq_off \u2212 safe probing for IRQs <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1222],"tags":[1226,1223,1225,1244],"class_list":["post-4164","post","type-post","status-publish","format-standard","hentry","category-9-rutinas-del-nucleo","tag-1226","tag-kernel","tag-man9","tag-probe_irq_on"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4164","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=4164"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4164\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=4164"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=4164"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=4164"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}