Skip to content

L
linux
Commit 59dfc3f8 authored by venkatesh.pallipadi@intel.com's avatar venkatesh.pallipadi@intel.com Committed by Ingo Molnar
Browse files
Options

x86: PAT documentation updates with debug info 

Documentation update for PAT. Reflect the latest API details.
Also, adds details about ways to get more info in order to debug PAT.
Signed-off-by: default avatarVenkatesh Pallipadi <venkatesh.pallipadi@intel.com>
Signed-off-by: default avatarIngo Molnar <mingo@elte.hu>
parent 470fba7e
Show whitespace changes
Inline Side-by-side
Showing with 45 additions and 9 deletions
Documentation/x86/pat.txt
View file @ 59dfc3f8
...@@ -14,6 +14,10 @@ PAT allows for different types of memory attributes. The most commonly used ...@@ -14,6 +14,10 @@ PAT allows for different types of memory attributes. The most commonly used
ones that will be supported at this time are Write-back, Uncached, ones that will be supported at this time are Write-back, Uncached,
Write-combined and Uncached Minus. Write-combined and Uncached Minus.
PAT APIs
--------
There are many different APIs in the kernel that allows setting of memory There are many different APIs in the kernel that allows setting of memory
attributes at the page level. In order to avoid aliasing, these interfaces attributes at the page level. In order to avoid aliasing, these interfaces
should be used thoughtfully. Below is a table of interfaces available, should be used thoughtfully. Below is a table of interfaces available,
...@@ -26,38 +30,38 @@ address range to avoid any aliasing. ...@@ -26,38 +30,38 @@ address range to avoid any aliasing.
API | RAM | ACPI,... | Reserved/Holes | API | RAM | ACPI,... | Reserved/Holes |
-----------------------|----------|------------|------------------| -----------------------|----------|------------|------------------|
| | | | | | | |
ioremap | -- | UC | UC | ioremap | -- | UC- | UC- |
| | | | | | | |
ioremap_cache | -- | WB | WB | ioremap_cache | -- | WB | WB |
| | | | | | | |
ioremap_nocache | -- | UC | UC | ioremap_nocache | -- | UC- | UC- |
| | | | | | | |
ioremap_wc | -- | -- | WC | ioremap_wc | -- | -- | WC |
| | | | | | | |
set_memory_uc | UC | -- | -- | set_memory_uc | UC- | -- | -- |
set_memory_wb | | | | set_memory_wb | | | |
| | | | | | | |
set_memory_wc | WC | -- | -- | set_memory_wc | WC | -- | -- |
set_memory_wb | | | | set_memory_wb | | | |
| | | | | | | |
pci sysfs resource | -- | -- | UC | pci sysfs resource | -- | -- | UC- |
| | | | | | | |
pci sysfs resource_wc | -- | -- | WC | pci sysfs resource_wc | -- | -- | WC |
is IORESOURCE_PREFETCH| | | | is IORESOURCE_PREFETCH| | | |
| | | | | | | |
pci proc | -- | -- | UC | pci proc | -- | -- | UC- |
!PCIIOC_WRITE_COMBINE | | | | !PCIIOC_WRITE_COMBINE | | | |
| | | | | | | |
pci proc | -- | -- | WC | pci proc | -- | -- | WC |
PCIIOC_WRITE_COMBINE | | | | PCIIOC_WRITE_COMBINE | | | |
| | | | | | | |
/dev/mem | -- | UC | UC | /dev/mem | -- | WB/WC/UC- | WB/WC/UC- |
read-write | | | | read-write | | | |
| | | | | | | |
/dev/mem | -- | UC | UC | /dev/mem | -- | UC- | UC- |
mmap SYNC flag | | | | mmap SYNC flag | | | |
| | | | | | | |
/dev/mem | -- | WB/WC/UC | WB/WC/UC | /dev/mem | -- | WB/WC/UC- | WB/WC/UC- |
mmap !SYNC flag | |(from exist-| (from exist- | mmap !SYNC flag | |(from exist-| (from exist- |
and | | ing alias)| ing alias) | and | | ing alias)| ing alias) |
any alias to this area| | | | any alias to this area| | | |
...@@ -68,7 +72,7 @@ pci proc | -- | -- | WC | ...@@ -68,7 +72,7 @@ pci proc | -- | -- | WC |
and | | | | and | | | |
MTRR says WB | | | | MTRR says WB | | | |
| | | | | | | |
/dev/mem | -- | -- | UC_MINUS | /dev/mem | -- | -- | UC- |
mmap !SYNC flag | | | | mmap !SYNC flag | | | |
no alias to this area | | | | no alias to this area | | | |
and | | | | and | | | |
...@@ -98,3 +102,35 @@ types. ...@@ -98,3 +102,35 @@ types.
Drivers should use set_memory_[uc|wc] to set access type for RAM ranges. Drivers should use set_memory_[uc|wc] to set access type for RAM ranges.
PAT debugging
-------------
With CONFIG_DEBUG_FS enabled, PAT memtype list can be examined by
# 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
This list shows physical address ranges and various PAT settings used to
access those physical address ranges.
Another, 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.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7