1 This file contains various information. 2 3 Please refer to http://nptl.bullopensource.org/phpBB/ for general information 4 and questions. Feel free to post your questions there. 5 6 ----------------------------------- COMPILATION ----------------------------------- 7 We are doing our best to ensure the test case will be very portable. 8 Please report any problems on the forum (see on top of this file) 9 10 11 * Flags 12 You may want to add -DVERBOSE=2 to have verbose tests, 13 or -DVERBOSE=0 to have silent tests (for batchs for example). 14 15 You may add -DWITHOUT_XOPEN to disable the XSI features 16 from the tests. Some of the tests won't work with this option. 17 18 You may want to add -DSCALABILITY_FACTOR=X, where X is an integer, 19 to change the stress programs load (default is 1). 20 21 You may want to add -DPLOT_OUTPUT if you want data for plotting. 22 23 * Commands 24 Compilation under linux: 25 gcc -o <bin> -lpthread -lm -lrt <source> 26 where <bin> is the executable you want to build and <source> is the source file. 27 28 * Execution 29 This case will possiblly run for half an hour. 30 If you want diagrams showing the result: 31 a. Add -DPLOT_OUTPUT flags when compiling 32 b. ./s-c > data 33 c. ./do-plot data 34 This script will use gnuplot to create a png file named scalable.png. 35 36 (If your gnuplot does not support png terminal, just remove 37 set term png 38 set output "scalable.png" 39 from the do-plot script). 40 41 Stress tests will run until they are killed with SIGUSR1 (or they 42 fail). Currently, I do 43 $> ./stress & 44 and then after a while 45 $> kill -USR1 <pid> 46 or 47 $> for PR in `ps o pid --no-headers -Cstress`; \ 48 do echo Sending SIGUSR1 to pid $PR...; \ 49 kill -USR1 $PR; \ 50 done; 51 Some cases will keep on executing ~ 1 minute after they receive the 52 signal; it is normal (time for stopping all threads). 53