# LLDB UI state in the Vim user interface. import os, re, sys import lldb import vim from vim_panes import * from vim_signs import * def is_same_file(a, b): """ returns true if paths a and b are the same file """ a = os.path.realpath(a) b = os.path.realpath(b) return a in b or b in a class UI: def __init__(self): """ Declare UI state variables """ # Default panes to display self.defaultPanes = ['breakpoints', 'backtrace', 'locals', 'threads', 'registers', 'disassembly'] # map of tuples (filename, line) --> SBBreakpoint self.markedBreakpoints = {} # Currently shown signs self.breakpointSigns = {} self.pcSigns = [] # Container for panes self.paneCol = PaneLayout() # All possible LLDB panes self.backtracePane = BacktracePane(self.paneCol) self.threadPane = ThreadPane(self.paneCol) self.disassemblyPane = DisassemblyPane(self.paneCol) self.localsPane = LocalsPane(self.paneCol) self.registersPane = RegistersPane(self.paneCol) self.breakPane = BreakpointsPane(self.paneCol) def activate(self): """ Activate UI: display default set of panes """ self.paneCol.prepare(self.defaultPanes) def get_user_buffers(self, filter_name=None): """ Returns a list of buffers that are not a part of the LLDB UI. That is, they are not contained in the PaneLayout object self.paneCol. """ ret = [] for w in vim.windows: b = w.buffer if not self.paneCol.contains(b.name): if filter_name is None or filter_name in b.name: ret.append(b) return ret def update_pc(self, process, buffers, goto_file): """ Place the PC sign on the PC location of each thread's selected frame """ def GetPCSourceLocation(thread): """ Returns a tuple (thread_index, file, line, column) that represents where the PC sign should be placed for a thread. """ frame = thread.GetSelectedFrame() frame_num = frame.GetFrameID() le = frame.GetLineEntry() while not le.IsValid() and frame_num < thread.GetNumFrames(): frame_num += 1 le = thread.GetFrameAtIndex(frame_num).GetLineEntry() if le.IsValid(): path = os.path.join(le.GetFileSpec().GetDirectory(), le.GetFileSpec().GetFilename()) return (thread.GetIndexID(), path, le.GetLine(), le.GetColumn()) return None # Clear all existing PC signs del_list = [] for sign in self.pcSigns: sign.hide() del_list.append(sign) for sign in del_list: self.pcSigns.remove(sign) del sign # Select a user (non-lldb) window if not self.paneCol.selectWindow(False): # No user window found; avoid clobbering by splitting vim.command(":vsp") # Show a PC marker for each thread for thread in process: loc = GetPCSourceLocation(thread) if not loc: # no valid source locations for PCs. hide all existing PC markers continue buf = None (tid, fname, line, col) = loc buffers = self.get_user_buffers(fname) is_selected = thread.GetIndexID() == process.GetSelectedThread().GetIndexID() if len(buffers) == 1: buf = buffers[0] if buf != vim.current.buffer: # Vim has an open buffer to the required file: select it vim.command('execute ":%db"' % buf.number) elif is_selected and vim.current.buffer.name not in fname and os.path.exists(fname) and goto_file: # FIXME: If current buffer is modified, vim will complain when we try to switch away. # Find a way to detect if the current buffer is modified, and...warn instead? vim.command('execute ":e %s"' % fname) buf = vim.current.buffer elif len(buffers) > 1 and goto_file: #FIXME: multiple open buffers match PC location continue else: continue self.pcSigns.append(PCSign(buf, line, is_selected)) if is_selected and goto_file: # if the selected file has a PC marker, move the cursor there too curname = vim.current.buffer.name if curname is not None and is_same_file(curname, fname): move_cursor(line, 0) elif move_cursor: print "FIXME: not sure where to move cursor because %s != %s " % (vim.current.buffer.name, fname) def update_breakpoints(self, target, buffers): """ Decorates buffer with signs corresponding to breakpoints in target. """ def GetBreakpointLocations(bp): """ Returns a list of tuples (resolved, filename, line) where a breakpoint was resolved. """ if not bp.IsValid(): sys.stderr.write("breakpoint is invalid, no locations") return [] ret = [] numLocs = bp.GetNumLocations() for i in range(numLocs): loc = bp.GetLocationAtIndex(i) desc = get_description(loc, lldb.eDescriptionLevelFull) match = re.search('at\ ([^:]+):([\d]+)', desc) try: lineNum = int(match.group(2).strip()) ret.append((loc.IsResolved(), match.group(1), lineNum)) except ValueError as e: sys.stderr.write("unable to parse breakpoint location line number: '%s'" % match.group(2)) sys.stderr.write(str(e)) return ret if target is None or not target.IsValid(): return needed_bps = {} for bp_index in range(target.GetNumBreakpoints()): bp = target.GetBreakpointAtIndex(bp_index) locations = GetBreakpointLocations(bp) for (is_resolved, file, line) in GetBreakpointLocations(bp): for buf in buffers: if file in buf.name: needed_bps[(buf, line, is_resolved)] = bp # Hide any signs that correspond with disabled breakpoints del_list = [] for (b, l, r) in self.breakpointSigns: if (b, l, r) not in needed_bps: self.breakpointSigns[(b, l, r)].hide() del_list.append((b, l, r)) for d in del_list: del self.breakpointSigns[d] # Show any signs for new breakpoints for (b, l, r) in needed_bps: bp = needed_bps[(b, l, r)] if self.haveBreakpoint(b.name, l): self.markedBreakpoints[(b.name, l)].append(bp) else: self.markedBreakpoints[(b.name, l)] = [bp] if (b, l, r) not in self.breakpointSigns: s = BreakpointSign(b, l, r) self.breakpointSigns[(b, l, r)] = s def update(self, target, status, controller, goto_file=False): """ Updates debugger info panels and breakpoint/pc marks and prints status to the vim status line. If goto_file is True, the user's cursor is moved to the source PC location in the selected frame. """ self.paneCol.update(target, controller) self.update_breakpoints(target, self.get_user_buffers()) if target is not None and target.IsValid(): process = target.GetProcess() if process is not None and process.IsValid(): self.update_pc(process, self.get_user_buffers, goto_file) if status is not None and len(status) > 0: print status def haveBreakpoint(self, file, line): """ Returns True if we have a breakpoint at file:line, False otherwise """ return (file, line) in self.markedBreakpoints def getBreakpoints(self, fname, line): """ Returns the LLDB SBBreakpoint object at fname:line """ if self.haveBreakpoint(fname, line): return self.markedBreakpoints[(fname, line)] else: return None def deleteBreakpoints(self, name, line): del self.markedBreakpoints[(name, line)] def showWindow(self, name): """ Shows (un-hides) window pane specified by name """ if not self.paneCol.havePane(name): sys.stderr.write("unknown window: %s" % name) return False self.paneCol.prepare([name]) return True def hideWindow(self, name): """ Hides window pane specified by name """ if not self.paneCol.havePane(name): sys.stderr.write("unknown window: %s" % name) return False self.paneCol.hide([name]) return True global ui ui = UI()