.\" SCCSID: @(#)memx.8	8.1	9/11/90.TH memx 8 .SH Namememx \- memory exerciser.SH Syntax.B /usr/field/memx[.B \-h] [.B \-s] [.BI \-o file.B ] [.BI \-t i.B ] [.BI \-m j.B ] [.BI \-p k.B ] .SH Description.NXR "memx exerciser".NXR "memory" "testing"The .PN memx memory exerciser spawns processes to exercise memoryby writing and reading three patterns: 1's and 0's, 0's and 1's,and a random pattern..PPYou specify the number of processes to spawn and the size of memory to be tested by each process. The first process is a shared memoryexerciser, the remaining are standard memoryexercisers. The .PN memxexerciserwill run until the processreceives a.CT Cor a kill \-15 \fIpid\fR..PPA logfile is made in .PN /usr/fieldfor you to examine and then remove. If there are errorsin the logfile, check the .PN /usr/adm/syserr/syserr.<hostname> file, where the driver and kernel errormessages are saved..SH Options.NXR "memx" "options"The.PN memxoptions are:.IP \fB\-h\fR 1iPrint the help message for the.PN memxcommand..IP \fB\-s\fR 1iDisable shared memory testing..IP \fB\-o\fIfile\fR 1iSave diagnostic output in \fIfile\fR..IP \fB\-t\fIi\fR 1iRun time in minutes (\fIi\fR).  The default is to run untilthe process receives a.CT C or a kill \-15 \fIpid\fR..IP \fB\-m\fIj\fR 1iThe memory size in bytes (\fIj\fR) to be tested by each spawnedprocess.  Must be greater than 4095.  The default is(total-memory)/20..IP \fB\-p\fIk\fR 1iThe number of processes to spawn (\fIk\fR).  The default is 20.The maximum is also 20..SH Restrictions.NXR "memx exerciser" "restricted"The .PN memx exerciser is restricted by the sizeof swap space available.  The size of the swap space andthe size of internal memory available will determine howmany processes can run on the system.  For example,If there were 16Mbytesof swap space and 16Mbytes of memory, all of theswap space would be used if all 20 spawned memory exerciserswere running.  In that event, no new processes would be able to run.On systems with large amounts of memory and small swapspace, you must restrict the number of memory exercisers and/or thesize of memory being tested..PPIf there is a need to run a system exerciser over an NFS link or on a disklesssystem there are some restrictions.  For exercisers that need to write into a filesystem, such as .MS fsx 8 ,the target file system must be writable by root.  Also the directory, in which anyof the exercisers are executed, must be writable by root because temporaryfiles are written into the current directory.  These latter restrictions aresometimes difficult to overcome because often NFS file systems are mounted in away that prevents root from writing into them.  Some of the restrictions may beovercome by copying the exerciser to another directory and then executing it.  .SH Examples.NXR "memx exerciser" "examples"The following example tests all of memory by running 20spawned processes until a.CT Cor kill \-15 \fIpid\fR is received..EX% /usr/field/memx .EEThe following example runs 10 spawned processes, memory size 500,000bytes, for 180 minutes in the background..EX% /usr/field/memx \-t180 \-m500000 \-p10 &.EE.SH See Also.I "Guide to System Exercisers"