[Lldb-commits] [lldb] r171934 - /lldb/trunk/examples/python/operating_system.py

[Greg Clayton]

Author: gclayton
Date: Tue Jan  8 20:05:38 2013
New Revision: 171934

URL: http://llvm.org/viewvc/llvm-project?rev=171934&view=rev
Log:
Updated documentation on the "register_data_addr" key that can be supplied in the "thread" dictionary return value for the python OS plug-ins.


Modified:
    lldb/trunk/examples/python/operating_system.py

Modified: lldb/trunk/examples/python/operating_system.py
URL: http://llvm.org/viewvc/llvm-project/lldb/trunk/examples/python/operating_system.py?rev=171934&r1=171933&r2=171934&view=diff
==============================================================================
--- lldb/trunk/examples/python/operating_system.py (original)
+++ lldb/trunk/examples/python/operating_system.py Tue Jan  8 20:05:38 2013
@@ -37,6 +37,11 @@
             #   'none' thread is just stopped because the process is stopped
             #   'trace' the thread just single stepped
             #   The usual value for this while threads are in memory is 'none'
+            # register_data_addr => the address of the register data in memory (optional key/value pair)
+            #   Specifying this key/value pair for a thread will avoid a call to get_register_data()
+            #   and can be used when your registers are in a thread context structure that is contiguous
+            #   in memory. Don't specify this if your register layout in memory doesn't match the layout
+            #   described by the dictionary returned from a call to the get_register_info() method.
             self.threads = [
                     { 'tid' : 0x111111111, 'name' : 'one'  , 'queue' : 'queue1', 'state' : 'stopped', 'stop_reason' : 'breakpoint'},
                     { 'tid' : 0x222222222, 'name' : 'two'  , 'queue' : 'queue2', 'state' : 'stopped', 'stop_reason' : 'none'      },