.TH memtester "8" "November 2007" "memtester 4" "Maintenance Commands".SH NAMEmemtester \- stress test to find memory subsystem faults..SH SYNOPSIS.B memtester<\fIMEMORY\fR>[\fIITERATIONS\fR].SH DESCRIPTION.\" Add any additional description here.PPmemtester is an effective userspace tester for stress-testing the memorysubsystem.  It is very effective at finding intermittent and non-deterministicfaults.  Note that problems in other hardware areas (overheating CPU, out-of-specification power supply, etc.) can cause memory faults..PPmemtester will malloc(3) the amount of memory specified, if possible.  Ifthis fails, it will decrease the amount of memory requested until it succeeds.It will then attempt to mlock(3) this memory; if it cannot do so, testingwill be slower and less effective..PPNote that the maximum amount of memory that memtester can test will be lessthan the total amount of memory installed in the system; the operating system,libraries, and other system limits take some of the available memory.memtester is also limited to the amount of memory available to a singleprocess; for example, on 32-bit machines with more than 4GB of memory,memtester is still limited to less than 4GB..PP.SH OPTIONS.TP\fIMEMORY\fRthe amount of memory to allocate and test, in megabytes.TP\fIITERATIONS\fR(optional) number of loops to iterate through.  Default is infinite..SH NOTE.PPmemtester must be run with root privileges to mlock(3) its pages.  Testingmemory without locking the pages in place is mostly pointless and slow..SH EXIT CODE.PPmemtester's exit code is 0 when everything works properly.  Otherwise,it is the logical OR of the following values:.TP\f0x01error allocating or locking memory, or invocation error.TP\f0x02error during stuck address test.TP\f0x04error during one of the other tests.SH AUTHORWritten by Charles Cazabon..SH "REPORTING BUGS"Report bugs to <charlesc-memtester-bugs@pyropus.ca>..PP.SH COPYRIGHTCopyright \(co 2007 Charles Cazabon.brThis is free software; see the file COPYING for copying conditions.  There is NOwarranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.