[Digital logo]
[HR]

OpenVMS Alpha System Dump Analyzer Utility Manual


Previous | Contents

This SDA session shows the output of the SHOW LOCK command for several locks. The SHOW RESOURCE command, executed for the last displayed lock, verifies that the lock is in the resource's granted queue. (See Table SDA-28 for a full explanation of the contents of the display of the SHOW RESOURCE command.)


SHOW MACHINE_CHECK

Displays the contents of the stored machine check frame. This command is valid for the DEC 4000 Alpha, DEC 7000 Alpha, and DEC 10000 Alpha computers only.

Format

SHOW MACHINE_CHECK [/FULL] [cpu-id]


PARAMETER

cpu-id

Numeric value from 00 to 1F16 indicating the identity of the processor for which context information is to be displayed. This parameter changes the SDA current CPU (the default) to the CPU specified with cpu-id. If you specify a value outside this range, or you specify the cpu-id of a processor that was not active at the time of the system failure, SDA displays the following message:
%SDA-E-CPUNOTVLD, CPU not booted or CPU number out of range 

If you use the cpu-id parameter, the SHOW MACHINE_CHECK command performs an implicit SET CPU command, making the processor indicated by cpu-id the current CPU for subsequent SDA commands. (See the description of the SET CPU command and Section 5 for information on how this can affect the CPU context---and process context---in which SDA commands execute.)


QUALIFIER

/FULL

Specifies that a detailed version of the machine check information be displayed. This is currently identical to the default summary display.

DESCRIPTION

The SHOW MACHINE_CHECK command displays the contents of the stored machine check frame. A separate frame is allocated at boot time for every CPU in a multiple-CPU system. This command is valid for the DEC 4000 Alpha, DEC 7000 Alpha, and DEC 10000 Alpha computers only.

If no qualifier is specified, a summary version of the machine check frame is displayed.

The default cpu-id is the SDA current CPU.


Examples

#1
SDA> SHOW MACHINE_CHECK 
CPU 00 Stored Machine Check Crash Data
--------------------------------------
Processor specific information: 
------------------------------- 
Exception address:    FFFFFFFF.800B0250    Exception Summary:  00000000.00000000 
Pal base address:     00000000.00008000    Exception Mask:     00000000.00000000 
HW Interrupt Request: 00000000.00000342    HW Interrupt Ena:   00000001.FFC01CE0 
MM_CSR                00000000.00003640    ICCSR:              00000002.381F0000 
D-cache address:      00000007.FFFFFFFF    D-cache status:     00000000.000002E0 
BIU status:           00000000.00000050    BIU address [7..0]: 00000000.000060E0 
BIU control:          00000008.50006447    Fill Address:       00000000.00006120 
Single-bit syndrome:  00000000.00000000    Processor mchck VA: 00000000.00006190 
A-box control:        00000000.0000040E    B-cache TAG:        00106100.83008828 
System specific information: 
---------------------------- 
Garbage bus info:     00200009 00000038    Device type:                 000B8001 
LCNR:                          00000001    Memory error:                00000000 
LBER:                          00000009    Bus error synd 0,1: 00000000 00000000 
Bus error cmd:        00048858 00AB1C88    Bus error synd 2,3: 00000000 0000002C 
LEP mode:                      00010010    LEP lock address:            00041108 
 

The SHOW MACHINE_CHECK command in this SDA display shows the contents of the stored machine check frame.

#2
SDA> SHOW MACHINE_CHECK 1
CPU 01 Stored Machine Check Crash Data 
--------------------------------------
Processor specific information: 
------------------------------- 
Exception address:    FFFFFFFF.800868A0    Exception Summary:  00000000.00000000 
Pal base address:     00000000.00008000    Exception Mask:     00000000.00000000 
HW Interrupt Request: 00000000.00000342    HW Interrupt Ena:   00000000.1FFE1CE0 
MM_CSR                00000000.00005BF1    ICCSR:              00000000.081F0000 
D-cache address:      00000007.FFFFFFFF    D-cache status:     00000000.000002E0 
BIU status:           00000000.00000050    BIU address [7..0]: 00000000.000063E0 
BIU control:          00000008.50006447    Fill Address:       00000000.00006420 
Single-bit syndrome:  00000000.00000000    Processor mchck VA: 00000000.00006490 
A-box control:        00000000.0000040E    B-cache TAG:        35028EA0.50833828 
System specific information: 
---------------------------- 
Garbage bus info:     00210001 00000038    Device type:                 000B8001 
LCNR:                          00000001    Memory error:                00000080 
LBER:                          00040209    Bus error synd 0,1: 00000000 00000000 
Bus error cmd:        00048858 00AB1C88    Bus error synd 2,3: 00000000 0000002C 
LEP mode:                      00010010    LEP lock address:            00041108 
 

The SHOW MACHINE_CHECK command in this SDA display shows the contents of the stored machine check frame for cpu-id 01.


SHOW PAGE_TABLE

Displays a range of system page table entries, the entire system page table, or the entire global page table.

Format

SHOW PAGE_TABLE {range|/FREE|/GLOBAL|/GPT|/PT
|/S0S1 (d)|/SPTW|/ALL|option}
{/L1|/L2|/L3 (d)}


PARAMETER

range

Range of virtual addresses for which SDA is to display page table entries. You can express a range using the following syntax:
m Displays the single page table entry tht corresponds to virtual address m
m:n Displays the page table entries that correspond to the range of virtual addresses from m to n
m;n Displays the page table entries that correspond to a range of n bytes starting at virtual address m

QUALIFIERS

/FREE

Causes the free starting addresses of blocks of free page table entries in the specified range to be displayed.

/GLOBAL

Lists the global page table.

/GPT

Specifies the portion of page table space that maps the global page table as the address range.

/L1

Lists the L1 page table entries for the portion of memory specified.

/L2

Lists the L2 page table entries for the portion of memory specified.

/L3

Lists the L3 page table entries for the portion of memory specified. This qualifier is the default level.

/PT

Specifies page table space as the address range as viewed from system context.

/S0S1

Specifies S0 and S1 space as the address range. The default portion of memory.

/S2

Specifies S2 space as the address range.

/SPTW

Displays the contents of the system page table window.

/ALL

Displays the equivalent to all of /S0S1, /S2, /SPTW, /PT, /GPT, and /GLOBAL.

OPTION

= ALL

Displays with the SHOW PAGE = All command the page table entries for all shared (system) addresses, without regard to the section of memory being referenced. This option can be qualified only by one of the /L1, /L2, or /L3 qualifiers.

Note

The /L1, /L2, and /L3 qualifiers are ignored when use with the /FREE, /GLOBAL, and /SPTW qualifiers.


DESCRIPTION

For each virtual address displayed by the SHOW PAGE_TABLE command, the first eight columns of the listing provide the associated page table entry and describe its location, characteristics, and contents. SDA obtains this information from the system page table. Table SDA-13 describes the information displayed by the SHOW PAGE_TABLE command.

Table SDA-13 Virtual Page Information in the SHOW PAGE_TABLE Display
Value Meaning
MAPPED ADDRESS Virtual address that marks the base of the virtual page.
PTE ADDRESS Virtual address of the page table entry that maps the virtual page.
PTE Contents of the page table entry, a quadword that describes a system virtual page.
TYPE Type of virtual page. Table SDA-14 shows the eight types and their meanings.
READ A code, derived from bits in the PTE, that designates the processor access modes (kernel, executive, supervisor, or user) for which read access is granted.
WRIT A code, derived from bits in the PTE, that designates the processor access modes (kernel, executive, supervisor, or user) for which write access is granted.
BITS Letters that represent the setting of a bit or a combination of bits in the PTE. These bits indicate attributes of a page. Table SDA-15 shows the codes and their meanings.
GH Contents of granularity hint bits.

Table SDA-14 Type of Virtual Pages
Type Meaning
VALID Valid page (in main memory)
TRANS Transitional page (between main memory and page lists)
DZERO Demand-allocated, zero-filled page
PGFIL Page within a paging file
STX Section table's index page
GPTX Index page for a global page table
IOPAG Page in I/O address space
NXMEM Page not represented in physical memory. The page frame number (PFN) of this page is not mapped by any of the system's memory controllers. This indicates an error condition.

Table SDA-15 Bits In the PTE
Code Meaning
A Address space match is set.
M Page has been modified.
L Page is locked into a working set.
K Owner can access the page in kernel mode.
E Owner can access the page in executive mode.
S Owner can access the page in supervisor mode.
U Owner can access the page in user mode.

If the virtual page has been mapped to a physical page, the last six columns of the listing include information from the page frame number (PFN) database Otherwise, the section is left blank. Table SDA-16 describes the physical page information displayed by the SHOW PAGE_TABLE command.

Table SDA-16 Physical Page Information in the SHOW PAGE_TABLE Display
Category Meaning
PGTYP Type of physical page. Table SDA-17 shows the types of physical page.
LOC Location of the page within the system. Table SDA-18 shows the 10 types with their meaning.
BAK Place to find information on this page when all links to this PTE are broken: either an index into a process section table or the number of a virtual block in the paging file.
REFCNT Number of references being made to this page.
FLINK Forward link within PFN database that points to the next physical page; this longword also acts as the count of the number of processes that are sharing this global section.
BLINK Backward link within PFN database; also acts as an index into the working set list.

Table SDA-17 Types of Physical Pages
Page Type Meaning
PROCESS Page is part of process space.
SYSTEM Page is part of system space.
GLOBAL Page is part of a global section.
PPGTBL Page is part of a process page table.
PHD¹ Page is part of a process PHD.
PPT(Ln)¹ Page is a process page table page at level n.
SPT(Ln)¹ Page is a system page table page at level n.
GPGTBL Page is part of a global page table.
GBLWRT Page is part of a global, writable section.
SHPT² Page is part of a shared page table.
UNKNOWN Unknown.


¹These page types are variants of the PPGTBL page type.
²The SHPT page type is a variant of the GBLWRT page type.

Table SDA-18 Location of the Page
Location Meaning
ACTIVE Page is in a working set.
MFYLST Page is in the modified-page list.
FRELST Page is in the free-page list.
BADLST Page is in the bad-page list.
RELPND Release of the page is pending.
RDERR Page has had an error during an attempted read operation.
PAGOUT Page is being written into a paging file.
PAGIN Page is being brought into memory from a paging file.
ZROLST Page is in the zeroed-page list.
UNKNWN Page is in unknown list.

SDA indicates pages are inaccessible by displaying one of the following messages:

 
-------   1 null page:       VA   FFFFFFFE.00064000     PTE   FFFFFFFD.FF800190 
 
------- 974 null pages:      VA   FFFFFFFE.00064000     PTE   FFFFFFFD.FF800190 
                             -to- FFFFFFFE.007FE000     -to-  FFFFFFFD.FF801FF8 

In this case, the page table entries are not in use (page referenced is inaccessible)

 
-------      1 entry not in memory:    VA   FFFFFFFE.00800000   PTE   FFFFFFFD.FF802000 
 
------- 784384 entries not in memory:  VA   FFFFFFFE.00800000   PTE   FFFFFFFD.FF802000 
                                       -to- FFFFFFFF.7F7FE000   -to-  FFFFFFFD.FFDFDFF8 

In this case, the page table entries to not exist (PTE itself is enaccessible)

 
-------    1 free PTE:    VA   FFFFFFFF.7F800000   PTE   FFFFFFFD.FFDFEOOO 
 
------- 1000 free PTEs:   VA   FFFFFFFF.7F800000   PTE   FFFFFFFD.FFDFE000 
                          -to- FFFFFFFF.7FFCE000   -to-  FFFFFFFD.FFDFFF38 

In this case, the page table entries are in the list of free system pages

In each case, "VA" is the MAPPED ADDRESS of the skipped entry, and "PTE" is the PTE ADDRESS of the skipped entry.


SHOW PFN_DATA

Displays information that is contained in the page lists and PFN database.

Format

SHOW_PFN_DATA {[/qualifier]|pfn [{:end-pfn|;length}]}


PARAMETERS

pfn

Page frame number (PFN) of the physical page for which information is to be displayed.

length

Specifies the length of the PFN list to be displayed. When you specify the length parameter, a range of PFNs is displayed. This range starts at the PFN specified by the pfn parameter and contains the number of entries specified by the length parameter.

end-pfn

Specifies the last PFN to be displayed. When you specify the end-pfn parameter, a range of PFNs is displayed. This range starts at the PFN specified by the pfn parameter and ends with the PFN specified by the end-pfn parameter.

QUALIFIERS

/ADDRESS=<PFN-entry-address>

Displays the PFN database entry at the address specified. The address specified is rounded to the nearest entry address so if you have an address that points to one of the fields of the entry, the correct database entry will still be found.

/ALL

Displays the free-page list, modified-page list, and bad-page list. This is the default behavior of the SHOW PFN_DATA command. SDA precedes each list with a count of the pages it contains and its low and high limits.

/BAD

Displays the bad-page list. SDA precedes the list with a count of the pages it contains, its low limit, and its high limit.

/COLOR [={n|ALL}]

Displays data on page coloring. Table SDA-19 shows the command options available with this qualifier.

Table SDA-19 Command Options with the /COLOR Qualifier
Options Meaning
/COLOR with no value Displays a summary of the lengths of the colored page lists for both free pages and zeroed pages.
/COLOR= n where n is a color number Displays the data in the PFN lists (for the specified color) for both free and zeroed pages.
/COLOR=ALL Displays the data in the PFN lists (for all colors), for both free and zeroed free pages.
/COLOR= n or /COLOR=ALL with /FREE or /ZERO Displays only the data in the PFN list (for the specified color or all colors), for either free or zeroed free pages as appropriate. The qualifiers /BAD and /MODIFIED are ignored with /COLOR= n and /COLOR=ALL.
/COLOR without an option specified together with one or more of /FREE, /ZERO, /BAD, or /MODIFIED Displays the color summary in addition to the display of the requested list(s).

For more information on page coloring, see OpenVMS System Management Utilities Reference Manual: M--Z.

/FREE

Displays the free-page list. SDA precedes the list with a count of the pages it contains, its low limit, and its high limit.

/MODIFIED

Displays the modified-page list. SDA precedes the list with a count of the pages it contains, its low limit, and its high limit.

/SYSTEM

Displays the entire PFN database in order by page frame number, starting at PFN 0000.

/ZERO

Displays the contents of the zeroed free page list.

DESCRIPTION

For each page frame number it displays, the SHOW PFN_DATA command lists information used in translating physical page addresses to virtual page addresses. The display has two lines of information. Table SDA-20 shows the first line's fields; Table SDA-21 shows the second line's fields.

Table SDA-20 Page Frame Number Information---Line One Fields
Item Contents
PFN Page frame number.
DB ADDRESS Address of PFN structure for this page.
PT PFN PFN of the page page table page that maps this page.
BAK Place to find information on this page when all links to this PTE are broken: either an index into a process section table or the number of a virtual block in the paging file.
FLINK Forward link within PFN database that points to the next physical page; this longword also acts as the count of the number of processes that are sharing this global section.
BLINK Backward link within PFN database; also acts as an index into the working set list.
SWP/BO Either a swap file page number or a buffer object reference count, depending on a flag set in the page state field.
LOC Location of the page within the system. Table SDA-18 shows the location with their 10 types and meaning.
FLAGS Displays in text form the flags that are set in page state. Table SDA-22 shows the possible flags and their meaning.

Table SDA-21 Page Frame Number Information---Line Two Fields
Item Contents
Blank
PTE ADDRESS System virtual address of the page table entry that describes the virtual page mapped into this physical page. If no virtual page is mapped into this physical page then "<no backpointer>" is displayed.
Blank
Blank
Blank
Blank
REFCNT Number of references being made to this page.
PAGETYP Type of physical page. See Table SDA-17 for the types of physical pages and their meanings.
FLAGS If the page is a page table page, then the contents of the PRN$W_PT_VAL_CNT, PFN$W_PT_LCK_CNT, and PFN$W_PT_WIN_CNT fields are displayed. The format is as follows:
  • VALCNT = nnnn
  • LCKCNT = nnnn
  • WINCNT = nnnn

Table SDA-22 Flags Set in Page State
Flag Meaning
BUFOBJ Set if any buffer objects reference this page.
COLLISION Empty collision queue when page read is complete.
BADPAG Bad page.
RPTEVT Report event on I/O completion.
DELCON Delete PFN when REFCNT= 0.
MODIFY Dirty page (modified).
UNAVAILABLE PFN is unavailable. Most likely a console page.


SHOW POOL

Displays the contents of the nonpaged dynamic storage pool and the paged dynamic storage pool. You can display part or all of each pool. If no range or qualifiers are specified, the default is SHOW POOL/ALL. Optionally, it displays the nonpaged pool history ring buffer.

Format

SHOW POOL {{range|/ALL (d)|/BAP|/NONPAGED|/PAGED} [/FREE|/HEADER|/SUMMARY|/TYPE=block-type| /SUBTYPE=block-type] |/RING_BUFFER|/STATISTICS [{/NONPAGED|/BAP}]}


PARAMETER

range

Range of virtual addresses in pool that SDA is to examine. You can express a range using the following syntax:
m:n Range of virtual addresses in pool from m to n
m;n Range of virtual addresses in pool starting at m and continuing for n bytes

QUALIFIERS

/ALL

Displays the entire contents of memory, except for those portions of memory that are free (available). This is the default behavior of the SHOW POOL command.

/BAP

Displays the contents of the bus-addressable dynamic storage pool currently in use.

/FREE

Displays the entire contents, both allocated and free, of the specified region or regions of pool. Use the /FREE qualifier with a range to show all of the used and free pool in the given range.

/HEADER

Displays only the first 16 longwords of each data block found within the specified region or regions of pool.

/NONPAGED

Displays the contents of the nonpaged dynamic storage pool currently in use.

/PAGED

Displays the contents of the paged dynamic storage pool currently in use.

/RING_BUFFER

Displays the contents of the nonpaged pool history ring buffer if pool checking has been enabled. Entries are displayed in reverse chronological order; that is, most to least recent. This qualifier is mutually exclusive of all other SHOW POOL qualifiers.

/STATISTICS

Displays usage statistics about each lookaside list. For each list, its queue header address, packet size, attempts, fails, and deallocations are displayed. This can be further qualified by using /NONPAGED, or /BAP to only display statistics for a specified pool area.

/SUBTYPE=block-type

Displays the blocks within the specified region or regions of pool that are of the indicated block-type. If SDA finds no blocks of that subtype in the pool region, it displays a blank screen, followed by an allocation summary of the region. For information on block-type, see block-type in the Description section.

/SUMMARY

Displays only an allocation summary for each specified region of pool.

/TYPE=block-type

Displays the blocks within the specified region or regions of pool that are of the indicated block-type. If SDA finds no blocks of that type in the pool region, it displays a blank screen, followed by an allocation summary of the region. For information on block-type, see block-type in the Description section.

Note

Some qualifiers cannot be used in the same command as some other qualifiers. Regard the first group of qualifiers (/FREE, etc) as filter qualifiers, the second group of qualifiers (/range, etc) as range specifying qualifiers, and the third group as additional exclusive qualifiers.


DESCRIPTION

The SHOW POOL command displays information about the contents of any specified region of pool in an 8-column format. The contents of the full display, from left to right, are listed as follows:


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6135P010.HTM
  OSSG Documentation
  22-NOV-1996 14:12:01.14

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal