#!/usr/bin/env python import lldb import shlex import sys try: from tkinter import * import tkinter.ttk as ttk except ImportError: from Tkinter import * import ttk class ValueTreeItemDelegate(object): def __init__(self, value): self.value = value def get_item_dictionary(self): name = self.value.name if name is None: name = "" typename = self.value.type if typename is None: typename = "" value = self.value.value if value is None: value = "" summary = self.value.summary if summary is None: summary = "" has_children = self.value.MightHaveChildren() return { "#0": name, "typename": typename, "value": value, "summary": summary, "children": has_children, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() for i in range(self.value.num_children): item_delegate = ValueTreeItemDelegate(self.value.GetChildAtIndex(i)) item_dicts.append(item_delegate.get_item_dictionary()) return item_dicts class FrameTreeItemDelegate(object): def __init__(self, frame): self.frame = frame def get_item_dictionary(self): id = self.frame.GetFrameID() name = "frame #%u" % (id) value = "0x%16.16x" % (self.frame.GetPC()) stream = lldb.SBStream() self.frame.GetDescription(stream) summary = stream.GetData().split("`")[1] return { "#0": name, "value": value, "summary": summary, "children": self.frame.GetVariables(True, True, True, True).GetSize() > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() variables = self.frame.GetVariables(True, True, True, True) n = variables.GetSize() for i in range(n): item_delegate = ValueTreeItemDelegate(variables[i]) item_dicts.append(item_delegate.get_item_dictionary()) return item_dicts class ThreadTreeItemDelegate(object): def __init__(self, thread): self.thread = thread def get_item_dictionary(self): num_frames = self.thread.GetNumFrames() name = "thread #%u" % (self.thread.GetIndexID()) value = "0x%x" % (self.thread.GetThreadID()) summary = "%u frames" % (num_frames) return { "#0": name, "value": value, "summary": summary, "children": num_frames > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() for frame in self.thread: item_delegate = FrameTreeItemDelegate(frame) item_dicts.append(item_delegate.get_item_dictionary()) return item_dicts class ProcessTreeItemDelegate(object): def __init__(self, process): self.process = process def get_item_dictionary(self): id = self.process.GetProcessID() num_threads = self.process.GetNumThreads() value = str(self.process.GetProcessID()) summary = self.process.target.executable.fullpath return { "#0": "process", "value": value, "summary": summary, "children": num_threads > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() for thread in self.process: item_delegate = ThreadTreeItemDelegate(thread) item_dicts.append(item_delegate.get_item_dictionary()) return item_dicts class TargetTreeItemDelegate(object): def __init__(self, target): self.target = target def get_item_dictionary(self): value = str(self.target.triple) summary = self.target.executable.fullpath return { "#0": "target", "value": value, "summary": summary, "children": True, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() image_item_delegate = TargetImagesTreeItemDelegate(self.target) item_dicts.append(image_item_delegate.get_item_dictionary()) return item_dicts class TargetImagesTreeItemDelegate(object): def __init__(self, target): self.target = target def get_item_dictionary(self): value = str(self.target.triple) summary = self.target.executable.fullpath num_modules = self.target.GetNumModules() return { "#0": "images", "value": "", "summary": "%u images" % num_modules, "children": num_modules > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() for i in range(self.target.GetNumModules()): module = self.target.GetModuleAtIndex(i) image_item_delegate = ModuleTreeItemDelegate(self.target, module, i) item_dicts.append(image_item_delegate.get_item_dictionary()) return item_dicts class ModuleTreeItemDelegate(object): def __init__(self, target, module, index): self.target = target self.module = module self.index = index def get_item_dictionary(self): name = "module %u" % (self.index) value = self.module.file.basename summary = self.module.file.dirname return { "#0": name, "value": value, "summary": summary, "children": True, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() sections_item_delegate = ModuleSectionsTreeItemDelegate( self.target, self.module ) item_dicts.append(sections_item_delegate.get_item_dictionary()) symbols_item_delegate = ModuleSymbolsTreeItemDelegate(self.target, self.module) item_dicts.append(symbols_item_delegate.get_item_dictionary()) comp_units_item_delegate = ModuleCompileUnitsTreeItemDelegate( self.target, self.module ) item_dicts.append(comp_units_item_delegate.get_item_dictionary()) return item_dicts class ModuleSectionsTreeItemDelegate(object): def __init__(self, target, module): self.target = target self.module = module def get_item_dictionary(self): name = "sections" value = "" summary = "%u sections" % (self.module.GetNumSections()) return { "#0": name, "value": value, "summary": summary, "children": True, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() num_sections = self.module.GetNumSections() for i in range(num_sections): section = self.module.GetSectionAtIndex(i) image_item_delegate = SectionTreeItemDelegate(self.target, section) item_dicts.append(image_item_delegate.get_item_dictionary()) return item_dicts class SectionTreeItemDelegate(object): def __init__(self, target, section): self.target = target self.section = section def get_item_dictionary(self): name = self.section.name section_load_addr = self.section.GetLoadAddress(self.target) if section_load_addr != lldb.LLDB_INVALID_ADDRESS: value = "0x%16.16x" % (section_load_addr) else: value = "0x%16.16x *" % (self.section.file_addr) summary = "" return { "#0": name, "value": value, "summary": summary, "children": self.section.GetNumSubSections() > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() num_sections = self.section.GetNumSubSections() for i in range(num_sections): section = self.section.GetSubSectionAtIndex(i) image_item_delegate = SectionTreeItemDelegate(self.target, section) item_dicts.append(image_item_delegate.get_item_dictionary()) return item_dicts class ModuleCompileUnitsTreeItemDelegate(object): def __init__(self, target, module): self.target = target self.module = module def get_item_dictionary(self): name = "compile units" value = "" summary = "%u compile units" % (self.module.GetNumSections()) return { "#0": name, "value": value, "summary": summary, "children": self.module.GetNumCompileUnits() > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() num_cus = self.module.GetNumCompileUnits() for i in range(num_cus): cu = self.module.GetCompileUnitAtIndex(i) image_item_delegate = CompileUnitTreeItemDelegate(self.target, cu) item_dicts.append(image_item_delegate.get_item_dictionary()) return item_dicts class CompileUnitTreeItemDelegate(object): def __init__(self, target, cu): self.target = target self.cu = cu def get_item_dictionary(self): name = self.cu.GetFileSpec().basename value = "" num_lines = self.cu.GetNumLineEntries() summary = "" return { "#0": name, "value": value, "summary": summary, "children": num_lines > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() item_delegate = LineTableTreeItemDelegate(self.target, self.cu) item_dicts.append(item_delegate.get_item_dictionary()) return item_dicts class LineTableTreeItemDelegate(object): def __init__(self, target, cu): self.target = target self.cu = cu def get_item_dictionary(self): name = "line table" value = "" num_lines = self.cu.GetNumLineEntries() summary = "%u line entries" % (num_lines) return { "#0": name, "value": value, "summary": summary, "children": num_lines > 0, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() num_lines = self.cu.GetNumLineEntries() for i in range(num_lines): line_entry = self.cu.GetLineEntryAtIndex(i) item_delegate = LineEntryTreeItemDelegate(self.target, line_entry, i) item_dicts.append(item_delegate.get_item_dictionary()) return item_dicts class LineEntryTreeItemDelegate(object): def __init__(self, target, line_entry, index): self.target = target self.line_entry = line_entry self.index = index def get_item_dictionary(self): name = str(self.index) address = self.line_entry.GetStartAddress() load_addr = address.GetLoadAddress(self.target) if load_addr != lldb.LLDB_INVALID_ADDRESS: value = "0x%16.16x" % (load_addr) else: value = "0x%16.16x *" % (address.file_addr) summary = ( self.line_entry.GetFileSpec().fullpath + ":" + str(self.line_entry.line) ) return { "#0": name, "value": value, "summary": summary, "children": False, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() return item_dicts class InstructionTreeItemDelegate(object): def __init__(self, target, instr): self.target = target self.instr = instr def get_item_dictionary(self): address = self.instr.GetAddress() load_addr = address.GetLoadAddress(self.target) if load_addr != lldb.LLDB_INVALID_ADDRESS: name = "0x%16.16x" % (load_addr) else: name = "0x%16.16x *" % (address.file_addr) value = ( self.instr.GetMnemonic(self.target) + " " + self.instr.GetOperands(self.target) ) summary = self.instr.GetComment(self.target) return { "#0": name, "value": value, "summary": summary, "children": False, "tree-item-delegate": self, } class ModuleSymbolsTreeItemDelegate(object): def __init__(self, target, module): self.target = target self.module = module def get_item_dictionary(self): name = "symbols" value = "" summary = "%u symbols" % (self.module.GetNumSymbols()) return { "#0": name, "value": value, "summary": summary, "children": True, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() num_symbols = self.module.GetNumSymbols() for i in range(num_symbols): symbol = self.module.GetSymbolAtIndex(i) image_item_delegate = SymbolTreeItemDelegate(self.target, symbol, i) item_dicts.append(image_item_delegate.get_item_dictionary()) return item_dicts class SymbolTreeItemDelegate(object): def __init__(self, target, symbol, index): self.target = target self.symbol = symbol self.index = index def get_item_dictionary(self): address = self.symbol.GetStartAddress() name = "[%u]" % self.index symbol_load_addr = address.GetLoadAddress(self.target) if symbol_load_addr != lldb.LLDB_INVALID_ADDRESS: value = "0x%16.16x" % (symbol_load_addr) else: value = "0x%16.16x *" % (address.file_addr) summary = self.symbol.name return { "#0": name, "value": value, "summary": summary, "children": False, "tree-item-delegate": self, } def get_child_item_dictionaries(self): item_dicts = list() return item_dicts class DelegateTree(ttk.Frame): def __init__(self, column_dicts, delegate, title, name): ttk.Frame.__init__(self, name=name) self.pack(expand=Y, fill=BOTH) self.master.title(title) self.delegate = delegate self.columns_dicts = column_dicts self.item_id_to_item_dict = dict() frame = Frame(self) frame.pack(side=TOP, fill=BOTH, expand=Y) self._create_treeview(frame) self._populate_root() def _create_treeview(self, parent): frame = ttk.Frame(parent) frame.pack(side=TOP, fill=BOTH, expand=Y) column_ids = list() for i in range(1, len(self.columns_dicts)): column_ids.append(self.columns_dicts[i]["id"]) # create the tree and scrollbars self.tree = ttk.Treeview(columns=column_ids) scroll_bar_v = ttk.Scrollbar(orient=VERTICAL, command=self.tree.yview) scroll_bar_h = ttk.Scrollbar(orient=HORIZONTAL, command=self.tree.xview) self.tree["yscroll"] = scroll_bar_v.set self.tree["xscroll"] = scroll_bar_h.set # setup column headings and columns properties for columns_dict in self.columns_dicts: self.tree.heading( columns_dict["id"], text=columns_dict["text"], anchor=columns_dict["anchor"], ) self.tree.column(columns_dict["id"], stretch=columns_dict["stretch"]) # add tree and scrollbars to frame self.tree.grid(in_=frame, row=0, column=0, sticky=NSEW) scroll_bar_v.grid(in_=frame, row=0, column=1, sticky=NS) scroll_bar_h.grid(in_=frame, row=1, column=0, sticky=EW) # set frame resizing priorities frame.rowconfigure(0, weight=1) frame.columnconfigure(0, weight=1) # action to perform when a node is expanded self.tree.bind("<>", self._update_tree) def insert_items(self, parent_id, item_dicts): for item_dict in item_dicts: name = None values = list() first = True for columns_dict in self.columns_dicts: if first: name = item_dict[columns_dict["id"]] first = False else: values.append(item_dict[columns_dict["id"]]) item_id = self.tree.insert( parent_id, END, text=name, values=values # root item has an empty name ) self.item_id_to_item_dict[item_id] = item_dict if item_dict["children"]: self.tree.insert(item_id, END, text="dummy") def _populate_root(self): # use current directory as root node self.insert_items("", self.delegate.get_child_item_dictionaries()) def _update_tree(self, event): # user expanded a node - build the related directory item_id = self.tree.focus() # the id of the expanded node children = self.tree.get_children(item_id) if len(children): first_child = children[0] # if the node only has a 'dummy' child, remove it and # build new directory; skip if the node is already # populated if self.tree.item(first_child, option="text") == "dummy": self.tree.delete(first_child) item_dict = self.item_id_to_item_dict[item_id] item_dicts = item_dict[ "tree-item-delegate" ].get_child_item_dictionaries() self.insert_items(item_id, item_dicts) @lldb.command("tk-variables") def tk_variable_display(debugger, command, result, dict): # needed for tree creation in TK library as it uses sys.argv... sys.argv = ["tk-variables"] target = debugger.GetSelectedTarget() if not target: print("invalid target", file=result) return process = target.GetProcess() if not process: print("invalid process", file=result) return thread = process.GetSelectedThread() if not thread: print("invalid thread", file=result) return frame = thread.GetSelectedFrame() if not frame: print("invalid frame", file=result) return # Parse command line args command_args = shlex.split(command) column_dicts = [ {"id": "#0", "text": "Name", "anchor": W, "stretch": 0}, {"id": "typename", "text": "Type", "anchor": W, "stretch": 0}, {"id": "value", "text": "Value", "anchor": W, "stretch": 0}, {"id": "summary", "text": "Summary", "anchor": W, "stretch": 1}, ] tree = DelegateTree( column_dicts, FrameTreeItemDelegate(frame), "Variables", "lldb-tk-variables" ) tree.mainloop() @lldb.command("tk-process") def tk_process_display(debugger, command, result, dict): # needed for tree creation in TK library as it uses sys.argv... sys.argv = ["tk-process"] target = debugger.GetSelectedTarget() if not target: print("invalid target", file=result) return process = target.GetProcess() if not process: print("invalid process", file=result) return # Parse command line args columnd_dicts = [ {"id": "#0", "text": "Name", "anchor": W, "stretch": 0}, {"id": "value", "text": "Value", "anchor": W, "stretch": 0}, {"id": "summary", "text": "Summary", "anchor": W, "stretch": 1}, ] command_args = shlex.split(command) tree = DelegateTree( columnd_dicts, ProcessTreeItemDelegate(process), "Process", "lldb-tk-process" ) tree.mainloop() @lldb.command("tk-target") def tk_target_display(debugger, command, result, dict): # needed for tree creation in TK library as it uses sys.argv... sys.argv = ["tk-target"] target = debugger.GetSelectedTarget() if not target: print("invalid target", file=result) return # Parse command line args columnd_dicts = [ {"id": "#0", "text": "Name", "anchor": W, "stretch": 0}, {"id": "value", "text": "Value", "anchor": W, "stretch": 0}, {"id": "summary", "text": "Summary", "anchor": W, "stretch": 1}, ] command_args = shlex.split(command) tree = DelegateTree( columnd_dicts, TargetTreeItemDelegate(target), "Target", "lldb-tk-target" ) tree.mainloop()