blob: dc672e4081d08a70cad23d46d58937bdb0a035ca [file] [log] [blame]
alaffin198500d2000-08-21 22:18:17 +00001
2Linux Test Project
robbiew9ea3ce72001-09-18 20:38:09 +00003http://ltp.sf.net
alaffin198500d2000-08-21 22:18:17 +00004
alaffin198500d2000-08-21 22:18:17 +00005
nstraz0312c252000-09-26 20:59:21 +00006About the Linux Test Project
alaffin198500d2000-08-21 22:18:17 +00007
robbiew9ea3ce72001-09-18 20:38:09 +00008The Linux Test Project is a joint project with SGI, IBM, OSDL, and Bull with a
9goal to deliver test suites to the open source community that validate the
10reliability, robustness, and stability of Linux. The Linux Test Project is a
11collection of tools for testing the Linux kernel and related features. Our goal
12is to improve the Linux kernel by bring test automation to the kernel testing
13effort. Interested open source contributors are encouraged to join the project.
alaffin198500d2000-08-21 22:18:17 +000014
nstraz0312c252000-09-26 20:59:21 +000015
16In the Package
alaffin198500d2000-08-21 22:18:17 +000017--------------
nstraz0312c252000-09-26 20:59:21 +000018Here is a short description of what is included in this package
alaffin198500d2000-08-21 22:18:17 +000019
nstraz0312c252000-09-26 20:59:21 +000020INSTALL
21 Installation documentation and quick start guide
alaffin198500d2000-08-21 22:18:17 +000022
nstraz0312c252000-09-26 20:59:21 +000023README
24 This document
alaffin198500d2000-08-21 22:18:17 +000025
nstraz0312c252000-09-26 20:59:21 +000026CREDITS
27 Credits to those who have contributed to the project.
alaffin198500d2000-08-21 22:18:17 +000028
nstraz0312c252000-09-26 20:59:21 +000029COPYING
30 GNU Public License
alaffin198500d2000-08-21 22:18:17 +000031
nstraz0312c252000-09-26 20:59:21 +000032ChangeLog
33 An incomplete list of changes to the project. We will try harder to
34 keep this up to date.
nstrazf307d5f2000-09-14 21:54:44 +000035
nstraz0312c252000-09-26 20:59:21 +000036Makefile
37 Top level make file for LTP.
38
39runalltests.sh
40 A simple script to run all of the packaged tests in sequential order and
41 report the over all result.
42
robbiew9ea3ce72001-09-18 20:38:09 +000043diskio.sh
44 A simple script to run all the diskio tests that pertain to the CD-ROM and
45 floppy disk file systems.
46
47networktests.sh
48 A simple script to run all the network related tests that require another
49 remote machine.
50
nstraz0312c252000-09-26 20:59:21 +000051doc/*
52 Documentation for the project including man pages for some of the
robbiewca0a7de2001-09-25 18:58:43 +000053 tools & library functions, as well as descriptions of every test.
nstraz0312c252000-09-26 20:59:21 +000054
nstraz0312c252000-09-26 20:59:21 +000055
56include/*
57lib/*
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
robbiew9ea3ce72001-09-18 20:38:09 +000062testcases/*
robbiew3ebacce2001-09-19 15:38:28 +000063 Contains all tests that run under the LTP as well as the "bin" directory,
64 which has hardlinks to all the test executables.
nstraz0312c252000-09-26 20:59:21 +000065
66runtest/*
robbiew9ea3ce72001-09-18 20:38:09 +000067 It houses command lists that are used by pan for automated testing.
68
nstraz0312c252000-09-26 20:59:21 +000069pan/*
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.
alaffin198500d2000-08-21 22:18:17 +000073
74
nstraz0312c252000-09-26 20:59:21 +000075Warning!
76--------
alaffin198500d2000-08-21 22:18:17 +000077Be careful with these tests!
78
79Don't run them on production systems. Growfiles, doio, and iogen in particular
80stress the I/O capabilities of systems and while they should not cause problems
81on properly functioning systems, they are intended to find (or cause) problems.
nstraz0312c252000-09-26 20:59:21 +000082
83
84Contact Information and Updates
85-------------------------------
86
robbiew9ea3ce72001-09-18 20:38:09 +000087URL: http://ltp.sf.net
nstraz0312c252000-09-26 20:59:21 +000088
robbiew9ea3ce72001-09-18 20:38:09 +000089Questions and comments should be sent to the LTP mailing list located on the project page.
nstraz0312c252000-09-26 20:59:21 +000090