Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / ltp / 7dd48f3ef716443c6379b1531c069b99b3da7857 / . / README
blob: fbebfecbf61bba5401ba2af167748664e51dd916 [file] [log] [blame]
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]1Linux Test Project
subrata_modak7509b212008-08-27 13:36:52 +0000[diff] [blame]2(Maintained by: Subrata Modak<subrata@linux.vnet.ibm.com>)
robbiew6f3a9f32002-06-07 18:21:19 +0000[diff] [blame]3
4The latest image is always available at http://ltp.sf.net
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]5
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]6
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]7About the Linux Test Project
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]8
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]9The Linux Test Project is a joint project with SGI, IBM, OSDL, and Bull with a
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]10goal to deliver test suites to the open source community that validate the
11reliability, robustness, and stability of Linux. The Linux Test Project is a
12collection of tools for testing the Linux kernel and related features. Our goal
13is to improve the Linux kernel by bringing test automation to the kernel testing
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]14effort. Interested open source contributors are encouraged to join the project.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]15
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]16
17In the Package
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]18--------------
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]19Here is a short description of what is included in this package
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]20
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]21INSTALL
22 Installation documentation and quick start guide
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]23
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]24README
25 This document
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]26
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]27CREDITS
28 Credits to those who have contributed to the project.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]29
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]30COPYING
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]31 GNU General Public License
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]32
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]33ChangeLog
34 An incomplete list of changes to the project. We will try harder to
35 keep this up to date.
nstrazf307d5f2000-09-14 21:54:44 +0000[diff] [blame]36
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]37Makefile
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]38 Top level make file for LTP.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]39
40runalltests.sh
41 A simple script to run all of the packaged tests in sequential order and
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]42 report the overall result.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]43
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]44diskio.sh
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]45 A simple script to run all the diskio tests that pertain to the CD-ROM
46 and floppy disk file systems.
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]47
48networktests.sh
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]49 A simple script to run all the network related tests that require
50 another remote machine.
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]51
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]52doc/*
53 Documentation for the project including man pages for some of the
robbiewca0a7de2001-09-25 18:58:43 +0000[diff] [blame]54 tools & library functions, as well as descriptions of every test.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]55
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]56
57include/*
58lib/*
59 The include and lib directories contain headers and codes for common
60 routines used by many of the tests. We have tried to keep this to a
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]61 minimum.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]62
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]63testcases/*
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]64 Contains all tests that run under the LTP as well as the "bin"
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]65 directory, which has hardlinks to all the test executables.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]66
67runtest/*
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]68 It houses command lists that are used by pan for automated testing.
69
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]70pan/*
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.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]74
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]75scratch/*
76 The scratch directory is a dumping ground for snippets and test cases
77 that we found but haven't integrated into LTP yet. Feel free to suggest
78 new snippets to be added, or take one of these and finish it off.
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]79
subrata_modak0c5f9702007-04-26 11:02:47 +0000[diff] [blame]80testcases/kernel/containers/*
subrata_modak8cd73052007-06-22 10:28:26 +0000[diff] [blame]81 Contains all the testcases related to container functionality ( e.g: sysvipc, utsname etc..)
subrata_modak0c5f9702007-04-26 11:02:47 +0000[diff] [blame]82 For further information on the each of the container functionality refer
83 the following file: testcases/kernel/containers/README
84
85
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]86Warning!
87--------
alaffin198500d2000-08-21 22:18:17 +0000[diff] [blame]88Be careful with these tests!
89
90Don't run them on production systems. Growfiles, doio, and iogen in particular
91stress the I/O capabilities of systems and while they should not cause problems
92on properly functioning systems, they are intended to find (or cause) problems.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]93
94
95Contact Information and Updates
96-------------------------------
97
robbiew9ea3ce72001-09-18 20:38:09 +0000[diff] [blame]98URL: http://ltp.sf.net
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]99
nstrazd226d9d2002-01-09 23:03:50 +0000[diff] [blame]100Questions and comments should be sent to the LTP mailing list located on the
robbiew0eea3522004-02-05 17:33:10 +0000[diff] [blame]101project page.
nstraz0312c252000-09-26 20:59:21 +0000[diff] [blame]102
subrata_modak23f869f2007-04-09 12:03:49 +0000[diff] [blame]103Using KDUMP test automation suite
104---------------------------------
subrata_modak23f869f2007-04-09 12:03:49 +0000[diff] [blame]105For more information on how to use the kdump test automation suite please refer
106to file testcases/kdump/README.
107
subrata_modak9b555d12007-08-24 09:41:59 +0000[diff] [blame]108Using NUMA test automation suite
109---------------------------------
110For more information on how to use the 'numa' test automation suite please refer
111to file testcases/kernel/numa/README.
112