Author: Dave Lee Date: 2022-01-13T11:09:40-08:00 New Revision: cb5ea132d2eee8f83207633794256939dd8d8082
URL: https://github.com/llvm/llvm-project/commit/cb5ea132d2eee8f83207633794256939dd8d8082 DIFF: https://github.com/llvm/llvm-project/commit/cb5ea132d2eee8f83207633794256939dd8d8082.diff LOG: [lldb] Add long help to `crashlog` Convert the `crashlog` command to be implemented as a class. The `Symbolicate` function is switched to a class, to implement `get_long_help`. The text for the long help comes from the help output generated by `OptionParser`. That is, the output of `help crashlog` is the same as `crashlog --help`. Differential Revision: https://reviews.llvm.org/D117165 Added: Modified: lldb/examples/python/crashlog.py Removed: ################################################################################ diff --git a/lldb/examples/python/crashlog.py b/lldb/examples/python/crashlog.py index 242ded01817f..bdb9ae12b33c 100755 --- a/lldb/examples/python/crashlog.py +++ b/lldb/examples/python/crashlog.py @@ -1003,11 +1003,22 @@ def save_crashlog(debugger, command, exe_ctx, result, dict): result.PutCString("error: invalid target") -def Symbolicate(debugger, command, result, dict): - try: - SymbolicateCrashLogs(debugger, shlex.split(command)) - except Exception as e: - result.PutCString("error: python exception: %s" % e) +class Symbolicate: + def __init__(self, debugger, internal_dict): + pass + + def __call__(self, debugger, command, exe_ctx, result): + try: + SymbolicateCrashLogs(debugger, shlex.split(command)) + except Exception as e: + result.PutCString("error: python exception: %s" % e) + + def get_short_help(self): + return "Symbolicate one or more darwin crash log files." + + def get_long_help(self): + option_parser = CrashLogOptionParser() + return option_parser.format_help() def SymbolicateCrashLog(crash_log, options): @@ -1186,7 +1197,7 @@ def CreateSymbolicateCrashLogOptions( return option_parser -def SymbolicateCrashLogs(debugger, command_args): +def CrashLogOptionParser(): description = '''Symbolicate one or more darwin crash log files to provide source file and line information, inlined stack frames back to the concrete functions, and disassemble the location of the crash for the first frame of the crashed thread. @@ -1195,8 +1206,10 @@ def SymbolicateCrashLogs(debugger, command_args): created that has all of the shared libraries loaded at the load addresses found in the crash log file. This allows you to explore the program as if it were stopped at the locations described in the crash log and functions can be disassembled and lookups can be performed using the addresses found in the crash log.''' - option_parser = CreateSymbolicateCrashLogOptions( - 'crashlog', description, True) + return CreateSymbolicateCrashLogOptions('crashlog', description, True) + +def SymbolicateCrashLogs(debugger, command_args): + option_parser = CrashLogOptionParser() try: (options, args) = option_parser.parse_args(command_args) except: @@ -1219,13 +1232,15 @@ def SymbolicateCrashLogs(debugger, command_args): for crash_log_file in args: crash_log = CrashLogParser().parse(debugger, crash_log_file, options.verbose) SymbolicateCrashLog(crash_log, options) + if __name__ == '__main__': # Create a new debugger instance debugger = lldb.SBDebugger.Create() SymbolicateCrashLogs(debugger, sys.argv[1:]) lldb.SBDebugger.Destroy(debugger) -elif getattr(lldb, 'debugger', None): - lldb.debugger.HandleCommand( - 'command script add -f lldb.macosx.crashlog.Symbolicate crashlog') - lldb.debugger.HandleCommand( + +def __lldb_init_module(debugger, internal_dict): + debugger.HandleCommand( + 'command script add -c lldb.macosx.crashlog.Symbolicate crashlog') + debugger.HandleCommand( 'command script add -f lldb.macosx.crashlog.save_crashlog save_crashlog') _______________________________________________ lldb-commits mailing list lldb-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-commits
