unix.ap.core File/Unix

unix.ap.core

Command unix.ap.core File/Unix
Applicable release versions: AP 6.1
Category Unix (24)
Description is created automatically on the directory "/usr/tmp" when a machine abort occurs (bus error, segmentation violation, ...), or upon request with the Monitor Debugger 'd' command.
This file is a regular Unix file which can be written on tape, using Unix utilities like 'tar' or 'cpio' to be sent to Technical Support for investigating a problem. The utility 'apcrash' can be used to examine the core file with commands similar to the Pick Virtual Debugger.

The core file is made of 'segments', each representing part of the memory at the time the dump occurred. The segments have a 16 byte header as follows:

0 4 8 12 15 16
+-----+-----+-----+-----+-----+-----+-----+--+--+
| start | size | data | pib | |TY|
+-----+-----+-----+-----+-----+-----+-----+--+--+

start Start address.
size Size in bytes.
data Optional data filed.
pib PIB number of the process.
TY Segment type.

The actual size of the segment is rounded up to the nearest 4 byte boundary.

The following lists the segment types and the meaning of the other fields, where applicable:

"0" PCB.

"B" Buffer table.

"F" Virtual Frame. 'data' is the FID.

"G" Global segment. 'start' is the value of the GM register ra.

"L" Local segment. 'start' is the value of the GM register ral.

"M" Monitor Version. 'data' is the frame size, in bytes.

"P" PIBs table. 'data' is the pib size, in bytes.

"R" Hardware registers.

"S" Main shared memory. 'data' is the starting offset of the dump.

"V" Virtual Buffers.
Syntax
Options
Example
Purpose
Related unix.apcrash