xref: /llvm-project/lldb/examples/python/disasm.py (revision 2cf62497b3d3b162dfeb59729006aa72deda6f85)
1#!/usr/bin/python
2
3#----------------------------------------------------------------------
4# Be sure to add the python path that points to the LLDB shared library.
5# On MacOSX csh, tcsh:
6#   setenv PYTHONPATH /Developer/Library/PrivateFrameworks/LLDB.framework/Resources/Python
7# On MacOSX sh, bash:
8#   export PYTHONPATH=/Developer/Library/PrivateFrameworks/LLDB.framework/Resources/Python
9#----------------------------------------------------------------------
10
11import lldb
12import os
13import sys
14import time
15
16def disassemble_instructions (insts):
17    for i in insts:
18        print i
19
20# Create a new debugger instance
21debugger = lldb.SBDebugger.Create()
22
23# When we step or continue, don't return from the function until the process
24# stops. We do this by setting the async mode to false.
25debugger.SetAsync (False)
26
27# Create a target from a file and arch
28print "Creating a target for '%s'" % sys.argv[1]
29
30target = debugger.CreateTargetWithFileAndArch (sys.argv[1], lldb.LLDB_ARCH_DEFAULT)
31
32if target:
33    # If the target is valid set a breakpoint at main
34    main_bp = target.BreakpointCreateByName ("main", target.GetExecutable().GetFilename());
35
36    print main_bp
37
38    # Launch the process. Since we specified synchronous mode, we won't return
39    # from this function until we hit the breakpoint at main
40    process = target.LaunchSimple (None, None, os.getcwd())
41
42    # Make sure the launch went ok
43    if process:
44        # Print some simple process info
45        state = process.GetState ()
46        print process
47        if state == lldb.eStateStopped:
48            # Get the first thread
49            thread = process.GetThreadAtIndex (0)
50            if thread:
51                # Print some simple thread info
52                print thread
53                # Get the first frame
54                frame = thread.GetFrameAtIndex (0)
55                if frame:
56                    # Print some simple frame info
57                    print frame
58                    function = frame.GetFunction()
59                    # See if we have debug info (a function)
60                    if function:
61                        # We do have a function, print some info for the function
62                        print function
63                        # Now get all instructions for this function and print them
64                        insts = function.GetInstructions(target)
65                        disassemble_instructions (insts)
66                    else:
67                        # See if we have a symbol in the symbol table for where we stopped
68                        symbol = frame.GetSymbol();
69                        if symbol:
70                            # We do have a symbol, print some info for the symbol
71                            print symbol
72                            # Now get all instructions for this symbol and print them
73                            insts = symbol.GetInstructions(target)
74                            disassemble_instructions (insts)
75
76                    registerList = frame.GetRegisters()
77                    print "Frame registers (size of register set = %d):" % registerList.GetSize()
78                    for value in registerList:
79                        #print value
80                        print "%s (number of children = %d):" % (value.GetName(), value.GetNumChildren())
81                        for child in value:
82                            print "Name: ", child.GetName(), " Value: ", child.GetValue(frame)
83
84            print "Hit the breakpoint at main, continue and wait for program to exit..."
85            # Now continue to the program exit
86            process.Continue()
87            # When we return from the above function we will hopefully be at the
88            # program exit. Print out some process info
89            print process
90        elif state == lldb.eStateExited:
91            print "Didn't hit the breakpoint at main, program has exited..."
92        else:
93            print "Unexpected process state: %s, killing process..." % debugger.StateAsCString (state)
94            process.Kill()
95
96
97
98lldb.SBDebugger.Terminate()
99