€•×'      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ*/translations/zh_CN/arch/sh/register-banks”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/zh_TW/arch/sh/register-banks”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/it_IT/arch/sh/register-banks”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ja_JP/arch/sh/register-banks”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/ko_KR/arch/sh/register-banks”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ*/translations/sp_SP/arch/sh/register-banks”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒD/var/lib/git/docbuild/linux/Documentation/arch/sh/register-banks.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ*Notes on register bank usage in the kernel”h]”hŒ*Notes on register bank usage in the kernel”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hhÌhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhÉhžhhŸh³h KubhŒ	paragraph”“”)”}”(hŒåThe SH-3 and SH-4 CPU families traditionally include a single partial register
bank (selected by SR.RB, only r0 ... r7 are banked), whereas other families
may have more full-featured banking or simply no such capabilities at all.”h]”hŒåThe SH-3 and SH-4 CPU families traditionally include a single partial register
bank (selected by SR.RB, only r0 ... r7 are banked), whereas other families
may have more full-featured banking or simply no such capabilities at all.”…””}”(hhÜhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K
hhÉhžhubeh}”(h]”Œintroduction”ah ]”h"]”Œintroduction”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒSR.RB banking”h]”hŒSR.RB banking”…””}”(hhõhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hhòhžhhŸh³h KubhÛ)”}”(hX  In the case of this type of banking, banked registers are mapped directly to
r0 ... r7 if SR.RB is set to the bank we are interested in, otherwise ldc/stc
can still be used to reference the banked registers (as r0_bank ... r7_bank)
when in the context of another bank. The developer must keep the SR.RB value
in mind when writing code that utilizes these banked registers, for obvious
reasons. Userspace is also not able to poke at the bank1 values, so these can
be used rather effectively as scratch registers by the kernel.”h]”hX  In the case of this type of banking, banked registers are mapped directly to
r0 ... r7 if SR.RB is set to the bank we are interested in, otherwise ldc/stc
can still be used to reference the banked registers (as r0_bank ... r7_bank)
when in the context of another bank. The developer must keep the SR.RB value
in mind when writing code that utilizes these banked registers, for obvious
reasons. Userspace is also not able to poke at the bank1 values, so these can
be used rather effectively as scratch registers by the kernel.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhòhžhubhÛ)”}”(hŒ5Presently the kernel uses several of these registers.”h]”hŒ5Presently the kernel uses several of these registers.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhhòhžhubhŒblock_quote”“”)”}”(hXà  - r0_bank, r1_bank (referenced as k0 and k1, used for scratch
  registers when doing exception handling).

- r2_bank (used to track the EXPEVT/INTEVT code)

        - Used by do_IRQ() and friends for doing irq mapping based off
          of the interrupt exception vector jump table offset

- r6_bank (global interrupt mask)

        - The SR.IMASK interrupt handler makes use of this to set the
          interrupt priority level (used by local_irq_enable())

- r7_bank (current)”h]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒfr0_bank, r1_bank (referenced as k0 and k1, used for scratch
registers when doing exception handling).
”h]”hÛ)”}”(hŒer0_bank, r1_bank (referenced as k0 and k1, used for scratch
registers when doing exception handling).”h]”hŒer0_bank, r1_bank (referenced as k0 and k1, used for scratch
registers when doing exception handling).”…””}”(hj0  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h Khj,  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j*  hj'  ubj+  )”}”(hŒ±r2_bank (used to track the EXPEVT/INTEVT code)

      - Used by do_IRQ() and friends for doing irq mapping based off
        of the interrupt exception vector jump table offset
”h]”(hÛ)”}”(hŒ.r2_bank (used to track the EXPEVT/INTEVT code)”h]”hŒ.r2_bank (used to track the EXPEVT/INTEVT code)”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h KhjD  ubj   )”}”(hŒu- Used by do_IRQ() and friends for doing irq mapping based off
  of the interrupt exception vector jump table offset
”h]”j&  )”}”(hhh]”j+  )”}”(hŒqUsed by do_IRQ() and friends for doing irq mapping based off
of the interrupt exception vector jump table offset
”h]”hÛ)”}”(hŒpUsed by do_IRQ() and friends for doing irq mapping based off
of the interrupt exception vector jump table offset”h]”hŒpUsed by do_IRQ() and friends for doing irq mapping based off
of the interrupt exception vector jump table offset”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K hj]  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j*  hjZ  ubah}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1j%  hŸh³h K hjV  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h K hjD  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j*  hj'  ubj+  )”}”(hŒ£r6_bank (global interrupt mask)

      - The SR.IMASK interrupt handler makes use of this to set the
        interrupt priority level (used by local_irq_enable())
”h]”(hÛ)”}”(hŒr6_bank (global interrupt mask)”h]”hŒr6_bank (global interrupt mask)”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K#hj‰  ubj   )”}”(hŒv- The SR.IMASK interrupt handler makes use of this to set the
  interrupt priority level (used by local_irq_enable())
”h]”j&  )”}”(hhh]”j+  )”}”(hŒrThe SR.IMASK interrupt handler makes use of this to set the
interrupt priority level (used by local_irq_enable())
”h]”hÛ)”}”(hŒqThe SR.IMASK interrupt handler makes use of this to set the
interrupt priority level (used by local_irq_enable())”h]”hŒqThe SR.IMASK interrupt handler makes use of this to set the
interrupt priority level (used by local_irq_enable())”…””}”(hj¦  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K%hj¢  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j*  hjŸ  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1j%  hŸh³h K%hj›  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h K%hj‰  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j*  hj'  ubj+  )”}”(hŒr7_bank (current)”h]”hÛ)”}”(hjÎ  h]”hŒr7_bank (current)”…””}”(hjÐ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÚhŸh³h K(hjÌ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j*  hj'  ubeh}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1j%  hŸh³h Khj!  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j  hŸh³h Khhòhžhubeh}”(h]”Œsr-rb-banking”ah ]”h"]”Œsr.rb banking”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubeh}”(h]”Œ*notes-on-register-bank-usage-in-the-kernel”ah ]”h"]”Œ*notes on register bank usage in the kernel”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j"  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jü  jù  hïhìjô  jñ  uŒ	nametypes”}”(jü  ‰hï‰jô  ‰uh}”(jù  h¶hìhÉjñ  hòuŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.