Launching remote and local MinGW-compiled programs

To launch and debug a new process on remote Unix machine or local machine (MinGW or Embedded-Systems), use the "Launch Remote Process" command from the WinGDB menu. The following dialog will appear:

Some of the fields are required:

Login information:
- for local machine (MinGW or Embedded-Systems) just put "local" or "localhost" qualifier. For embedded-systems you may want to fill "Target" field too.
- for remote Unix machine it usually consists of your user account name and the target host name or IP address. Optionally you can provide also a port number and/or a password. The syntax is "username[:password]@hostname[:port]" where square brackets denote optional parts. If you don't provide the password, another dialog will appear, prompting you for it:
Byte-order: select Big-Endian or Little-Endian according to platform which the process will be launched on.
Process executable path: this should be a full path to the program you want to run. You can also open a local/remote filesystem browser by pressing the "..." button.

The remaining fields are optional:

The target qualifier for the debugging session. WinGDB will use "target" GDB command to set it. Needed mainly for embedded-systems. For common applications it should stay blank.
The working directory for the process. You can also use the browser to specify it. WinGDB will use "--cd" GDB switch to set this directory.
Command line arguments for the process. WinGDB will use "-exec-arguments" GDB command to set these arguments.
Extra environment variables for the process. WinGDB will use "set environment" GDB command to set these variables. If you want to set many variables then separate them with semicolon character (';').
The path to custom initialization script - it is simple text file (more about syntax) which will run after debugger has been started. It has to be located on local machine.
Additional source directories for the process. WinGDB will use "dir" GDB command to add these directories. If you want to add many source directories then separate them with semicolon character (';').
The debug info directory for the process. WinGDB will use "set debug-file-directory" GDB command to set this directory.
The shared library prefix for the process. WinGDB will use "set solib-absolute-prefix" (it is equivalent of "set sysroot" ) GDB command to set this directory.
The shared library directories for the process. WinGDB will use "set solib-search-path" GDB command to set these directories.
A separate host with source files. Use this option when you build your program on one host and debug on another one, without a copy of the sources. GDB must be also installed on the source host, in the same location as on the debugee host. Your program must be accessible and debuggable on the source host, also from the same location. The location limitations will be relaxed in subsequent WinGDB versions.

Also you can set "Stop in main()" check box to make the process stop at the first instruction of the "main()" function. Otherwise the process will run until a breakpoint is reached, or the program exits.

Relaunch remote process
To run remote process with the same settings like in previous session use 'Relaunch remote process' option from WinGDB menu.

Table of Contents