About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Documentation / sh / register-banks.txt

Custom Search

Based on kernel version 4.13.3. Page generated on 2017-09-23 13:56 EST.

1		Notes on register bank usage in the kernel
2		==========================================
4	Introduction
5	------------
7	The SH-3 and SH-4 CPU families traditionally include a single partial register
8	bank (selected by SR.RB, only r0 ... r7 are banked), whereas other families
9	may have more full-featured banking or simply no such capabilities at all.
11	SR.RB banking
12	-------------
14	In the case of this type of banking, banked registers are mapped directly to
15	r0 ... r7 if SR.RB is set to the bank we are interested in, otherwise ldc/stc
16	can still be used to reference the banked registers (as r0_bank ... r7_bank)
17	when in the context of another bank. The developer must keep the SR.RB value
18	in mind when writing code that utilizes these banked registers, for obvious
19	reasons. Userspace is also not able to poke at the bank1 values, so these can
20	be used rather effectively as scratch registers by the kernel.
22	Presently the kernel uses several of these registers.
24		- r0_bank, r1_bank (referenced as k0 and k1, used for scratch
25		  registers when doing exception handling).
26		- r2_bank (used to track the EXPEVT/INTEVT code)
27			- Used by do_IRQ() and friends for doing irq mapping based off
28			  of the interrupt exception vector jump table offset
29		- r6_bank (global interrupt mask)
30			- The SR.IMASK interrupt handler makes use of this to set the
31			  interrupt priority level (used by local_irq_enable())
32		- r7_bank (current)
Hide Line Numbers
About Kernel Documentation Linux Kernel Contact Linux Resources Linux Blog

Information is copyright its respective author. All material is available from the Linux Kernel Source distributed under a GPL License. This page is provided as a free service by mjmwired.net.