kwdb.1m (2011 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

kwdb(1M) kwdb(1M)

NAME

kwdb - invoke KWDB, the source level kernel debugger and crash dump analyzer

SYNOPSIS

kwdb [options ] kernel_ﬁle

Run KWDB on a copy of the target kernel executable ﬁle on your host system.

kwdb -q4 [options ][kernel_ﬁle][crash_dump_directory]

Run KWDB for crash dump analysis.

kwdb -q4 [options ] kernel_ﬁle [remote_system:port ]

Run KWDB for remote crash dump analysis.

kwdb -q4 [options ] kernel_ﬁle

/dev/[k]mem

Run KWDB for live memory analysis

DESCRIPTION

kwdb is a kernel debugging tool based on the HP WDB Source-Level Debugger,

gdb. For complete infor-

mation about this debugger and its commands, see HP KWDB Kernel Debugger Guide, Debugging with

GDB, and Getting Started with HP WDB.

Use

kwdb for the following tasks:

• Perform source level debugging of HP-UX kernel and Dynamically Loadable Kernel Modules from a

remote host system.

• Analyze a crash dump.

• Analyze the behavior of a running system.

Options

-b BAUDRATE Set serial port baud rate for remote debugging. BAUDRATE is 19200 for PA-

RISC systems or 57600 for Itanium-based systems.

-batch Run in batch mode.

-cd=DIR Change current directory to DIR.

-command=FILE Execute gdb commands from a FILE.

-directory=DIR Search for source ﬁles in the directory, DIR.

-epoch Use output from the epoch emacs-GDB interface.

-exec=EXECFILE Use the ﬁle, EXECFILE, as the executable ﬁle for debugging.

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

-help List the version information and all options with brief explanations.

-m Process all loaded DLKMs.

-nw Do not use the Windows interface for debugging.

-nx Do not execute commands from initialization ﬁles.

-objectdir=DIR Search for object ﬁles in the directory, DIR.

-p Enable PERL scripts to run in q4 programming mode.

-q4 Set kwdb to run in q4 mode.

-quiet Do not print introductory and copyright messages.

-readnow Read symbol ﬁles completely on its ﬁrst access.

-se=FILE Use the ﬁle, FILE, as both a symbol ﬁle and an executable ﬁle.

-symbols=FILE Read symbols from the ﬁle, FILE.

-tui Use a terminal user interface.

-type-clash Generate table of type name clashes.

HP-UX 11i Version 3: March 2011 − 1 − Hewlett-Packard Company 1

Summary of content (12 pages)

PAGE 1
kwdb(1M) kwdb(1M) NAME kwdb - invoke KWDB, the source level kernel debugger and crash dump analyzer SYNOPSIS kwdb [options ] kernel_file Run KWDB on a copy of the target kernel executable file on your host system. kwdb -q4 [options ] [kernel_file ] [crash_dump_directory] Run KWDB for crash dump analysis. kwdb -q4 [options ] kernel_file [remote_system:port ] Run KWDB for remote crash dump analysis.
PAGE 2
kwdb(1M) -write kwdb(1M) Enable writing into kernel file and memory. For remote debugging, kwdb has to be invoked with a local copy of the kernel file. Invoking kwdb with the -q4 option and a crash dump directory name as an argument starts kwdb for crash dump analysis in q4 mode. Invoking kwdb with the -q4 option and kernel file name followed by a remote system :portnumber starts kwdb for analyzing crash dump on a remote system.
PAGE 3
kwdb(1M) kwdb(1M) target nddb -h comm_server -t ethernet_mac_address 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. target pa_kern comm_server [:47001] Set up LAN-based debugging on the kwdbd server on the comm_server for PA-RISC architecture.
PAGE 4
kwdb(1M) watch name kwdb(1M) Set the watchpoint at a global symbol specified by name. Kernel Stack This section explains commands for examining the stack frames. The debugger assigns numbers to the stack frames starting from zero for the innermost (currently executing) frame. backtrace [n] bt[n] A 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.
PAGE 5
kwdb(1M) kwdb(1M) a c d f o t u x x [N|u|f] expr address, absolute and relative character signed decimal floating point octal binary unsigned decimal hexadecimal Examine memory at the address specified by expr . specifications are specified by one of the following: N The count of how many units to display. u The unit size. One of b g h w f The optional format individual bytes giant words (eight bytes) half words (four bytes) words (four bytes) Printing format.
PAGE 6
kwdb(1M) kwdb(1M) info source Show the name of the current source file. info sources List all source files in use. list Show the next ten lines of source list. list - Show the previous ten lines of source list. list f,l Show the source list from line f to line l. list lines Display the source surrounding lines , which is specified as one of the following: *addr Display the line containing addr . [file :]num Display the line number, num.
PAGE 7
kwdb(1M) kwdb(1M) set kwdb log [on|off] If on, set logging of kwdb output to the file, kwdb-log. If off, then disable logging. set kwdb logfile name Change the name of log file from kwdb-log to name. set kwdb memory_cache number Set the number of pages for caching memory read from crash dump. set kwdb ntimeout number Set the number of retries for remote network I/O. set kwdb performanceregs [on|off] Enable or disable display of Itanium-based performance registers.
PAGE 8
kwdb(1M) kwdb(1M) ltor (vaddr) Get the physical address corresponding to the virtual address vaddr . vaddr can be an expression. tooffset (long_addr) Get the space of long_addr . tospace (long_addr) Move the offset of long_addr to space. var_name =value Create a variable var_name with the value of value . examine 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.
PAGE 9
kwdb(1M) kwdb(1M) Print a word in hexadecimal. Increment the address by four. Print a word as a date and time string. Increment the address by four bytes (see ctime (3C) for format information). X Y expr Evaluate the expression expr (in kwdb q4 mode only). fields [flags] [struct|union] type listing fields of a specified type in the format defined by the following flags: -c -h -v -x print fields in C style. print header even if output is redirected. print fields with offset and size in C style.
PAGE 10
kwdb(1M) kwdb(1M) q4 print [options] field1 [%fmt],field2 [%fmt],...] Print fields in the current pile. The options are: q4 print %fmt Print numerical value of the field using the %fmt format. Format characters for printf can be used in fmt . -d Print the integer fields in decimal format. -h Turn on the column heading even if the output is redirected. -H Turn off the column heading even if output is not redirected. -o Print integer fields in octal format.
PAGE 11
kwdb(1M) write kwdb(1M) 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. data The data to be written. addr The address to write the data to. addr can be an expression including kernel symbols.
PAGE 12
kwdb(1M) kwdb(1M) SEE ALSO gdb(1), wdb(1), ctime(3C). Debugging with GDB, Getting Started with HP WDB, HP KWDB Kernel Debugger Guide . COPYRIGHT Copyright (c) 1991 Free Software Foundation, Inc. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.