| SunVTS 6.2 Test Reference Manual for SPARC Platforms
|
   
|
Physical Memory Test (pmemtest)
|
pmemtest Description
The pmemtest checks the physical memory of the system, and reports hard and soft error correction code (ECC) errors, memory read errors, and addressing problems. The pseudo driver mem reads the physical memory.
This test reads through all the available physical memory. It does not write to any physical memory location.
pmemtest Options
pmemtest is supported both in physical mapping and logical mapping displays in the UI. In physical mapping, pmemtest provides support to test the memory on a per-board basis. Users can select the pmemtest that is displayed under the physical memory board, that is to be tested and test only that board. In logical mapping, the pmemtest options apply to the complete memory across all boards.
To reach the following dialog box, right-click on the test name in the System Map and select Test Parameter Options. If you do not see this test in the System Map, you might need to expand the collapsed groups, or your system might not include the device appropriate to this test. Refer to the SunVTS User's Guide for more details.
FIGURE 45-1 pmemtest Test Parameter Options Dialog Box
TABLE 45-1 pmemtest Options
|
pmemtest Options
|
Description
|
|
Configuration
|
Shows the total amount of physical memory, rounded up to the nearest MB, that is probed by the SunVTS kernel.
|
|
Amount of Memory
|
Specifies the percentage of the physical memory to be tested. The default 0% ensures dividing the total memory equally among instances which results in 100% coverage at the completion of every test pass. One test pass includes one pass each by all instances.
|
|
ECC Error Monitor
|
Enables or disables ECC error monitoring.
|
|
ECC Report Threshold
|
For UltraSPARC servers only. Determines how many correctable ECC errors occurred in the elapsed time before pmemtest reports a test failure. A value of zero results in no report of any correctable ECC errors. The default is 2.
|
|
Section ID
|
For UltraSPARC servers only. When set to -1, pmemtest will test one memory section in each pass, automatically testing each subsequent memory section as testing progresses. When set to a number other than -1, only the section specified is tested. A section is defined by the pass and instance number settings.
|
|
Instance
|
Instances are the number of copies of pmemtest to run simultaneously on the memory being tested.
|
|
Note - The amount of memory option is specified on a per-instance basis. The real memory coverage for one test pass depends on the amount of memory option and the number of instances. For example, if there are four instances, and each instance specifies 50% for the amount of memory option, then this will result in 200% (4 times 50%) coverage on each test pass. For guaranteed 100% memory coverage for each test pass, choose the default percentage size option as 0% for all instances.
|
pmemtest Test Modes
TABLE 45-2 pmemtest Supported Test Modes
|
Test Mode
|
Description
|
|
Connection
|
One percent of the memory is read. pmemtest also informs you how much physical memory is available. For sun4m, sun4u, and UltraSPARC servers, the test reports the ECC errors that have occurred since it was last invoked. The test reports ECC errors for a particular CPU or memory board when physical mapping is selected, otherwise it provides the DIMM number of the ECC memory error.
|
|
Functional
|
The amount of memory to be read can vary. By default 100% of the memory is tested. The test reports ECC errors for a particular memory board when physical mapping is selected, otherwise it provides the DIMM number of the ECC memory error.
|
|
Online
|
The amount of memory to be read can vary. By default 100% of the memory is tested. The test reports ECC errors for a particular memory board when physical mapping is selected, otherwise it provides the DIMM number of the ECC memory error.
|
pmemtest Command-Line Syntax
For 32-bit configurations:
/opt/SUNWvts/bin/pmemtest standard-arguments -o size=[0-100],dev=device-name,eccmon=Enabled|Disabled,threshold=report-threshold,bdinfo=number,section=section-id
For 64-bit configurations:
/opt/SUNWvts/bin/sparcv9/pmemtest standard-arguments -o size=[0-100],dev=device-name,eccmon=Enabled|Disabled,threshold=report-threshold, bdinfo=number,section=section-id
TABLE 45-3 pmemtest Command-Line Syntax
|
Argument
|
Description
|
|
size=0-100
|
Specifies the percentage of memory to be tested. The default is 0% (for 100% memory coverage).
|
|
dev=device-name
|
Specifies the device to test, for example, mem.
|
|
eccmon=Enabled|Disabled
|
Enables or disables ECC error monitoring.
|
|
threshold=report-threshold
|
Number of ECC errors after which the test stops (if ECC monitor is running). When the threshold is reached the test will exit with a non zero exit code. If set to zero, the test will still report all the errors but will not stop. The default threshold is 2.
|
|
bdinfo=number
|
For UltraSPARC servers only. This argument indicates board number information. For example, if board 0 and board 5 have memory and you want the test to read the memory on both boards, then this argument should read bdinfo=33 (2**5+2**0). The bdinfo value can be specified as 0 to test the memory present on all boards.
|
|
section=section-id
|
For UltraSPARC servers only. When set to -1, pmemtest tests one memory section in each pass, automatically testing each subsequent memory section. When set to a number other than -1, only the section specified is tested. A section is defined by the pass and instance number settings.
|
| SunVTS 6.2 Test Reference Manual for SPARC Platforms
|
819-6455-10
|
|
Copyright © 2006, Sun Microsystems, Inc. All Rights Reserved.