chiark - git - ian - stressapptest/blob - stressapptest.1

   1 .TH STRESSAPPTEST 1 2009-10-20
   2 .SH NAME
   3 stressapptest \- stress test application for simulating high load situations
   4 .SH SYNOPSIS
   5 .B stressapptest
   6 .RI [ options ]
   7 .SH DESCRIPTION
   8 This manual page documents briefly the
   9 .B stressapptest
  10 command.
  11 .PP
  12 \fBstressapptest\fP (unix name for Stressful Application Test) is a program that
  13 tries to maximize randomized traffic to memory from processor and I/O, with the
  14 intent of creating a realistic high load situation in order to test the existing
  15 hardware devices in a computer.
  16 .SH OPTIONS
  17 This program supports the following options:
  18
  19 .TP
  20 .B \-A
  21 Run in degraded mode on incompatible systems.
  22
  23 .TP
  24 .B \-C <threads>
  25 Number of memory CPU stress threads to run.
  26
  27 .TP
  28 .B \-d <device>
  29 Add a direct write disk thread with block device (or file) 'device'.
  30
  31 .TP
  32 .B \-f <filename>
  33 Add a disk thread with tempfile 'filename'.
  34
  35 .TP
  36 .B \-F
  37 Don't result check each transaction.
  38
  39 .TP
  40 .B \-i <threads>
  41 Number of memory invert threads to run.
  42
  43 .TP
  44 .B \-l <logfile>
  45 Log output to file 'logfile'.
  46
  47 .TP
  48 .B \-m <threads>
  49 Number of memory copy threads to run.
  50
  51 .TP
  52 .B \-M <mbytes>
  53 Megabytes of RAM to test.
  54
  55 .TP
  56 .B \-n <ipaddr>
  57 Add a network thread connecting to system at 'ipaddr'.
  58
  59 .TP
  60 .B \-p <pagesize>
  61 Size in bytes of memory chunks.
  62
  63 .TP
  64 .B \-s <seconds>
  65 Number of seconds to run.
  66
  67 .TP
  68 .B \-v <level>
  69 Verbosity (0-20), default is 8.
  70
  71 .TP
  72 .B \-W
  73 Use more CPU-stressful memory copy.
  74
  75 .TP
  76 .B \-\-blocks\-per\-segment <number>
  77 Number of blocks to read/write per segment per iteration (\-d).
  78
  79 .TP
  80 .B \-\-cache\-size <size>
  81 Size of disk cache (\-d).
  82
  83 .TP
  84 .B \-\-cc_inc_count <number>
  85 Number of times to increment the cacheline's member.
  86
  87 .TP
  88 .B \-\-cc_line_count <number>
  89 Number of cache line sized datastructures to allocate for the cache coherency
  90 threads to operate.
  91
  92 .TP
  93 .B \-\-cc_line_size <number>
  94 Size of cache line to use as the basis for cache coherency test data
  95 structures.
  96
  97 .TP
  98 .B \-\-cc_test
  99 Do the cache coherency testing.
 100
 101 .TP
 102 .B \-\-destructive
 103 Write/wipe disk partition (\-d).
 104
 105 .TP
 106 .B \-\-filesize <size>
 107 Size of disk IO tempfiles.
 108
 109 .TP
 110 .B \-\-findfiles
 111 Find locations to do disk IO automatically.
 112
 113 .TP
 114 .B \-\-force_errors
 115 Inject false errors to test error handling.
 116
 117 .TP
 118 .B \-\-force_errors_like_crazy
 119 Inject a lot of false errors to test error handling.
 120
 121 .TP
 122 .B \-\-listen
 123 Run threads that listen for incoming net connections.
 124
 125 .TP
 126 .B \-\-local_numa
 127 Choose memory regions associated with each CPU to be tested by that CPU.
 128
 129 .TP
 130 .B \-\-max_errors <number>
 131 Exit early after finding specified number of errors.
 132
 133 .TP
 134 .B \-\-monitor_mode
 135 Only do ECC error polling, no stress load.
 136
 137 .TP
 138 .B \-\-no_errors
 139 Run without checking for ECC or other errors.
 140
 141 .TP
 142 .B \-\-paddr_base <address>
 143 Allocate memory starting from this address.
 144
 145 .TP
 146 .B \-\-pause_delay <seconds>
 147 Delay (in seconds) between power spikes.
 148
 149 .TP
 150 .B \-\-pause_duration <seconds>
 151 Duration (in seconds) of each pause.
 152
 153 .TP
 154 .B \-\-random-threads <number>
 155 Number of random threads for each disk write thread (\-d).
 156
 157 .TP
 158 .B \-\-read-block-size <size>
 159 Size of block for reading (\-d).
 160
 161 .TP
 162 .B \-\-read-threshold <time>
 163 Maximum time (in us) a block read should take (\-d).
 164
 165 .TP
 166 .B \-\-remote_numa <time>
 167 Choose memory regions not associated with each CPU to be tested by that CPU.
 168
 169 .TP
 170 .B \-\-segment-size <size>
 171 Size of segments to split disk into (\-d).
 172
 173 .TP
 174 .B \-\-stop_on_errors
 175 Stop after finding the first error.
 176
 177 .TP
 178 .B \-\-write-block-size <size>
 179 Size of block for writing (\-d). If not defined, the size of block for writing
 180 will be defined as the size of block for reading.
 181
 182 .TP
 183 .B \-\-write-threshold <time>
 184 Maximum time (in us) a block write should take (\-d).
 185
 186 .SH SEE ALSO
 187 .BR http://code.google.com/p/stressapptest/
 188 .SH AUTHOR
 189 stressapptest was written by Nick Sanders and Rapahel Menderico (Google Inc).
 190 .PP
 191 This manual page was written by Michael Prokop <mika@debian.org>
 192 for the Debian project (and may be used by others).