€•#^      Œ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/trace/mmiotrace”Œ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/trace/mmiotrace”Œ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/trace/mmiotrace”Œ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/trace/mmiotrace”Œ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/trace/mmiotrace”Œ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/trace/mmiotrace”Œ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Œsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ#In-kernel memory-mapped I/O tracing”h]”hŒ#In-kernel memory-mapped I/O tracing”…””}”(hh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒ=/var/lib/git/docbuild/linux/Documentation/trace/mmiotrace.rst”h KubhŒ	paragraph”“”)”}”(hŒ1Home page and links to optional user space tools:”h]”hŒ1Home page and links to optional user space tools:”…””}”(hh¹hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubhŒblock_quote”“”)”}”(hŒ/https://nouveau.freedesktop.org/wiki/MmioTrace
”h]”h¸)”}”(hŒ.https://nouveau.freedesktop.org/wiki/MmioTrace”h]”hŒ	reference”“”)”}”(hhÏh]”hŒ.https://nouveau.freedesktop.org/wiki/MmioTrace”…””}”(hhÓhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”hÏuh1hÑhhÍubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KhhÉubah}”(h]”h ]”h"]”h$]”h&]”uh1hÇhŸh¶h Khh£hžhubh¸)”}”(hX  MMIO tracing was originally developed by Intel around 2003 for their Fault
Injection Test Harness. In Dec 2006 - Jan 2007, using the code from Intel,
Jeff Muizelaar created a tool for tracing MMIO accesses with the Nouveau
project in mind. Since then many people have contributed.”h]”hX  MMIO tracing was originally developed by Intel around 2003 for their Fault
Injection Test Harness. In Dec 2006 - Jan 2007, using the code from Intel,
Jeff Muizelaar created a tool for tracing MMIO accesses with the Nouveau
project in mind. Since then many people have contributed.”…””}”(hhíhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K
hh£hžhubh¸)”}”(hŒ©Mmiotrace was built for reverse engineering any memory-mapped IO device with
the Nouveau project as the first real user. Only x86 and x86_64 architectures
are supported.”h]”hŒ©Mmiotrace was built for reverse engineering any memory-mapped IO device with
the Nouveau project as the first real user. Only x86 and x86_64 architectures
are supported.”…””}”(hhûhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¸)”}”(hŒxOut-of-tree mmiotrace was originally modified for mainline inclusion and
ftrace framework by Pekka Paalanen <pq@iki.fi>.”h]”(hŒmOut-of-tree mmiotrace was originally modified for mainline inclusion and
ftrace framework by Pekka Paalanen <”…””}”(hj	  hžhhŸNh NubhÒ)”}”(hŒ	pq@iki.fi”h]”hŒ	pq@iki.fi”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:pq@iki.fi”uh1hÑhj	  ubhŒ>.”…””}”(hj	  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khh£hžhubh¢)”}”(hhh]”(h§)”}”(hŒPreparation”h]”hŒPreparation”…””}”(hj.  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj+  hžhhŸh¶h Kubh¸)”}”(hXÏ  Mmiotrace feature is compiled in by the CONFIG_MMIOTRACE option. Tracing is
disabled by default, so it is safe to have this set to yes. SMP systems are
supported, but tracing is unreliable and may miss events if more than one CPU
is on-line, therefore mmiotrace takes all but one CPU off-line during run-time
activation. You can re-enable CPUs by hand, but you have been warned, there
is no way to automatically detect if you are losing events due to CPUs racing.”h]”hXÏ  Mmiotrace feature is compiled in by the CONFIG_MMIOTRACE option. Tracing is
disabled by default, so it is safe to have this set to yes. SMP systems are
supported, but tracing is unreliable and may miss events if more than one CPU
is on-line, therefore mmiotrace takes all but one CPU off-line during run-time
activation. You can re-enable CPUs by hand, but you have been warned, there
is no way to automatically detect if you are losing events due to CPUs racing.”…””}”(hj<  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj+  hžhubeh}”(h]”Œpreparation”ah ]”h"]”Œpreparation”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kubh¢)”}”(hhh]”(h§)”}”(hŒUsage Quick Reference”h]”hŒUsage Quick Reference”…””}”(hjU  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjR  hžhhŸh¶h K#ubhŒliteral_block”“”)”}”(hX&  $ mount -t debugfs debugfs /sys/kernel/debug
$ echo mmiotrace > /sys/kernel/tracing/current_tracer
$ cat /sys/kernel/tracing/trace_pipe > mydump.txt &
Start X or whatever.
$ echo "X is up" > /sys/kernel/tracing/trace_marker
$ echo nop > /sys/kernel/tracing/current_tracer
Check for lost events.”h]”hX&  $ mount -t debugfs debugfs /sys/kernel/debug
$ echo mmiotrace > /sys/kernel/tracing/current_tracer
$ cat /sys/kernel/tracing/trace_pipe > mydump.txt &
Start X or whatever.
$ echo "X is up" > /sys/kernel/tracing/trace_marker
$ echo nop > /sys/kernel/tracing/current_tracer
Check for lost events.”…””}”hje  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jc  hŸh¶h K&hjR  hžhubeh}”(h]”Œusage-quick-reference”ah ]”h"]”Œusage quick reference”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K#ubh¢)”}”(hhh]”(h§)”}”(hŒUsage”h]”hŒUsage”…””}”(hj€  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj}  hžhhŸh¶h K0ubh¸)”}”(hŒVMake sure debugfs is mounted to /sys/kernel/debug.
If not (requires root privileges)::”h]”hŒUMake sure debugfs is mounted to /sys/kernel/debug.
If not (requires root privileges):”…””}”(hjŽ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K2hj}  hžhubjd  )”}”(hŒ,$ mount -t debugfs debugfs /sys/kernel/debug”h]”hŒ,$ mount -t debugfs debugfs /sys/kernel/debug”…””}”hjœ  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h K5hj}  hžhubh¸)”}”(hŒ;Check that the driver you are about to trace is not loaded.”h]”hŒ;Check that the driver you are about to trace is not loaded.”…””}”(hjª  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K7hj}  hžhubh¸)”}”(hŒ/Activate mmiotrace (requires root privileges)::”h]”hŒ.Activate mmiotrace (requires root privileges):”…””}”(hj¸  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K9hj}  hžhubjd  )”}”(hŒ5$ echo mmiotrace > /sys/kernel/tracing/current_tracer”h]”hŒ5$ echo mmiotrace > /sys/kernel/tracing/current_tracer”…””}”hjÆ  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h K;hj}  hžhubh¸)”}”(hŒStart storing the trace::”h]”hŒStart storing the trace:”…””}”(hjÔ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K=hj}  hžhubjd  )”}”(hŒ3$ cat /sys/kernel/tracing/trace_pipe > mydump.txt &”h]”hŒ3$ cat /sys/kernel/tracing/trace_pipe > mydump.txt &”…””}”hjâ  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h K?hj}  hžhubh¸)”}”(hŒCThe 'cat' process should stay running (sleeping) in the background.”h]”hŒGThe â€˜catâ€™ process should stay running (sleeping) in the background.”…””}”(hjð  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KAhj}  hžhubh¸)”}”(hŒLoad the driver you want to trace and use it. Mmiotrace will only catch MMIO
accesses to areas that are ioremapped while mmiotrace is active.”h]”hŒLoad the driver you want to trace and use it. Mmiotrace will only catch MMIO
accesses to areas that are ioremapped while mmiotrace is active.”…””}”(hjþ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KChj}  hžhubh¸)”}”(hX  During tracing you can place comments (markers) into the trace by
$ echo "X is up" > /sys/kernel/tracing/trace_marker
This makes it easier to see which part of the (huge) trace corresponds to
which action. It is recommended to place descriptive markers about what you
do.”h]”hX  During tracing you can place comments (markers) into the trace by
$ echo â€œX is upâ€ > /sys/kernel/tracing/trace_marker
This makes it easier to see which part of the (huge) trace corresponds to
which action. It is recommended to place descriptive markers about what you
do.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KFhj}  hžhubh¸)”}”(hŒ0Shut down mmiotrace (requires root privileges)::”h]”hŒ/Shut down mmiotrace (requires root privileges):”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KLhj}  hžhubjd  )”}”(hŒ/$ echo nop > /sys/kernel/tracing/current_tracer”h]”hŒ/$ echo nop > /sys/kernel/tracing/current_tracer”…””}”hj(  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h KNhj}  hžhubh¸)”}”(hŒ]The 'cat' process exits. If it does not, kill it by issuing 'fg' command and
pressing ctrl+c.”h]”hŒeThe â€˜catâ€™ process exits. If it does not, kill it by issuing â€˜fgâ€™ command and
pressing ctrl+c.”…””}”(hj6  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KPhj}  hžhubh¸)”}”(hŒMCheck that mmiotrace did not lose events due to a buffer filling up. Either::”h]”hŒLCheck that mmiotrace did not lose events due to a buffer filling up. Either:”…””}”(hjD  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KShj}  hžhubjd  )”}”(hŒ$ grep -i lost mydump.txt”h]”hŒ$ grep -i lost mydump.txt”…””}”hjR  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h KUhj}  hžhubh¸)”}”(hŒ;which tells you exactly how many events were lost, or use::”h]”hŒ:which tells you exactly how many events were lost, or use:”…””}”(hj`  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h KWhj}  hžhubjd  )”}”(hŒ$ dmesg”h]”hŒ$ dmesg”…””}”hjn  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h KYhj}  hžhubh¸)”}”(hŒîto view your kernel log and look for "mmiotrace has lost events" warning. If
events were lost, the trace is incomplete. You should enlarge the buffers and
try again. Buffers are enlarged by first seeing how large the current buffers
are::”h]”hŒñto view your kernel log and look for â€œmmiotrace has lost eventsâ€ warning. If
events were lost, the trace is incomplete. You should enlarge the buffers and
try again. Buffers are enlarged by first seeing how large the current buffers
are:”…””}”(hj|  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K[hj}  hžhubjd  )”}”(hŒ($ cat /sys/kernel/tracing/buffer_size_kb”h]”hŒ($ cat /sys/kernel/tracing/buffer_size_kb”…””}”hjŠ  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h K`hj}  hžhubh¸)”}”(hŒVgives you a number. Approximately double this number and write it back, for
instance::”h]”hŒUgives you a number. Approximately double this number and write it back, for
instance:”…””}”(hj˜  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kbhj}  hžhubjd  )”}”(hŒ2$ echo 128000 > /sys/kernel/tracing/buffer_size_kb”h]”hŒ2$ echo 128000 > /sys/kernel/tracing/buffer_size_kb”…””}”hj¦  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h Kehj}  hžhubh¸)”}”(hŒThen start again from the top.”h]”hŒThen start again from the top.”…””}”(hj´  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kghj}  hžhubh¸)”}”(hŒ{If you are doing a trace for a driver project, e.g. Nouveau, you should also
do the following before sending your results::”h]”hŒzIf you are doing a trace for a driver project, e.g. Nouveau, you should also
do the following before sending your results:”…””}”(hjÂ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kihj}  hžhubjd  )”}”(hŒq$ lspci -vvv > lspci.txt
$ dmesg > dmesg.txt
$ tar zcf pciid-nick-mmiotrace.tar.gz mydump.txt lspci.txt dmesg.txt”h]”hŒq$ lspci -vvv > lspci.txt
$ dmesg > dmesg.txt
$ tar zcf pciid-nick-mmiotrace.tar.gz mydump.txt lspci.txt dmesg.txt”…””}”hjÐ  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h Klhj}  hžhubh¸)”}”(hŒ¼and then send the .tar.gz file. The trace compresses considerably. Replace
"pciid" and "nick" with the PCI ID or model name of your piece of hardware
under investigation and your nickname.”h]”hŒÄand then send the .tar.gz file. The trace compresses considerably. Replace
â€œpciidâ€ and â€œnickâ€ with the PCI ID or model name of your piece of hardware
under investigation and your nickname.”…””}”(hjÞ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kphj}  hžhubeh}”(h]”Œusage”ah ]”h"]”Œusage”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K0ubh¢)”}”(hhh]”(h§)”}”(hŒHow Mmiotrace Works”h]”hŒHow Mmiotrace Works”…””}”(hj÷  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjô  hžhhŸh¶h Kvubh¸)”}”(hXv  Access to hardware IO-memory is gained by mapping addresses from PCI bus by
calling one of the ioremap_*() functions. Mmiotrace is hooked into the
__ioremap() function and gets called whenever a mapping is created. Mapping is
an event that is recorded into the trace log. Note that ISA range mappings
are not caught, since the mapping always exists and is returned directly.”h]”hXv  Access to hardware IO-memory is gained by mapping addresses from PCI bus by
calling one of the ioremap_*() functions. Mmiotrace is hooked into the
__ioremap() function and gets called whenever a mapping is created. Mapping is
an event that is recorded into the trace log. Note that ISA range mappings
are not caught, since the mapping always exists and is returned directly.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Kxhjô  hžhubh¸)”}”(hXN  MMIO accesses are recorded via page faults. Just before __ioremap() returns,
the mapped pages are marked as not present. Any access to the pages causes a
fault. The page fault handler calls mmiotrace to handle the fault. Mmiotrace
marks the page present, sets TF flag to achieve single stepping and exits the
fault handler. The instruction that faulted is executed and debug trap is
entered. Here mmiotrace again marks the page as not present. The instruction
is decoded to get the type of operation (read/write), data width and the value
read or written. These are stored to the trace log.”h]”hXN  MMIO accesses are recorded via page faults. Just before __ioremap() returns,
the mapped pages are marked as not present. Any access to the pages causes a
fault. The page fault handler calls mmiotrace to handle the fault. Mmiotrace
marks the page present, sets TF flag to achieve single stepping and exits the
fault handler. The instruction that faulted is executed and debug trap is
entered. Here mmiotrace again marks the page as not present. The instruction
is decoded to get the type of operation (read/write), data width and the value
read or written. These are stored to the trace log.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K~hjô  hžhubh¸)”}”(hŒûSetting the page present in the page fault handler has a race condition on SMP
machines. During the single stepping other CPUs may run freely on that page
and events can be missed without a notice. Re-enabling other CPUs during
tracing is discouraged.”h]”hŒûSetting the page present in the page fault handler has a race condition on SMP
machines. During the single stepping other CPUs may run freely on that page
and events can be missed without a notice. Re-enabling other CPUs during
tracing is discouraged.”…””}”(hj!  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K‡hjô  hžhubeh}”(h]”Œhow-mmiotrace-works”ah ]”h"]”Œhow mmiotrace works”ah$]”h&]”uh1h¡hh£hžhhŸh¶h Kvubh¢)”}”(hhh]”(h§)”}”(hŒTrace Log Format”h]”hŒTrace Log Format”…””}”(hj:  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj7  hžhhŸh¶h KŽubh¸)”}”(hX"  The raw log is text and easily filtered with e.g. grep and awk. One record is
one line in the log. A record starts with a keyword, followed by keyword-
dependent arguments. Arguments are separated by a space, or continue until the
end of line. The format for version 20070824 is as follows:”h]”hX"  The raw log is text and easily filtered with e.g. grep and awk. One record is
one line in the log. A record starts with a keyword, followed by keyword-
dependent arguments. Arguments are separated by a space, or continue until the
end of line. The format for version 20070824 is as follows:”…””}”(hjH  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h Khj7  hžhubeh}”(h]”Œtrace-log-format”ah ]”h"]”Œtrace log format”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KŽubh¢)”}”(hhh]”(h§)”}”(hŒ1Explanation     Keyword Space-separated arguments”h]”hŒ1Explanation     Keyword Space-separated arguments”…””}”(hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj^  hžhhŸh¶h K–ubh¸)”}”(hX!  read event      R       width, timestamp, map id, physical, value, PC, PID
write event     W       width, timestamp, map id, physical, value, PC, PID
ioremap event   MAP     timestamp, map id, physical, virtual, length, PC, PID
iounmap event   UNMAP   timestamp, map id, PC, PID
marker          MARK    timestamp, text
version         VERSION the string "20070824"
info for reader LSPCI   one line from lspci -v
PCI address map PCIDEV  space-separated /proc/bus/pci/devices data
unk. opcode     UNKNOWN timestamp, map id, physical, data, PC, PID”h]”hX%  read event      R       width, timestamp, map id, physical, value, PC, PID
write event     W       width, timestamp, map id, physical, value, PC, PID
ioremap event   MAP     timestamp, map id, physical, virtual, length, PC, PID
iounmap event   UNMAP   timestamp, map id, PC, PID
marker          MARK    timestamp, text
version         VERSION the string â€œ20070824â€
info for reader LSPCI   one line from lspci -v
PCI address map PCIDEV  space-separated /proc/bus/pci/devices data
unk. opcode     UNKNOWN timestamp, map id, physical, data, PC, PID”…””}”(hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K˜hj^  hžhubh¸)”}”(hX¶  Timestamp is in seconds with decimals. Physical is a PCI bus address, virtual
is a kernel virtual address. Width is the data width in bytes and value is the
data value. Map id is an arbitrary id number identifying the mapping that was
used in an operation. PC is the program counter and PID is process id. PC is
zero if it is not recorded. PID is always zero as tracing MMIO accesses
originating in user space memory is not yet supported.”h]”hX¶  Timestamp is in seconds with decimals. Physical is a PCI bus address, virtual
is a kernel virtual address. Width is the data width in bytes and value is the
data value. Map id is an arbitrary id number identifying the mapping that was
used in an operation. PC is the program counter and PID is process id. PC is
zero if it is not recorded. PID is always zero as tracing MMIO accesses
originating in user space memory is not yet supported.”…””}”(hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K¢hj^  hžhubh¸)”}”(hŒŠFor instance, the following awk filter will pass all 32-bit writes that target
physical addresses in the range [0xfb73ce40, 0xfb800000]
::”h]”hŒ‡For instance, the following awk filter will pass all 32-bit writes that target
physical addresses in the range [0xfb73ce40, 0xfb800000]”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h·hŸh¶h K©hj^  hžhubjd  )”}”(hŒV$ awk '/W 4 / { adr=strtonum($5); if (adr >= 0xfb73ce40 &&
adr < 0xfb800000) print; }'”h]”hŒV$ awk '/W 4 / { adr=strtonum($5); if (adr >= 0xfb73ce40 &&
adr < 0xfb800000) print; }'”…””}”hj™  sbah}”(h]”h ]”h"]”h$]”h&]”js  jt  uh1jc  hŸh¶h K­hj^  hžhubeh}”(h]”Œ-explanation-keyword-space-separated-arguments”ah ]”h"]”Œ-explanation keyword space-separated arguments”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K–ubh¢)”}”(hhh]”(h§)”}”(hŒTools for Developers”h]”hŒTools for Developers”…””}”(hj²  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj¯  hžhhŸh¶h K²ubhŒdefinition_list”“”)”}”(hhh]”hŒdefinition_list_item”“”)”}”(hŒ±The user space tools include utilities for:
- replacing numeric addresses and values with hardware register names
- replaying MMIO logs, i.e., re-executing the recorded writes

”h]”(hŒterm”“”)”}”(hŒ+The user space tools include utilities for:”h]”hŒ+The user space tools include utilities for:”…””}”(hjÍ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jË  hŸh¶h K·hjÇ  ubhŒ
definition”“”)”}”(hhh]”hŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒCreplacing numeric addresses and values with hardware register names”h]”h¸)”}”(hjé  h]”hŒCreplacing numeric addresses and values with hardware register names”…””}”(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â  ubjæ  )”}”(hŒ=replaying MMIO logs, i.e., re-executing the recorded writes

”h]”h¸)”}”(hŒ;replaying MMIO logs, i.e., re-executing the recorded writes”h]”hŒ;replaying MMIO logs, i.e., re-executing the recorded writes”…””}”(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&]”Œbullet”Œ-”uh1jà  hŸh¶h KµhjÝ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÛ  hjÇ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÅ  hŸh¶h K·hjÂ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÀ  hj¯  hžhhŸNh Nubeh}”(h]”Œtools-for-developers”ah ]”h"]”Œtools for developers”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K²ubeh}”(h]”Œ#in-kernel-memory-mapped-i-o-tracing”ah ]”h"]”Œ#in-kernel memory-mapped i/o tracing”ah$]”h&]”uh1h¡hhhžhhŸh¶h Kubeh}”(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”jc  Œ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:  jO  jL  jz  jw  jñ  jî  j4  j1  j[  jX  j¬  j©  j5  j2  uŒ	nametypes”}”(j=  ‰jO  ‰jz  ‰jñ  ‰j4  ‰j[  ‰j¬  ‰j5  ‰uh}”(j:  h£jL  j+  jw  jR  jî  j}  j1  jô  jX  j7  j©  j^  j2  j¯  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.