73811d32c7
For performance reasons the reproducers don't copy the files captured by the file collector eagerly, but wait until the reproducer needs to be generated. This is a problematic when LLDB crashes and we have to do all this signal-unsafe work in the signal handler. This patch uses a similar trick to clang, which has the driver invoke a new cc1 instance to do all this work out-of-process. This patch moves the writing of the mapping file as well as copying over the reproducers into a separate process spawned when lldb crashes. Differential revision: https://reviews.llvm.org/D89600
247 lines
8.3 KiB
TableGen
247 lines
8.3 KiB
TableGen
include "llvm/Option/OptParser.td"
|
|
|
|
class F<string name>: Flag<["--", "-"], name>;
|
|
class S<string name>: Separate<["--", "-"], name>;
|
|
class R<list<string> prefixes, string name>
|
|
: Option<prefixes, name, KIND_REMAINING_ARGS>;
|
|
|
|
// Please keep this in sync with the man page in docs/man/lldb.rst
|
|
|
|
// Attaching options.
|
|
def grp_attach : OptionGroup<"attaching">, HelpText<"ATTACHING">;
|
|
|
|
def attach_name: Separate<["--", "-"], "attach-name">,
|
|
MetaVarName<"<name>">,
|
|
HelpText<"Tells the debugger to attach to a process with the given name.">,
|
|
Group<grp_attach>;
|
|
def: Separate<["-"], "n">,
|
|
Alias<attach_name>,
|
|
HelpText<"Alias for --attach-name">,
|
|
Group<grp_attach>;
|
|
|
|
def wait_for: F<"wait-for">,
|
|
HelpText<"Tells the debugger to wait for a process with the given pid or name to launch before attaching.">,
|
|
Group<grp_attach>;
|
|
def: Flag<["-"], "w">,
|
|
Alias<wait_for>,
|
|
HelpText<"Alias for --wait-for">,
|
|
Group<grp_attach>;
|
|
|
|
def attach_pid: Separate<["--", "-"], "attach-pid">,
|
|
MetaVarName<"<pid>">,
|
|
HelpText<"Tells the debugger to attach to a process with the given pid.">,
|
|
Group<grp_attach>;
|
|
def: Separate<["-"], "p">,
|
|
Alias<attach_pid>,
|
|
HelpText<"Alias for --attach-pid">,
|
|
Group<grp_attach>;
|
|
|
|
|
|
// Scripting options.
|
|
def grp_scripting : OptionGroup<"scripting">, HelpText<"SCRIPTING">;
|
|
|
|
def python_path: F<"python-path">,
|
|
HelpText<"Prints out the path to the lldb.py file for this version of lldb.">,
|
|
Group<grp_scripting>;
|
|
def: Flag<["-"], "P">,
|
|
Alias<python_path>,
|
|
HelpText<"Alias for --python-path">,
|
|
Group<grp_scripting>;
|
|
|
|
def script_language: Separate<["--", "-"], "script-language">,
|
|
MetaVarName<"<language>">,
|
|
HelpText<"Tells the debugger to use the specified scripting language for user-defined scripts.">,
|
|
Group<grp_scripting>;
|
|
def: Separate<["-"], "l">,
|
|
Alias<script_language>,
|
|
HelpText<"Alias for --script-language">,
|
|
Group<grp_scripting>;
|
|
|
|
// Repl options.
|
|
def grp_repl : OptionGroup<"repl">, HelpText<"REPL">;
|
|
|
|
def repl: Flag<["--", "-"], "repl">,
|
|
HelpText<"Runs lldb in REPL mode with a stub process.">,
|
|
Group<grp_repl>;
|
|
def: Flag<["-"], "r">,
|
|
Alias<repl>,
|
|
HelpText<"Alias for --repl">,
|
|
Group<grp_repl>;
|
|
def repl_: Joined<["--", "-"], "repl=">,
|
|
MetaVarName<"<flags>">,
|
|
HelpText<"Runs lldb in REPL mode with a stub process with the given flags.">,
|
|
Group<grp_repl>;
|
|
def: Joined<["-"], "r=">,
|
|
MetaVarName<"<flags>">,
|
|
Alias<repl_>,
|
|
HelpText<"Alias for --repl=<flags>">,
|
|
Group<grp_repl>;
|
|
|
|
def repl_language: Separate<["--", "-"], "repl-language">,
|
|
MetaVarName<"<language>">,
|
|
HelpText<"Chooses the language for the REPL.">,
|
|
Group<grp_repl>;
|
|
def: Separate<["-"], "R">,
|
|
Alias<repl_language>,
|
|
HelpText<"Alias for --repl-language">,
|
|
Group<grp_repl>;
|
|
|
|
|
|
// Command options.
|
|
def grp_command : OptionGroup<"command">, HelpText<"COMMANDS">;
|
|
|
|
def no_lldbinit: F<"no-lldbinit">,
|
|
HelpText<"Do not automatically parse any '.lldbinit' files.">,
|
|
Group<grp_command>;
|
|
def: Flag<["-"], "x">,
|
|
Alias<no_lldbinit>,
|
|
HelpText<"Alias for --no-lldbinit">,
|
|
Group<grp_command>;
|
|
def local_lldbinit: F<"local-lldbinit">,
|
|
HelpText<"Allow the debugger to parse the .lldbinit files in the current working directory, unless --no-lldbinit is passed.">,
|
|
Group<grp_command>;
|
|
|
|
def batch: F<"batch">,
|
|
HelpText<"Tells the debugger to run the commands from -s, -S, -o & -O, and then quit.">,
|
|
Group<grp_command>;
|
|
def: Flag<["-"], "b">,
|
|
Alias<batch>,
|
|
HelpText<"Alias for --batch">,
|
|
Group<grp_command>;
|
|
|
|
def source_quietly: F<"source-quietly">,
|
|
HelpText<"Tells the debugger to execute this one-line lldb command before any file has been loaded.">,
|
|
Group<grp_command>;
|
|
def: Flag<["-"], "Q">,
|
|
Alias<source_quietly>,
|
|
HelpText<"Alias for --source-quietly">,
|
|
Group<grp_command>;
|
|
|
|
def one_line_on_crash: Separate<["--", "-"], "one-line-on-crash">,
|
|
MetaVarName<"<command>">,
|
|
HelpText<"When in batch mode, tells the debugger to run this one-line lldb command if the target crashes.">,
|
|
Group<grp_command>;
|
|
def: Separate<["-"], "k">,
|
|
Alias<one_line_on_crash>,
|
|
HelpText<"Alias for --one-line-on-crash">,
|
|
Group<grp_command>;
|
|
|
|
def source_on_crash: Separate<["--", "-"], "source-on-crash">,
|
|
MetaVarName<"<file>">,
|
|
HelpText<"When in batch mode, tells the debugger to source this file of lldb commands if the target crashes.">,
|
|
Group<grp_command>;
|
|
def: Separate<["-"], "K">,
|
|
Alias<source_on_crash>,
|
|
HelpText<"Alias for --source-on-crash">,
|
|
Group<grp_command>;
|
|
|
|
def source: Separate<["--", "-"], "source">,
|
|
MetaVarName<"<file>">,
|
|
HelpText<"Tells the debugger to read in and execute the lldb commands in the given file, after any file has been loaded.">,
|
|
Group<grp_command>;
|
|
def: Separate<["-"], "s">,
|
|
Alias<source>,
|
|
HelpText<"Alias for --source">,
|
|
Group<grp_command>;
|
|
|
|
def source_before_file: Separate<["--", "-"], "source-before-file">,
|
|
MetaVarName<"<file>">,
|
|
HelpText<"Tells the debugger to read in and execute the lldb commands in the given file, before any file has been loaded.">,
|
|
Group<grp_command>;
|
|
def: Separate<["-"], "S">,
|
|
Alias<source_before_file>,
|
|
HelpText<"Alias for --source-before-file">,
|
|
Group<grp_command>;
|
|
|
|
def one_line: Separate<["--", "-"], "one-line">,
|
|
MetaVarName<"<command>">,
|
|
HelpText<"Tells the debugger to execute this one-line lldb command after any file provided on the command line has been loaded.">,
|
|
Group<grp_command>;
|
|
def: Separate<["-"], "o">,
|
|
Alias<one_line>,
|
|
HelpText<"Alias for --one-line">,
|
|
Group<grp_command>;
|
|
|
|
def one_line_before_file: Separate<["--", "-"], "one-line-before-file">,
|
|
MetaVarName<"<command>">,
|
|
HelpText<"Tells the debugger to execute this one-line lldb command before any file provided on the command line has been loaded.">,
|
|
Group<grp_command>;
|
|
def: Separate<["-"], "O">,
|
|
Alias<one_line_before_file>,
|
|
HelpText<"Alias for --one-line-before-file">,
|
|
Group<grp_command>;
|
|
|
|
|
|
// General options.
|
|
def version: F<"version">,
|
|
HelpText<"Prints out the current version number of the LLDB debugger.">;
|
|
def: Flag<["-"], "v">,
|
|
Alias<version>,
|
|
HelpText<"Alias for --version">;
|
|
|
|
def help: F<"help">,
|
|
HelpText<"Prints out the usage information for the LLDB debugger.">;
|
|
def: Flag<["-"], "h">,
|
|
Alias<help>,
|
|
HelpText<"Alias for --help">;
|
|
|
|
def core: Separate<["--", "-"], "core">,
|
|
MetaVarName<"<filename>">,
|
|
HelpText<"Tells the debugger to use the full path to <filename> as the core file.">;
|
|
def: Separate<["-"], "c">,
|
|
Alias<core>,
|
|
HelpText<"Alias for --core">;
|
|
|
|
def editor: F<"editor">,
|
|
HelpText<"Tells the debugger to open source files using the host's \"external editor\" mechanism.">;
|
|
def: Flag<["-"], "e">,
|
|
Alias<editor>,
|
|
HelpText<"Alias for --editor">;
|
|
|
|
def no_use_colors: F<"no-use-colors">,
|
|
HelpText<"Do not use colors.">;
|
|
def: Flag<["-"], "X">,
|
|
Alias<no_use_colors>,
|
|
HelpText<"Alias for --no-use-color">;
|
|
|
|
def file: Separate<["--", "-"], "file">,
|
|
MetaVarName<"<filename>">,
|
|
HelpText<"Tells the debugger to use the file <filename> as the program to be debugged.">;
|
|
def: Separate<["-"], "f">,
|
|
Alias<file>,
|
|
HelpText<"Alias for --file">;
|
|
|
|
def arch: Separate<["--", "-"], "arch">,
|
|
MetaVarName<"<architecture>">,
|
|
HelpText<"Tells the debugger to use the specified architecture when starting and running the program.">;
|
|
def: Separate<["-"], "a">,
|
|
Alias<arch>,
|
|
HelpText<"Alias for --arch">;
|
|
|
|
def debug: F<"debug">,
|
|
HelpText<"Tells the debugger to print out extra information for debugging itself.">;
|
|
def: Flag<["-"], "d">,
|
|
Alias<debug>,
|
|
HelpText<"Alias for --debug">;
|
|
|
|
def capture: F<"capture">,
|
|
HelpText<"Tells the debugger to capture a reproducer.">;
|
|
def capture_path: Separate<["--", "-"], "capture-path">,
|
|
MetaVarName<"<filename>">,
|
|
HelpText<"Tells the debugger to use the given filename for the reproducer.">;
|
|
def replay: Separate<["--", "-"], "replay">,
|
|
MetaVarName<"<filename>">,
|
|
HelpText<"Tells the debugger to replay a reproducer from <filename>.">;
|
|
def reproducer_finalize: Separate<["--", "-"], "reproducer-finalize">,
|
|
MetaVarName<"<filename>">;
|
|
def no_version_check: F<"reproducer-no-version-check">,
|
|
HelpText<"Disable the reproducer version check.">;
|
|
def no_verification: F<"reproducer-no-verify">,
|
|
HelpText<"Disable the reproducer verification.">;
|
|
def no_generate_on_signal: F<"reproducer-no-generate-on-signal">,
|
|
HelpText<"Don't generate reproducer when a signal is received.">;
|
|
def generate_on_exit: F<"reproducer-generate-on-exit">,
|
|
HelpText<"Generate reproducer on exit.">;
|
|
|
|
def REM : R<["--"], "">;
|