memtest used to assume megabytes if no letter was supplied. It now exits instead.
If memtest cannot allocate the amount of memory specified, it will keep trying with smaller amounts until it succeeds.
If the option -l (or --log) is given, memtest will log to the file memtest.log in addition to stderr. Any previous log will be overwritten. If memtest fails to open its logfile it will abort.
memtest will attempt to lock its pages into memory to increase the chances of testing a greater percentage of physical memory. This typically requires the program to be run as root. If it cannot lock its pages into memory due to a lack of permissions, it will issue a warning and continue with unlocked pages. If it fails to lock pages because there are insufficient pages of memory available to be locked, it will reduce its allocation and try again.
Note that if memtest runs with unlocked pages, it may start swapping. Since memtest spends virtually all of its time accessing memory, this will slow down its operation by several orders of magnitude. The best way to run memtest is to use the largest value of memory to test which will allow it to lock its pages into memory.
-1 if it encounters an error and cannot run.
Test 16MB of memory, run all tests twice, and log only to stderr.
Test 2GB of memory, run until interrupted, and log to stderr and memtest.log.
Test 1GB of memory, run all tests four times, and log to stderr and memtest.log.
Testing memory can be slow. Sample testing times for one complete run of
tests follow. If you have other examples, please send them to me.
Successfully allocated 4194304 bytes. Aligning memory...settling on 4190208 bytes at 0x400b7000... Proceeding to lock pages...success. Starting tests...
memtest typically tests a slightly smaller amount of memory than is specified on the commandline. This is because it aligns its memory allocation to a page boundary before attempting to lock its pages into memory. This is a requirement on some Unix systems. With very small allocations of memory (typically only used during debugging of memtest), it may fail to align to a page boundary with a message similar to this:
Aligning memory...allocation too small to align to pagesize of 4096 bytes. Failed to get sufficient memory. Exiting...
If not run as root, the memlock will fail as follows:
Proceeding to lock pages...mlock failed: only root can lock pages. Continuing with unlocked pages. Results are less reliable.
Then, as the program runs through tests, it prints the current `run' (cycle of tests) and test number and name. It also prints status information on the progress of the tests. This will look like the following:
Run 1:
Test 1: Random value: Setting...Testing...Passed.
Test 2: XOR comparison: Setting...Testing...Passed.
If one of the tests finds an error in memory, a message like the following will be printed:
FAILURE: 0x5aa0f5c5 != 0x5aa0f585 at offset 0x0067f837. Skipping to next test...
If the Stuck Address test finds a failure, it outputs a slightly different message, to remind the user that other tests are unreliable if an addressing problem exists:
FAILURE: possible bad address line at offset 0x004563f3.
At the end of each `run' it will print a summary of that run as follows:
Run 1 completed in 114 seconds (2 tests showed errors).
When the program completes (is interrupted by a signal, or finishes its last run, when a limit is specified on the commandline), it will print an overall summary:
2 runs completed. 2 errors detected. Total runtime: 235 seconds. Exiting...
If your problem is that memtest won't compile, please include some information about your system (basic hardware type, operating system type and version) and a log of the output of `make clean; make all'.
If memtest builds and runs, but you feel it does not run properly, please include the output log from memtest generated by the --log option.