pdebug

Process-level debugger

Syntax:

pdebug [-1eflsv] [-n priority_levels] device

Runs on:

Neutrino

Options:

-1
(“One”) Exit pdebug after the debugging session is done.
-e
Echo the debugged program's stdin back to the host.
-f
Run pdebug as a foreground process.
-l
(“el”) By default, pdebug sets the LD_BIND_NOW to 1 to force all binding to be done immediately instead of lazily. To permit lazy binding, specify the -l option. For more information, see Optimizing the runtime linker in the Compiling and Debugging chapter of the QNX Neutrino Programmer's Guide.
-n priority_levels
Be nice; set the debugged program's priority to be priority_levels lower than pdebug's. Doing this can keep pdebug from becoming unresponsive if the debugged process misbehaves (e.g. looping in a tight loop taking lots of CPU time).
-s
Notify the host only of signals caused by faults.
-v
Be verbose;
device
The device to use for the remote debug protocol; one of:
-
Use stdout / stdin.
/device_name[,baud]
Open and use the specified device, such as /dev/ser1, optionally setting the baud rate.
number
Accept connections on TCP/IP port number.

Description:

This utility provides access to process-level debugging from a remote host. To use pdebug, you need to run devc-pty on the target machine (i.e. the machine being debugged).

Examples:

For a 57600 baud serial connection on /dev/ser2:

pdebug /dev/ser2,57600 &

For a TCP/IP connection on port 8000:

pdebug 8000 &

See also:

devc-pty

Debugging in the Compiling & Debugging chapter of the Programmer's Guide