Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ltp / 5345539886205d06457cca45ff8a5fea4f02989f / . / README
blob: 1f3f466302bafda3ed9e23c6d0b991657bc1382a [file] [log] [blame]
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]1
2Linux Test Project
robbiew6f3a9f32002-06-07 18:21:19 +0000[diff] [blame]3
4
5The latest image is always available at http://ltp.sf.net
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]6
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]7
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]8About the Linux Test Project
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]9
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]10The Linux Test Project is a joint project with SGI, IBM, OSDL, and Bull with a
11goal to deliver test suites to the open source community that validate the
12reliability, robustness, and stability of Linux. The Linux Test Project is a
13collection of tools for testing the Linux kernel and related features. Our goal
14is to improve the Linux kernel by bring test automation to the kernel testing
15effort. Interested open source contributors are encouraged to join the project.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]16
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]17
18In the Package
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]19--------------
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]20Here is a short description of what is included in this package
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]21
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]22INSTALL
23 Installation documentation and quick start guide
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]24
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]25README
26 This document
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]27
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]28CREDITS
29 Credits to those who have contributed to the project.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]30
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]31COPYING
32 GNU Public License
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]33
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]34ChangeLog
35 An incomplete list of changes to the project. We will try harder to
36 keep this up to date.
nstrazf307d5f2000-09-14 21:54:44 +0000[diff] [blame]37
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]38Makefile
39 Top level make file for LTP.
40
41runalltests.sh
42 A simple script to run all of the packaged tests in sequential order and
43 report the over all result.
44
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]45diskio.sh
nstrazd226d9d2002-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.
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]48
49networktests.sh
nstrazd226d9d2002-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.
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]52
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]53doc/*
54 Documentation for the project including man pages for some of the
robbiewca0a7de2001-09-25 18:58:43 +0000[diff] [blame]55 tools & library functions, as well as descriptions of every test.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]56
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]57
58include/*
59lib/*
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
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]64testcases/*
nstrazd226d9d2002-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.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]67
68runtest/*
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]69 It houses command lists that are used by pan for automated testing.
70
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]71pan/*
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.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]75
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]76scratch/*
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.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]80
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]81Warning!
82--------
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]83Be careful with these tests!
84
85Don't run them on production systems. Growfiles, doio, and iogen in particular
86stress the I/O capabilities of systems and while they should not cause problems
87on properly functioning systems, they are intended to find (or cause) problems.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]88
89
90Contact Information and Updates
91-------------------------------
92
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]93URL: http://ltp.sf.net
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]94
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]95Questions and comments should be sent to the LTP mailing list located on the
96project page.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]97