[OpenVMS documentation]
[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
Updated: 11 December 1998

OpenVMS Alpha System Analysis Tools Manual


Previous Contents Index


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 [/HEADER=address]
|/GLOBAL|/GPT|/PT
|/INVALID_PFN [=option]
|/NONMEMORY_PFN [=option]
|/PTE_ADDRESS|/SECTION_INDEX=n
|/S0S1 (d)|/SPTW|option}
{/L1|/L2|/L3 (d)
|=ALL}


Parameter

range

Range of virtual addresses or PTE addresses for which SDA displays page table entries. If the qualifier /PTE_ADDRESS is given, then the range is of PTE addresses; otherwise, the range is of virtual addresses.

If /PTE_ADDRESS is given, the range is expressed using the following syntax:
m Displays the single page table entry at address m
m:n Displays the page table entries from address m to address n
m;n Displays n bytes of page table entries starting at address m

If /PTE_ADDRESS is not given, then range is expressed using the following syntax:
m Displays the single page table entry that 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 starting addresses and sizes of blocks of pages in the free page list to be displayed. The qualifiers /S0S1 (default), /S2, /GLOBAL, and /HEADER determine which free page list is to be displayed.

/GLOBAL

Lists the global page table. When used with the /FREE qualifier, /GLOBAL indicates the free page list to be displayed.

/HEADER=address

When used with the /FREE qualifier, the /HEADER=address qualifier displays the free list for the specified private page table.

/GPT

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

/INVALID_PFN [=option]

The /INVALID_PFN qualifier, which is valid on platforms that supply an I/O memory map, causes SDA to display only page table entries that map to PFNs that are not in the system's private memory, nor in Galaxy shared memory, nor are I/O access pages.

See the /NONMEMORY_PFN qualifier definition for a description of the options.

/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.

/NONMEMORY_PFN [=option]

The /NONMEMORY_PFN qualifier, supported on all platforms, causes SDA to display only page table entries that are neither in the system's private memory nor in Galaxy shared memory.

Both /INVALID_PFN and /NONMEMORY_PFN qualifiers allow two optional keywords, READONLY and WRITABLE. If neither keyword is given, all relevant pages are displayed. If READONLY is given, only pages marked for no write access are displayed. If WRITABLE is given, only pages that allow write access are displayed. For example, SHOW PAGE_TABLE=ALL/INVALID_PFN=WRITABLE would display all system pages whose protection allows write, but which map to PFNs that do not belong to this system.

/PT

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

/PTE_ADDRESS

Specifies that the range given is of PTE addresses instead of the virtual addresses mapped by the PTEs.

/SECTION_INDEX=n

Displays the page table for the range of pages in the global section or pageable part of a loaded image. One of the qualifiers /L1, /L2, or /L3 can also be specified, except for global sections where global page table entries (GPTEs) are displayed.

/S0S1

Specifies S0 and S1 space as the address range. When used with the /FREE qualifer, /S0S1 indicates the free page list to be displayed. This is the default portion of memory or free page list to be displayed.

/S2

Specifies S2 space as the address range. When used with the /FREE qualifier, /S2 indicates the free page list to be displayed.

/SPTW

Displays the contents of the system page table window.

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. It is equivalent to specifying all of /S0S1, /S2, /SPTW, /PT, /GPT, and /GLOBAL. This option can be qualified by only one of the /L1, /L2, or /L3 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 4-5 describes the information displayed by the SHOW PAGE_TABLE command.

Note that the /L1, /L2, and /L3 qualifiers are ignored when used with the /FREE, /GLOBAL, and /SPTW qualifiers.

Table 4-5 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 4-6 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 4-7 shows the codes and their meanings.
GH Contents of granularity hint bits.

Table 4-6 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 4-7 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 is kernel mode.
E Owner is executive mode.
S Owner is supervisor mode.
U Owner is 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 4-8 describes the physical page information displayed by the SHOW PAGE_TABLE command.

Table 4-8 Physical Page Information in the SHOW PAGE_TABLE Display
Category Meaning
PGTYP Type of physical page. Table 4-9 shows the types of physical page.
LOC Location of the page within the system. Table 4-10 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 4-9 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 1 Page is part of a process PHD.
PPT(Ln) 1 Page is a process page table page at level n.
SPT(Ln) 1 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 2 Page is part of a shared page table.
UNKNOWN Unknown.


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

Table 4-10 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.


Examples

#1

      

For an example of SHOW PAGE_TABLE output when the qualifier /FREE has not been given, see the SHOW PROCESS/PAGE_TABLES command.

#2

SDA>SHOW PAGE_TABLE/FREE
S0/S1 Space Free PTEs 
--------------------- 
 MAPPED ADDRESS        PTE ADDRESS             PTE           COUNT 
 
FFFFFFFF.82A08000   FFFFFFFD.FFE0A820   0001FFE0.A8580000   00000003 
FFFFFFFF.82A16000   FFFFFFFD.FFE0A858   0001FFE0.A8900000   00000003 
FFFFFFFF.82A24000   FFFFFFFD.FFE0A890   0001FFE0.B3C00000   00000003 
FFFFFFFF.82CF0000   FFFFFFFD.FFE0B3C0   0001FFE0.B4010000   00000001 
FFFFFFFF.82D00000   FFFFFFFD.FFE0B400   0001FFE0.B4680000   00000002 
FFFFFFFF.82D1A000   FFFFFFFD.FFE0B468   0001FFE0.B4B00000   00000002 
FFFFFFFF.82D2C000   FFFFFFFD.FFE0B4B0   0001FFE0.B5700000   00000002 
FFFFFFFF.82D5C000   FFFFFFFD.FFE0B570   0001FFE0.B6C00000   00000002 
FFFFFFFF.82DB0000   FFFFFFFD.FFE0B6C0   0001FFE0.B6F80000   00000002 
FFFFFFFF.82DBE000   FFFFFFFD.FFE0B6F8   0001FFE0.B7200000   00000002 
FFFFFFFF.82DC8000   FFFFFFFD.FFE0B720   0001FFE0.B7680000   00000002 
FFFFFFFF.82DDA000   FFFFFFFD.FFE0B768   0001FFE0.B8000000   00000002 
FFFFFFFF.82E00000   FFFFFFFD.FFE0B800   0001FFE0.B8380000   00000002 
FFFFFFFF.82E0E000   FFFFFFFD.FFE0B838   0001FFE0.B8700000   00000002 
FFFFFFFF.82E1C000   FFFFFFFD.FFE0B870   0001FFE0.B8890000   00000001 
FFFFFFFF.82E22000   FFFFFFFD.FFE0B888   0001FFE0.B8D80000   00000002 
FFFFFFFF.82E36000   FFFFFFFD.FFE0B8D8   0001FFE0.B9080000   00000002 
FFFFFFFF.82E42000   FFFFFFFD.FFE0B908   0001FFE0.B9200000   00000002 
FFFFFFFF.82E48000   FFFFFFFD.FFE0B920   0001FFE0.B9390000   00000001 
FFFFFFFF.82E4E000   FFFFFFFD.FFE0B938   0001FFE0.BA200000   00000002 
FFFFFFFF.82E88000   FFFFFFFD.FFE0BA20   0001FFE0.C9780000   00000003 
FFFFFFFF.8325E000   FFFFFFFD.FFE0C978   0001FFE0.CC980000   00000003 
FFFFFFFF.83326000   FFFFFFFD.FFE0CC98   00000000.00000000   0000066D
      

This example shows the output when the the SHOW PAGE_TABLE/FREE command is invoked.


SHOW PARAMETER

Displays the name, location, and value of one or more SYSGEN parameters at the time that the system dump is taken.

Format

SHOW PARAMETER [SYSGEN_parameter]
[/ACP][/ALL][/CLUSTER][/DYNAMIC][/GALAXY]
[/GEN][/JOB][/LGI][/MAJOR][/MULTIPROCESSING]
[/PQL][/RMS][/SCS][/SPECIAL][/SYS][/STARTUP]
[/TTY]


Parameter

SYSGEN_parameter

The name of a parameter to be displayed. The name given may include wildcards. However, a truncated name is not recognized, unlike the equivalent SYSGEN and SYSMAN commands.

Qualifiers

/ACP

Displays all Files-11 ACP parameters.

/ALL

Displays the values of all parameters except the special control parameters.

/CLUSTER

Displays all parameters specific to clusters.

/DYNAMIC

Displays all parameters that can be changed on a running system.

/GALAXY

Displays all parameters specific to Galaxy systems.

/GEN

Displays all general parameters.

/JOB

Displays all Job Controller parameters.

/LGI

Displays all LOGIN security control parameters.

/MAJOR

Displays the most important parameters.

/MULTIPROCESSING

Displays parameters specific to multiprocessing.

/PQL

Displays the parameters for all default process quotas.

/RMS

Displays all parameters specific to OpenVMS Record Management Services (RMS).

/SCS

Displays all parameters specific to OpenVMS Cluster System Communications Services.

/SPECIAL

Displays all special control parameters.

/STARTUP

Displays the name of the site-independent startup procedure.

/SYS

Displays all active system parameters.

/TTY

Displays all parameters for terminal drivers.

Description

The SHOW PARAMETER command displays the name, location and value of one or more SYSGEN parameters at the time that the system dump is taken. You can specify either a parameter name, or one or more qualifiers, but not both a parameter and qualifiers. If neither a parameter nor qualifiers are given, then the last parameter displayed is displayed again.

The qualifiers are the equivalent to those available for the SHOW [parameter] command in the SYSGEN utility and the PARAMETERS SHOW command in the SYSMAN utility. See the OpenVMS System Management Utilities Reference Manual: M--Z for more informaton about these two commands. You can combine qualifiers, and all appropriate SYSGEN parameters are displayed.

Note

To see the entire set of parameters, use the SDA command
SHOW PARAMETER /ALL/SPECIAL /STARTUP.



SHOW PFN_DATA

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

Format

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

or

SHOW PFN_DATA/MAP


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 4-11 shows the command options available with this qualifier.

Table 4-11 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.

/MAP

Displays the contents of the PFN memory map. It is also displayed on platforms that support an I/O space map. The /MAP qualifier cannot be combined with any parameters or other qualifiers.

/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.

/PRIVATE [=address]

Displays private PFN lists. If no address is given, all private PFN lists are displayed; if an address is given, only the PFN list whose head is at the given address is displayed.

/SYSTEM

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

/UNTESTED

Displays the state of the untested PFN list that was set up for deferred memory testing.

/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 4-12 shows the first line's fields; Table 4-13 shows the second line's fields.

Table 4-12 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 4-10 shows the location with their 10 types and meaning.
FLAGS Displays in text form the flags that are set in page state. Table 4-14 shows the possible flags and their meaning.

Table 4-13 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 4-9 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 4-14 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.


Previous Next Contents Index

[Site home] [Send comments] [Help with this site] [How to order documentation] [OpenVMS site] [Compaq site]
[OpenVMS documentation]

Copyright © Compaq Computer Corporation 1998. All rights reserved.

Legal
6549PRO_013.HTML