The irmtdbgc command starts the debug engine on the remote system. The irmtdbgc command has the syntax, irmtdbgc [debugger parms] debuggee_name [debuggee parms], where [debugger parms] are, in any order:
| Parameter | Description |
|---|---|
| -qhost= <host:port> | <host> specifies the host name of the machine
running the debugger user interface. This can be a host name or an
IP address. If not specified, the value in the environment variable
DER_DBG_ADDR is used. If neither is specified, the value localhost is
used. <port> is optional (by default, port 8001 is assumed). |
| -i | If present, specifies that the debugger is to stop immediately after loading the debuggee, and not run to the main entry point of your application. For C++, this means you can debug the static initialization code in your application. |
-a xxxx |
xxxx may be a process identifier or, if the name of the application is unique, the name of the process as shown by the ps command. |
| -qdisplay= xxxx | xxxx specifies the X Window display to be used for the debuggee. The default is the value of the DISPLAY environment variable. The debuggee will X Window display only if:
If both conditions are not met, the debuggee will use the session that the debug engine was started in. Use of this parameter requires that the -qconsole=GUI parameter be present. |
| -qconsole=<remote, local, or GUI> | This controls where the console for the program
being debugged will appear. If -qconsole=remote is specified, output will be directed to the local session and to the user interface. If -qconsole=local is specified, the console appears in the console window in which the you typed the irmtdbgc command. If -qconsole=GUI is specified, the console appears in a separate window. The default value of this parameter is remote. See also the -qdisplay option for UNIX systems. |
| -s | Specifies that the debuggee is to run immediately. The debuggee will stop when it reaches a breakpoint from the profile, or if a signal occurs. |
| -- | This indicates that the next parameter is the debuggee name. It is only required if the debuggee name begins with the character '-'. |
The debugger will search for the program to debug using the PATH environment variable. On AIX®, the program that you are debugging may also be a core file.