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