From 90f37252466af8b5a64ba2d9032bf090c34c605f Mon Sep 17 00:00:00 2001
From: Dan <46821332+nsadeveloper789@users.noreply.github.com>
Date: Thu, 23 May 2024 09:01:30 -0400
Subject: [PATCH] GP-4617: Moving most documentation from connectors to Help.
---
.../data/debugger-launchers/local-dbgeng.bat | 13 +-
.../data/debugger-launchers/local-ttd.bat | 13 +-
.../data/debugger-launchers/local-gdb.sh | 9 +-
.../data/debugger-launchers/qemu-gdb.sh | 14 +-
.../data/debugger-launchers/raw-gdb.sh | 12 +-
.../data/debugger-launchers/remote-gdb.sh | 17 +-
.../data/debugger-launchers/ssh-gdb.sh | 19 +-
.../data/debugger-launchers/ssh-gdbserver.sh | 18 +-
.../data/debugger-launchers/wine-gdb.sh | 19 +-
.../data/debugger-launchers/local-lldb.sh | 9 +-
.../data/debugger-launchers/remote-lldb.sh | 15 +-
.../data/debugger-launchers/raw-python3.sh | 9 +-
.../TraceRmiLauncherServicePlugin.html | 359 ++++++++++++++----
.../images/GdbLauncher.png | Bin 17742 -> 14541 bytes
.../launcher/AbstractTraceRmiLaunchOffer.java | 3 +-
.../launcher/LaunchFailureDialog.java | 8 +-
16 files changed, 360 insertions(+), 177 deletions(-)
diff --git a/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-dbgeng.bat b/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-dbgeng.bat
index 4ce4b27a3a..171590c961 100644
--- a/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-dbgeng.bat
+++ b/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-dbgeng.bat
@@ -1,21 +1,20 @@
::@title dbgeng
::@desc
::@desc Launch with dbgeng (in a Python interpreter)
-::@desc This will launch the target on the local machine using dbgeng.dll. Typically,
-::@desc Windows systems have this library pre-installed, but it may have limitations, e.g., you
-::@desc cannot use .server. For the full capabilities, you must install WinDbg.
-::@desc Furthermore, you must have Python 3 installed on your system, and it must have the
-::@desc pybag and protobuf packages installed.
+::@desc
+::@desc This will launch the target on the local machine using dbgeng.dll.
+::@desc For setup instructions, press F1.
+::@desc
::@desc
::@menu-group local
::@icon icon.debugger
::@help TraceRmiLauncherServicePlugin#dbgeng
-::@env OPT_PYTHON_EXE:str="python" "Path to python" "The path to the Python 3 interpreter. Omit the full path to resolve using the system PATH."
+::@env OPT_PYTHON_EXE:str="python" "Python command" "The path to the Python 3 interpreter. Omit the full path to resolve using the system PATH."
:: Use env instead of args, because "all args except first" is terrible to implement in batch
::@env OPT_TARGET_IMG:str="" "Image" "The target binary executable image"
::@env OPT_TARGET_ARGS:str="" "Arguments" "Command-line arguments to pass to the target"
::@env OPT_USE_DBGMODEL:bool=true "Use dbgmodel" "Load and use dbgmodel.dll if it is available."
-::@env WINDBG_DIR:str="" "Path to dbgeng" "Path to dbgeng and associated DLLS (if not Windows Kits)."
+::@env WINDBG_DIR:str="" "Path to dbgeng.dll directory" "Path containing dbgeng and associated DLLS (if not Windows Kits)."
@echo off
diff --git a/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-ttd.bat b/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-ttd.bat
index 37cfc06fbb..693f7c67c8 100644
--- a/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-ttd.bat
+++ b/Ghidra/Debug/Debugger-agent-dbgeng/data/debugger-launchers/local-ttd.bat
@@ -1,21 +1,20 @@
::@title ttd
::@desc
::@desc Launch with ttd (in a Python interpreter)
-::@desc This will launch the target on the local machine using dbgeng.dll. Typically,
-::@desc Windows systems have this library pre-installed, but it may have limitations, e.g., you
-::@desc cannot use .server. For the full capabilities, you must install WinDbg.
-::@desc Furthermore, you must have Python 3 installed on your system, and it must have the
-::@desc pybag and protobuf packages installed.
+::@desc
+::@desc This will launch the target on the local machine for time-travel debugging.
+::@desc For setup instructions, press F1.
+::@desc
::@desc
::@menu-group local
::@icon icon.debugger
::@help TraceRmiLauncherServicePlugin#dbgeng_ttd
-::@env OPT_PYTHON_EXE:str="python" "Path to python" "The path to the Python 3 interpreter. Omit the full path to resolve using the system PATH."
+::@env OPT_PYTHON_EXE:str="python" "Python command" "The path to the Python 3 interpreter. Omit the full path to resolve using the system PATH."
:: Use env instead of args, because "all args except first" is terrible to implement in batch
::@env OPT_TARGET_IMG:str="" "Trace (.run)" "A trace associated with the target binary executable"
::@env OPT_TARGET_ARGS:str="" "Arguments" "Command-line arguments to pass to the target"
::@env OPT_USE_DBGMODEL:bool=true "Use dbgmodel" "Load and use dbgmodel.dll if it is available."
-::@env OPT_DBGMODEL_PATH:str="" "Path to dbgeng & \\ttd" "Path to dbgeng and associated DLLS (if not Windows Kits)."
+::@env OPT_DBGMODEL_PATH:str="" "Path to dbgeng.dll & \\ttd" "Path containing dbgeng and associated DLLS (if not Windows Kits)."
@echo off
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/local-gdb.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/local-gdb.sh
index 74a4099743..9f9f91374a 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/local-gdb.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/local-gdb.sh
@@ -17,9 +17,10 @@
#@title gdb
#@desc
#@desc Launch with gdb
-#@desc This will launch the target on the local machine using gdb. GDB must already
-#@desc be installed on your system, and it must embed the Python 3 interpreter. You will also
-#@desc need protobuf and psutil installed for Python 3.
+#@desc
+#@desc This will launch the target on the local machine using gdb.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group local
#@icon icon.debugger
@@ -27,7 +28,7 @@
#@enum StartCmd:str run start starti
#@arg :str "Image" "The target binary executable image"
#@args "Arguments" "Command-line arguments to pass to the target"
-#@env OPT_GDB_PATH:str="gdb" "Path to gdb" "The path to gdb. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb" "gdb command" "The path to gdb. Omit the full path to resolve using the system PATH."
#@env OPT_START_CMD:StartCmd="starti" "Run command" "The gdb command to actually run the target."
#@env OPT_EXTRA_TTY:bool=false "Inferior TTY" "Provide a separate terminal emulator for the target."
#@tty TTY_TARGET if env:OPT_EXTRA_TTY
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/qemu-gdb.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/qemu-gdb.sh
index ed48419357..924a151d0e 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/qemu-gdb.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/qemu-gdb.sh
@@ -17,21 +17,21 @@
#@title qemu + gdb
#@desc
#@desc Launch with qemu and connect with gdb
-#@desc This will launch the target on the local machine using qemu. Then in a second
-#@desc terminal, it will connect gdb to QEMU's GDBstub.
-#@desc GDB must already be installed on your system, it must support your target architecture
-#@desc (you may install gdb-multiarch), and it must embed the Python 3 interpreter. You
-#@desc will also need protobuf installed for Python 3.
+#@desc
+#@desc This will launch the target on the local machine using qemu.
+#@desc Then in a second terminal, it will connect gdb to QEMU's GDBstub.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group cross
#@icon icon.debugger
#@help TraceRmiLauncherServicePlugin#gdb_qemu
#@arg :str "Image" "The target binary executable image"
#@args "Arguments" "Command-line arguments to pass to the target"
-#@env GHIDRA_LANG_EXTTOOL_qemu:str="" "Path to qemu" "The path to qemu for the target architecture."
+#@env GHIDRA_LANG_EXTTOOL_qemu:str="" "QEMU command" "The path to qemu for the target architecture."
#@env QEMU_GDB:int=12345 "QEMU Port" "Port for gdb connection to qemu"
#@env OPT_EXTRA_QEMU_ARGS:str="" "Extra qemu arguments" "Extra arguments to pass to qemu. Use with care."
-#@env OPT_GDB_PATH:str="gdb-multiarch" "Path to gdb" "The path to gdb. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb-multiarch" "gdb command" "The path to gdb. Omit the full path to resolve using the system PATH."
#@env OPT_EXTRA_TTY:bool=false "QEMU TTY" "Provide a separate terminal emulator for the target."
#@tty TTY_TARGET if env:OPT_EXTRA_TTY
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/raw-gdb.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/raw-gdb.sh
index 37779af3e3..5b572354e5 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/raw-gdb.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/raw-gdb.sh
@@ -18,16 +18,16 @@
#@no-image
#@desc
#@desc Start gdb
-#@desc This will start gdb and connect to it. It will not launch
-#@desc a target, so you can (must) set up your target manually.
-#@desc GDB must already
-#@desc be installed on your system, and it must embed the Python 3 interpreter. You will also
-#@desc need protobuf and psutil installed for Python 3.
+#@desc
+#@desc This will start gdb and connect to it.
+#@desc It will not launch a target, so you can (must) set up your target manually.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group raw
#@icon icon.debugger
#@help TraceRmiLauncherServicePlugin#gdb_raw
-#@env OPT_GDB_PATH:str="gdb" "Path to gdb" "The path to gdb. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb" "gdb command" "The path to gdb. Omit the full path to resolve using the system PATH."
#@env OPT_ARCH:str="i386:x86-64" "Architecture" "Target architecture"
if [ -d ${GHIDRA_HOME}/ghidra/.git ]
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/remote-gdb.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/remote-gdb.sh
index 76af6bdcfd..29d80336ab 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/remote-gdb.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/remote-gdb.sh
@@ -18,25 +18,20 @@
#@no-image
#@desc
#@desc Launch with local gdb and connect to a stub (e.g., gdbserver)
-#@desc This will start gdb on the local system and then use it to connect to the remote system.
-#@desc The actual command used is, e.g:
-#@desc target remote host:port
-#@desc It may be worth testing this manually to ensure everything is configured correctly.
-#@desc GDB must be installed on your local system, it must be compatible with the remote system,
-#@desc and it must embed the Python 3 interpreter. You will also need protobuf installed
-#@desc for Python 3 on the local system. There are no Python requirements for the remote system.
-#@desc Please ensure that Ghidra's current program and the target's image match. Otherwise, the
-#@desc modules may not map.
+#@desc
+#@desc This will start gdb on the local system and then use it to connect to the remote system.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group remote
#@icon icon.debugger
-#@help TraceRmiLauncherServicePlugin#gdb
+#@help TraceRmiLauncherServicePlugin#gdb_remote
#@enum TargetType:str remote extended-remote
#@env OPT_TARGET_TYPE:TargetType="remote" "Target" "The type of remote target"
#@env OPT_HOST:str="localhost" "Host" "The hostname of the target"
#@env OPT_PORT:str="9999" "Port" "The host's listening port"
#@env OPT_ARCH:str="" "Architecture (optional)" "Target architecture override"
-#@env OPT_GDB_PATH:str="gdb" "Path to gdb" "The path to gdb on the local system. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb" "gdb command" "The path to gdb on the local system. Omit the full path to resolve using the system PATH."
if [ -d ${GHIDRA_HOME}/ghidra/.git ]
then
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdb.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdb.sh
index 6ccb89e34b..9c455de227 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdb.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdb.sh
@@ -18,19 +18,10 @@
#@title gdb via ssh
#@desc
#@desc Launch with gdb via ssh
-#@desc This will launch the target on a remote machine using gdb via ssh.
-#@desc GDB and an SSH server must already be installed and operational on the remote system, and
-#@desc GDB must embed the Python 3 interpreter. The remote SSH server must be configured to allow
-#@desc remote port forwarding. You will also need to install the following for GDB's embedded
-#@desc version of Python:
-#@desc
-#@desc - ghidragdb - Ghidra plugin for GDB, available from the Debugger-agent-gdb
-#@desc directory in Ghidra
-#@desc - ghidratrace - Ghidra Trace RMI client for Python, available from the
-#@desc Debugger-rmi-trace directory in Ghidra
-#@desc - protobuf - available from PyPI
-#@desc - psutil - available from PyPI
-#@desc
+#@desc
+#@desc This will launch the target on a remote machine using gdb via ssh.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group remote
#@icon icon.debugger
@@ -41,7 +32,7 @@
#@env OPT_HOST:str="localhost" "[User@]Host" "The hostname or user@host"
#@env OPT_REMOTE_PORT:int=12345 "Remote Trace RMI Port" "A free port on the remote end to receive and forward the Trace RMI connection."
#@env OPT_EXTRA_SSH_ARGS:str="" "Extra ssh arguments" "Extra arguments to pass to ssh. Use with care."
-#@env OPT_GDB_PATH:str="gdb" "Path to gdb" "The path to gdb on the remote system. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb" "gdb command" "The path to gdb on the remote system. Omit the full path to resolve using the system PATH."
#@env OPT_START_CMD:StartCmd="start" "Run command" "The gdb command to actually run the target."
target_image="$1"
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdbserver.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdbserver.sh
index 4185dac8c0..cf47498d80 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdbserver.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/ssh-gdbserver.sh
@@ -18,16 +18,10 @@
#@title gdb + gdbserver via ssh
#@desc
#@desc Launch with local gdb and gdbserver via ssh
-#@desc This will start gdb on the local system and then use it to connect and launch
-#@desc the target in gdbserver on the remote system via ssh. The actual command
-#@desc used is, e.g:
-#@desc target remote | ssh user@host gdbserver - /path/to/image
-#@desc It may be worth testing this manually to ensure everything is configured correctly. An
-#@desc SSH server and gdbserver must already be installed and operational on the remote
-#@desc system. GDB must be installed on your local system, it must be compatible with the
-#@desc gdbserver on the remote system, and it must embed the Python 3 interpreter. You
-#@desc will also need protobuf installed for Python 3 on the local system. There are no
-#@desc Python requirements for the remote system.
+#@desc
+#@desc This will start gdb on the local system and then use it to connect and launch the target in gdbserver on the remote system via ssh.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group remote
#@icon icon.debugger
@@ -36,9 +30,9 @@
#@args "Arguments" "Command-line arguments to pass to the target"
#@env OPT_HOST:str="localhost" "[User@]Host" "The hostname or user@host"
#@env OPT_EXTRA_SSH_ARGS:str="" "Extra ssh arguments" "Extra arguments to pass to ssh. Use with care."
-#@env OPT_GDBSERVER_PATH:str="gdbserver" "Path to gdbserver (remote)" "The path to gdbserver on the remote system. Omit the full path to resolve using the system PATH."
+#@env OPT_GDBSERVER_PATH:str="gdbserver" "gdbserver command (remote)" "The path to gdbserver on the remote system. Omit the full path to resolve using the system PATH."
#@env OPT_EXTRA_GDBSERVER_ARGS:str="" "Extra gdbserver arguments" "Extra arguments to pass to gdbserver. Use with care."
-#@env OPT_GDB_PATH:str="gdb" "Path to gdb" "The path to gdb on the local system. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb" "gdb command" "The path to gdb on the local system. Omit the full path to resolve using the system PATH."
if [ -d ${GHIDRA_HOME}/ghidra/.git ]
then
diff --git a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/wine-gdb.sh b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/wine-gdb.sh
index f1eaf81905..5a37621166 100755
--- a/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/wine-gdb.sh
+++ b/Ghidra/Debug/Debugger-agent-gdb/data/debugger-launchers/wine-gdb.sh
@@ -17,19 +17,10 @@
#@title wine + gdb
#@desc
#@desc Launch with gdb and wine
-#@desc This will launch the target on the local machine using gdb and wine.
-#@desc GDB and Wine must already be installed on your system, and GDB must embed the Python 3
-#@desc interpreter. You will also need protobuf and psutil installed for Python
-#@desc 3.
-#@desc This operates by starting GDB on the Wine executable and passing arguments to launch a
-#@desc Windows target. This may prevent GDB from processing the object file, because it is a PE
-#@desc file, and most copies of GDB for UNIX will support only ELF. Nevertheless, Ghidra should
-#@desc recognize the target and map it, giving you symbols and debug info in the front end, even
-#@desc if not in the GDB CLI.
-#@desc You will need to locate the wine executable, not the script, on your system. To
-#@desc find it, either dissect the wine script or consult online documentation for your
-#@desc distribution of Wine. There are often two executables, one for 32-bit targets and one for
-#@desc 64-bit targets. You must select the correct one.
+#@desc
+#@desc This will launch the target on the local machine using gdb and wine.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group cross
#@icon icon.debugger
@@ -37,7 +28,7 @@
#@arg :str "Image" "The target binary executable image"
#@args "Arguments" "Command-line arguments to pass to the target"
#@env OPT_WINE_PATH:str="/usr/lib/wine/wine64" "Path to wine binary" "The path to the wine executable for your target architecture."
-#@env OPT_GDB_PATH:str="gdb" "Path to gdb" "The path to gdb. Omit the full path to resolve using the system PATH."
+#@env OPT_GDB_PATH:str="gdb" "gdb command" "The path to gdb. Omit the full path to resolve using the system PATH."
#@env OPT_EXTRA_TTY:bool=false "Inferior TTY" "Provide a separate terminal emulator for the target."
#@tty TTY_TARGET if env:OPT_EXTRA_TTY
diff --git a/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/local-lldb.sh b/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/local-lldb.sh
index 3b6f364c57..d94d836d10 100755
--- a/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/local-lldb.sh
+++ b/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/local-lldb.sh
@@ -17,9 +17,10 @@
#@title lldb
#@desc
#@desc Launch with lldb
-#@desc This will launch the target on the local machine using lldb. LLDB must already
-#@desc be installed on your system, and it must embed the Python 3 interpreter. You will also
-#@desc need protobuf and psutil installed for Python 3.
+#@desc
+#@desc This will launch the target on the local machine using lldb.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group local
#@icon icon.debugger
@@ -27,7 +28,7 @@
#@enum StartCmd:str "process launch" "process launch --stop-at-entry"
#@arg :str "Image" "The target binary executable image"
#@args "Arguments" "Command-line arguments to pass to the target"
-#@env OPT_LLDB_PATH:str="lldb" "Path to lldb" "The path to lldb. Omit the full path to resolve using the system PATH."
+#@env OPT_LLDB_PATH:str="lldb" "lldb command" "The path to lldb. Omit the full path to resolve using the system PATH."
#@env OPT_START_CMD:StartCmd="process launch" "Run command" "The lldb command to actually run the target."
#@env OPT_EXTRA_TTY:bool=false "Target TTY" "Provide a separate terminal emulator for the target."
#@tty TTY_TARGET if env:OPT_EXTRA_TTY
diff --git a/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/remote-lldb.sh b/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/remote-lldb.sh
index 84d0b3f94a..c7ac062620 100755
--- a/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/remote-lldb.sh
+++ b/Ghidra/Debug/Debugger-agent-lldb/data/debugger-launchers/remote-lldb.sh
@@ -18,15 +18,10 @@
#@no-image
#@desc
#@desc Launch with local lldb and connect to a stub (e.g., gdbserver)
-#@desc This will start lldb on the local system and then use it to connect to the remote system.
-#@desc The actual command used is, e.g:
-#@desc gdb-remote host:port
-#@desc It may be worth testing this manually to ensure everything is configured correctly.
-#@desc LLDB must be installed on your local system, it must be compatible with the remote system,
-#@desc and it must embed the Python 3 interpreter. You will also need protobuf installed
-#@desc for Python 3 on the local system. There are no Python requirements for the remote system.
-#@desc Please ensure that Ghidra's current program and the target's image match. Otherwise, the
-#@desc modules may not map.
+#@desc
+#@desc This will start lldb on the local system and then use it to connect to the remote system.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group remote
#@icon icon.debugger
@@ -34,7 +29,7 @@
#@env OPT_HOST:str="localhost" "Host" "The hostname of the target"
#@env OPT_PORT:str="9999" "Port" "The host's listening port"
#@env OPT_ARCH:str="" "Architecture" "Target architecture override"
-#@env OPT_LLDB_PATH:str="lldb" "Path to lldb" "The path to lldb on the local system. Omit the full path to resolve using the system PATH."
+#@env OPT_LLDB_PATH:str="lldb" "lldb command" "The path to lldb on the local system. Omit the full path to resolve using the system PATH."
if [ -d ${GHIDRA_HOME}/ghidra/.git ]
then
diff --git a/Ghidra/Debug/Debugger-rmi-trace/data/debugger-launchers/raw-python3.sh b/Ghidra/Debug/Debugger-rmi-trace/data/debugger-launchers/raw-python3.sh
index 823881931d..bdc3eb8ac1 100755
--- a/Ghidra/Debug/Debugger-rmi-trace/data/debugger-launchers/raw-python3.sh
+++ b/Ghidra/Debug/Debugger-rmi-trace/data/debugger-launchers/raw-python3.sh
@@ -19,14 +19,15 @@
#@no-image
#@desc
#@desc Start gdb
-#@desc This will start python, import ghidratrace and connect to it.
-#@desc This connector is made for those wanting to explore the TraceRMI API and possibly develop
-#@desc a new connector. You will need protobuf installed for Python 3.
+#@desc
+#@desc This will start python, import ghidratrace and connect to it for development purposes.
+#@desc For setup instructions, press F1.
+#@desc
#@desc
#@menu-group raw
#@icon icon.debugger
#@help TraceRmiLauncherServicePlugin#python_raw
-#@env OPT_PYTHON_EXE:str="python" "Path to python" "The path to the Python 3 interpreter. Omit the full path to resolve using the system PATH."
+#@env OPT_PYTHON_EXE:str="python" "python command" "The path to the Python 3 interpreter. Omit the full path to resolve using the system PATH."
#@env OPT_LANG:str="DATA:LE:64:default" "Ghidra Language" "The Ghidra LanguageID for the trace"
#@env OPT_COMP:str="pointer64" "Ghidra Compiler" "The Ghidra CompilerSpecID for the trace"
diff --git a/Ghidra/Debug/Debugger-rmi-trace/src/main/help/help/topics/TraceRmiLauncherServicePlugin/TraceRmiLauncherServicePlugin.html b/Ghidra/Debug/Debugger-rmi-trace/src/main/help/help/topics/TraceRmiLauncherServicePlugin/TraceRmiLauncherServicePlugin.html
index cc90ae864a..ca64099f65 100644
--- a/Ghidra/Debug/Debugger-rmi-trace/src/main/help/help/topics/TraceRmiLauncherServicePlugin/TraceRmiLauncherServicePlugin.html
+++ b/Ghidra/Debug/Debugger-rmi-trace/src/main/help/help/topics/TraceRmiLauncherServicePlugin/TraceRmiLauncherServicePlugin.html
@@ -105,21 +105,57 @@
properly-configured build of GDB for your target. If you are working with an embedded system,
it is probably safest to install the "multiarch" build of GDB from your package manager.
- Once running, you are presented with GDB's command-line interface in Ghidra's Terminal. This
- is the bona fide GDB command-line interface, so it has all the functionality you would
- expect. If you command GDB from this shell, the plugin will keep Ghidra in sync. The terminal
- can also be used to interact with the target application when it is running. The plugin
- provides an additional set of commands for managing the connection to Ghidra, as well as
- controlling trace synchronization. These are all in the "ghidra" command prefix. You
- can use tab completion to enumerate the available commands and GDB's "help" command to
- examine their documentation.
+ Setup
+
+ You must have GDB installed on the local system, and it must embed the Python 3 interpreter.
+ If you have access to PyPI, setting up your Python 3 environment is done using Pip. Please note
+ the version specifier for Protobuf.
+
+
+
+ If you are offline, or would like to use our provided packages, we still use Pip, but with a
+ more complicated invocation:
+
+
+
+ Beware that GDB may embed a different Python interpreter than your system's default. If you
+ are still getting import errors, check the version that GDB embeds:
+
+
+
+ Note the version and ensure that you are invoking Pip with that version. Supposing
+ sys.version indicates 3.10, you should invoke Pip using python3.10 -m
+ pip.
+
+ Options
- Options
-
- Image: This is the path to the target binary image (ELF). Ghidra will try to fill
this in based on information gathered when the current program was imported. If the file
@@ -132,7 +168,7 @@
- Arguments: These are the command-line arguments to pass into the target process.
These are passed as is to GDB's "set args ..." command.
- - Path to gdb: This is the command or path to GDB. We recommend version 13
+
- gdb command: This is the command or path to GDB. We recommend version 13
or later. We require version 8 or later.
- Run command: This is the GDB command to actually launch the target. In most cases
@@ -145,6 +181,15 @@
window.
+ Once running, you are presented with GDB's command-line interface in Ghidra's Terminal. This
+ is the bona fide GDB command-line interface, so it has all the functionality you would
+ expect. If you command GDB from this shell, the plugin will keep Ghidra in sync. The terminal
+ can also be used to interact with the target application when it is running. The plugin
+ provides an additional set of commands for managing the connection to Ghidra, as well as
+ controlling trace synchronization. These are all in the "ghidra" command prefix. You
+ can use tab completion to enumerate the available commands and GDB's "help" command to
+ examine their documentation.
+
GDB via SSH
This works the same as the GDB launcher, but runs gdb on a remote system via
@@ -152,10 +197,30 @@
launcher uses the ssh command on the local system. Thus, it should have broader
compatibility with remote systems, and it should use the same configuration files as you are
accustomed to. That said, we developed it using OpenSSH, so your experience will be best if
- your copy understands the same command-line arguments. It will need to be capable of port
- forwarding. The remote server must permit remote port forwarding (-R option) and terminal
- allocation (-t option). You will also need to manually install the required Python
- packages on the target host, comprising our plugin for GDB and its dependencies.
+ your copy understands the same command-line arguments.
+
+ Setup
+
+ You must install GDB and an SSH server onto the target host. Your local SSH client must
+ support remote port forwarding (-R option) and terminal allocation (-t option), and
+ the remote server must be configured to permit them.
+
+ You will need to manually install the required Python packages on the target host,
+ comprising our plugin for GDB and its dependencies. Copy all of the Python packages from
+ Ghidra/Debug/Debugger-rmi-trace/pypkg/dist/ and
+ Ghidra/Debug/Debugger-agent-gdb/pypkg/dist/ to the remote system. It is easiest to put
+ them all in one directory, e.g., ~/ghidra-pypgk/. Then install them:
+
+
+
+ Please see GDB Setup for notes about embedded Python interpreter
+ versions.
Options
@@ -184,7 +249,7 @@
that syntax errors may cause strange behavior, and that not all features may be compatible
with this launcher.
- Path to gdb: This works the same as in GDB, but with respect to the
+ gdb command: This works the same as in GDB, but with respect to the
remote file system.
Run command: This works the same as in GDB.
@@ -195,8 +260,9 @@
GDB + gdbserver via SSH
This works similarly to the GDB via SSH launcher, but instead of tunneling the Trace RMI
- connection, tunnels the RSP (gdbserver) connection. There is actually a fairly elegant method
- of doing this straight from within gdb, which is exactly what this launcher does:
+ connection, tunnels the RSP (gdbserver) connection. There is actually a fairly elegant
+ method of doing this straight from within gdb, which is exactly what this launcher
+ does:
-
@@ -227,6 +293,15 @@ target remote | ssh user@host gdbserver - /path/to/image
address space, if the map is of interest to your analysis, it may not be available.
+ Setup
+
+ You must have GDB installed on the local system and a compatible version of
+ gdbserver installed on the target system. You must have an SSH server installed on the
+ target system. It may be worth testing your setup manually (outside of Ghidra) to ensure
+ everything is configured correctly. On the local system, follow the steps given in GDB Setup. There are no additional Python requirements on the target
+ system.
+
Options
@@ -241,7 +316,7 @@ target remote | ssh user@host gdbserver - /path/to/image
- Extra ssh arguments: This works the same as in GDB via SSH.
- - Path to gdbserver: This is the command or path to gdbserver with
+
- gdbserver command: This is the command or path to gdbserver with
respect to the remote file system.
- Extra gdbserver arguments: These are extra arguments to pass to
@@ -249,7 +324,7 @@ target remote | ssh user@host gdbserver - /path/to/image
dash. Beware that syntax errors may cause strange behavior, and that not all features may be
compatible with this launcher.
- - Path to gdb: This works the same as in GDB, with respect to the
+
- gdb command: This works the same as in GDB, with respect to the
local file system.
- Note there is no option to create a second Terminal (TTY) for the target.
@@ -258,11 +333,14 @@ target remote | ssh user@host gdbserver - /path/to/image
QEMU + GDB
This launcher orchestrates a QEMU user-mode target and connects to it using our Python
- plugin for GDB. You will almost certainly need the "multiarch" build of GDB, and by default,
- the launcher will try to use gdb-multiarch. You must also install the appropriate
- build of QEMU for your target architecture. Ghidra will inspect the current program and attempt
- to map its language to the appropriate QEMU command, but this may fail, or be subtly
- incorrect.
+ plugin for GDB. Ghidra will inspect the current program and attempt to map its language to the
+ appropriate QEMU command, but this may fail, or be subtly incorrect.
+
+ Setup
+
+ You must acquire a version of QEMU and GDB that support the target architecture. On many
+ distributions of Linux, you can install gdb-multiarch. Follow the steps given in GDB Setup.
Options
@@ -274,7 +352,7 @@ target remote | ssh user@host gdbserver - /path/to/image
- Arguments: These are the command-line arguments to pass into the target process.
These are passed as is on QEMU's command line.
- - Path to qemu: The command or path to QEMU.
+ - QEMU command: The command or path to QEMU.
- QEMU Port: An available TCP port for QEMU to listen on for GDB.
@@ -283,7 +361,7 @@ target remote | ssh user@host gdbserver - /path/to/image
arguments. Beware that syntax errors may cause strange behavior, and that not all features
may be compatible with this launcher.
- - Path to gdb: This works the same as in GDB, but defaults to
+
- gdb command: This works the same as in GDB, but defaults to
"gdb-multiarch."
- QEMU TTY: This works similarly as in GDB, but just runs QEMU in the second
@@ -294,10 +372,18 @@ target remote | ssh user@host gdbserver - /path/to/image
This launchers runs wine in a gdb session on Linux and directs it to a
target Windows executable. There are other ways to rig a Windows target in GDB on Linux, but
- this is the method we have chosen: You will need to install Wine on your system and locate the
- actual wine executable. These are often in some library directory and named
- "wine32" or "wine64." To find them, either examine the file list of the
- installed package, or dissect the wrapper wine script, usually on your path:
+ this is the method we have chosen. This may prevent GDB from processing the object file,
+ because it is a PE file, and most copies of GDB for UNIX will support only ELF. Nevertheless,
+ Ghidra should recognize the target and map it, giving you symbols and debug info in the front
+ end, even if not in the GDB CLI.
+
+ Setup
+
+ In addition to the steps given in GDB Setup, you must install Wine
+ on your system. Prepare for configuration by locating the actual wine executable.
+ These are often in some library directory and named "wine32" or "wine64." To
+ find them, either examine the file list of the installed package, or dissect the wrapper
+ wine script, usually on your path:
-
@@ -337,7 +423,7 @@ less $(which wine)
- Path to wine binary: The path to wine for your target architecture. See note above!
- - Path to gdb: This works the same as in GDB.
+ - gdb command: This works the same as in GDB.
- Inferior TTY: This works the same as in GDB.
@@ -359,6 +445,15 @@ target remote [host]:[port]
compatible before using this launcher. This launcher does not require an image, nor does it
create your target. Thus, it can be used without a current program.
+ Setup
+
+ On your local system, follow the steps given in GDB Setup. Your
+ version of GDB must be compatible with the stub (e.g., gdbserver) on the target
+ system. There are no additional requirements on the target system.
+
+ NOTE: The target program image must match that imported in Ghidra, or else things may
+ not map or synchronize correctly.
+
Options
@@ -375,7 +470,7 @@ target remote [host]:[port]
session outside of Ghidra to see the list of available options in your configuration. You may
want to use gdb-multiarch.
- - Path to gdb: This works the same as in GDB, though you may want to use
+
- gdb command: This works the same as in GDB, though you may want to use
gdb-multiarch.
@@ -388,17 +483,19 @@ target remote [host]:[port]
to ensure your target maps to the current program, if you happen to have one. You may have to
do it manually.
+ Setup
+
+ Follow the steps given in GDB Setup.
+
Options
- - Path to gdb: This works the same as in GDB.
+ - gdb command: This works the same as in GDB.
- Architecture: Because the trace is created before the target, you must specify the
- target's architecture.
-
- - This is passed as is to "set arch ..." immediately
- before the "target ..." command. Enter "set arch" into a GDB session
- outside of Ghidra to see the list of available options in your configuration.
+ target's architecture. This is passed as is to "set arch ..." immediately before the
+ "target ..." command. Enter "set arch" into a GDB session outside of Ghidra
+ to see the list of available options in your configuration.
Stock LLDB Launchers
@@ -409,17 +506,53 @@ target remote [host]:[port]
This launcher is a Python plugin for LLDB, and so is well suited for debugging user-space
targets on a variety of platforms. It is the de facto debugger for macOS. It can be
- obtained by installing XCode from the App Store. Though it may require a bit more careful
+ obtained by installing Xcode from the App Store. Though it may require a bit more careful
configuration, it can also be obtained from other repositories like brew.
- Once running, you are presented with LLDB's command-line interface in Ghidra's Terminal.
- This is the bona fide LLDB command-line interface, so it has all the functionality you
- would expect. If you command LLDB from this shell, the plugin will keep Ghidra in sync. The
- terminal can be used to interact with the target application when it is running. The plugin
- provides an additional set of commands for managing the connection to Ghidra, as well as
- controlling trace synchronization. These are all in the "ghidra" category. You can use
- tab completion to enumerate the available commands and LLDB's "help" command to
- examine their documentation.
+ Setup
+
+ You must have LLDB installed on the local system, and it must embed the Python 3
+ interpreter. If you have access to PyPI, setting up your Python 3 environment is done using
+ Pip. Please note the version specifier for Protobuf.
+
+
+
+ If you are offline, or would like to use our provided packages, we still use Pip, but with a
+ more complicated invocation:
+
+
+
+ Beware that LLDB may embed a different Python interpreter than your system's default. If you
+ are still getting import errors, check the version that LLDB embeds:
+
+
+
+ Note the version and ensure that you are invoking Pip with that version. Supposing
+ sys.version indicates 3.10, you should invoke Pip using python3.10 -m
+ pip.
Options
@@ -435,7 +568,7 @@ target remote [host]:[port]
- Arguments: These are the command-line arguments to pass into the target. These are
passed as is to LLDB's "settings set target.run-args ..." command.
- - Path to lldb: This is the command or path to LLDB. We recommend version
+
- lldb command: This is the command or path to LLDB. We recommend version
15 or later.
- Run command: This is the LLDB command to actually launch the target. In most cases
@@ -448,6 +581,15 @@ target remote [host]:[port]
direct the target's I/O to a second Terminal window.
+ Once running, you are presented with LLDB's command-line interface in Ghidra's Terminal.
+ This is the bona fide LLDB command-line interface, so it has all the functionality you
+ would expect. If you command LLDB from this shell, the plugin will keep Ghidra in sync. The
+ terminal can be used to interact with the target application when it is running. The plugin
+ provides an additional set of commands for managing the connection to Ghidra, as well as
+ controlling trace synchronization. These are all in the "ghidra" category. You can use
+ tab completion to enumerate the available commands and LLDB's "help" command to
+ examine their documentation.
+
Remote LLDB
This launcher can target any TCP-based GDB stub that is compatible with a local copy of
@@ -465,6 +607,15 @@ gdb-remote [host]:[port]
compatible before using this launcher. This launcher does not require an image, nor does it
create your target. Thus, it can be used without a current program.
+ Setup
+
+ On your local system, follow the steps given in LLDB Setup. Your
+ version of LLDB must be compatible with the stub (e.g., gdbserver) on the target
+ system. There are no additional requirements on the target system.
+
+ NOTE: The target program image must match that imported in Ghidra, or else things may
+ not map or synchronize correctly.
+
Options
@@ -476,7 +627,7 @@ gdb-remote [host]:[port]
you must set it before connecting. This is passed as is to "setting set
target.default-arch ..." immediately before the "gdb-remote ..." command.
- - Path to llddb: This works the same as in LLDB.
+ - lldb command: This works the same as in LLDB.
Stock Windows Debugger (WinDbg) Launchers
@@ -491,26 +642,53 @@ gdb-remote [host]:[port]
suited for debugging Windows user-space targets. Windows kernel targets are not yet supported.
This DLL also backs WinDbg and several other debuggers on Windows. By default, the launcher
will search for this DLL in an installation of the Windows Debugging Kits version 10. If it
- does not find it there, it will fall back to the one provided with Windows, which is
- substantially less capable. Installing WinDbg is highly recommended. Please note on some system
- configurations, one of the debugger's dependencies dbghelp.dll may get loaded from the
- system directory instead of from the WinDbg installation, usually because a security product
- has pre-loaded it into the Python process. You might work around this by copying the affected
- DLLs from your WinDbg installation into your Python installation.
+ does not find it there, it will probably crash with a message in the Terminal.
- Once running, you are presented with a command-line interface in Ghidra's Terminal. This CLI
- accepts your usual WinDbg (kd) commands. You can escape from this CLI and enter a Python 3 REPL
- by entering ".exit". This is not an actual kd command, but our implementation
- understands this to mean exit the kd REPL. From the Python 3 REPL, you can access the
- underlying Python-based API pybag. This is an uncommon need, but may be useful for
- diagnostics and/or workarounds. To re-enter the kd REPL, enter "repl()".
- Alternatively, if you are trying to quit, but typed ".exit", just type
- "quit()" to terminate the session.
+ Please note on some system configurations, one of the debugger's dependencies
+ dbghelp.dll may get loaded from the system directory instead of from the WinDbg
+ installation, usually because a security product has pre-loaded it into the Python process. You
+ might work around this by copying the affected DLLs from your WinDbg installation into your
+ Python installation.
+
+ Setup
+
+ Installing WinDbg is highly recommended. If you wish to forego installing WinDbg, you can
+ use the DLL provided with Windows, which is substantially less capable, by manually pointing
+ this connector to C:\Windows\system32. If you do this, some commands, e.g.
+ .server, will not be available.
+
+ If you have access to PyPI, setting up your Python 3 environment is done using Pip. Please
+ note the version specifier for Protobuf.
+
+
+
+ If you are offline, or would like to use our provided packages, we still use Pip, but with a
+ more complicated invocation:
+
+
+
+ If you get an import error regarding distutils, it is due to a transitive
+ dependency on a buggy version of capstone. Work around it by installing
+ setuptools.
Options
- - Path to python: This is the command or path to the Python interpreter. It
+
- python command: This is the command or path to the Python interpreter. It
must be version 3. Python 2 is not supported.
- Image: This is the path to the target binary image (EXE file). Ghidra will try to
@@ -530,15 +708,24 @@ gdb-remote [host]:[port]
available from dbgeng.dll. Disabling this option will prevent the launcher from
using dbgmodel.dll, even when it is available.
- - Path to dbgeng: By default, the launcher allows the underlying
- pybag package to locate the Windows Debugger DLLs. This is typically found by
- examining the registry for a Windows Kits 10 installation. Otherwise, it may check its
- typical installation directory before falling back to those in the Windows system directory.
- This option allows you to override this search. For example, if you have installed WinDbg
- Preview or later from the Microsoft Store and wish to use its DLLs, you will need to fill in
- this option.
+ - Path to dbgeng.dll directory: By default, the launcher allows the
+ underlying pybag package to locate the Windows Debugger DLLs. This is typically
+ found by examining the registry for a Windows Kits 10 installation. Otherwise, it may check
+ its typical installation directory. This will not search the Windows system
+ directory, but you can configure it manually here. This option allows you to override this
+ search. For example, if you have installed WinDbg Preview or later from the Microsoft Store
+ and wish to use its DLLs, you will need to fill in this option.
+ Once running, you are presented with a command-line interface in Ghidra's Terminal. This CLI
+ accepts your usual WinDbg (kd) commands. You can escape from this CLI and enter a Python 3 REPL
+ by entering ".exit". This is not an actual kd command, but our implementation
+ understands this to mean exit the kd REPL. From the Python 3 REPL, you can access the
+ underlying Python-based API pybag. This is an uncommon need, but may be useful for
+ diagnostics and/or workarounds. To re-enter the kd REPL, enter "repl()".
+ Alternatively, if you are trying to quit, but typed ".exit", just type
+ "quit()" to terminate the session.
+
TTD (Time-Travel Debugging)
This is a nascent extension to our launcher for the Windows Debugger. The launcher itself
@@ -584,10 +771,36 @@ gdb-remote [host]:[port]
namespace. Thus, a developer can explore the API, invoke methods, and observer how Ghidra
reacts.
+ Setup
+
+ If you have access to PyPI, setting up your Python 3 environment is done using Pip. Please
+ note the version specifier for Protobuf.
+
+
+
+ If you are offline, or would like to use our provided packages, we still use Pip, but with a
+ more complicated invocation:
+
+
+
Options
- - Path to python: This is the command or path to python version 3.
+
- python command: This is the command or path to python version 3.
Python 2 is not supported.
- Ghidra Language: The LanguageID for the blank trace.
diff --git a/Ghidra/Debug/Debugger-rmi-trace/src/main/help/help/topics/TraceRmiLauncherServicePlugin/images/GdbLauncher.png b/Ghidra/Debug/Debugger-rmi-trace/src/main/help/help/topics/TraceRmiLauncherServicePlugin/images/GdbLauncher.png
index 85b71b483be45615f5ef83f582133454aa5d6365..408cd4a2dd21fd5e0c61eec50c80d551dd5f1006 100644
GIT binary patch
literal 14541
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
X4zQZ_whF-D6GTc({$=rt*YE!yCpsVD
literal 17742
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
diff --git a/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/AbstractTraceRmiLaunchOffer.java b/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/AbstractTraceRmiLaunchOffer.java
index b05a06f34f..2478d173e0 100644
--- a/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/AbstractTraceRmiLaunchOffer.java
+++ b/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/AbstractTraceRmiLaunchOffer.java
@@ -321,6 +321,7 @@ public abstract class AbstractTraceRmiLaunchOffer implements TraceRmiLaunchOffer
DebuggerMethodInvocationDialog dialog =
new DebuggerMethodInvocationDialog(tool, getTitle(), "Launch", getIcon());
dialog.setDescription(getDescription());
+ dialog.setHelpLocation(getHelpLocation());
// NB. Do not invoke read/writeConfigState
Map args;
boolean reset = false;
@@ -681,6 +682,6 @@ public abstract class AbstractTraceRmiLaunchOffer implements TraceRmiLaunchOffer
}
protected ErrPromptResponse promptError(LaunchResult result) {
- return LaunchFailureDialog.show(result);
+ return LaunchFailureDialog.show(result, getHelpLocation());
}
}
diff --git a/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/LaunchFailureDialog.java b/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/LaunchFailureDialog.java
index 6bce1afeef..84476059f3 100644
--- a/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/LaunchFailureDialog.java
+++ b/Ghidra/Debug/Debugger-rmi-trace/src/main/java/ghidra/app/plugin/core/debug/gui/tracermi/launcher/LaunchFailureDialog.java
@@ -21,6 +21,7 @@ import docking.widgets.OptionDialog;
import ghidra.debug.api.tracermi.TerminalSession;
import ghidra.debug.api.tracermi.TraceRmiLaunchOffer.LaunchResult;
import ghidra.util.HTMLUtilities;
+import ghidra.util.HelpLocation;
public class LaunchFailureDialog extends OptionDialog {
private static final String MSGPAT_PART_TOP = """
@@ -116,8 +117,8 @@ public class LaunchFailureDialog extends OptionDialog {
return sb.toString();
}
- public static ErrPromptResponse show(LaunchResult result) {
- return switch (new LaunchFailureDialog(result).show()) {
+ public static ErrPromptResponse show(LaunchResult result, HelpLocation helpLocation) {
+ return switch (new LaunchFailureDialog(result, helpLocation).show()) {
case OptionDialog.YES_OPTION -> ErrPromptResponse.KEEP;
case OptionDialog.NO_OPTION -> ErrPromptResponse.RETRY;
case OptionDialog.CANCEL_OPTION -> ErrPromptResponse.TERMINATE;
@@ -125,8 +126,9 @@ public class LaunchFailureDialog extends OptionDialog {
};
}
- protected LaunchFailureDialog(LaunchResult result) {
+ protected LaunchFailureDialog(LaunchResult result, HelpLocation helpLocation) {
super("Launch Failed", formatMessage(result), hasResources(result) ? "&Keep" : null,
"&Retry", OptionDialog.ERROR_MESSAGE, null, true, "Retry");
+ setHelpLocation(helpLocation);
}
}
