unix.apcrash Verb: TCL2/Unix

unix.apcrash

Command unix.apcrash Verb: TCL2/Unix
Applicable release versions: AP 6.1
Category Unix (24)
Description a utility running under Unix to examine Pick core dumps.
A Pick core dump is created either automatically when a machine abort occurs (bus error, segmentation violation, ..), or by requesting it with the Monitor Debugger 'd' command.

The core file contains a series of segments, each representing part of the Pick memory at the time the dump was done. Segments can contain both Monitor and Virtual data. The data in the core file cannot be changed.

"core.file" Name of the core file to examine. If not specified, the default '/usr/tmp/ap.core' is used. Note this file can be very large.


Display formats:

Data is displayed in a way similar to the Virtual Debugger. "apcrash" has a notion of a 'window' (number of bytes displayed). After each window is displayed, an equal (=) sign is displayed and the user is prompted for an action. A one character code, followed by <return> is expected:

n Next window.
p Previous window.
x Redisplay data in hexadecimal.
c Redisplay data in characters.
i Redisplay data in decimal.


"apcrash" displays a prompt '(crash)' and waits for commands on its standard input:

? Display Help.

!unix.command Execute the Unix shell command 'unix.command'.

{.}fid[,|.]dsp{;win} Display the specified Virtual Address. The core file must contain either a segment for the appropriate 'fid', or both the Buffer Table segment AND a the Virtual Buffer segment which contains the specified frame.

b{.}fid Display the buffer table entry associated to the specified FID. The Buffer Table segment must be present.

l{.}fid Display the Link fields of the specified frame. The core file must contain either a segment for the appropriate 'fid', or both the Buffer Table segment AND a the Virtual Buffer segment which contains the specified frame.

m{l|g}{.}addr{;win} Display 'real' memory. The prefix 'l' specifies a local address (mpcb); 'g' specifies a global address (mcb). Without prefix, 'addr' is an 'absolute' address.

q or <ctrl>+D Quit.

S{type} Display the core segments in the current core file. If 'type' is specified, only the segments of this type are specified. See the Advanced Pick Reference Manual entry for 'ap.core'.

v Display the Monitor version.

x Display the hardware registers, PCB fid, ra and ral values and the PIB of the process which made the dump. The Register, PCB, es Global and Local segments must be in the core file.
Syntax apcrash {core.file}
Options
Example
Purpose
Related unix.ap.core