blob: 3bb3ff976d24c334ca1bb99f6494c68ced061961 [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 Hrubis1a1339d2014-02-12 19:25:10 +010016The latest image is always available at http://sf.net/projects/ltp/
nstraz0312c252000-09-26 20:59:21 +000017
Cyril Hrubisf4289d62014-02-26 18:50:10 +010018The discussion about the project happens at ltp-list mailing list:
19https://lists.sourceforge.net/lists/listinfo/ltp-list
alaffin198500d2000-08-21 22:18:17 +000020
Cyril Hrubisf4289d62014-02-26 18:50:10 +010021The git repository is located at GitHub at:
22https://github.com/linux-test-project/ltp
subrata_modak0c5f9702007-04-26 11:02:47 +000023
nstraz0312c252000-09-26 20:59:21 +000024Warning!
25--------
alaffin198500d2000-08-21 22:18:17 +000026Be careful with these tests!
27
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010028Don't run them on production systems. Growfiles, doio, and iogen in particular
alaffin198500d2000-08-21 22:18:17 +000029stress the I/O capabilities of systems and while they should not cause problems
30on properly functioning systems, they are intended to find (or cause) problems.
nstraz0312c252000-09-26 20:59:21 +000031
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010032Developers corner
33-----------------
nstraz0312c252000-09-26 20:59:21 +000034
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010035Before you start you should read following documents:
nstraz0312c252000-09-26 20:59:21 +000036
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010037* doc/test-writing-guidelines.txt
38* doc/build-system-guide.txt
nstraz0312c252000-09-26 20:59:21 +000039
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010040these two should contain all information needed for modifying or creating LTP
41testcases. If something is not covered there don't hesitate to ask on the LTP
42mailing list.
nstraz0312c252000-09-26 20:59:21 +000043
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010044Also note that these documents are available online at:
subrata_modak23f869f2007-04-09 12:03:49 +000045
Cyril Hrubis1a1339d2014-02-12 19:25:10 +010046https://github.com/linux-test-project/ltp/wiki/Test-Writing-Guidelines
47https://github.com/linux-test-project/ltp/wiki/BuildSystem