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

INIT_BH<\/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

init_bh, remove_bh, mark_bh, disable_bh, enable_bh \u2212 split-half interrupt handling<\/p>\n

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

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

void\u00a0init_bh(int<\/b> nr<\/i>, void\u00a0(*<\/b>routine<\/i>)(void));<\/b><\/p>\n<\/td>\n

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

void\u00a0remove_bh(int\u00a0<\/b>nr<\/i>);<\/b><\/p>\n<\/td>\n

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

void\u00a0mark_bh(int\u00a0<\/b>nr<\/i>);<\/b><\/p>\n<\/td>\n

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

void\u00a0disable_bh(int\u00a0<\/b>nr<\/i>);<\/b><\/p>\n<\/td>\n

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

void\u00a0enable_bh(int\u00a0<\/b>nr<\/i>);<\/b><\/p>\n<\/td>\n

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

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

Theory<\/b>
Split-half handling is a means of dividing an interrupt handler into two sections, one of which (known as the \u2018top half\u2019) is time-critical and one of which (the \u2018bottom half\u2019) is not.<\/p>\n

The top half (the handler registered with request_irq<\/b>(9)) normally moves data between the device and a memory buffer, ensures that the device is in a sane state, and little else. While the top half of a handler is running, the IRQ is question is blocked; if it is a fast interrupt handler (i.e., it has SA_INTERRUPT<\/b> set), all interrupts are disabled.<\/p>\n

The bottom half does whatever remains to be done. Bottom halves run with interrupts enabled, although a locking mechanism ensures that only one bottom half will be running at a given time. Bottom halves are run by do_bottom_half()<\/b>, which is called from schedule()<\/b> and ret_from_sys_call()<\/b>.<\/p>\n

Usage
init_bh()<\/b> installs routine()<\/i> as bottom half number nr<\/i>. It operates by adding an entry to the bh_base[]<\/b> table, and setting the appropriate bit of the bh_mask<\/b> vector. Rather than specifying a number explicitly, one should add an entry to the anonymous enum in include\/linux\/interrupt.h<\/i>.<\/p>\n

remove_bh()<\/b> removes bottom half number nr<\/i> from the list of bottom halves. It removes the entry from bh_base[]<\/b> and clears the appropriate bit of bh_mask<\/b>.<\/p>\n

mark_bh()<\/b> requests that the kernel run the specified bottom half at the first available opportunity. This function is normally called from the top half of an interrupt handler. It operates by setting the appropriate bit of the bh_active<\/b> vector.<\/p>\n

disable_bh()<\/b> disables bottom half number nr<\/i> by clearing the appropriate bit of bh_mask<\/b>. This function also increments bh_mask_count[<\/b>nr<\/i>]<\/b>, which is used to ensure that nested calls to disable_bh()<\/b> must be matched by an equal number of calls to enable_bh()<\/b>.<\/p>\n

enable_bh()<\/b> enables a bottom half previously disabled by disable_bh()<\/b>. This function decrements bh_mask_count[<\/b>nr<\/i>]<\/b>. Then, if that value is zero, the specified bottom half is enabled by setting the appropriate bit of bh_mask<\/b>.<\/p>\n

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

No value is returned.<\/p>\n

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

Linux 2.0+. init_bh()<\/b> and remove_bh()<\/b> were not present in older versions on Linux. Under those versions, bh_base[]<\/b> and bh_mask<\/b> must be modified by hand.<\/p>\n

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

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

include\/asm*\/softirq.h<\/i>, include\/linux\/interrupt.h<\/i>, kernel\/softirq.c<\/i><\/p>\n

\u201cKernel Korner\u201d in issue 26 of The Linux Journal<\/i> includes a discussion of split-half interrupts under Linux. An online copy of this article can be found at http:\/\/www.ssc.com\/lj\/issue26\/interrupt.html<\/b>.<\/p>\n

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

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

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

Only 32 bottom halves are allowed. Increasing this number requires changing the size of bh_base[]<\/b> and bh_mask_count[]<\/b> in kernel\/softirq.c,<\/i> and changing bh_active<\/b> and bh_mask<\/b> (in the same file) to a larger type. A better solution, however, would be to consolidate multiple bottom halves into a single one by using task queues. See queue_task<\/b>(9) for details.<\/p>\n

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

init_bh, remove_bh, mark_bh, disable_bh, enable_bh \u2212 split-half interrupt handling <\/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,1264,1223,1225],"class_list":["post-4184","post","type-post","status-publish","format-standard","hentry","category-9-rutinas-del-nucleo","tag-1226","tag-init_bh","tag-kernel","tag-man9"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4184","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=4184"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/4184\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=4184"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=4184"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=4184"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}