====== Linux Test Project (LTP) ======

Linux Test Project is a joint project started by SGI, OSDL and Bull developed and maintained by IBM, Cisco, Fujitsu, SUSE, Red Hat, Oracle and others. The project goal is to deliver tests to the open source community that validate the reliability, robustness, and stability of Linux.

More information at https://github.com/linux-test-project/ltp/blob/master/README.

The code for realtime test cases of ltp is available at:
https://github.com/linux-test-project/ltp/tree/master/testcases/realtime

===== Installation =====
Following are the steps to quickly download ltp and build all the realtime related testcases:
<code sh>
$> git clone https://github.com/linux-test-project/ltp.git
$> cd ltp
$> make autotools
$> ./configure
$> cd testcases/realtime
$> ./configure
$> make
</code>

Detailed installation instructions can be found at https://github.com/linux-test-project/ltp/blob/master/INSTALL. 

Following is the list of real-time testcases which are currently available in LTP: 

  * ./func/hrtimer-prio
  * ./func/gtod_latency
  * ./func/prio-wake
  * ./func/thread_clock
  * ./func/pi-tests
  * ./func/prio-preempt
  * ./func/periodic_cpu_load
  * ./func/rt-migrate
  * ./func/matrix_mult
  * ./func/async_handler
  * ./func/sched_football
  * ./func/pthread_kill_latency
  * ./func/measurement
  * ./func/sched_latency
  * ./func/pi_perf
  * ./func/sched_jitter
  * ./perf/latency

Description of all the test cases: https://github.com/linux-test-project/ltp/blob/master/testcases/realtime/00_Descriptions.txt

===== Running testcases =====
To run all the test cases, just traverse to ${SRC}/testcases/realtime and run the following command as ''root'':

<WRAP center round important 100%>
Be careful with these tests!

Don't run them on production systems. Growfiles, doio, and iogen in particular
stress the I/O capabilities of systems and while they should not cause problems
on properly functioning systems, they are intended to find (or cause) problems.
(Reference: [[https://github.com/linux-test-project/ltp/blob/master/README]])
</WRAP>

<code sh>
# please make sure to include the '-l' argument even though it is specified as optional 
# because there is a bug in ltp which throughs out a syntax error if the argument is not specified.
$> ./run.sh -t all -l 1
</code>
The user can also run functional, stress and performance test by providing ''func'', ''stress'' and ''perf'' as argument to -t switch respectively.