€•Št      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”(hhŒparent”hubaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ3/translations/zh_CN/core-api/debugging-via-ohci1394”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”(hhhh2ubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/zh_TW/core-api/debugging-via-ohci1394”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”(hhhhFubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/it_IT/core-api/debugging-via-ohci1394”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”(hhhhZubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/ja_JP/core-api/debugging-via-ohci1394”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”(hhhhnubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/ko_KR/core-api/debugging-via-ohci1394”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”(hhhh‚ubah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ3/translations/sp_SP/core-api/debugging-via-ohci1394”Œ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ŒKUsing physical DMA provided by OHCI-1394 FireWire controllers for debugging”h]”hŒKUsing physical DMA provided by OHCI-1394 FireWire controllers for debugging”…””}”(hhªhh¨hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh£hžhhŸŒM/var/lib/git/docbuild/linux/Documentation/core-api/debugging-via-ohci1394.rst”h Kubh¢)”}”(hhh]”(h§)”}”(hŒIntroduction”h]”hŒIntroduction”…””}”(hh¼hhºhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hh·hžhhŸh¶h KubhŒ	paragraph”“”)”}”(hXl  Basically all FireWire controllers which are in use today are compliant
to the OHCI-1394 specification which defines the controller to be a PCI
bus master which uses DMA to offload data transfers from the CPU and has
a "Physical Response Unit" which executes specific requests by employing
PCI-Bus master DMA after applying filters defined by the OHCI-1394 driver.”h]”hXp  Basically all FireWire controllers which are in use today are compliant
to the OHCI-1394 specification which defines the controller to be a PCI
bus master which uses DMA to offload data transfers from the CPU and has
a â€œPhysical Response Unitâ€ which executes specific requests by employing
PCI-Bus master DMA after applying filters defined by the OHCI-1394 driver.”…””}”(hhÌhhÊhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hŒùOnce properly configured, remote machines can send these requests to
ask the OHCI-1394 controller to perform read and write requests on
physical system memory and, for read requests, send the result of
the physical memory read back to the requester.”h]”hŒùOnce properly configured, remote machines can send these requests to
ask the OHCI-1394 controller to perform read and write requests on
physical system memory and, for read requests, send the result of
the physical memory read back to the requester.”…””}”(hhÚhhØhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hŒŽWith that, it is possible to debug issues by reading interesting memory
locations such as buffers like the printk buffer or the process table.”h]”hŒŽWith that, it is possible to debug issues by reading interesting memory
locations such as buffers like the printk buffer or the process table.”…””}”(hhèhhæhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hŒ‚Retrieving a full system memory dump is also possible over the FireWire,
using data transfer rates in the order of 10MB/s or more.”h]”hŒ‚Retrieving a full system memory dump is also possible over the FireWire,
using data transfer rates in the order of 10MB/s or more.”…””}”(hhöhhôhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hX  With most FireWire controllers, memory access is limited to the low 4 GB
of physical address space.  This can be a problem on machines where memory is
located mostly above that limit, but it is rarely a problem on more common
hardware such as x86, x86-64 and PowerPC.”h]”hX  With most FireWire controllers, memory access is limited to the low 4 GB
of physical address space.  This can be a problem on machines where memory is
located mostly above that limit, but it is rarely a problem on more common
hardware such as x86, x86-64 and PowerPC.”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hŒAt least LSI FW643e and FW643e2 controllers are known to support access to
physical addresses above 4 GB, but this feature is currently not enabled by
Linux.”h]”hŒAt least LSI FW643e and FW643e2 controllers are known to support access to
physical addresses above 4 GB, but this feature is currently not enabled by
Linux.”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khh·hžhubhÉ)”}”(hX€  Together with a early initialization of the OHCI-1394 controller for debugging,
this facility proved most useful for examining long debugs logs in the printk
buffer on to debug early boot problems in areas like ACPI where the system
fails to boot and other means for debugging (serial port) are either not
available (notebooks) or too slow for extensive debug information (like ACPI).”h]”hX€  Together with a early initialization of the OHCI-1394 controller for debugging,
this facility proved most useful for examining long debugs logs in the printk
buffer on to debug early boot problems in areas like ACPI where the system
fails to boot and other means for debugging (serial port) are either not
available (notebooks) or too slow for extensive debug information (like ACPI).”…””}”(hj   hj  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ŒDrivers”h]”hŒDrivers”…””}”(hj9  hj7  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj4  hžhhŸh¶h K)ubhÉ)”}”(hŒÝThe firewire-ohci driver in drivers/firewire uses filtered physical
DMA by default, which is more secure but not suitable for remote debugging.
Pass the remote_dma=1 parameter to the driver to get unfiltered physical DMA.”h]”hŒÝThe firewire-ohci driver in drivers/firewire uses filtered physical
DMA by default, which is more secure but not suitable for remote debugging.
Pass the remote_dma=1 parameter to the driver to get unfiltered physical DMA.”…””}”(hjG  hjE  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K+hj4  hžhubhÉ)”}”(hX  Because the firewire-ohci driver depends on the PCI enumeration to be
completed, an initialization routine which runs pretty early has been
implemented for x86.  This routine runs long before console_init() can be
called, i.e. before the printk buffer appears on the console.”h]”hX  Because the firewire-ohci driver depends on the PCI enumeration to be
completed, an initialization routine which runs pretty early has been
implemented for x86.  This routine runs long before console_init() can be
called, i.e. before the printk buffer appears on the console.”…””}”(hjU  hjS  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K/hj4  hžhubhÉ)”}”(hŒÉTo activate it, enable CONFIG_PROVIDE_OHCI1394_DMA_INIT (Kernel hacking menu:
Remote debugging over FireWire early on boot) and pass the parameter
"ohci1394_dma=early" to the recompiled kernel on boot.”h]”hŒÍTo activate it, enable CONFIG_PROVIDE_OHCI1394_DMA_INIT (Kernel hacking menu:
Remote debugging over FireWire early on boot) and pass the parameter
â€œohci1394_dma=earlyâ€ to the recompiled kernel on boot.”…””}”(hjc  hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K4hj4  hžhubeh}”(h]”Œdrivers”ah ]”h"]”Œdrivers”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K)ubh¢)”}”(hhh]”(h§)”}”(hŒTools”h]”hŒTools”…””}”(hj|  hjz  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hjw  hžhhŸh¶h K9ubhÉ)”}”(hŒèfirescope - Originally developed by Benjamin Herrenschmidt, Andi Kleen ported
it from PowerPC to x86 and x86_64 and added functionality, firescope can now
be used to view the printk buffer of a remote machine, even with live update.”h]”hŒèfirescope - Originally developed by Benjamin Herrenschmidt, Andi Kleen ported
it from PowerPC to x86 and x86_64 and added functionality, firescope can now
be used to view the printk buffer of a remote machine, even with live update.”…””}”(hjŠ  hjˆ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K;hjw  hžhubhÉ)”}”(hŒ‘Bernhard Kaindl enhanced firescope to support accessing 64-bit machines
from 32-bit firescope and vice versa:
- http://v3.sk/~lkundrak/firescope/”h]”(hŒpBernhard Kaindl enhanced firescope to support accessing 64-bit machines
from 32-bit firescope and vice versa:
- ”…””}”(hŒpBernhard Kaindl enhanced firescope to support accessing 64-bit machines
from 32-bit firescope and vice versa:
- ”hj–  hžhhŸNh NubhŒ	reference”“”)”}”(hŒ!http://v3.sk/~lkundrak/firescope/”h]”hŒ!http://v3.sk/~lkundrak/firescope/”…””}”(hhhj¡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j£  uh1jŸ  hj–  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K?hjw  hžhubhÉ)”}”(hŒzand he implemented fast system dump (alpha version - read README.txt):
- http://halobates.de/firewire/firedump-0.1.tar.bz2”h]”(hŒIand he implemented fast system dump (alpha version - read README.txt):
- ”…””}”(hŒIand he implemented fast system dump (alpha version - read README.txt):
- ”hj¶  hžhhŸNh Nubj   )”}”(hŒ1http://halobates.de/firewire/firedump-0.1.tar.bz2”h]”hŒ1http://halobates.de/firewire/firedump-0.1.tar.bz2”…””}”(hhhj¿  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jÁ  uh1jŸ  hj¶  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KChjw  hžhubhÉ)”}”(hŒÁThere is also a gdb proxy for firewire which allows to use gdb to access
data which can be referenced from symbols found by gdb in vmlinux:
- http://halobates.de/firewire/fireproxy-0.33.tar.bz2”h]”(hŒŽThere is also a gdb proxy for firewire which allows to use gdb to access
data which can be referenced from symbols found by gdb in vmlinux:
- ”…””}”(hŒŽThere is also a gdb proxy for firewire which allows to use gdb to access
data which can be referenced from symbols found by gdb in vmlinux:
- ”hjÔ  hžhhŸNh Nubj   )”}”(hŒ3http://halobates.de/firewire/fireproxy-0.33.tar.bz2”h]”hŒ3http://halobates.de/firewire/fireproxy-0.33.tar.bz2”…””}”(hhhjÝ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jß  uh1jŸ  hjÔ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KFhjw  hžhubhÉ)”}”(hŒ”The latest version of this gdb proxy (fireproxy-0.34) can communicate (not
yet stable) with kgdb over an memory-based communication module (kgdbom).”h]”hŒ”The latest version of this gdb proxy (fireproxy-0.34) can communicate (not
yet stable) with kgdb over an memory-based communication module (kgdbom).”…””}”(hjô  hjò  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KJhjw  hžhubeh}”(h]”Œtools”ah ]”h"]”Œtools”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K9ubh¢)”}”(hhh]”(h§)”}”(hŒGetting Started”h]”hŒGetting Started”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h KNubhÉ)”}”(hŒtThe OHCI-1394 specification regulates that the OHCI-1394 controller must
disable all physical DMA on each bus reset.”h]”hŒtThe OHCI-1394 specification regulates that the OHCI-1394 controller must
disable all physical DMA on each bus reset.”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KPhj  hžhubhÉ)”}”(hX3  This means that if you want to debug an issue in a system state where
interrupts are disabled and where no polling of the OHCI-1394 controller
for bus resets takes place, you have to establish any FireWire cable
connections and fully initialize all FireWire hardware __before__ the
system enters such state.”h]”hX3  This means that if you want to debug an issue in a system state where
interrupts are disabled and where no polling of the OHCI-1394 controller
for bus resets takes place, you have to establish any FireWire cable
connections and fully initialize all FireWire hardware __before__ the
system enters such state.”…””}”(hj)  hj'  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KShj  hžhubhÉ)”}”(hŒMStep-by-step instructions for using firescope with early OHCI initialization:”h]”hŒMStep-by-step instructions for using firescope with early OHCI initialization:”…””}”(hj7  hj5  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KYhj  hžhubhŒenumerated_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hXQ  Verify that your hardware is supported:

Load the firewire-ohci module and check your kernel logs.
You should see a line similar to::

  firewire_ohci 0000:15:00.1: added OHCI v1.0 device as card 2, 4 IR + 4 IT
  ... contexts, quirks 0x11

when loading the driver. If you have no supported controller, many PCI,
CardBus and even some Express cards which are fully compliant to OHCI-1394
specification are available. If it requires no driver for Windows operating
systems, it most likely is. Only specialized shops have cards which are not
compliant, they are based on TI PCILynx chips and require drivers for Windows
operating systems.

The mentioned kernel log message contains the string "physUB" if the
controller implements a writable Physical Upper Bound register.  This is
required for physical DMA above 4 GB (but not utilized by Linux yet).
”h]”(hÉ)”}”(hŒ'Verify that your hardware is supported:”h]”hŒ'Verify that your hardware is supported:”…””}”(hjP  hjN  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K[hjJ  ubhÉ)”}”(hŒ\Load the firewire-ohci module and check your kernel logs.
You should see a line similar to::”h]”hŒ[Load the firewire-ohci module and check your kernel logs.
You should see a line similar to:”…””}”(hŒ[Load the firewire-ohci module and check your kernel logs.
You should see a line similar to:”hj\  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K]hjJ  ubhŒliteral_block”“”)”}”(hŒcfirewire_ohci 0000:15:00.1: added OHCI v1.0 device as card 2, 4 IR + 4 IT
... contexts, quirks 0x11”h]”hŒcfirewire_ohci 0000:15:00.1: added OHCI v1.0 device as card 2, 4 IR + 4 IT
... contexts, quirks 0x11”…””}”(hhhjm  ubah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jk  hŸh¶h K`hjJ  ubhÉ)”}”(hX‹  when loading the driver. If you have no supported controller, many PCI,
CardBus and even some Express cards which are fully compliant to OHCI-1394
specification are available. If it requires no driver for Windows operating
systems, it most likely is. Only specialized shops have cards which are not
compliant, they are based on TI PCILynx chips and require drivers for Windows
operating systems.”h]”hX‹  when loading the driver. If you have no supported controller, many PCI,
CardBus and even some Express cards which are fully compliant to OHCI-1394
specification are available. If it requires no driver for Windows operating
systems, it most likely is. Only specialized shops have cards which are not
compliant, they are based on TI PCILynx chips and require drivers for Windows
operating systems.”…””}”(hj  hj}  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KchjJ  ubhÉ)”}”(hŒÓThe mentioned kernel log message contains the string "physUB" if the
controller implements a writable Physical Upper Bound register.  This is
required for physical DMA above 4 GB (but not utilized by Linux yet).”h]”hŒ×The mentioned kernel log message contains the string â€œphysUBâ€ if the
controller implements a writable Physical Upper Bound register.  This is
required for physical DMA above 4 GB (but not utilized by Linux yet).”…””}”(hj  hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KjhjJ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jH  hjE  hžhhŸh¶h NubjI  )”}”(hXÝ  Establish a working FireWire cable connection:

Any FireWire cable, as long at it provides electrically and mechanically
stable connection and has matching connectors (there are small 4-pin and
large 6-pin FireWire ports) will do.

If an driver is running on both machines you should see a line like::

  firewire_core 0000:15:00.1: created device fw1: GUID 00061b0020105917, S400

on both machines in the kernel log when the cable is plugged in
and connects the two machines.
”h]”(hÉ)”}”(hŒ.Establish a working FireWire cable connection:”h]”hŒ.Establish a working FireWire cable connection:”…””}”(hj¥  hj£  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KnhjŸ  ubhÉ)”}”(hŒ¶Any FireWire cable, as long at it provides electrically and mechanically
stable connection and has matching connectors (there are small 4-pin and
large 6-pin FireWire ports) will do.”h]”hŒ¶Any FireWire cable, as long at it provides electrically and mechanically
stable connection and has matching connectors (there are small 4-pin and
large 6-pin FireWire ports) will do.”…””}”(hj³  hj±  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KphjŸ  ubhÉ)”}”(hŒEIf an driver is running on both machines you should see a line like::”h]”hŒDIf an driver is running on both machines you should see a line like:”…””}”(hŒDIf an driver is running on both machines you should see a line like:”hj¿  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KthjŸ  ubjl  )”}”(hŒKfirewire_core 0000:15:00.1: created device fw1: GUID 00061b0020105917, S400”h]”hŒKfirewire_core 0000:15:00.1: created device fw1: GUID 00061b0020105917, S400”…””}”(hhhjÎ  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jk  hŸh¶h KvhjŸ  ubhÉ)”}”(hŒ^on both machines in the kernel log when the cable is plugged in
and connects the two machines.”h]”hŒ^on both machines in the kernel log when the cable is plugged in
and connects the two machines.”…””}”(hjÞ  hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h KxhjŸ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jH  hjE  hžhhŸh¶h NubjI  )”}”(hXR  Test physical DMA using firescope:

On the debug host, make sure that /dev/fw* is accessible,
then start firescope::

     $ firescope
     Port 0 (/dev/fw1) opened, 2 nodes detected

     FireScope
     ---------
     Target : <unspecified>
     Gen    : 1
     [Ctrl-T] choose target
     [Ctrl-H] this menu
     [Ctrl-Q] quit

 ------> Press Ctrl-T now, the output should be similar to:

     2 nodes available, local node is: 0
      0: ffc0, uuid: 00000000 00000000 [LOCAL]
      1: ffc1, uuid: 00279000 ba4bb801

Besides the [LOCAL] node, it must show another node without error message.
”h]”(hÉ)”}”(hŒ"Test physical DMA using firescope:”h]”hŒ"Test physical DMA using firescope:”…””}”(hjö  hjô  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K{hjð  ubhÉ)”}”(hŒPOn the debug host, make sure that /dev/fw* is accessible,
then start firescope::”h]”hŒOOn the debug host, make sure that /dev/fw* is accessible,
then start firescope:”…””}”(hŒOOn the debug host, make sure that /dev/fw* is accessible,
then start firescope:”hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K}hjð  ubjl  )”}”(hX‚      $ firescope
    Port 0 (/dev/fw1) opened, 2 nodes detected

    FireScope
    ---------
    Target : <unspecified>
    Gen    : 1
    [Ctrl-T] choose target
    [Ctrl-H] this menu
    [Ctrl-Q] quit

------> Press Ctrl-T now, the output should be similar to:

    2 nodes available, local node is: 0
     0: ffc0, uuid: 00000000 00000000 [LOCAL]
     1: ffc1, uuid: 00279000 ba4bb801”h]”hX‚      $ firescope
    Port 0 (/dev/fw1) opened, 2 nodes detected

    FireScope
    ---------
    Target : <unspecified>
    Gen    : 1
    [Ctrl-T] choose target
    [Ctrl-H] this menu
    [Ctrl-Q] quit

------> Press Ctrl-T now, the output should be similar to:

    2 nodes available, local node is: 0
     0: ffc0, uuid: 00000000 00000000 [LOCAL]
     1: ffc1, uuid: 00279000 ba4bb801”…””}”(hhhj  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jk  hŸh¶h K€hjð  ubhÉ)”}”(hŒJBesides the [LOCAL] node, it must show another node without error message.”h]”hŒJBesides the [LOCAL] node, it must show another node without error message.”…””}”(hj!  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K‘hjð  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jH  hjE  hžhhŸh¶h NubjI  )”}”(hX&  Prepare for debugging with early OHCI-1394 initialization:

4.1) Kernel compilation and installation on debug target

Compile the kernel to be debugged with CONFIG_PROVIDE_OHCI1394_DMA_INIT
(Kernel hacking: Provide code for enabling DMA over FireWire early on boot)
enabled and install it on the machine to be debugged (debug target).

4.2) Transfer the System.map of the debugged kernel to the debug host

Copy the System.map of the kernel be debugged to the debug host (the host
which is connected to the debugged machine over the FireWire cable).
”h]”(hÉ)”}”(hŒ:Prepare for debugging with early OHCI-1394 initialization:”h]”hŒ:Prepare for debugging with early OHCI-1394 initialization:”…””}”(hj9  hj7  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K“hj3  ubhÉ)”}”(hŒ84.1) Kernel compilation and installation on debug target”h]”hŒ84.1) Kernel compilation and installation on debug target”…””}”(hjG  hjE  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K•hj3  ubhÉ)”}”(hŒØCompile the kernel to be debugged with CONFIG_PROVIDE_OHCI1394_DMA_INIT
(Kernel hacking: Provide code for enabling DMA over FireWire early on boot)
enabled and install it on the machine to be debugged (debug target).”h]”hŒØCompile the kernel to be debugged with CONFIG_PROVIDE_OHCI1394_DMA_INIT
(Kernel hacking: Provide code for enabling DMA over FireWire early on boot)
enabled and install it on the machine to be debugged (debug target).”…””}”(hjU  hjS  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K—hj3  ubhÉ)”}”(hŒE4.2) Transfer the System.map of the debugged kernel to the debug host”h]”hŒE4.2) Transfer the System.map of the debugged kernel to the debug host”…””}”(hjc  hja  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K›hj3  ubhÉ)”}”(hŒŽCopy the System.map of the kernel be debugged to the debug host (the host
which is connected to the debugged machine over the FireWire cable).”h]”hŒŽCopy the System.map of the kernel be debugged to the debug host (the host
which is connected to the debugged machine over the FireWire cable).”…””}”(hjq  hjo  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Khj3  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jH  hjE  hžhhŸh¶h NubjI  )”}”(hX,  Retrieving the printk buffer contents:

With the FireWire cable connected, the OHCI-1394 driver on the debugging
host loaded, reboot the debugged machine, booting the kernel which has
CONFIG_PROVIDE_OHCI1394_DMA_INIT enabled, with the option ohci1394_dma=early.

Then, on the debugging host, run firescope, for example by using -A::

     firescope -A System.map-of-debug-target-kernel

Note: -A automatically attaches to the first non-local node. It only works
reliably if only connected two machines are connected using FireWire.

After having attached to the debug target, press Ctrl-D to view the
complete printk buffer or Ctrl-U to enter auto update mode and get an
updated live view of recent kernel messages logged on the debug target.

Call "firescope -h" to get more information on firescope's options.
”h]”(hÉ)”}”(hŒ&Retrieving the printk buffer contents:”h]”hŒ&Retrieving the printk buffer contents:”…””}”(hj‰  hj‡  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K hjƒ  ubhÉ)”}”(hŒÝWith the FireWire cable connected, the OHCI-1394 driver on the debugging
host loaded, reboot the debugged machine, booting the kernel which has
CONFIG_PROVIDE_OHCI1394_DMA_INIT enabled, with the option ohci1394_dma=early.”h]”hŒÝWith the FireWire cable connected, the OHCI-1394 driver on the debugging
host loaded, reboot the debugged machine, booting the kernel which has
CONFIG_PROVIDE_OHCI1394_DMA_INIT enabled, with the option ohci1394_dma=early.”…””}”(hj—  hj•  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¢hjƒ  ubhÉ)”}”(hŒEThen, on the debugging host, run firescope, for example by using -A::”h]”hŒDThen, on the debugging host, run firescope, for example by using -A:”…””}”(hŒDThen, on the debugging host, run firescope, for example by using -A:”hj£  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¦hjƒ  ubjl  )”}”(hŒ.firescope -A System.map-of-debug-target-kernel”h]”hŒ.firescope -A System.map-of-debug-target-kernel”…””}”(hhhj²  ubah}”(h]”h ]”h"]”h$]”h&]”j{  j|  uh1jk  hŸh¶h K¨hjƒ  ubhÉ)”}”(hŒNote: -A automatically attaches to the first non-local node. It only works
reliably if only connected two machines are connected using FireWire.”h]”hŒNote: -A automatically attaches to the first non-local node. It only works
reliably if only connected two machines are connected using FireWire.”…””}”(hjÂ  hjÀ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h Kªhjƒ  ubhÉ)”}”(hŒÑAfter having attached to the debug target, press Ctrl-D to view the
complete printk buffer or Ctrl-U to enter auto update mode and get an
updated live view of recent kernel messages logged on the debug target.”h]”hŒÑAfter having attached to the debug target, press Ctrl-D to view the
complete printk buffer or Ctrl-U to enter auto update mode and get an
updated live view of recent kernel messages logged on the debug target.”…””}”(hjÐ  hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K­hjƒ  ubhÉ)”}”(hŒCCall "firescope -h" to get more information on firescope's options.”h]”hŒICall â€œfirescope -hâ€ to get more information on firescopeâ€™s options.”…””}”(hjÞ  hjÜ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K±hjƒ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jH  hjE  hžhhŸh¶h Nubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œarabic”Œprefix”hŒsuffix”Œ)”uh1jC  hj  hžhhŸh¶h K[ubeh}”(h]”Œgetting-started”ah ]”h"]”Œgetting started”ah$]”h&]”uh1h¡hh£hžhhŸh¶h KNubh¢)”}”(hhh]”(h§)”}”(hŒNotes”h]”hŒNotes”…””}”(hj  hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¦hj  hžhhŸh¶h K´ubhÉ)”}”(hŒ?Documentation and specifications: http://halobates.de/firewire/”h]”(hŒ"Documentation and specifications: ”…””}”(hŒ"Documentation and specifications: ”hj  hžhhŸNh Nubj   )”}”(hŒhttp://halobates.de/firewire/”h]”hŒhttp://halobates.de/firewire/”…””}”(hhhj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j  uh1jŸ  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¶hj  hžhubhÉ)”}”(hŒtFireWire is a trademark of Apple Inc. - for more information please refer to:
https://en.wikipedia.org/wiki/FireWire”h]”(hŒNFireWire is a trademark of Apple Inc. - for more information please refer to:
”…””}”(hŒNFireWire is a trademark of Apple Inc. - for more information please refer to:
”hj2  hžhhŸNh Nubj   )”}”(hŒ&https://en.wikipedia.org/wiki/FireWire”h]”hŒ&https://en.wikipedia.org/wiki/FireWire”…””}”(hhhj;  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”j=  uh1jŸ  hj2  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÈhŸh¶h K¸hj  hžhubeh}”(h]”Œnotes”ah ]”h"]”Œnotes”ah$]”h&]”uh1h¡hh£hžhhŸh¶h K´ubeh}”(h]”ŒKusing-physical-dma-provided-by-ohci-1394-firewire-controllers-for-debugging”ah ]”h"]”ŒKusing physical dma provided by ohci-1394 firewire controllers for debugging”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”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Œ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”‰Œfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œ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”‰Œembed_images”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j]  jZ  j1  j.  jt  jq  j  j  j   jý  jU  jR  uŒ	nametypes”}”(j]  Nj1  Njt  Nj  Nj   NjU  Nuh}”(jZ  h£j.  h·jq  j4  j  jw  jý  j  jR  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.