| pathdb - The PathScale Debugger |
| pathdb |
| [-help][-nx][-q][-cd=dir][-e prog][-c core][-x cmds][-d dir] |
| The pathdb debugger enables you to "see into" a program as it executes, or investigate what happened at the moment a program crashed. |
| The pathdb program can be used with C, C++, and Fortran programs. The shell command pathdb invokes the program. Type help to view the command-line Help system. Type quit to exit the program. |
| The pathdb program can be run with no arguments or options. Generally you would start the pathdb program with an argument specifying the executable program you want to debug. |
| pathdb program |
| The PathScale debugger supports a number of options. All of the pathdb options and command line arguments are processed in sequential order. The order of commands and options is important when the '-x' option is used. |
| -fullname |
| Print filename and line number information about current line. Primarily used internally for interfacing pathdb with emacs. |
| -nt |
| No terminal, do not execute with command-line editing. Option available for compatibility with GDB. |
| -nw |
| Option available for compatibility with GDB. Pathdb ignores this option. |
| -nx |
| Do not execute .pathdbrc file. Option available for compatibility with GDB. |
| -q, -quiet |
| Run in "quiet" mode; do not print out any introductory or copyright messages. |
| -subverbose |
| Produces diagnostic output about the subscription management for the debugger. |
| -v, -version |
| Print the pathdb version and exit. |
| -x file |
| Execute pathdb commands from the file file. |
| advance |
| Continue execution until the specified location is reached. |
| alias |
| With no args, show all aliases. With one arg, show the named alias. With two args, set the named alias to the named value |
| attach |
| Attach to a running process |
| backtrace |
| Show the stack backtrace for the specified number of levels. The default is for all levels. |
| break [file:]function |
| Set a breakpoint at a function, line number, or static address. A file can be specified. |
| call |
| Call a function in the program being debugged. Record the value and print it if the type is not void. |
| catch |
| Create a catchpoint breakpoint for the given event. |
| cd |
| Change the current working directory to that specified. No arg means to change to the home directory. |
| clear |
| Clear breakpoints at the specified location (line or address). |
| commands |
| Specify a set of commands to be executed when the breakpoint is activated. |
| condition |
| Set or clear the condition on the specified breakpoint. |
| continue |
| Continue execution of the program being debugged (after stopping at a breakpoint). |
| define |
| Define a new command as a sequence of existing commands. |
| delete |
| Delete breakpoints, watchpoints, or displays. |
| detach |
| Detach from a running process that is currently being controlled by the debugger. |
| dir |
| Set the search directory for source file searches. |
| disable |
| Disable the numbered breakpoints. |
| disassemble |
| Disassemble the current function, or the addresses specified. |
| display |
| Print the value of the expression every time the debugger stops the program being debugged. |
| down |
| Move the current stack frame down the stack (to the called functions) by the specified number of levels. |
| echo |
| Print some text to the screen. |
| edit [file] |
| View the current program line. |
| enable |
| Enable or set the disposition on a set of breakpoints. |
| env |
| Show the values of all the environment variables. |
| exec |
| Specify the file to be used for the executable image. |
| file |
| Change the file being debugged. |
| finish |
| Continue execution until the current function returns. |
| frame |
| Select the specified frame number or show the current frame. |
| handle |
| Specify what to do with signals when they are raised by the program being debugged. |
| hbreak |
| Set a hardware-assisted breakpoint at the specified location. |
| help [name] |
| Display information about the pathdb command name or display general help information for pathdb. |
| history |
| Show all the commands typed by the user. |
| if |
| Execute a sequence of commands if the expression evaluates to non-zero. |
| ignore |
| Set the ignore-count for the specified breakpoint. |
| info |
| Provide information on the named entity. |
| kill |
| Kill the program being debugged. |
| list [file] |
| List the source lines at the specified locations. |
| memdump |
| Dump the address specified in hex and ASCII. |
| next |
| Step the program being debugged by a number of lines, stepping over called functions |
| nexti |
| Step the program being debugged by a number of instructions, stepping over call instructions. |
| output |
| Print the value of the expression with no line feed and do not insert the value into a debugger variable. |
| Print the value of the expression and put result in debugger variable. |
| process |
| Switch to another process. |
| processes |
| List all the processes being debugged. |
| ptype |
| Print the type of the expression. |
| pwd |
| Print the current working directory. |
| quit |
| Exit the pathdb program. |
| rerun |
| Step backwards by a number of commands. |
| return |
| Return from the current function with the value specified. |
| run [arglist] |
| Run your program using pathdb (with an arglist if included). |
| watch |
| Create a watchpoint for a read of the specified location. |
| set |
| Set the value of control parameters or program variables. |
| set env |
| Set or print. |
| step |
| Step the program being debugged by a number of lines, stepping into called functions. If no number is specified, then step one line. |
| where |
| Display the program stack (function backtrace). |
| x |
| Examine memory at the specified address, using the format specified. |
| Copyright 2004, 2005 PathScale, Inc. All Rights Reserved. |
| See the PathScale Debugger User Guide. |