SunVTS 3.0 Test Reference Manual

Chapter 25 Physical Memory Test (`pmemtest`)

The pmemtest checks the physical memory of the system. The pmemtest locates parity errors, hard and soft error correction code (ECC) errors, memory read errors, and addressing problems. The pseudo driver mem(7) is used to read the physical memory.

This test reads through all available physical memory. It does not write to any physical memory location.

`pmemtest` Options

Figure 25-1 `pmemtest` Option Menu

Refer to Table 25-1 for test parameter descriptions.

Figure 25-2 `pmemtest` UltraSPARC Server Option Menu

Refer to Table 25-1 for test parameter descriptions.

Table 25-1 pmemtest Options


`pmemtest` Options	Description
Configuration	Shows the total amount of physical memory, rounded up to the nearest megabyte, probed by the SunVTs kernel.
Amount of Memory	Specifies the percent of the physical memory to be tested.
ECC Report Threshold	Determines how many correctable ECC errors occur before they are reported as an error causing `pmemtest` to report a failure. A value of zero results in no report of any correctable ECC errors. The default is 2.This option is only available on UltraSPARC systems.
Section ID	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 will be tested.A section is defined by the pass and instance number settings. This option is only available on UltraSPARC systems.
Instance	The number of copies of `pmemtest` to run simultaneously on the memory you are testing.

`pmemtest` Test Modes

Table 25-2 pmemtest Test Modes


Test Mode	Description
Connection Test	In this mode, 1 percent of the memory is read; `pmemtest` also informs the user 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 SIMM number of the ECC memory error.
Functional Test	In Functional test, the amount of memory to be read can vary; the default is 100 percent. For UltraSPARC servers, this test mode reports all ECC errors that have occurred since the system was brought online
Functional Test mode through SyMON	When `pmemtest` is invoked through SyMON, the following Functional Test description applies: A variable amount of memory is read; the default is 100 percent. For UltraSPARC servers, the ECC error reporting is the same as for the Connection test.

`pmemtest` Command Line Syntax

/opt/SUNWvts/bin/pmemtest standard_arguments -o size=[1-100],dev=device_name,threshold=report_threshold,bdinfo=number,section=section_id

Table 25-3 pmemtest Command Line Syntax


Argument	Explanation
`size`=`[1-100]`	`S`pecifies the percentage of memory to be tested.
`dev=``device_name`	Specifies the device to test such as `mem`.
`threshold=``report_threshold`	Determines how many correctable ECC errors occur before they are reported as an error causing `pmemtest` to report a failure. A value of zero results in no report of any correctable ECC errors. The default is 2.This option is only available on UltraSPARC systems.
`bdinfo`=`number`	For UltraSPARC servers, 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 bdinfo=33 (25+20).
`section`=`section_id`	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 will be tested.A section is defined by the pass and instance number settings. This option is only available on UltraSPARC systems.

Note -

64-bit tests are located in the sparcv9 subdirectory: /opt/SUNWvts/bin/sparcv9/testname. If a test is not present in this directory, then it may only be available as a 32-bit test. For more information refer to "32-Bit and 64-Bit Tests".

`pmemtest` Error Messages

Table 25-4 pmemtest Error Messages


	Error Message	Probable Cause(s)	Recommended Action
`6003`	`numberintermittent errors ontext.` `textwould indicate the SIMM locations`
`6004`	`Symbol` `textnot found in kernel image.` `textwill indicate the name of the symbol not found in the kernel image`
`6005`	`numberpersistent errors ontext` `SIMM(s).` `textwould indicate the SIMM locations`	SIMM(s), check the SIMM location	Call your Sun service representative.
`8000`	`kvm_open() failed:` `error_message`
`8001`	`sysinfo(SI_PLATFORM) failed:` `error_message`
`8002`	`Symbol` `textnot found in kernel image.` `textwill indicate the name of the symbol not found in the kernel image`
`8003`	`Couldn't open file /dev/mem:error_message`
`8004`	`Unable to read pointer to memlist structure`
`8005`	`Unable to read "size" and "address" in memlist`
`8006`	`llseek() to address` `addressfailed (error_message)`
`8007`	`read() at address` `addressfailed (error_message)`
`8008`	`sysconf(_SC_NPROCESSORS_ONLN) failed:error_message`
`8009`	`llseek to address` `addressfailed (error_message)`
`8010`	`llseek to address` `address` `[text] failed (error_message)`	This message is seen on UltraSPARC servers only. The `text` indicates to which board and bank the physical address maps.
`8011`	`read() at address` `address` `[text] failed (error_message)`	This message is seen on UltraSPARC servers only. The `text` indicates to which board and bank the physical address maps.

Chapter 25 Physical Memory Test (pmemtest)

pmemtest Options

Figure 25-1 pmemtest Option Menu

Figure 25-2 pmemtest UltraSPARC Server Option Menu

pmemtest Test Modes

pmemtest Command Line Syntax