blob: bf0061c4113122b8e0f7c698b7c7b1d00778c631 [file] [log] [blame]
alaffin198500d2000-08-21 22:18:17 +00001Linux Test Project
Cyril Hrubis1a1339d2014-02-12 19:25:10 +01002------------------
robbiew6f3a9f32002-06-07 18:21:19 +00003
Cyril Hrubis1a1339d2014-02-12 19:25:10 +01004Linux Test Project is a joint project started by SGI, OSDL and Bull developed
Cyril Hrubisf4289d62014-02-26 18:50:10 +01005and maintained by IBM, Cisco, Fujitsu, SUSE, Red Hat, Oracle and others. The
6project goal is to deliver tests to the open source community that validate the
Cyril Hrubis1a1339d2014-02-12 19:25:10 +01007reliability, robustness, and stability of Linux.
alaffin198500d2000-08-21 22:18:17 +00008
Cyril Hrubis1a1339d2014-02-12 19:25:10 +01009The LTP testsuite contains a collection of tools for testing the Linux kernel
10and related features. Our goal is to improve the Linux kernel and system
11libraries by bringing test automation to the testing effort. Interested open
Cyril Hrubisf4289d62014-02-26 18:50:10 +010012source contributors are encouraged to join.
alaffin198500d2000-08-21 22:18:17 +000013
Cyril Hrubisf4289d62014-02-26 18:50:10 +010014Project pages are located at: http://linux-test-project.github.io/
alaffin198500d2000-08-21 22:18:17 +000015
Cyril Hrubisdc900452015-10-22 14:17:26 +020016The latest image is always available at:
17https://github.com/linux-test-project/ltp/releases
nstraz0312c252000-09-26 20:59:21 +000018
Cyril Hrubis70d7e8c2015-09-15 12:50:31 +020019The discussion about the project happens at ltp mailing list:
20http://lists.linux.it/listinfo/ltp
alaffin198500d2000-08-21 22:18:17 +000021
Cyril Hrubisf4289d62014-02-26 18:50:10 +010022The git repository is located at GitHub at:
23https://github.com/linux-test-project/ltp
subrata_modak0c5f9702007-04-26 11:02:47 +000024
nstraz0312c252000-09-26 20:59:21 +000025Warning!
26--------
alaffin198500d2000-08-21 22:18:17 +000027Be careful with these tests!
28
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010029Don't run them on production systems. Growfiles, doio, and iogen in particular
alaffin198500d2000-08-21 22:18:17 +000030stress the I/O capabilities of systems and while they should not cause problems
31on properly functioning systems, they are intended to find (or cause) problems.
nstraz0312c252000-09-26 20:59:21 +000032
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010033Developers corner
34-----------------
nstraz0312c252000-09-26 20:59:21 +000035
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010036Before you start you should read following documents:
nstraz0312c252000-09-26 20:59:21 +000037
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010038* doc/test-writing-guidelines.txt
39* doc/build-system-guide.txt
nstraz0312c252000-09-26 20:59:21 +000040
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010041these two should contain all information needed for modifying or creating LTP
42testcases. If something is not covered there don't hesitate to ask on the LTP
43mailing list.
nstraz0312c252000-09-26 20:59:21 +000044
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010045Also note that these documents are available online at:
subrata_modak23f869f2007-04-09 12:03:49 +000046
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010047https://github.com/linux-test-project/ltp/wiki/Test-Writing-Guidelines
48https://github.com/linux-test-project/ltp/wiki/BuildSystem