#!/usr/bin/bash ## ### # IP: GHIDRA # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. ## #@timeout 60000 #@title gdb via ssh #@desc #@desc

Launch with gdb via ssh

#@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 #@help TraceRmiLauncherServicePlugin#gdb_ssh #@enum StartCmd:str run start starti #@arg :str "Image" "The target binary executable image on the remote system" #@args "Arguments" "Command-line arguments to pass to the target" #@env OPT_SSH_PATH:file="ssh" "ssh command" "The path to ssh on the local system. Omit the full path to resolve using the system PATH." #@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" "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="starti" "Run command" "The gdb command to actually run the target." target_image="$1" shift target_args="$@" "$OPT_SSH_PATH" "-R$OPT_REMOTE_PORT:$GHIDRA_TRACE_RMI_ADDR" -t $OPT_EXTRA_SSH_ARGS "$OPT_HOST" "TERM='$TERM' '$OPT_GDB_PATH' \ -q \ -ex 'set pagination off' \ -ex 'set confirm off' \ -ex 'show version' \ -ex 'python import ghidragdb' \ -ex 'file \"$target_image\"' \ -ex 'set args $target_args' \ -ex 'ghidra trace connect \"localhost:$OPT_REMOTE_PORT\"' \ -ex 'ghidra trace start' \ -ex 'ghidra trace sync-enable' \ -ex '$OPT_START_CMD' \ -ex 'set confirm on' \ -ex 'set pagination on'"