================ @@ -153,3 +153,148 @@ Linux applies to Windows. To find dependencies like Python, you need to run ``dumpbin`` on ``liblldb.dll`` too. On MacOS, use ``otool -l <path-to-lldb>``. + +Why Do I See More, Less, Or Different Registers Than I Expected? +---------------------------------------------------------------- + +The registers you see in LLDB are defined by information either provided by the +debug server you are connected to, or in some cases, guessed by LLDB. + +If you are not seeing the registers you expect, the first step is to figure out +which method is being used to read the register information. They are presented +here in the order that LLDB will try them. + +Target Definition Script +^^^^^^^^^^^^^^^^^^^^^^^^ + +These scripts tell LLDB what registers exist on the debug-server without having +to ask it. You can check if you are using one by checking the setting: + +:: + + (lldb) settings show plugin.process.gdb-remote.target-definition-file + +In most cases you will not be using such a script. + +If you are using one, or want to write one, you can learn about them by reading +the ``*_target_definition.py`` files in the +`Python examples folder <https://github.com/llvm/llvm-project/tree/main/lldb/examples/python>`__. + +We recommend that before attempting to write a target definition script to solve +your issues, you look into the other methods first. + +Target Description Format XML +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +The most commonly used method is the debug server sending LLDB an XML +document in the +`Target Description Format <https://sourceware.org/gdb/current/onlinedocs/gdb.html/Target-Description-Format.html>`__. + +LLDB can only process this if XML parsing was enabled when it was built. A +previous section of this document explains how to check this. If XML is not +enabled and the debug server has offered an XML document, we highly recommend +switching to a build of LLDB with XML parsing enabled. + +.. note:: + + If LLDB was offered an XML document but could not use it, you will see a + warning in your debug session to alert you to this situation. + +If your LLDB has XML support, next check whether the debug-server offered this ---------------- DavidSpickett wrote:
Done. https://github.com/llvm/llvm-project/pull/171806 _______________________________________________ lldb-commits mailing list [email protected] https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-commits
