alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 1 | |
| 2 | Linux Test Project |
robbiew | 6f3a9f3 | 2002-06-07 18:21:19 +0000 | [diff] [blame] | 3 | |
| 4 | |
| 5 | The latest image is always available at http://ltp.sf.net |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 6 | |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 7 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 8 | About the Linux Test Project |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 9 | |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 10 | The Linux Test Project is a joint project with SGI, IBM, OSDL, and Bull with a |
| 11 | goal to deliver test suites to the open source community that validate the |
| 12 | reliability, robustness, and stability of Linux. The Linux Test Project is a |
| 13 | collection of tools for testing the Linux kernel and related features. Our goal |
| 14 | is to improve the Linux kernel by bring test automation to the kernel testing |
| 15 | effort. Interested open source contributors are encouraged to join the project. |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 16 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 17 | |
| 18 | In the Package |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 19 | -------------- |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 20 | Here is a short description of what is included in this package |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 21 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 22 | INSTALL |
| 23 | Installation documentation and quick start guide |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 24 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 25 | README |
| 26 | This document |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 27 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 28 | CREDITS |
| 29 | Credits to those who have contributed to the project. |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 30 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 31 | COPYING |
| 32 | GNU Public License |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 33 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 34 | ChangeLog |
| 35 | An incomplete list of changes to the project. We will try harder to |
| 36 | keep this up to date. |
nstraz | f307d5f | 2000-09-14 21:54:44 +0000 | [diff] [blame] | 37 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 38 | Makefile |
| 39 | Top level make file for LTP. |
| 40 | |
| 41 | runalltests.sh |
| 42 | A simple script to run all of the packaged tests in sequential order and |
| 43 | report the over all result. |
| 44 | |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 45 | diskio.sh |
nstraz | d226d9d | 2002-01-09 23:03:50 +0000 | [diff] [blame] | 46 | A simple script to run all the diskio tests that pertain to the CD-ROM |
| 47 | and floppy disk file systems. |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 48 | |
| 49 | networktests.sh |
nstraz | d226d9d | 2002-01-09 23:03:50 +0000 | [diff] [blame] | 50 | A simple script to run all the network related tests that require |
| 51 | another remote machine. |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 52 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 53 | doc/* |
| 54 | Documentation for the project including man pages for some of the |
robbiew | ca0a7de | 2001-09-25 18:58:43 +0000 | [diff] [blame] | 55 | tools & library functions, as well as descriptions of every test. |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 56 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 57 | |
| 58 | include/* |
| 59 | lib/* |
| 60 | The include and lib directories contain headers and codes for common |
| 61 | routines used by many of the tests. We have tried to keep this to a |
| 62 | minimum. |
| 63 | |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 64 | testcases/* |
nstraz | d226d9d | 2002-01-09 23:03:50 +0000 | [diff] [blame] | 65 | Contains all tests that run under the LTP as well as the "bin" |
| 66 | directory, which has hardlinks to all the test executables. |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 67 | |
| 68 | runtest/* |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 69 | It houses command lists that are used by pan for automated testing. |
| 70 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 71 | pan/* |
| 72 | The pan directory contains a simple, lightweight test harness. pan |
| 73 | has the ability to run tests randomly and in parallel. See pan's man |
| 74 | page for more information. |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 75 | |
nstraz | d226d9d | 2002-01-09 23:03:50 +0000 | [diff] [blame] | 76 | scratch/* |
| 77 | The scratch directory is a dumping ground for snippets and test cases |
| 78 | that we found but haven't integrated into LTP yet. Feel free to suggest |
| 79 | new snippets to be added, or take one of these and finish it off. |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 80 | |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 81 | Warning! |
| 82 | -------- |
alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 83 | Be careful with these tests! |
| 84 | |
| 85 | Don't run them on production systems. Growfiles, doio, and iogen in particular |
| 86 | stress the I/O capabilities of systems and while they should not cause problems |
| 87 | on properly functioning systems, they are intended to find (or cause) problems. |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 88 | |
| 89 | |
| 90 | Contact Information and Updates |
| 91 | ------------------------------- |
| 92 | |
robbiew | 9ea3ce7 | 2001-09-18 20:38:09 +0000 | [diff] [blame] | 93 | URL: http://ltp.sf.net |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 94 | |
nstraz | d226d9d | 2002-01-09 23:03:50 +0000 | [diff] [blame] | 95 | Questions and comments should be sent to the LTP mailing list located on the |
| 96 | project page. |
nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 97 | |