(sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget /translations/zh_CN/arch/x86/patmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/zh_TW/arch/x86/patmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/it_IT/arch/x86/patmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ja_JP/arch/x86/patmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/ko_KR/arch/x86/patmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/pt_BR/arch/x86/patmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget /translations/sp_SP/arch/x86/patmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhh:/var/lib/git/docbuild/linux/Documentation/arch/x86/pat.rsthKubhsection)}(hhh](htitle)}(hPAT (Page Attribute Table)h]hPAT (Page Attribute Table)}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(hX,x86 Page Attribute Table (PAT) allows for setting the memory attribute at the page level granularity. PAT is complementary to the MTRR settings which allows for setting of memory types over physical address ranges. However, PAT is more flexible than MTRR due to its capability to set attributes at page level and also due to the fact that there are no hardware limitations on number of such attribute settings allowed. Added flexibility comes with guidelines for not having memory type aliasing for the same physical memory with multiple virtual addresses.h]hX,x86 Page Attribute Table (PAT) allows for setting the memory attribute at the page level granularity. PAT is complementary to the MTRR settings which allows for setting of memory types over physical address ranges. However, PAT is more flexible than MTRR due to its capability to set attributes at page level and also due to the fact that there are no hardware limitations on number of such attribute settings allowed. Added flexibility comes with guidelines for not having memory type aliasing for the same physical memory with multiple virtual addresses.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(hyPAT allows for different types of memory attributes. The most commonly used ones that will be supported at this time are:h]hyPAT allows for different types of memory attributes. The most commonly used ones that will be supported at this time are:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubhtable)}(hhh]htgroup)}(hhh](hcolspec)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjubhtbody)}(hhh](hrow)}(hhh](hentry)}(hhh]h)}(hWBh]hWB}(hj*hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj'ubah}(h]h ]h"]h$]h&]uh1j%hj"ubj&)}(hhh]h)}(h Write-backh]h Write-back}(hjAhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj>ubah}(h]h ]h"]h$]h&]uh1j%hj"ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hUCh]hUC}(hjahhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj^ubah}(h]h ]h"]h$]h&]uh1j%hj[ubj&)}(hhh]h)}(hUncachedh]hUncached}(hjxhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjuubah}(h]h ]h"]h$]h&]uh1j%hj[ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hWCh]hWC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hWrite-combinedh]hWrite-combined}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hWTh]hWT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h Write-throughh]h Write-through}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hUC-h]hUC-}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUncached Minush]hUncached Minus}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh)}(hhh](h)}(hPAT APIsh]hPAT APIs}(hjMhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjJhhhhhKubh)}(hXThere are many different APIs in the kernel that allows setting of memory attributes at the page level. In order to avoid aliasing, these interfaces should be used thoughtfully. Below is a table of interfaces available, their intended usage and their memory attribute relationships. Internally, these APIs use a reserve_memtype()/free_memtype() interface on the physical address range to avoid any aliasing.h]hXThere are many different APIs in the kernel that allows setting of memory attributes at the page level. In order to avoid aliasing, these interfaces should be used thoughtfully. Below is a table of interfaces available, their intended usage and their memory attribute relationships. Internally, these APIs use a reserve_memtype()/free_memtype() interface on the physical address range to avoid any aliasing.}(hj[hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjJhhubh)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjlubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjlubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjlubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhjlubj)}(hhh](j!)}(hhh](j&)}(hhh]h)}(hAPIh]hAPI}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hRAMh]hRAM}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hACPI,...h]hACPI,...}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hReserved/Holesh]hReserved/Holes}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hioremaph]hioremap}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUC-h]hUC-}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hj0ubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUC-h]hUC-}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK)hjGubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h ioremap_cacheh]h ioremap_cache}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjgubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hj~ubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(hWBh]hWB}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(hWBh]hWB}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hjubah}(h]h ]h"]h$]h&]uh1j%hjdubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h ioremap_uch]h ioremap_uc}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUCh]hUC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUCh]hUC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK-hjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h ioremap_wch]h ioremap_wc}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj1ubah}(h]h ]h"]h$]h&]uh1j%hj.ubj&)}(hhh]h)}(h--h]h--}(hjKhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjHubah}(h]h ]h"]h$]h&]uh1j%hj.ubj&)}(hhh]h)}(h--h]h--}(hjbhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hj_ubah}(h]h ]h"]h$]h&]uh1j%hj.ubj&)}(hhh]h)}(hWCh]hWC}(hjyhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK/hjvubah}(h]h ]h"]h$]h&]uh1j%hj.ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h ioremap_wth]h ioremap_wt}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hWTh]hWT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK1hjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hset_memory_uc, set_memory_wbh]hset_memory_uc, set_memory_wb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUC-h]hUC-}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hj,hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hj)ubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjChhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hj@ubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hset_memory_wc, set_memory_wbh]hset_memory_wc, set_memory_wb}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hj`ubah}(h]h ]h"]h$]h&]uh1j%hj]ubj&)}(hhh]h)}(hWCh]hWC}(hjzhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjwubah}(h]h ]h"]h$]h&]uh1j%hj]ubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjubah}(h]h ]h"]h$]h&]uh1j%hj]ubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK6hjubah}(h]h ]h"]h$]h&]uh1j%hj]ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hset_memory_wt, set_memory_wbh]hset_memory_wt, set_memory_wb}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hWTh]hWT}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK9hj ubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hpci sysfs resourceh]hpci sysfs resource}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hWCh]hWC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK>hjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hpci proc !PCIIOC_WRITE_COMBINEh]hpci proc !PCIIOC_WRITE_COMBINE}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhj ubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hj%hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhj"ubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hUC-h]hUC-}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKAhj9ubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hpci proc PCIIOC_WRITE_COMBINEh]hpci proc PCIIOC_WRITE_COMBINE}(hj\hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjYubah}(h]h ]h"]h$]h&]uh1j%hjVubj&)}(hhh]h)}(h--h]h--}(hjshhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjpubah}(h]h ]h"]h$]h&]uh1j%hjVubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjubah}(h]h ]h"]h$]h&]uh1j%hjVubj&)}(hhh]h)}(hWCh]hWC}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKDhjubah}(h]h ]h"]h$]h&]uh1j%hjVubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h/dev/mem read-writeh]h/dev/mem read-write}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h WB/WC/UC-h]h WB/WC/UC-}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h WB/WC/UC-h]h WB/WC/UC-}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKGhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h/dev/mem mmap SYNC flagh]h/dev/mem mmap SYNC flag}(hj&hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhj#ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(h--h]h--}(hj=hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhj:ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hUC-h]hUC-}(hjThhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjQubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hUC-h]hUC-}(hjkhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKJhjhubah}(h]h ]h"]h$]h&]uh1j%hj ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h3/dev/mem mmap !SYNC flag and any alias to this areah]h3/dev/mem mmap !SYNC flag and any alias to this area}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h--h]h--}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh](h block_quote)}(h WB/WC/UC- h]h)}(h WB/WC/UC-h]h WB/WC/UC-}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubah}(h]h ]h"]h$]h&]uh1jhhhKMhjubh)}(h(from existing alias)h]h(from existing alias)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubeh}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh](h)}(h WB/WC/UC-h]h WB/WC/UC-}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKMhjubh)}(h(from existing alias)h]h(from existing alias)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjubeh}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h?/dev/mem mmap !SYNC flag no alias to this area and MTRR says WBh]h?/dev/mem mmap !SYNC flag no alias to this area and MTRR says WB}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(h--h]h--}(hj/ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhj, ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hWBh]hWB}(hjF hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjC ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hWBh]hWB}(hj] hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKRhjZ ubah}(h]h ]h"]h$]h&]uh1j%hj ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h@/dev/mem mmap !SYNC flag no alias to this area and MTRR says !WBh]h@/dev/mem mmap !SYNC flag no alias to this area and MTRR says !WB}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjz ubah}(h]h ]h"]h$]h&]uh1j%hjw ubj&)}(hhh]h)}(h--h]h--}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhj ubah}(h]h ]h"]h$]h&]uh1j%hjw ubj&)}(hhh]h)}(h--h]h--}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhj ubah}(h]h ]h"]h$]h&]uh1j%hjw ubj&)}(hhh]h)}(hUC-h]hUC-}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhj ubah}(h]h ]h"]h$]h&]uh1j%hjw ubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjlubeh}(h]h ]h"]h$]h&]colsKuh1jhjiubah}(h]h ]h"]h$]h&]uh1hhjJhhhhhNubeh}(h]pat-apisah ]h"]pat apisah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hAdvanced APIs for driversh]hAdvanced APIs for drivers}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKaubh)}(hUA. Exporting pages to users with remap_pfn_range, io_remap_pfn_range, vmf_insert_pfn.h]hUA. Exporting pages to users with remap_pfn_range, io_remap_pfn_range, vmf_insert_pfn.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKchj hhubh)}(heDrivers wanting to export some pages to userspace do it by using mmap interface and a combination of:h]heDrivers wanting to export some pages to userspace do it by using mmap interface and a combination of:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKfhj hhubj)}(hW1) pgprot_noncached() 2) io_remap_pfn_range() or remap_pfn_range() or vmf_insert_pfn() h]henumerated_list)}(hhh](h list_item)}(hpgprot_noncached()h]h)}(hj1 h]hpgprot_noncached()}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKihj/ ubah}(h]h ]h"]h$]h&]uh1j- hj* ubj. )}(h>io_remap_pfn_range() or remap_pfn_range() or vmf_insert_pfn() h]h)}(h=io_remap_pfn_range() or remap_pfn_range() or vmf_insert_pfn()h]h=io_remap_pfn_range() or remap_pfn_range() or vmf_insert_pfn()}(hjJ hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKjhjF ubah}(h]h ]h"]h$]h&]uh1j- hj* ubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix)uh1j( hj$ ubah}(h]h ]h"]h$]h&]uh1jhhhKihj hhubh)}(hWith PAT support, a new API pgprot_writecombine is being added. So, drivers can continue to use the above sequence, with either pgprot_noncached() or pgprot_writecombine() in step 1, followed by step 2.h]hWith PAT support, a new API pgprot_writecombine is being added. So, drivers can continue to use the above sequence, with either pgprot_noncached() or pgprot_writecombine() in step 1, followed by step 2.}(hjo hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKlhj hhubh)}(hwIn addition, step 2 internally tracks the region as UC or WC in memtype list in order to ensure no conflicting mapping.h]hwIn addition, step 2 internally tracks the region as UC or WC in memtype list in order to ensure no conflicting mapping.}(hj} hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKphj hhubh)}(hXNote that this set of APIs only works with IO (non RAM) regions. If driver wants to export a RAM region, it has to do set_memory_uc() or set_memory_wc() as step 0 above and also track the usage of those pages and use set_memory_wb() before the page is freed to free pool.h]hXNote that this set of APIs only works with IO (non RAM) regions. If driver wants to export a RAM region, it has to do set_memory_uc() or set_memory_wc() as step 0 above and also track the usage of those pages and use set_memory_wb() before the page is freed to free pool.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKshj hhubeh}(h]advanced-apis-for-driversah ]h"]advanced apis for driversah$]h&]uh1hhhhhhhhKaubh)}(hhh](h)}(h%MTRR effects on PAT / non-PAT systemsh]h%MTRR effects on PAT / non-PAT systems}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKyubh)}(hXThe following table provides the effects of using write-combining MTRRs when using ioremap*() calls on x86 for both non-PAT and PAT systems. Ideally mtrr_add() usage will be phased out in favor of arch_phys_wc_add() which will be a no-op on PAT enabled systems. The region over which a arch_phys_wc_add() is made, should already have been ioremapped with WC attributes or PAT entries, this can be done by using ioremap_wc() / set_memory_wc(). Devices which combine areas of IO memory desired to remain uncacheable with areas where write-combining is desirable should consider use of ioremap_uc() followed by set_memory_wc() to white-list effective write-combined areas. Such use is nevertheless discouraged as the effective memory type is considered implementation defined, yet this strategy can be used as last resort on devices with size-constrained regions where otherwise MTRR write-combining would otherwise not be effective. ::h]hXThe following table provides the effects of using write-combining MTRRs when using ioremap*() calls on x86 for both non-PAT and PAT systems. Ideally mtrr_add() usage will be phased out in favor of arch_phys_wc_add() which will be a no-op on PAT enabled systems. The region over which a arch_phys_wc_add() is made, should already have been ioremapped with WC attributes or PAT entries, this can be done by using ioremap_wc() / set_memory_wc(). Devices which combine areas of IO memory desired to remain uncacheable with areas where write-combining is desirable should consider use of ioremap_uc() followed by set_memory_wc() to white-list effective write-combined areas. Such use is nevertheless discouraged as the effective memory type is considered implementation defined, yet this strategy can be used as last resort on devices with size-constrained regions where otherwise MTRR write-combining would otherwise not be effective.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK{hj hhubh literal_block)}(hX;==== ======= === ========================= ===================== MTRR Non-PAT PAT Linux ioremap value Effective memory type ==== ======= === ========================= ===================== PAT Non-PAT | PAT |PCD | ||PWT | ||| | WC 000 WB _PAGE_CACHE_MODE_WB WC | WC WC 001 WC _PAGE_CACHE_MODE_WC WC* | WC WC 010 UC- _PAGE_CACHE_MODE_UC_MINUS WC* | UC WC 011 UC _PAGE_CACHE_MODE_UC UC | UC ==== ======= === ========================= ===================== (*) denotes implementation defined and is discouragedh]hX;==== ======= === ========================= ===================== MTRR Non-PAT PAT Linux ioremap value Effective memory type ==== ======= === ========================= ===================== PAT Non-PAT | PAT |PCD | ||PWT | ||| | WC 000 WB _PAGE_CACHE_MODE_WB WC | WC WC 001 WC _PAGE_CACHE_MODE_WC WC* | WC WC 010 UC- _PAGE_CACHE_MODE_UC_MINUS WC* | UC WC 011 UC _PAGE_CACHE_MODE_UC UC | UC ==== ======= === ========================= ===================== (*) denotes implementation defined and is discouraged}hj sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhj hhubhnote)}(h-- in the above table mean "Not suggested usage for the API". Some of the --'s are strictly enforced by the kernel. Some others are not really enforced today, but may be enforced in future.h]h)}(h-- in the above table mean "Not suggested usage for the API". Some of the --'s are strictly enforced by the kernel. Some others are not really enforced today, but may be enforced in future.h]h-- in the above table mean “Not suggested usage for the API”. Some of the --‘s are strictly enforced by the kernel. Some others are not really enforced today, but may be enforced in future.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j hj hhhhhNubh)}(hX For ioremap and pci access through /sys or /proc - The actual type returned can be more restrictive, in case of any existing aliasing for that address. For example: If there is an existing uncached mapping, a new ioremap_wc can return uncached mapping in place of write-combine requested.h]hX For ioremap and pci access through /sys or /proc - The actual type returned can be more restrictive, in case of any existing aliasing for that address. For example: If there is an existing uncached mapping, a new ioremap_wc can return uncached mapping in place of write-combine requested.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hset_memory_[uc|wc|wt] and set_memory_wb should be used in pairs, where driver will first make a region uc, wc or wt and switch it back to wb after use.h]hset_memory_[uc|wc|wt] and set_memory_wb should be used in pairs, where driver will first make a region uc, wc or wt and switch it back to wb after use.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hOver time writes to /proc/mtrr will be deprecated in favor of using PAT based interfaces. Users writing to /proc/mtrr are suggested to use above interfaces.h]hOver time writes to /proc/mtrr will be deprecated in favor of using PAT based interfaces. Users writing to /proc/mtrr are suggested to use above interfaces.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hPDrivers should use ioremap_[uc|wc] to access PCI BARs with [uc|wc] access types.h]hPDrivers should use ioremap_[uc|wc] to access PCI BARs with [uc|wc] access types.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hKDrivers should use set_memory_[uc|wc|wt] to set access type for RAM ranges.h]hKDrivers should use set_memory_[uc|wc|wt] to set access type for RAM ranges.}(hj" hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubeh}(h]#mtrr-effects-on-pat-non-pat-systemsah ]h"]%mtrr effects on pat / non-pat systemsah$]h&]uh1hhhhhhhhKyubh)}(hhh](h)}(h PAT debuggingh]h PAT debugging}(hj; hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj8 hhhhhKubh)}(hCWith CONFIG_DEBUG_FS enabled, PAT memtype list can be examined by::h]hBWith CONFIG_DEBUG_FS enabled, PAT memtype list can be examined by:}(hjI hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj8 hhubj )}(hX# mount -t debugfs debugfs /sys/kernel/debug # cat /sys/kernel/debug/x86/pat_memtype_list PAT memtype list: uncached-minus @ 0x7fadf000-0x7fae0000 uncached-minus @ 0x7fb19000-0x7fb1a000 uncached-minus @ 0x7fb1a000-0x7fb1b000 uncached-minus @ 0x7fb1b000-0x7fb1c000 uncached-minus @ 0x7fb1c000-0x7fb1d000 uncached-minus @ 0x7fb1d000-0x7fb1e000 uncached-minus @ 0x7fb1e000-0x7fb25000 uncached-minus @ 0x7fb25000-0x7fb26000 uncached-minus @ 0x7fb26000-0x7fb27000 uncached-minus @ 0x7fb27000-0x7fb28000 uncached-minus @ 0x7fb28000-0x7fb2e000 uncached-minus @ 0x7fb2e000-0x7fb2f000 uncached-minus @ 0x7fb2f000-0x7fb30000 uncached-minus @ 0x7fb31000-0x7fb32000 uncached-minus @ 0x80000000-0x90000000h]hX# mount -t debugfs debugfs /sys/kernel/debug # cat /sys/kernel/debug/x86/pat_memtype_list PAT memtype list: uncached-minus @ 0x7fadf000-0x7fae0000 uncached-minus @ 0x7fb19000-0x7fb1a000 uncached-minus @ 0x7fb1a000-0x7fb1b000 uncached-minus @ 0x7fb1b000-0x7fb1c000 uncached-minus @ 0x7fb1c000-0x7fb1d000 uncached-minus @ 0x7fb1d000-0x7fb1e000 uncached-minus @ 0x7fb1e000-0x7fb25000 uncached-minus @ 0x7fb25000-0x7fb26000 uncached-minus @ 0x7fb26000-0x7fb27000 uncached-minus @ 0x7fb27000-0x7fb28000 uncached-minus @ 0x7fb28000-0x7fb2e000 uncached-minus @ 0x7fb2e000-0x7fb2f000 uncached-minus @ 0x7fb2f000-0x7fb30000 uncached-minus @ 0x7fb31000-0x7fb32000 uncached-minus @ 0x80000000-0x90000000}hjW sbah}(h]h ]h"]h$]h&]hhuh1j hhhKhj8 hhubh)}(hnThis list shows physical address ranges and various PAT settings used to access those physical address ranges.h]hnThis list shows physical address ranges and various PAT settings used to access those physical address ranges.}(hje hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj8 hhubh)}(hAnother, more verbose way of getting PAT related debug messages is with "debugpat" boot parameter. With this parameter, various debug messages are printed to dmesg log.h]hAnother, more verbose way of getting PAT related debug messages is with “debugpat” boot parameter. With this parameter, various debug messages are printed to dmesg log.}(hjs hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj8 hhubeh}(h] pat-debuggingah ]h"] pat debuggingah$]h&]uh1hhhhhhhhKubh)}(hhh](h)}(hPAT Initializationh]hPAT Initialization}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj hhhhhKubh)}(hX"The following table describes how PAT is initialized under various configurations. The PAT MSR must be updated by Linux in order to support WC and WT attributes. Otherwise, the PAT MSR has the value programmed in it by the firmware. Note, Xen enables WC attribute in the PAT MSR for guests.h]hX"The following table describes how PAT is initialized under various configurations. The PAT MSR must be updated by Linux in order to support WC and WT attributes. Otherwise, the PAT MSR has the value programmed in it by the firmware. Note, Xen enables WC attribute in the PAT MSR for guests.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(hX==== ===== ========================== ========= ======= MTRR PAT Call Sequence PAT State PAT MSR ==== ===== ========================== ========= ======= E E MTRR -> PAT init Enabled OS E D MTRR -> PAT init Disabled - D E MTRR -> PAT disable Disabled BIOS D D MTRR -> PAT disable Disabled - - np/E PAT -> PAT disable Disabled BIOS - np/D PAT -> PAT disable Disabled - E !P/E MTRR -> PAT init Disabled BIOS D !P/E MTRR -> PAT disable Disabled BIOS !M !P/E MTRR stub -> PAT disable Disabled BIOS ==== ===== ========================== ========= ======= Legend ========= ======================================= E Feature enabled in CPU D Feature disabled/unsupported in CPU np "nopat" boot option specified !P CONFIG_X86_PAT option unset !M CONFIG_MTRR option unset Enabled PAT state set to enabled Disabled PAT state set to disabled OS PAT initializes PAT MSR with OS setting BIOS PAT keeps PAT MSR with BIOS setting ========= ======================================= h](h)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhj ubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthKuh1jhj ubhthead)}(hhh]j!)}(hhh](j&)}(hhh]h)}(hMTRRh]hMTRR}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hPATh]hPAT}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(h Call Sequenceh]h Call Sequence}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(h PAT Stateh]h PAT State}(hj4 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj1 ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hPAT MSRh]hPAT MSR}(hjK hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjH ubah}(h]h ]h"]h$]h&]uh1j%hj ubeh}(h]h ]h"]h$]h&]uh1j hj ubah}(h]h ]h"]h$]h&]uh1j hj ubj)}(hhh](j!)}(hhh](j&)}(hhh]h)}(hEh]hE}(hjt hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjq ubah}(h]h ]h"]h$]h&]uh1j%hjn ubj&)}(hhh]h)}(hjv h]hE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjn ubj&)}(hhh]h)}(hMTRR -> PAT inith]hMTRR -> PAT init}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjn ubj&)}(hhh]h)}(hEnabledh]hEnabled}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjn ubj&)}(hhh]h)}(hOSh]hOS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjn ubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]h)}(hjv h]hE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hDh]hD}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hMTRR -> PAT inith]hMTRR -> PAT init}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hDisabledh]hDisabled}(hj3 hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj0 ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h bullet_list)}(hhh]j. )}(hhh]h}(h]h ]h"]h$]h&]uh1j- hjL ubah}(h]h ]h"]h$]h&]bullet-uh1jJ hhhKhjG ubah}(h]h ]h"]h$]h&]uh1j%hj ubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]h)}(hj h]hD}(hjr hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjo ubah}(h]h ]h"]h$]h&]uh1j%hjl ubj&)}(hhh]h)}(hjv h]hE}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjl ubj&)}(hhh]h)}(hMTRR -> PAT disableh]hMTRR -> PAT disable}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjl ubj&)}(hhh]h)}(hDisabledh]hDisabled}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjl ubj&)}(hhh]h)}(hBIOSh]hBIOS}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hjl ubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]h)}(hj h]hD}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hj h]hD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hMTRR -> PAT disableh]hMTRR -> PAT disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]h)}(hDisabledh]hDisabled}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj,ubah}(h]h ]h"]h$]h&]uh1j%hj ubj&)}(hhh]jK )}(hhh]j. )}(hhh]h}(h]h ]h"]h$]h&]uh1j- hjFubah}(h]h ]h"]h$]h&]j^ j_ uh1jJ hhhKhjCubah}(h]h ]h"]h$]h&]uh1j%hj ubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]jK )}(hhh]j. )}(hhh]h}(h]h ]h"]h$]h&]uh1j- hjjubah}(h]h ]h"]h$]h&]j^ j_ uh1jJ hhhKhjgubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(hnp/Eh]hnp/E}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(hPAT -> PAT disableh]hPAT -> PAT disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(hDisabledh]hDisabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjdubj&)}(hhh]h)}(hBIOSh]hBIOS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjdubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]jK )}(hhh]j. )}(hhh]h}(h]h ]h"]h$]h&]uh1j- hjubah}(h]h ]h"]h$]h&]j^ j_ uh1jJ hhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hnp/Dh]hnp/D}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hPAT -> PAT disableh]hPAT -> PAT disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hDisabledh]hDisabled}(hj3hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj0ubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]jK )}(hhh]j. )}(hhh]h}(h]h ]h"]h$]h&]uh1j- hjJubah}(h]h ]h"]h$]h&]j^ j_ uh1jJ hhhKhjGubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]h)}(hjv h]hE}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjkubah}(h]h ]h"]h$]h&]uh1j%hjhubj&)}(hhh]h)}(h!P/Eh]h!P/E}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjhubj&)}(hhh]h)}(hMTRR -> PAT inith]hMTRR -> PAT init}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjhubj&)}(hhh]h)}(hDisabledh]hDisabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjhubj&)}(hhh]h)}(hBIOSh]hBIOS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjhubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]h)}(hj h]hD}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h!P/Eh]h!P/E}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hMTRR -> PAT disableh]hMTRR -> PAT disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hDisabledh]hDisabled}(hj-hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj*ubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hBIOSh]hBIOS}(hjDhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjAubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjk ubj!)}(hhh](j&)}(hhh]h)}(h!Mh]h!M}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjaubah}(h]h ]h"]h$]h&]uh1j%hj^ubj&)}(hhh]h)}(h!P/Eh]h!P/E}(hj{hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjxubah}(h]h ]h"]h$]h&]uh1j%hj^ubj&)}(hhh]h)}(hMTRR stub -> PAT disableh]hMTRR stub -> PAT disable}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hj^ubj&)}(hhh]h)}(hDisabledh]hDisabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hj^ubj&)}(hhh]h)}(hBIOSh]hBIOS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hj^ubeh}(h]h ]h"]h$]h&]uh1j hjk ubeh}(h]h ]h"]h$]h&]uh1jhj ubeh}(h]h ]h"]h$]h&]colsKuh1jhj ubah}(h]h ]h"]h$]h&]uh1hhj ubj)}(hLegend h]h)}(hLegendh]hLegend}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1jhhhKhj ubh)}(hhh]j)}(hhh](j)}(hhh]h}(h]h ]h"]h$]h&]colwidthK uh1jhjubj)}(hhh]h}(h]h ]h"]h$]h&]colwidthK'uh1jhjubj)}(hhh](j!)}(hhh](j&)}(hhh]h)}(hjv h]hE}(hj(hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj%ubah}(h]h ]h"]h$]h&]uh1j%hj"ubj&)}(hhh]h)}(hFeature enabled in CPUh]hFeature enabled in CPU}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj;ubah}(h]h ]h"]h$]h&]uh1j%hj"ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hj h]hD}(hj^hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj[ubah}(h]h ]h"]h$]h&]uh1j%hjXubj&)}(hhh]h)}(h#Feature disabled/unsupported in CPUh]h#Feature disabled/unsupported in CPU}(hjthhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjqubah}(h]h ]h"]h$]h&]uh1j%hjXubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hnph]hnp}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h"nopat" boot option specifiedh]h!“nopat” boot option specified}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h!Ph]h!P}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hCONFIG_X86_PAT option unseth]hCONFIG_X86_PAT option unset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(h!Mh]h!M}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(hCONFIG_MTRR option unseth]hCONFIG_MTRR option unset}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hEnabledh]hEnabled}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj6ubah}(h]h ]h"]h$]h&]uh1j%hj3ubj&)}(hhh]h)}(hPAT state set to enabledh]hPAT state set to enabled}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjMubah}(h]h ]h"]h$]h&]uh1j%hj3ubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hDisabledh]hDisabled}(hjphhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjmubah}(h]h ]h"]h$]h&]uh1j%hjjubj&)}(hhh]h)}(hPAT state set to disabledh]hPAT state set to disabled}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hOSh]hOS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h'PAT initializes PAT MSR with OS settingh]h'PAT initializes PAT MSR with OS setting}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubj!)}(hhh](j&)}(hhh]h)}(hBIOSh]hBIOS}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubj&)}(hhh]h)}(h#PAT keeps PAT MSR with BIOS settingh]h#PAT keeps PAT MSR with BIOS setting}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1j%hjubeh}(h]h ]h"]h$]h&]uh1j hjubeh}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]colsKuh1jhjubah}(h]h ]h"]h$]h&]uh1hhj ubeh}(h]h ]h"]h$]h&]uh1jhhhKhj hhubeh}(h]pat-initializationah ]h"]pat initializationah$]h&]uh1hhhhhhhhKubeh}(h]pat-page-attribute-tableah ]h"]pat (page attribute table)ah$]h&]uh1hhhhhhhhKubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksj%footnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjZerror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}nameids}(j5j2j j j j j5 j2 j j j-j*u nametypes}(j5j j j5 j j-uh}(j2hj jJj j j2 j j j8 j*j u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages](hsystem_message)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOlineK*sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK,sourcehuh1jhj~ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK.sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK0sourcehuh1jhjHubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hj.hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj+ubah}(h]h ]h"]h$]h&]levelKtypejlineK0sourcehuh1jhj_ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjIhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjFubah}(h]h ]h"]h$]h&]levelKtypejlineK2sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjdhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjaubah}(h]h ]h"]h$]h&]levelKtypejlineK2sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj|ubah}(h]h ]h"]h$]h&]levelKtypejlineK4sourcehuh1jhj)ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK4sourcehuh1jhj@ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK7sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK7sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK:sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK:sourcehuh1jhj ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineK=sourcehuh1jhjAubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hj<hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj9ubah}(h]h ]h"]h$]h&]levelKtypejlineK=sourcehuh1jhjXubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjWhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjTubah}(h]h ]h"]h$]h&]levelKtypejlineK?sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjrhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjoubah}(h]h ]h"]h$]h&]levelKtypejlineK?sourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineKBsourcehuh1jhj ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineKBsourcehuh1jhj"ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineKEsourcehuh1jhjpubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineKEsourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineKHsourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejlineKKsourcehuh1jhj:ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hj/hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj,ubah}(h]h ]h"]h$]h&]levelKtypejlineKNsourcehuh1jhjubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjJhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjGubah}(h]h ]h"]h$]h&]levelKtypejlineKSsourcehuh1jhj, ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjehhhNhNubah}(h]h ]h"]h$]h&]uh1hhjbubah}(h]h ]h"]h$]h&]levelKtypejlineKYsourcehuh1jhj ubj)}(hhh]h)}(heUnexpected possible title overline or transition. Treating it as ordinary text because it's so short.h]hgUnexpected possible title overline or transition. Treating it as ordinary text because it’s so short.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhj}ubah}(h]h ]h"]h$]h&]levelKtypejlineKYsourcehuh1jhj ubetransform_messages] transformerN include_log] decorationNhhub.