kwdb(1M)

Set serial port baud rate for remote debugging. BAUDRATE is 19200 for PA-RISC systems or 57600 for Itanium-based systems.

Run in batch mode.

Change current directory to DIR.

Execute gdb commands from a FILE.

Search for source files in the directory, DIR.

Use output from the epoch emacs-GDB interface.

Use the file, EXECFILE, as the executable file for debugging.

Cause output information to go to the epoch emacs-GDB interface.

List the version information and all options with brief explanations.

Process all loaded DLKMs.

Do not use the Windows interface for debugging.

Do not execute commands from initialization files.

Search for object files in the directory, DIR.

Enable PERL scripts to run in q4 programming mode.

Set kwdb to run in q4 mode.

Do not print introductory and copyright messages.

Read symbol files completely on its first access.

Use the file, FILE, as both a symbol file and an executable file.

Read symbols from the file, FILE.

Use a terminal user interface.

Generate table of type name clashes.

Enable writing into kernel file and memory.

List the classes of commands.

Describe the specified kwdb command.

Exit KWDB. Also typing q or EOF (CTRL- D) causes KWDB to quit.

(INTERRUPT) Terminate the current command, or interrupt the target kernel.

Release the target kernel from KWDB control and allow it to continue.

Release the target kernel from KWDB control and reboot.

Debug using the on-console debugger and kwdb via the remote console. lantron_name specifies the name of the terminal server such Lantronix hardware which is connected to the target system. nn is the port number for the remote console.

Set up LAN-based debugging through the KWDB server on the communication server, comm_server, for Itanium-based architecture.

Set up RS-232-based debugging for the specified serial device file, devicefile.

Set up Lantron serial debugging on the terminal server, lantron_name. nn is the serial port on the target system.

Debug an HP-UX 11.0 or earlier kernel using nddb compatibility mode. comm_server is the communication server. ethernet_mac_address is the Ethernet LAN MAC address of the LAN card used for debugger communications in the target system.

Set up LAN-based debugging on the kwdbd server on the comm_server for PA-RISC architecture.

Set up debugging for a Superdome, Keystone, or ORCA system using SUB/SINC. name_of_sub is the console name of the system.

Set up UDP-based debugging. ip-address is the IP address of the target system.

Specify the target crash directory, dir, which is to be debugged. The target crash command is not required if kwdb is invoked with -q4 option. The attach command is not used with this target.

kwdb runs on the target system and debugs live memory using /dev/mem or /dev/kmem. The target devmem command is not required if kwdb is invoked with the /dev/mem or /dev/kmem argument. The attach command is not used with this target system.

Attach the remote target system. If target is connected through the kwdbd or nddbcs communication server, target_id is the Ethernet MAC address of target LAN. If communication is through SUB/SINC, target_id is the partition name.

Set the breakpoint at the specified line number line in file.

Set the breakpoint at the function func in file.

Set the breakpoint at the specified address addr.

Set breakpoint at next instruction.

Break conditionally on a nonzero expr at the next instruction (or location specified as line or address or function).

Delete breakpoints at next instruction.

Delete breakpoints at entry to the function at func.

Delete breakpoints on source line.

Execute command-list every time breakpoint n is reached.

Make a new conditional expression on breakpoint n. Make an unconditional expression if expr is omitted.

Delete breakpoints or the breakpoint n.

Disable breakpoints or the breakpoint n.

Enable breakpoints or the breakpoint n.

Ignore breakpoint at n, count number of times.

Show breakpoints and watchpoints.

Specify a temporary breakpoint. Similar to the break command except that the breakpoint is temporary. When the breakpoint is reached, the breakpoint is disabled. args are accepted as in the break command.

Set the watchpoint at address specified by addr which is the default. Four bytes will be watched.

Set the watchpoint at a global symbol specified by name.

Trace all frames in stack or n number of frames. If n is specified and is greater than zero (0), then start from the innermost frame. If n is specified and is less than zero, then start from the outermost frame.

Select the frame that is n frames down.

Select frame n or the frame at address n. If n is not specified, then display the current frame.

Display all registers including floating point registers. This command is not supported in PA-RISC architecture.

Display arguments of the selected frame.

Describe the selected frame, or the frame at addr.

Display locals of the selected frame.

Display register values for a selected frame. If rn is specified, then display register rn.

Select a frame that is n frames up.

Call the specified function with up to eight 64-bit sized arguments.

Continue running. If count is specified, ignore this breakpoint count number of times.

Continue executing until the current function returns.

Resume execution at specified line number (line) or (address).

This command is similar to the step command in that it executes the next command but it does not step into functions.

This command is similar to the stepi command but does not step into functions.

Pop selected stack frame without executing. If an argument is given in expr, it is an expression for the value to return.

Evaluate expr without displaying it. Use this command for altering variables.

Continue to execute until another source line is reached. If the repeat count is specified, execute count number of times.

Step by machine instructions rather than source lines.

Execute or run until the next instruction. location is specified as a line, address, or function. If location is specified, run until the location is reached.

Display memory as machine instructions for the function at addr.

Display memory as machine instructions for the function func.

Show the value of expr according to format fmt:

Examine memory at the address specified by expr. The optional format specifications are specified by one of the following:

Show the value of expr each time the kernel stops according to the format fmt listed with x command.

Display all enabled expressions on the list created with display command.

Enable display for all expression(s). Use the list number, n, to define a specific number of expressions to display.

Display a numbered list of display expression(s).

Remove all expressions from the list of automatically-displayed expressions. Use the list number, n, to define a specific number of expressions to remove.

Disable display for all expression(s) Use the list number, n, to define a specific number of expressions to disable.

Show all names types of global variables (all, or matching the regular expression specified by regex).

Show where the address of the symbol name s is stored.

Show names, types of defined functions (all, or matching the regular expression specified by regex).

Describe type, struct, union, or enum. If the expression, expr, is specified, it is described also.

Show data type of expr (or $) without evaluating.

Add directory names to the front of the source path.

Clear the source path.

Search the following source lines for the regular expression specified by regex.

Show the starting and ending addresses of code for the source line num.

Show the name of the current source file.

List all source files in use.

Show the next ten lines of source list.

Show the previous ten lines of source list.

Show the source list from line f to line l.

Display the source surrounding lines, which is specified as one of the following:

Search preceding source lines for the regular expression specified by regex.

Show current source path in dir.

Stop on loads of module modname. If modname is omitted, catch all loads.

Stop on unloads of module modname. If modname is omitted, catch all unloads.

Display information about loaded modules.

Add the directory to the search path for kernel modules.

Similar to the catch load command but a temporary catchpoint. The catchpoint which was set is deleted when hit. If modname is omitted, catch all loads.

Similar to the catch unload command but temporary. Deleted when hit. If modname is omitted, catch all unloads.

Do not catch load for modname. If modname is omitted, do not catch any loads.

Do not catch unload for modname. If modname is omitted, do not catch any unloads.

Select CPU n as the viewed CPU.

Turn memory caching on or off.

Enable (on) or disable (off) display of Itanium-based control registers.

Enable (on) or disable (off) display of Itanium-based floating point registers.

If on, set logging of kwdb output to the file, kwdb-log. If off, then disable logging.

Change the name of log file from kwdb-log to name.

Set the number of pages for caching memory read from crash dump.

Set the number of retries for remote network I/O.

Enable or disable display of Itanium-based performance registers.

Log data packet communications to and from the target to file kwdb-remote-log for support purposes. If off is specified, then disable logging.

Set kwdb to q4 mode (on) or turn q4 mode off.

Set the virtual space ID for memory access to sid.

Set number to define the timeout for remote network I/O in tenths of seconds.

Set the terminal output on or off.

Control the printing of strings referenced by character pointers.

Set thread with the given address addr as the current context.

Set crash event n as the current context during crash dump analysis. n is the index of the crash event in the crash event table.

Add type information from an object file.

Process the DLKM module modname for debugging.

Print cataloged types matching regex. Use the -h option to print the header even if output is redirected.

Print the assembly code for function name or the function surrounding the address addr. You can use either the code or disassemble command.

Print enumerants in symbol table with values.

Discard structures satisfying a condition specified by cond_expr.

Print the assembly code for function name or the function surrounding the address addr.

Evaluate the expression expr, which may contain one or more of the following:

The format of the command is:

examine [-o|-r] [addr] [for no_of_lines] [using [n] fmt]

Print the contents of memory from address addr using the format specified.

Evaluate the expression expr (in kwdb q4 mode only).

listing fields of a specified type in the format defined by the following flags:

Delete the current pile or delete a specified pile as specified below. If a pile is not specified, then the current pile is deleted.

Print a list of q4 commands

Print the help message for the specified q4 command, cmd.

Print the history of loaded data structures.

Load the PERL script from the specified file.

Enable processing for type-clash and list the types of registers whose name match with the regular expression specified by regex. If the regex argument is omitted, list all types that have the name CLASH.

Select structures satisfying a condition, cond_expr.

Read a collection of structures:

Merge data from a pile specified by num, -num, or name to the current pile. See the forget command for information on num, -num, and name.

Print details of currently loaded DLKM modules.

Name the current pile or the pile specified with name.

Read structures of type from values of field from the current pile.

Pop the piles marked by last pushhistory.

Save the state of the current pile history for future popping.

The format of the command is:

q4 print [options] field1 [%fmt], field2 [%fmt],...]

Print fields in the current pile. The options are:

The format of the command is:

q4 print [options] [type] from addr

Print a structure from the value of addr. addr can be an expression.

Run a PERL script function func with or without args.

Print kernel symbols matching regexp.

Display the stack trace for the crash event number (num) for the crash target only. The options for all the q4 trace commands are as follows:

Display stack trace with pc and sp (PA-RISC only).

Display stack trace for structures from the current pile for process, processor, thread and crash event structures.

Display stack trace for the process at addr.

Display stack trace for the processor number specified by num.

Display stack trace for savestate at addr.

Display stack trace for thread at addr.

Remove a user defined variable specified by var_name.

Make a pile which is specified by num, -num, or name. See the forget command for information on num, -num, and name.

Execute the shell command specified by cmd.

Display the page table entry or translation registers used for translating addr.

Display all user defined variables and values.

The format of the command is:

write [-o|-r] data at addr [using format]

Write the given data into memory or into a kernel file at the address specified by addr. Options -o and -r have the same meanings as explained in the examine command.

Set working directory to dir for the debugger and program being debugged.

Define a new command, cmd. The definition appears on following lines, one command per line. End with a line that has only

Document a user-defined command, cmd. Give documentation on the following lines. End with a line that has only

Use file as the program to be debugged.

Print the working directory.

Execute the rest of the line with command_line as a shell command.

Read and run commands from a file named script.