| alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 1 | |
| 2 | Linux Test Project |
| nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 3 | http://oss.sgi.com/projects/ltp/ |
| 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 | |
| nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 8 | The Linux Test Project aims to develop a set of tools and tests to verify the |
| 9 | functionality and stability of the Linux kernel. We hope this will support |
| 10 | Linux development by making unit testing more complete and minimizing user |
| 11 | impact by building a barrier to keep bugs from making it to the user. The main |
| 12 | goal of the project is regression and functional testing, but there are many |
| 13 | ways this project can grow. |
| 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 | |
| 43 | doc/* |
| 44 | Documentation for the project including man pages for some of the |
| 45 | tools and library functions. |
| 46 | |
| 47 | doio/* |
| 48 | The doio directory contains three tools: doio, iogen, and growfiles. |
| 49 | These are elaborate filesystem tests for stressing and testing the |
| 50 | functionality of the filesystem. There is also a wrapper for doio |
| 51 | and iogen called rwtest. Command examples for these tools can be |
| 52 | found in runtest/fs. |
| 53 | |
| 54 | include/* |
| 55 | lib/* |
| 56 | The include and lib directories contain headers and codes for common |
| 57 | routines used by many of the tests. We have tried to keep this to a |
| 58 | minimum. |
| 59 | |
| 60 | tests/* |
| 61 | To date the tests directory contains a number of simple tests called |
| 62 | 'quickhitters'. These tests are designed to be simple and quick and |
| 63 | be run in conjunction with each other. They have some use as stand |
| 64 | alone tests, but when run many-at-a-time, interesting issues can come |
| 65 | up. |
| 66 | |
| 67 | runtest/* |
| 68 | This directory should be removed. Currently it houses command lists that |
| 69 | are used by pan for automated testing. |
| 70 | pan/* |
| 71 | The pan directory contains a simple, lightweight test harness. pan |
| 72 | has the ability to run tests randomly and in parallel. See pan's man |
| 73 | page for more information. |
| alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 74 | |
| 75 | |
| nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 76 | Warning! |
| 77 | -------- |
| alaffin | 198500d | 2000-08-21 22:18:17 +0000 | [diff] [blame] | 78 | Be careful with these tests! |
| 79 | |
| 80 | Don't run them on production systems. Growfiles, doio, and iogen in particular |
| 81 | stress the I/O capabilities of systems and while they should not cause problems |
| 82 | on properly functioning systems, they are intended to find (or cause) problems. |
| nstraz | 0312c25 | 2000-09-26 20:59:21 +0000 | [diff] [blame] | 83 | |
| 84 | |
| 85 | Contact Information and Updates |
| 86 | ------------------------------- |
| 87 | |
| 88 | URL: http://oss.sgi.com/projects/ltp/ |
| 89 | email: owners-ltp@oss.sgi.com |
| 90 | |
| 91 | Questions and comments should be sent to the LTP mailing list at |
| 92 | ltp@oss.sgi.com. To subscribe, send mail to majordomo@oss.sgi.com with |
| 93 | "subscribe ltp" in the body of the message. |
| 94 | |
| 95 | A list archive is available at http://oss.sgi.com/projects/ltp/mail-threaded/ |