73 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
			
		
		
	
	
			73 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
| USAGE
 | |
| 
 | |
| See the program's usage statement by invoking with --help.
 | |
| 
 | |
| NOTES
 | |
| 
 | |
| This program works really well for me, but it might not have some of the
 | |
| features that you want.  If you would like, please extend the code and send
 | |
| me the patch[1].  Enjoy the program :-)
 | |
| 
 | |
| Please use the context diff format.  That is: save the original program
 | |
| as stress.c.orig, then make and test your desired changes to stress.c, then
 | |
| run 'diff -u stress.c.orig stress.c' to produce a context patch.  Thanks.
 | |
| 
 | |
| Amos Waterland <apw@rossby.metr.ou.edu>
 | |
| Norman, Oklahoma
 | |
| 27 Nov 2001
 | |
| 
 | |
| EXAMPLES
 | |
| [examples]
 | |
| 
 | |
| The simple case is that you just want to bring the system load average up to
 | |
| an arbitrary value.  The following forks 13 processes, each of which spins
 | |
| in a tight loop calculating the sqrt() of a random number acquired with
 | |
| rand().
 | |
| 
 | |
|   % stress -c 13
 | |
| 
 | |
| Long options are supported, as well as is making the output less verbose.
 | |
| The following forks 1024 processes, and only reports error messages if any.
 | |
| 
 | |
|   % stress --quiet --hogcpu 1k
 | |
| 
 | |
| To see how your system performs when it is I/O bound, use the -i switch.
 | |
| The following forks 4 processes, each of which spins in a tight loop calling
 | |
| sync(), which is a system call that flushes memory buffers to disk.
 | |
| 
 | |
|   % stress -i 4
 | |
| 
 | |
| Multiple hogs may be combined on the same command line.  The following does
 | |
| everything the preceding examples did in one command, but also turns up the
 | |
| verbosity level as well as showing how to cause the command to
 | |
| self-terminate after 1 minute.
 | |
| 
 | |
|   % stress -c 13 -i 4 --verbose --timeout 1m
 | |
| 
 | |
| An value of 0 normally denotes infinity.  The following is how to do a fork
 | |
| bomb (be careful with this).
 | |
| 
 | |
|   % stress -c 0
 | |
| 
 | |
| For the -m and -d options, a value of 0 means to redo their operation an
 | |
| infinite number of times.  To allocate and free 128MB in a redo loop use the
 | |
| following command.  This can be useful for "bouncing" against the system RAM
 | |
| ceiling.
 | |
| 
 | |
|   % stress -m 0 --hogvm-bytes 128M
 | |
| 
 | |
| For the -m and -d options, a negative value of n means to redo the operation
 | |
| abs(n) times.  Here is now to allocate and free 5MB three times in a row.
 | |
| 
 | |
|   % stress -m -3 --hogvm-bytes 5m
 | |
| 
 | |
| You can write a file of arbitrary length to disk.  The file is created with
 | |
| mkstemp() in the current directory, the default is to unlink it, but
 | |
| unlinking can be overridden with the --hoghdd-noclean flag.
 | |
| 
 | |
|   % stress -d 1 --hoghdd-noclean --hoghdd-bytes 13
 | |
| 
 | |
| Large file support is enabled.
 | |
| 
 | |
|   % stress -d 1 --hoghdd-noclean --hoghdd-bytes 3G
 |