xref: /aosp_15_r20/external/ltp/testcases/realtime/doc/AUTOMATED_RUN (revision 49cdfc7efb34551c7342be41a7384b9c40d7cab7)
1*49cdfc7eSAndroid Build Coastguard WorkerThis explains how the automatic testing works with profile support.
2*49cdfc7eSAndroid Build Coastguard Worker
3*49cdfc7eSAndroid Build Coastguard WorkerProfiles help users maintaining sets of tests for specific requirements.
4*49cdfc7eSAndroid Build Coastguard WorkerEach profile is defined in a file.
5*49cdfc7eSAndroid Build Coastguard WorkerAll profiles are stored in the <RT_TESTS_ROOT>/profile/ directory.
6*49cdfc7eSAndroid Build Coastguard Worker
7*49cdfc7eSAndroid Build Coastguard Worker
8*49cdfc7eSAndroid Build Coastguard WorkerI. Automated tests in specific test-diretory.
9*49cdfc7eSAndroid Build Coastguard Worker
10*49cdfc7eSAndroid Build Coastguard WorkerTests can be run for one directory by running ./run_auto.sh in the wanted dir.
11*49cdfc7eSAndroid Build Coastguard Workerrun_auto.sh is customizable and contains a command line for each test to be run.
12*49cdfc7eSAndroid Build Coastguard Worker(see template run_auto.sh.tpl in this dir)
13*49cdfc7eSAndroid Build Coastguard Workerrun_auto.sh can be invoked with an argument which is the profile to use.
14*49cdfc7eSAndroid Build Coastguard Workerprofile/ dir holds a file for each defined profile.
15*49cdfc7eSAndroid Build Coastguard WorkerA profile has a number of lines for which each test executable can be run
16*49cdfc7eSAndroid Build Coastguard Workerwith different arguments.
17*49cdfc7eSAndroid Build Coastguard WorkerInvoking run_auto.sh with no arg uses the default profile.
18*49cdfc7eSAndroid Build Coastguard WorkerCurrently, the default profile does not alter the default values defined
19*49cdfc7eSAndroid Build Coastguard Workerindividually in each test.
20*49cdfc7eSAndroid Build Coastguard Worker
21*49cdfc7eSAndroid Build Coastguard WorkerExample:
22*49cdfc7eSAndroid Build Coastguard WorkerIn dir func/prio-preempt, user runs ./run_auto.sh prf1
23*49cdfc7eSAndroid Build Coastguard WorkerSince run_auto.sh contains this line:
24*49cdfc7eSAndroid Build Coastguard Worker	$SCRIPTS_DIR/run_c_files.sh $profile prio-preempt
25*49cdfc7eSAndroid Build Coastguard Worker
26*49cdfc7eSAndroid Build Coastguard Workerrun_c_files.sh will look into profile/prf1 for lines like this:
27*49cdfc7eSAndroid Build Coastguard Worker	func/prio-preempt prio-preempt -c 2 -j
28*49cdfc7eSAndroid Build Coastguard Worker	func/prio-preempt prio-preempt -c 1
29*49cdfc7eSAndroid Build Coastguard Worker
30*49cdfc7eSAndroid Build Coastguard Workerand run the following commands from the func/prio-preempt dir:
31*49cdfc7eSAndroid Build Coastguard Worker	prio-preempt -c 2 -j
32*49cdfc7eSAndroid Build Coastguard Worker	prio-preempt -c 1
33*49cdfc7eSAndroid Build Coastguard Worker
34*49cdfc7eSAndroid Build Coastguard Worker
35*49cdfc7eSAndroid Build Coastguard Worker
36*49cdfc7eSAndroid Build Coastguard WorkerII. All automated tests
37*49cdfc7eSAndroid Build Coastguard Worker
38*49cdfc7eSAndroid Build Coastguard WorkerTests can also be run with <RT_TESTS_ROOT>/run.sh. User may choose whatever
39*49cdfc7eSAndroid Build Coastguard Workertest range he wants. (all, func, perf... see README)
40*49cdfc7eSAndroid Build Coastguard Workerrun.sh searches for run_auto.sh files in the wanted area and runs them one
41*49cdfc7eSAndroid Build Coastguard Workerby one.
42*49cdfc7eSAndroid Build Coastguard WorkerTo use a profile other than default, use argument '-p <myprofile>'.
43*49cdfc7eSAndroid Build Coastguard Worker
44*49cdfc7eSAndroid Build Coastguard WorkerExamples:
45*49cdfc7eSAndroid Build Coastguard Worker	./run.sh -p prf1 -t func	# Uses prf1 profile
46*49cdfc7eSAndroid Build Coastguard Worker	./run.sh -t func		# Uses default profile
47