| This file contains various information. |
| |
| Please refer to http://nptl.bullopensource.org/phpBB/ for general information |
| and questions. Feel free to post your questions there. |
| |
| |
| We are doing our best to ensure the test case will be very portable. |
| Please report any problems on the forum (see on top of this file) |
| |
| |
| * Flags |
| You may want to add -DVERBOSE=2 to have verbose tests, |
| or -DVERBOSE=0 to have silent tests (for batchs for example). |
| |
| You may add -DWITHOUT_XOPEN to disable the XSI features |
| from the tests. Some of the tests won't work with this option. |
| |
| You may want to add -DSCALABILITY_FACTOR=X, where X is an integer, |
| to change the stress programs load (default is 1). |
| |
| |
| * Commands |
| Compilation under linux: |
| gcc -o <bin> -lpthread <source> |
| where <bin> is the executable you want to build and <source> is the source file. |
| |
| Compilation under AIX5L |
| cc -o <bin> -lpthread <source> |
| same comment as above |
| |
| Compilation under Solaris 9 (gcc: http://www.sunfreeware.com) |
| gcc -std=gnu99 -lpthread -lrt -o <bin> <source> |
| same comment as above. |
| Note: the -lrt is necessary for test cases using semaphore feature. |
| |
| * Execution |
| |
| Please consider the following: |
| -> I am sizing the tests to fit on a bi-xeon IA32 machine, with 2GB RAM. |
| You can change the SCALABILITY_FACTOR value to 2 or 3 to be more |
| resources consuming on a bigger system. This will create more threads, |
| etc... according to each case. |
| |
| -> Stress tests will run until they are killed with SIGUSR1 (or they |
| fail). Currently, I do |
| $> ./stress & |
| and then after a while |
| $> kill -USR1 <pid> |
| or |
| $> for PR in `ps o pid --no-headers -Cstress`; \ |
| do echo Sending SIGUSR1 to pid $PR...; \ |
| kill -USR1 $PR; \ |
| done; |
| Some cases will keep on executing ~ 1 minute after they receive the |
| signal; it is normal (time for stopping all threads). |
| |
