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