]> git.saurik.com Git - apple/xnu.git/blobdiff - tools/lldbmacros/core/operating_system.py
xnu-2422.1.72.tar.gz
[apple/xnu.git] / tools / lldbmacros / core / operating_system.py
diff --git a/tools/lldbmacros/core/operating_system.py b/tools/lldbmacros/core/operating_system.py
new file mode 100644 (file)
index 0000000..37d1aeb
--- /dev/null
@@ -0,0 +1,600 @@
+#!/usr/bin/python
+#
+
+#source of register info is from http://opensource.apple.com/source/gdb/gdb-962/src/gdb/arm-tdep.c
+import lldb
+import struct
+osplugin_target_obj = None
+
+class PluginValue(lldb.SBValue):
+  def GetChildMemberWithName(val, name):
+    val_type = val.GetType()
+    if val_type.IsPointerType() == True:
+      val_type = val_type.GetPointeeType()
+    for i in range(val_type.GetNumberOfFields()):
+      if name == val_type.GetFieldAtIndex(i).GetName():
+        return PluginValue(val.GetChildAtIndex(i))
+    return None
+
+
+class Armv7_RegisterSet(object):
+  """ register info set for armv7 32 bit architecture """
+  def __init__(self):
+    self.register_info = {}
+    self.register_info['sets'] = ['GPR']
+    self.register_info['registers'] = [
+                        { 'name':'r0'   , 'bitsize' : 32, 'offset' :  0, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 0, 'dwarf' : 0},
+                        { 'name':'r1'   , 'bitsize' : 32, 'offset' :  4, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 1, 'dwarf' : 1},
+                        { 'name':'r2'   , 'bitsize' : 32, 'offset' :  8, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 2, 'dwarf' : 2},
+                        { 'name':'r3'   , 'bitsize' : 32, 'offset' : 12, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 3, 'dwarf' : 3},
+                        { 'name':'r4'   , 'bitsize' : 32, 'offset' : 16, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 4, 'dwarf' : 4},
+                        { 'name':'r5'   , 'bitsize' : 32, 'offset' : 20, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 5, 'dwarf' : 5},
+                        { 'name':'r6'   , 'bitsize' : 32, 'offset' : 24, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 6, 'dwarf' : 6},
+                        { 'name':'r7'   , 'bitsize' : 32, 'offset' : 28, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 7, 'dwarf' : 7},
+                        { 'name':'r8'   , 'bitsize' : 32, 'offset' : 32, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 8, 'dwarf' : 8},
+                        { 'name':'r9'   , 'bitsize' : 32, 'offset' : 36, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc': 9, 'dwarf' : 9},
+                        { 'name':'r10'  , 'bitsize' : 32, 'offset' : 40, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':10, 'dwarf' :10},
+                        { 'name':'r11'  , 'bitsize' : 32, 'offset' : 44, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':11, 'dwarf' :11, 'alt-name': 'fp', 'generic': 'fp'},
+                        { 'name':'r12'  , 'bitsize' : 32, 'offset' : 48, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':12, 'dwarf' :12},
+                        { 'name':'sp'   , 'bitsize' : 32, 'offset' : 52, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':13, 'dwarf' :13, 'alt-name': 'sp', 'generic': 'sp'}, 
+                        { 'name':'lr'   , 'bitsize' : 32, 'offset' : 56, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':14, 'dwarf' :14, 'alt-name': 'lr', 'generic': 'lr'},
+                        { 'name':'pc'   , 'bitsize' : 32, 'offset' : 60, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':15, 'dwarf' :15, 'alt-name': 'pc', 'generic': 'pc'},
+                        { 'name':'cpsr' , 'bitsize' : 32, 'offset' : 64, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':25, 'dwarf' :16, 'alt-name':'cpsr','generic':'cpsr'},
+                        { 'name':'fsr'  , 'bitsize' : 32, 'offset' : 68, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':17, 'dwarf' :17, 'alt-name':'fsr', 'generic': 'fsr'},
+                        { 'name':'far'  , 'bitsize' : 32, 'offset' : 72, 'encoding':'uint', 'format':'hex', 'set':0, 'gcc':18, 'dwarf' :18, 'alt-name': 'far', 'generic': 'far'}
+                        ]
+    self.switch_context_address = osplugin_target_obj.FindSymbols('load_reg')[0].GetSymbol().GetStartAddress().GetLoadAddress(osplugin_target_obj) + 8
+    self.ResetRegisterValues()
+  def ResetRegisterValues(self):
+    self.r0 = 0
+    self.r1 = 0
+    self.r2 = 0
+    self.r3 = 0
+    self.r4 = 0
+    self.r5 = 0
+    self.r6 = 0
+    self.r7 = 0
+    self.r8 = 0
+    self.r9 = 0
+    self.r10 = 0
+    self.r11 = 0
+    self.r12 = 0
+    self.sp = 0
+    self.lr = 0
+    self.pc = 0
+    self.cpsr = 0
+    self.fsr = 0
+    self.far = 0
+
+  def __str__(self):
+    return """
+              r0 = {o.r0: <#010x}
+              r1 = {o.r1: <#010x}
+              r2 = {o.r2: <#010x}
+              r3 = {o.r3: <#010x}
+              r4 = {o.r4: <#010x}
+              r5 = {o.r5: <#010x}
+              r6 = {o.r6: <#010x}
+              r7 = {o.r7: <#010x}
+              r8 = {o.r8: <#010x}
+              r9 = {o.r9: <#010x}
+              r10 = {o.r10: <#010x}
+              r11 = {o.r11: <#010x}
+              r12 = {o.r12: <#010x}
+              sp = {o.sp: <#010x}
+              lr = {o.lr: <#010x}
+              pc = {o.pc: <#010x}
+              cpsr = {o.cpsr: <#010x}
+              fsr = {o.fsr : <#010x}
+              far = {o.far : <#010x}
+          """.format(o=self)
+
+  def GetPackedRegisterState(self):
+    return struct.pack('19I', self.r0, self.r1, self.r2, self.r3,
+                              self.r4, self.r5, self.r6, self.r7,
+                              self.r8, self.r9, self.r10, self.r11,
+                              self.r12, self.sp, self.lr, self.pc,
+                              self.cpsr, self.fsr, self.far)
+
+  def ReadRegisterDataFromKDPSavedState(self, kdp_state, kernel_version):
+      saved_state = kernel_version.CreateValueFromExpression(None, '(struct arm_saved_state *) ' + str(kdp_state.GetValueAsUnsigned()))
+      saved_state = saved_state.Dereference()
+      saved_state = PluginValue(saved_state)
+      self.ResetRegisterValues()
+      self.r0 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(0).GetValueAsUnsigned()
+      self.r1 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(1).GetValueAsUnsigned()
+      self.r2 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(2).GetValueAsUnsigned()
+      self.r3 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(3).GetValueAsUnsigned()
+      self.r4 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(4).GetValueAsUnsigned()
+      self.r5 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(5).GetValueAsUnsigned()
+      self.r6 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(6).GetValueAsUnsigned()
+      self.r7 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(7).GetValueAsUnsigned()
+      self.r8 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(8).GetValueAsUnsigned()
+      self.r9 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(9).GetValueAsUnsigned()
+      self.r10 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(10).GetValueAsUnsigned()
+      self.r11 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(11).GetValueAsUnsigned()
+      self.r12 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(12).GetValueAsUnsigned()
+      self.sp = saved_state.GetChildMemberWithName('sp').GetValueAsUnsigned()
+      self.lr = saved_state.GetChildMemberWithName('lr').GetValueAsUnsigned()
+      self.pc = saved_state.GetChildMemberWithName('pc').GetValueAsUnsigned()
+      self.cpsr = saved_state.GetChildMemberWithName('cpsr').GetValueAsUnsigned()
+      self.fsr = saved_state.GetChildMemberWithName('fsr').GetValueAsUnsigned()
+      self.far = saved_state.GetChildMemberWithName('far').GetValueAsUnsigned()
+      return self
+
+  def ReadRegisterDataFromKernelStack(self, kstack_saved_state_addr, kernel_version):
+      saved_state = kernel_version.CreateValueFromExpression(None, '(struct arm_saved_state *) '+ str(kstack_saved_state_addr))
+      saved_state = saved_state.Dereference()
+      saved_state = PluginValue(saved_state)
+      self.ResetRegisterValues()
+      self.r0 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(0).GetValueAsUnsigned()
+      self.r1 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(1).GetValueAsUnsigned()
+      self.r2 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(2).GetValueAsUnsigned()
+      self.r3 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(3).GetValueAsUnsigned()
+      self.r4 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(4).GetValueAsUnsigned()
+      self.r5 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(5).GetValueAsUnsigned()
+      self.r6 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(6).GetValueAsUnsigned()
+      self.r7 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(7).GetValueAsUnsigned()
+      self.r8 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(8).GetValueAsUnsigned()
+      self.r9 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(9).GetValueAsUnsigned()
+      self.r10 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(10).GetValueAsUnsigned()
+      self.r11 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(11).GetValueAsUnsigned()
+      self.r12 = saved_state.GetChildMemberWithName('r').GetChildAtIndex(12).GetValueAsUnsigned()
+      self.sp = saved_state.GetChildMemberWithName('sp').GetValueAsUnsigned()
+      self.lr = saved_state.GetChildMemberWithName('lr').GetValueAsUnsigned()
+      # pc for a blocked thread is treated to be the next instruction it would run after thread switch.
+      self.pc = self.switch_context_address
+      self.cpsr = saved_state.GetChildMemberWithName('cpsr').GetValueAsUnsigned()
+      self.fsr = saved_state.GetChildMemberWithName('fsr').GetValueAsUnsigned()
+      self.far = saved_state.GetChildMemberWithName('far').GetValueAsUnsigned()
+      return self
+
+  def ReadRegisterDataFromContinuation(self, continuation_ptr):
+      self.ResetRegisterValues()
+      self.pc = continuation_ptr
+      return self
+
+
+class I386_RegisterSet(object):
+  """ register info set for i386 architecture
+  """
+  def __init__(self):
+    self.register_info = []
+    self.register_info['sets'] = ['GPR']
+    self.register_info['registers'] = [
+                       { 'name': 'eax'   , 'bitsize': 32, 'offset' : 0, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 0, 'dwarf': 0},
+                       { 'name': 'ebx'   , 'bitsize': 32, 'offset' : 4, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 1, 'dwarf': 1},
+                       { 'name': 'ecx'   , 'bitsize': 32, 'offset' : 8, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 2, 'dwarf': 2},
+                       { 'name': 'edx'   , 'bitsize': 32, 'offset' :12, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 3, 'dwarf': 3},
+                       { 'name': 'edi'   , 'bitsize': 32, 'offset' :16, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 4, 'dwarf': 4},
+                       { 'name': 'esi'   , 'bitsize': 32, 'offset' :20, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 5, 'dwarf': 5},
+                       { 'name': 'ebp'   , 'bitsize': 32, 'offset' :24, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 6, 'dwarf': 6},
+                       { 'name': 'esp'   , 'bitsize': 32, 'offset' :28, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 7, 'dwarf': 7},
+                       { 'name': 'ss'    , 'bitsize': 32, 'offset' :32, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 8, 'dwarf': 8},
+                       { 'name': 'eflags', 'bitsize': 32, 'offset' :36, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' : 9, 'dwarf': 9},
+                       { 'name': 'eip'   , 'bitsize': 32, 'offset' :40, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' :10, 'dwarf':10},
+                       { 'name': 'cs'    , 'bitsize': 32, 'offset' :44, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' :11, 'dwarf':11},
+                       { 'name': 'ds'    , 'bitsize': 32, 'offset' :48, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' :12, 'dwarf':12},
+                       { 'name': 'es'    , 'bitsize': 32, 'offset' :52, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' :13, 'dwarf':13},
+                       { 'name': 'fs'    , 'bitsize': 32, 'offset' :56, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' :14, 'dwarf':14},
+                       { 'name': 'gs'    , 'bitsize': 32, 'offset' :60, 'encoding': 'uint' , 'format':'hex' , 'set': 0, 'gcc' :15, 'dwarf':15},
+                      ]
+    self.ResetRegisterValues()
+  def ResetRegisterValues(self):
+    """ set all registers to zero """
+    self.eax = 0
+    self.ebx = 0
+    self.ecx = 0
+    self.edx = 0
+    self.edi = 0
+    self.esi = 0
+    self.ebp = 0
+    self.esp = 0
+    self.ss  = 0
+    self.eflags = 0
+    self.eip = 0
+    self.cs = 0
+    self.ds = 0
+    self.es = 0
+    self.fs = 0
+    self.gs = 0
+
+  def __str__(self):
+    return """ 
+               eax = {o.eax: #010x}
+               ebx = {o.ebx: #010x}
+               ecx = {o.ecx: #010x}
+               edx = {o.edx: #010x}
+               edi = {o.edi: #010x}
+               esi = {o.esi: #010x}
+               ebp = {o.ebp: #010x}
+               esp = {o.esp: #010x}
+               ss  = {o.ss: #010x}
+            eflags = {o.eflags: #010x}
+               eip = {o.eip: #010x}
+               cs  = {o.cs: #010x}
+               ds  = {o.ds: #010x}
+               es  = {o.es: #010x}
+               fs  = {o.fs: #010x}
+               gs  = {o.gs: #010x}
+               """.format(o=self)
+  
+  def GetPackedRegisterState(self):
+    """ get a struct.pack register data """
+    return struct.pack('16I', self.eax, self.ebx, self.ecx,
+                              self.edx, self.edi, self.esi,
+                              self.ebp, self.esp, self.ss,
+                              self.eflags, self.eip, self.cs,
+                              self.ds, self.es, self.fs, self.gs
+                       )
+  def ReadRegisterDataFromKDPSavedState(self, kdp_state, kernel_version):
+    """ to be implemented"""
+    return None
+  def ReadRegisterDataFromKernelStack(self, kstack_saved_state_addr, kernel_version):
+    """ to be implemented """
+    return None 
+
+  def ReadRegisterDataFromContinuation(self, continuation_ptr):
+    self.ResetRegisterValues()
+    self.eip = continuation_ptr
+    return self
+               
+      
+class X86_64RegisterSet(object):
+  """ register info set for x86_64 architecture """
+  def __init__(self):
+    self.register_info = {}
+    self.register_info['sets'] =  ['GPR', 'FPU', 'EXC']
+    self.register_info['registers'] =  [
+                        { 'name':'rax'       , 'bitsize' :  64, 'offset' :   0, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 0, 'dwarf' : 0},
+                        { 'name':'rbx'       , 'bitsize' :  64, 'offset' :   8, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 3, 'dwarf' : 3},
+                        { 'name':'rcx'       , 'bitsize' :  64, 'offset' :  16, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 2, 'dwarf' : 2, 'generic':'arg4', 'alt-name':'arg4', },
+                        { 'name':'rdx'       , 'bitsize' :  64, 'offset' :  24, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 1, 'dwarf' : 1, 'generic':'arg3', 'alt-name':'arg3', },
+                        { 'name':'rdi'       , 'bitsize' :  64, 'offset' :  32, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 5, 'dwarf' : 5, 'generic':'arg1', 'alt-name':'arg1', },
+                        { 'name':'rsi'       , 'bitsize' :  64, 'offset' :  40, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 4, 'dwarf' : 4, 'generic':'arg2', 'alt-name':'arg2', },
+                        { 'name':'rbp'       , 'bitsize' :  64, 'offset' :  48, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 6, 'dwarf' : 6, 'generic':'fp'  , 'alt-name':'fp', },
+                        { 'name':'rsp'       , 'bitsize' :  64, 'offset' :  56, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 7, 'dwarf' : 7, 'generic':'sp'  , 'alt-name':'sp', },
+                        { 'name':'r8'        , 'bitsize' :  64, 'offset' :  64, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 8, 'dwarf' : 8, 'generic':'arg5', 'alt-name':'arg5', },
+                        { 'name':'r9'        , 'bitsize' :  64, 'offset' :  72, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 9, 'dwarf' : 9, 'generic':'arg6', 'alt-name':'arg6', },
+                        { 'name':'r10'       , 'bitsize' :  64, 'offset' :  80, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 10, 'dwarf' : 10},
+                        { 'name':'r11'       , 'bitsize' :  64, 'offset' :  88, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 11, 'dwarf' : 11},
+                        { 'name':'r12'       , 'bitsize' :  64, 'offset' :  96, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 12, 'dwarf' : 12},
+                        { 'name':'r13'       , 'bitsize' :  64, 'offset' : 104, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 13, 'dwarf' : 13},
+                        { 'name':'r14'       , 'bitsize' :  64, 'offset' : 112, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 14, 'dwarf' : 14},
+                        { 'name':'r15'       , 'bitsize' :  64, 'offset' : 120, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 15, 'dwarf' : 15},
+                        { 'name':'rip'       , 'bitsize' :  64, 'offset' : 128, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'gcc' : 16, 'dwarf' : 16, 'generic':'pc', 'alt-name':'pc' },
+                        { 'name':'rflags'    , 'bitsize' :  64, 'offset' : 136, 'encoding':'uint'  , 'format':'hex'         , 'set': 0, 'generic':'flags', 'alt-name':'flags' },
+                        { 'name':'cs'        , 'bitsize' :  64, 'offset' : 144, 'encoding':'uint'  , 'format':'hex'         , 'set': 0                          },
+                        { 'name':'fs'        , 'bitsize' :  64, 'offset' : 152, 'encoding':'uint'  , 'format':'hex'         , 'set': 0                          },
+                        { 'name':'gs'        , 'bitsize' :  64, 'offset' : 160, 'encoding':'uint'  , 'format':'hex'         , 'set': 0                          },
+                        ]
+    self.ResetRegisterValues()
+
+  def ResetRegisterValues(self):
+    """ set all the registers to zero. """
+    self.rax = 0
+    self.rbx = 0
+    self.rcx = 0
+    self.rdx = 0
+    self.rdi = 0
+    self.rsi = 0
+    self.rbp = 0
+    self.rsp = 0
+    self.r8  = 0
+    self.r9  = 0
+    self.r10 = 0
+    self.r11 = 0
+    self.r12 = 0
+    self.r13 = 0
+    self.r14 = 0
+    self.r15 = 0
+    self.rip = 0
+    self.rflags = 0
+    self.cs  = 0
+    self.fs  = 0
+    self.gs  = 0
+  def __str__(self):
+    return """ 
+               rax = {o.rax: <#018x}
+               rbx = {o.rbx: <#018x}
+               rcx = {o.rcx: <#018x}
+               rdx = {o.rdx: <#018x}
+               rdi = {o.rdi: <#018x}
+               rsi = {o.rsi: <#018x}
+               rbp = {o.rbp: <#018x}
+               rsp = {o.rsp: <#018x}
+               r8  = {o.r8: <#018x}
+               r9  = {o.r9: <#018x}
+               r10 = {o.r10: <#018x}
+               r11 = {o.r11: <#018x}
+               r12 = {o.r12: <#018x}
+               r13 = {o.r13: <#018x}
+               r14 = {o.r14: <#018x}
+               r15 = {o.r15: <#018x}
+               rip = {o.rip: <#018x}
+               rflags =  {o.rflags: <#018x}
+               cs = {o.cs: <#018x}
+               fs = {o.fs: <#018x}
+               gs = {o.gs: <#018x}
+               """.format(o=self)
+
+  def GetPackedRegisterState(self):
+    """ get a struct.pack register data for passing to C constructs """
+    return struct.pack('21Q', self.rax, self.rbx, self.rcx, self.rdx, self.rdi,
+                              self.rsi, self.rbp, self.rsp, self.r8,  self.r9,
+                              self.r10, self.r11, self.r12, self.r13, self.r14,
+                              self.r15, self.rip, self.rflags, self.cs, self.fs, self.gs)
+
+  def ReadRegisterDataFromKDPSavedState(self, kdp_state, kernel_version):
+    saved_state = kernel_version.CreateValueFromExpression(None,  '(struct x86_saved_state64 *) '+ str(kdp_state.GetValueAsUnsigned()))
+    saved_state = saved_state.Dereference()
+    saved_state = PluginValue(saved_state)
+    self.ResetRegisterValues()
+    self.rdi = saved_state.GetChildMemberWithName('rdi').GetValueAsUnsigned()
+    self.rsi = saved_state.GetChildMemberWithName('rsi').GetValueAsUnsigned()
+    self.rdx = saved_state.GetChildMemberWithName('rdx').GetValueAsUnsigned()
+    self.r10 = saved_state.GetChildMemberWithName('r10').GetValueAsUnsigned()
+    self.r8 = saved_state.GetChildMemberWithName('r8').GetValueAsUnsigned()
+    self.r9 = saved_state.GetChildMemberWithName('r9').GetValueAsUnsigned()
+    self.r15 = saved_state.GetChildMemberWithName('r15').GetValueAsUnsigned()
+    self.r14 = saved_state.GetChildMemberWithName('r14').GetValueAsUnsigned()
+    self.r13 = saved_state.GetChildMemberWithName('r13').GetValueAsUnsigned()
+    self.r12 = saved_state.GetChildMemberWithName('r12').GetValueAsUnsigned()
+    self.r11 = saved_state.GetChildMemberWithName('r11').GetValueAsUnsigned()
+    self.rbp = saved_state.GetChildMemberWithName('rbp').GetValueAsUnsigned()
+    self.rbx = saved_state.GetChildMemberWithName('rbx').GetValueAsUnsigned()
+    self.rcx = saved_state.GetChildMemberWithName('rcx').GetValueAsUnsigned()
+    self.rax = saved_state.GetChildMemberWithName('rax').GetValueAsUnsigned()
+    self.rip = saved_state.GetChildMemberWithName('isf').GetChildMemberWithName('rip').GetValueAsUnsigned()
+    self.rflags = saved_state.GetChildMemberWithName('isf').GetChildMemberWithName('rflags').GetValueAsUnsigned()
+    self.rsp = saved_state.GetChildMemberWithName('isf').GetChildMemberWithName('rsp').GetValueAsUnsigned()
+    return self
+
+  def ReadRegisterDataFromKernelStack(self, kstack_saved_state_addr, kernel_version):
+    saved_state = kernel_version.CreateValueFromExpression(None, '(struct x86_kernel_state *) '+ str(kstack_saved_state_addr))
+    saved_state = saved_state.Dereference()
+    saved_state = PluginValue(saved_state)
+    self.ResetRegisterValues()
+    self.rbx = saved_state.GetChildMemberWithName('k_rbx').GetValueAsUnsigned()
+    self.rsp = saved_state.GetChildMemberWithName('k_rsp').GetValueAsUnsigned()
+    self.rbp = saved_state.GetChildMemberWithName('k_rbp').GetValueAsUnsigned()
+    self.r12 = saved_state.GetChildMemberWithName('k_r12').GetValueAsUnsigned()
+    self.r13 = saved_state.GetChildMemberWithName('k_r13').GetValueAsUnsigned()
+    self.r14 = saved_state.GetChildMemberWithName('k_r14').GetValueAsUnsigned()
+    self.r15 = saved_state.GetChildMemberWithName('k_r15').GetValueAsUnsigned()
+    self.rip = saved_state.GetChildMemberWithName('k_rip').GetValueAsUnsigned()
+    return self
+
+  def ReadRegisterDataFromContinuation(self, continuation_ptr):
+    self.ResetRegisterValues()
+    self.rip = continuation_ptr
+    return self
+
+
+
+
+def IterateQueue(queue_head, element_ptr_type, element_field_name):
+    """ iterate over a queue in kernel of type queue_head_t. refer to osfmk/kern/queue.h 
+        params:
+            queue_head         - lldb.SBValue : Value object for queue_head.
+            element_type       - lldb.SBType : a pointer type of the element 'next' points to. Typically its structs like thread, task etc..
+            element_field_name - str : name of the field in target struct.
+        returns:
+            A generator does not return. It is used for iterating.
+            SBValue  : an object thats of type (element_type) queue_head->next. Always a pointer object    
+    """
+    queue_head_addr = 0x0
+    if queue_head.TypeIsPointerType():
+        queue_head_addr = queue_head.GetValueAsUnsigned()
+    else:
+        queue_head_addr = queue_head.GetAddress().GetLoadAddress(osplugin_target_obj)
+    cur_elt = queue_head.GetChildMemberWithName('next')
+    while True:
+        
+        if not cur_elt.IsValid() or cur_elt.GetValueAsUnsigned() == 0 or cur_elt.GetValueAsUnsigned() == queue_head_addr:
+            break
+        elt = cur_elt.Cast(element_ptr_type)
+        yield elt
+        cur_elt = elt.GetChildMemberWithName(element_field_name).GetChildMemberWithName('next')
+
+def GetUniqueSessionID(process_obj):
+  """ Create a unique session identifier. 
+      params:
+        process_obj: lldb.SBProcess object refering to connected process.
+      returns:
+        int - a unique number identified by processid and stopid.
+  """
+  session_key_str = ""
+  if hasattr(process_obj, "GetUniqueID"):
+    session_key_str += str(process_obj.GetUniqueID()) + ":"
+  else:
+    session_key_str += "0:"
+
+  if hasattr(process_obj, "GetStopID"):
+    session_key_str += str(process_obj.GetStopID()) 
+  else:
+    session_key_str +="1"
+
+  return hash(session_key_str)
+
+
+(archX86_64, archARMv7_family, archI386) = ("x86_64", ("armv7", "armv7s") , "i386")
+
+class OperatingSystemPlugIn(object):
+    """Class that provides data for an instance of a LLDB 'OperatingSystemPython' plug-in class"""
+    
+    def __init__(self, process):
+        '''Initialization needs a valid.SBProcess object'''
+        self.process = None
+        self.registers = None
+        self.threads = None
+        self.thread_cache = {}
+        self.current_session_id = 0
+        self.kdp_thread = None
+        if type(process) is lldb.SBProcess and process.IsValid():
+            global osplugin_target_obj
+            self.process = process
+            self._target = process.target
+            osplugin_target_obj = self._target
+            self.current_session_id = GetUniqueSessionID(self.process)
+            self.version = self._target.FindGlobalVariables('version', 0).GetValueAtIndex(0)
+            self.kernel_stack_size = self._target.FindGlobalVariables('kernel_stack_size', 0).GetValueAtIndex(0).GetValueAsUnsigned()
+            self.kernel_context_size = 0
+            self.connected_over_kdp = False
+            plugin_string = self.process.GetPluginName().lower()
+            if plugin_string.find("kdp") >=0:
+                self.connected_over_kdp = True
+            #print "version", self.version, "kernel_stack_size", self.kernel_stack_size, "context_size", self.kernel_context_size
+            self.threads = None # Will be an dictionary containing info for each thread
+            triple = self.process.target.triple
+            arch = triple.split('-')[0].lower()
+            self.target_arch = ""
+            self.kernel_context_size = 0
+            if arch == archX86_64 :
+              self.target_arch = archX86_64
+              print "Target arch: x86_64"
+              self.register_set = X86_64RegisterSet()
+              self.kernel_context_size = self._target.FindFirstType('x86_kernel_state').GetByteSize()
+            elif arch in archARMv7_family :
+              self.target_arch = arch
+              print "Target arch: " + self.target_arch
+              self.register_set = Armv7_RegisterSet()
+            self.registers = self.register_set.register_info
+    
+    def create_thread(self, tid, context):
+        th_ptr = context
+        th = self.version.CreateValueFromExpression(str(th_ptr),'(struct thread *)' + str(th_ptr))
+        thread_id = th.GetChildMemberWithName('thread_id').GetValueAsUnsigned()
+        if tid != thread_id:
+          print "FATAL ERROR: Creating thread from memory 0x%x with tid in mem=%d when requested tid = %d " % (context, thread_id, tid)
+          return None
+        thread_obj = { 'tid'   : thread_id,
+                       'ptr'   : th.GetValueAsUnsigned(),
+                       'name'  : hex(th.GetValueAsUnsigned()).rstrip('L'),
+                       'queue' : hex(th.GetChildMemberWithName('wait_queue').GetValueAsUnsigned()).rstrip('L'),
+                       'state' : 'stopped',
+                       'stop_reason' : 'none'
+                     }
+        if self.current_session_id != GetUniqueSessionID(self.process):
+          self.thread_cache = {}
+          self.current_session_id = GetUniqueSessionID(self.process)
+
+        self.thread_cache[tid] = thread_obj
+        return thread_obj
+
+
+    def get_thread_info(self):
+        self.kdp_thread = None
+        self.kdp_state = None
+        if self.connected_over_kdp :
+            kdp = self._target.FindGlobalVariables('kdp',1).GetValueAtIndex(0)
+            kdp_state = kdp.GetChildMemberWithName('saved_state')
+            kdp_thread = kdp.GetChildMemberWithName('kdp_thread')
+            if kdp_thread and kdp_thread.GetValueAsUnsigned() != 0:
+              self.kdp_thread = kdp_thread
+              self.kdp_state = kdp_state
+              kdp_thid = kdp_thread.GetChildMemberWithName('thread_id').GetValueAsUnsigned()
+              self.create_thread(kdp_thid, kdp_thread.GetValueAsUnsigned())
+              self.thread_cache[kdp_thid]['core']=0
+              retval = [self.thread_cache[kdp_thid]]
+              return retval
+            else:
+              print "FATAL FAILURE: Unable to find kdp_thread state for this connection."
+              return []
+
+        num_threads = self._target.FindGlobalVariables('threads_count',1).GetValueAtIndex(0).GetValueAsUnsigned()
+        #In case we are caught before threads are initialized. Fallback to threads known by astris/gdb server.
+        if num_threads <=0 :
+            return []
+        
+        self.current_session_id = GetUniqueSessionID(self.process)
+        self.threads = []
+        self.thread_cache = {}
+        self.processors = []
+        try:
+          processor_list_val = PluginValue(self._target.FindGlobalVariables('processor_list',1).GetValueAtIndex(0))
+          while processor_list_val.IsValid() and processor_list_val.GetValueAsUnsigned() !=0 :
+            th = processor_list_val.GetChildMemberWithName('active_thread')
+            th_id = th.GetChildMemberWithName('thread_id').GetValueAsUnsigned()
+            cpu_id = processor_list_val.GetChildMemberWithName('cpu_id').GetValueAsUnsigned()
+            self.processors.append({'active_thread': th.GetValueAsUnsigned(), 'cpu_id': cpu_id})
+            self.create_thread(th_id, th.GetValueAsUnsigned())
+            self.thread_cache[th_id]['core'] = cpu_id
+            nth = self.thread_cache[th_id]
+            print "Found 0x%x on logical cpu %d" % ( nth['ptr'], nth['core'])
+            self.threads.append(nth)
+            self.thread_cache[nth['tid']] = nth
+            processor_list_val = processor_list_val.GetChildMemberWithName('processor_list')          
+        except KeyboardInterrupt, ke:
+          print "OS Plugin Interrupted during thread loading process. \nWARNING:Thread registers and backtraces may not be accurate."
+          return self.threads
+        
+        if hasattr(self.process, 'CreateOSPluginThread'):
+          return self.threads
+
+        # FIXME remove legacy code   
+        try:
+          thread_q_head = self._target.FindGlobalVariables('threads', 0).GetValueAtIndex(0)
+          thread_type = self._target.FindFirstType('thread')
+          thread_ptr_type = thread_type.GetPointerType()
+          for th in IterateQueue(thread_q_head, thread_ptr_type, 'threads'):
+            th_id = th.GetChildMemberWithName('thread_id').GetValueAsUnsigned()
+            self.create_thread(th_id, th.GetValueAsUnsigned())
+            nth = self.thread_cache[th_id]
+            for cputhread in self.processors:
+              if cputhread['active_thread'] == nth['ptr']:
+                nth['core'] = cputhread['cpu_id']
+                #print "Found 0x%x on logical cpu %d" % ( nth['ptr'], cputhread['cpu_id'])
+            self.threads.append( nth )          
+        except KeyboardInterrupt, ke:
+          print "OS Plugin Interrupted during thread loading process. \nWARNING:Thread registers and backtraces may not be accurate."
+          return self.threads
+        # end legacy code            
+        return self.threads
+    
+    def get_register_info(self):
+        if self.registers == None:
+          print "Register Information not found "
+        return self.register_set.register_info
+            
+    def get_register_data(self, tid):
+        #print "searching for tid", tid
+        thobj = None
+        try:
+          if self.current_session_id != GetUniqueSessionID(self.process):
+            self.thread_cache = {}
+            self.current_session_id = GetUniqueSessionID(self.process)
+
+          if tid in self.thread_cache.keys():
+              thobj = self.version.CreateValueFromExpression(self.thread_cache[tid]['name'], '(struct thread *)' + str(self.thread_cache[tid]['ptr']))
+          regs = self.register_set
+          if thobj == None :
+              print "FATAL ERROR: Could not find thread with id %d" % tid
+              regs.ResetRegisterValues()
+              return regs.GetPackedRegisterState()
+
+          if self.kdp_thread and self.kdp_thread.GetValueAsUnsigned() == thobj.GetValueAsUnsigned():
+            regs.ReadRegisterDataFromKDPSavedState(self.kdp_state, self.version)
+            return regs.GetPackedRegisterState()
+          if int(PluginValue(thobj).GetChildMemberWithName('kernel_stack').GetValueAsUnsigned()) != 0 :
+            if self.target_arch == archX86_64 :
+              # we do have a stack so lets get register information
+              saved_state_addr = PluginValue(thobj).GetChildMemberWithName('kernel_stack').GetValueAsUnsigned() + self.kernel_stack_size - self.kernel_context_size
+              regs.ReadRegisterDataFromKernelStack(saved_state_addr, self.version)
+              return regs.GetPackedRegisterState()
+            elif self.target_arch in archARMv7_family and int(PluginValue(thobj).GetChildMemberWithName('machine').GetChildMemberWithName('kstackptr').GetValueAsUnsigned()) != 0:
+              #we have stack on the machine.kstackptr.
+              saved_state_addr = PluginValue(thobj).GetChildMemberWithName('machine').GetChildMemberWithName('kstackptr').GetValueAsUnsigned()
+              regs.ReadRegisterDataFromKernelStack(saved_state_addr, self.version)
+              return regs.GetPackedRegisterState()
+          elif self.target_arch == archX86_64 or self.target_arch in archARMv7_family:
+            regs.ReadRegisterDataFromContinuation( PluginValue(thobj).GetChildMemberWithName('continuation').GetValueAsUnsigned())
+            return regs.GetPackedRegisterState()
+          #incase we failed very miserably
+        except KeyboardInterrupt, ke:
+          print "OS Plugin Interrupted during thread register load. \nWARNING:Thread registers and backtraces may not be accurate. for tid = %d" % tid
+        regs.ResetRegisterValues()
+        print "FATAL ERROR: Failed to get register state for thread id 0x%x " % tid
+        print thobj
+        return regs.GetPackedRegisterState()
+