|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | - | - |
| android/ | | 03-May-2024 | - | 9,371 | 7,420 |
| doc/ | | 03-May-2024 | - | 7,750 | 5,650 |
| include/ | | 03-May-2024 | - | 14,887 | 9,384 |
| lib/ | | 03-May-2024 | - | 15,440 | 9,825 |
| m4/ | | 03-May-2024 | - | 2,101 | 1,887 |
| pan/ | | 03-May-2024 | - | 5,402 | 3,353 |
| runtest/ | | 03-May-2024 | - | 5,310 | 4,697 |
| scenario_groups/ | | 03-May-2024 | - | 126 | 92 |
| scripts/ | | 03-May-2024 | - | 543 | 266 |
| testcases/ | | 03-May-2024 | - | 856,257 | 540,095 |
| testscripts/ | | 03-May-2024 | - | 3,242 | 2,108 |
| tools/ | | 03-May-2024 | - | 2,926 | 2,090 |
| travis/ | | 03-May-2024 | - | 198 | 153 |
| utils/ | | 03-May-2024 | - | 33,181 | 22,834 |
| .gitignore | D | 03-May-2024 | 1.2 KiB | 85 | 77 |
| .travis.yml | D | 03-May-2024 | 2.1 KiB | 78 | 61 |
| Android.bp | D | 03-May-2024 | 2.7 KiB | 97 | 85 |
| Android.mk | D | 03-May-2024 | 642 | 18 | 1 |
| COPYING | D | 03-May-2024 | 17.7 KiB | 340 | 281 |
| IDcheck.sh | D | 03-May-2024 | 4.8 KiB | 190 | 129 |
| INSTALL | D | 03-May-2024 | 11.8 KiB | 322 | 247 |
| MODULE_LICENSE_GPL | D | 03-May-2024 | 0 | | |
| Makefile | D | 03-May-2024 | 7.3 KiB | 223 | 119 |
| Makefile.release | D | 03-May-2024 | 1.4 KiB | 47 | 13 |
| NOTICE | D | 03-May-2024 | 17.7 KiB | 340 | 281 |
| OWNERS | D | 03-May-2024 | 72 | 5 | 4 |
| README.kernel_config | D | 03-May-2024 | 10.7 KiB | 303 | 274 |
| README.md | D | 03-May-2024 | 5 KiB | 189 | 135 |
| TODO | D | 03-May-2024 | 1.3 KiB | 40 | 26 |
| VERSION | D | 03-May-2024 | 9 | 2 | 1 |
| build.sh | D | 03-May-2024 | 3.6 KiB | 164 | 125 |
| configure.ac | D | 03-May-2024 | 5.4 KiB | 246 | 223 |
| execltp.in | D | 03-May-2024 | 16 KiB | 475 | 326 |
| gen.bp | D | 03-May-2024 | 482.3 KiB | 18,737 | 17,202 |
| ltpmenu | D | 03-May-2024 | 19 KiB | 549 | 321 |
| runltp | D | 03-May-2024 | 36.9 KiB | 996 | 780 |
| ver_linux | D | 03-May-2024 | 3 KiB | 114 | 77 |
README.kernel_config
1---------------------------------
2Enable CODE COVERAGE for your Kernel:
3---------------------------------
41) Apply kernel-gcov patch(s) against the corresponding Kernel. They are available here:
5http://ltp.cvs.sourceforge.net/viewvc/ltp/utils/analysis/gcov-kernel/linux-2.*.*-gcov.patch?view=log,
62) Also enable the following options in your .config file before building the kernel
7CONFIG_GCOV_PROFILE=y
8CONFIG_GCOV_ALL=y
9CONFIG_GCOV_PROC=m
10CONFIG_GCOV_HAMMER=y
11
12---------------------------------
13Enabling Kernel Configuration to test Containers/Namespaces
14---------------------------------
15CONFIG_NAMESPACES=y
16CONFIG_UTS_NS=y
17CONFIG_IPC_NS=y
18CONFIG_USER_NS=y
19CONFIG_PID_NS=y
20CONFIG_NET_NS=y
21CONFIG_VETH=y
22CONFIG_MACVLAN=y
23
24The IPC namespaces do not automatically enable IPC, so you may
25also want to have:
26
27CONFIG_SYSVIPC=y
28CONFIG_SYSVIPC_SYSCTL=y
29CONFIG_POSIX_MQUEUE=y
30
31---------------------------------
32Enabling Kernel Configuration to test Controllers
33---------------------------------
34CONFIG_CGROUPS=y
35CONFIG_CGROUP_DEBUG=y
36CONFIG_CGROUP_NS=y
37CONFIG_GROUP_SCHED=y
38CONFIG_FAIR_GROUP_SCHED=y
39CONFIG_RT_GROUP_SCHED=y
40CONFIG_CGROUP_SCHED=y
41CONFIG_CGROUP_MEM_RES_CTLR=y
42CONFIG_LOCKDEP=y
43---------------------------------
44Enabling Kernel Configuration to test Power Management features
45---------------------------------
46CONFIG_CPU_FREQ=y
47CONFIG_CPU_FREQ_TABLE=y
48CONFIG_CPU_FREQ_DEBUG=y
49CONFIG_CPU_FREQ_STAT=y
50CONFIG_CPU_FREQ_STAT_DETAILS=y
51CONFIG_CPU_IDLE=y
52CONFIG_CPU_IDLE_GOV_LADDER=y
53CONFIG_CPU_IDLE_GOV_MENU=y
54CONFIG_SCHED_MC=y
55CONFIG_CPU_FREQ_DEFAULT_GOV_PERFORMANCE=y
56CONFIG_CPU_FREQ_DEFAULT_GOV_POWERSAVE=y
57CONFIG_CPU_FREQ_DEFAULT_GOV_USERSPACE=y
58CONFIG_CPU_FREQ_DEFAULT_GOV_ONDEMAND=y
59CONFIG_CPU_FREQ_DEFAULT_GOV_CONSERVATIVE=y
60CONFIG_CPU_FREQ_GOV_PERFORMANCE=y
61CONFIG_CPU_FREQ_GOV_POWERSAVE=y
62CONFIG_CPU_FREQ_GOV_USERSPACE=y
63CONFIG_CPU_FREQ_GOV_ONDEMAND=y
64CONFIG_CPU_FREQ_GOV_CONSERVATIVE=y
65---------------------------------
66Enabling Kernel Configuration to test filecaps security feature
67---------------------------------
68CONFIG_SECURITY_FILE_CAPABILITIES=y
69---------------------------------
70Enabling Kernel Configuration to test SELinux security feature
71---------------------------------
72Your Kernel should have been built with the following options to
73test SELinux:
74
75CONFIG_SECURITY=y
76CONFIG_SECURITY_NETWORK=y
77CONFIG_SECURITY_NETWORK_XFRM=y
78
79CONFIG_SECURITY_DEFAULT_MMAP_MIN_ADDR=0
80This has to be set to a positive value if you want to test this check.
81Fedora kernels set it to 65536.
82
83CONFIG_SECURITY_SELINUX=y
84CONFIG_SECURITY_SELINUX_BOOTPARAM=y
85CONFIG_SECURITY_SELINUX_BOOTPARAM_VALUE=1
86CONFIG_SECURITY_SELINUX_DEVELOP=y
87CONFIG_SECURITY_SELINUX_AVC_STATS=y
88CONFIG_SECURITY_SELINUX_CHECKREQPROT_VALUE=1
89CONFIG_SECURITY_SELINUX_ENABLE_SECMARK_DEFAULT=y
90
91CONFIG_SECURITY_SELINUX_POLICYDB_VERSION_MAX=y
92You don't want this one unless you are running Fedora 3 or 4.
93On anything newer, it will cause unnecessary policy expansion.
94
95CONFIG_SECURITY_SMACK=y
96CONFIG_SECURITY_SELINUX=y
97
98By default, if you boot with multiple LSMs compiled into the kernel, the
99kernel won't boot succesfully - there can be only one (aside from
100explicit internal "stacking" e.g. as is done for combining SELinux or
101Smack with capabilities). Unless you use the security= option to select
102one at boot. SELinux and Smack will honor the security= option.
103---------------------------------
104---------------------------------
105Enabling Kernel Configuration to test SMACK security feature
106---------------------------------
107CONFIG_NETLABEL=y
108CONFIG_SECURITY=y
109CONFIG_SECURITY_NETWORK=y
110CONFIG_SECURITY_SMACK=y
111CONFIG_SECURITY_SELINUX should not be set
112
113For more information to build/install/run these tests, look through:
114ltp/testcases/kernel/security/smack/README
115---------------------------------
116---------------------------------
117Enablement for Enhancement to kexec/kdump for implementing the following features:
118- Backup/restore memory used by the original kernel before/after kexec.
119- Save/restore CPU state before/after kexec.
120Now, only the i386 architecture is supported. More from the following git logs:
121http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commit;h=3ab83521378268044a448113c6aa9a9e245f4d2f,
122http://git.kernel.org/?p=linux/kernel/git/torvalds/linux-2.6.git;a=commit;h=89081d17f7bb81d89fa1aa9b70f821c5cf4d39e9,
123---------------------------------
124CONFIG_X86_32=y
125CONFIG_RELOCATABLE=y
126CONFIG_KEXEC=y
127CONFIG_CRASH_DUMP=y
128CONFIG_PM=y
129CONFIG_HIBERNATION=y
130CONFIG_KEXEC_JUMP=y
131---------------------------------
132Enabling HOTPLUG for your Kernels
133---------------------------------
134CONFIG_HOTPLUG=y
135CONFIG_HOTPLUG_CPU=y
136CONFIG_ARCH_ENABLE_MEMORY_HOTPLUG=y
137CONFIG_ACPI_HOTPLUG_CPU=y
138CONFIG_HOTPLUG_PCI_PCIE=y
139CONFIG_HOTPLUG_PCI=y
140CONFIG_HOTPLUG_PCI_FAKE=y
141CONFIG_HOTPLUG_PCI_COMPAQ=y
142CONFIG_HOTPLUG_PCI_COMPAQ_NVRAM=y
143CONFIG_HOTPLUG_PCI_IBM=y
144CONFIG_HOTPLUG_PCI_ACPI=y
145CONFIG_HOTPLUG_PCI_ACPI_IBM=y
146CONFIG_HOTPLUG_PCI_CPCI=y
147CONFIG_HOTPLUG_PCI_CPCI_ZT5550=y
148CONFIG_HOTPLUG_PCI_CPCI_GENERIC=y
149CONFIG_HOTPLUG_PCI_SHPC=y
150---------------------------------
151Video For Linux Two API testing Requirements:
152You need to have a video device (i.e. webcam, tuner card, etc.) connected to your system and available under /dev/video0. If you don't have any hardware device available, you can still test the "Virtual Video Driver". To compile this you need to compile your kernel with CONFIG_VIDEO_VIVI=m under:
153 -> Device Drivers
154 -> Multimedia devices
155 -> Video For Linux
156 -> Video capture adapters
157 -> Virtual Video Driver
158
159The tests also require CUnit Framework to be installed before compiling the tests. Download & Install the same from:
160http://sourceforge.net/projects/cunit/
161---------------------------------
162---------------------------------
163Native language support (nls) testsuite requirements
164----------------------------------------------------
165CONFIG_NLS=m
166CONFIG_BLOCK=y
167---------------------------------
168Enabling Controller area network (CAN) protocol support for your Kernels
169---------------------------------
170CONFIG_NET=y
171CONFIG_CAN=m
172CONFIG_CAN_RAW=m
173CONFIG_CAN_BCM=m
174# CAN Device Drivers
175CONFIG_CAN_VCAN=m
176---------------------------------
177Enabling Fault Injection Support for your kernel (version 2.6.29).
178Please check with the original kernel for the fault injection
179types it supports. Following supports will be available:
180
181/sys/kernel/debug/fail_io_timeout/interval
182/sys/kernel/debug/fail_io_timeout/probability
183/sys/kernel/debug/fail_io_timeout/reject-end
184/sys/kernel/debug/fail_io_timeout/reject-start
185/sys/kernel/debug/fail_io_timeout/require-end
186/sys/kernel/debug/fail_io_timeout/require-start
187/sys/kernel/debug/fail_io_timeout/space
188/sys/kernel/debug/fail_io_timeout/stacktrace-depth
189/sys/kernel/debug/fail_io_timeout/task-filter
190/sys/kernel/debug/fail_io_timeout/times
191/sys/kernel/debug/fail_io_timeout/verbose
192
193/sys/kernel/debug/fail_make_request/interval
194/sys/kernel/debug/fail_make_request/probability
195/sys/kernel/debug/fail_make_request/reject-end
196/sys/kernel/debug/fail_make_request/reject-start
197/sys/kernel/debug/fail_make_request/require-end
198/sys/kernel/debug/fail_make_request/require-start
199/sys/kernel/debug/fail_make_request/space
200/sys/kernel/debug/fail_make_request/stacktrace-depth
201/sys/kernel/debug/fail_make_request/task-filter
202/sys/kernel/debug/fail_make_request/times
203/sys/kernel/debug/fail_make_request/verbose
204
205/sys/kernel/debug/fail_page_alloc/ignore-gfp-highmem
206/sys/kernel/debug/fail_page_alloc/ignore-gfp-wait
207/sys/kernel/debug/fail_page_alloc/interval
208/sys/kernel/debug/fail_page_alloc/min-order
209/sys/kernel/debug/fail_page_alloc/probability
210/sys/kernel/debug/fail_page_alloc/reject-end
211/sys/kernel/debug/fail_page_alloc/reject-start
212/sys/kernel/debug/fail_page_alloc/require-end
213/sys/kernel/debug/fail_page_alloc/require-start
214/sys/kernel/debug/fail_page_alloc/space
215/sys/kernel/debug/fail_page_alloc/stacktrace-depth
216/sys/kernel/debug/fail_page_alloc/task-filter
217/sys/kernel/debug/fail_page_alloc/times
218/sys/kernel/debug/fail_page_alloc/verbose
219
220/sys/kernel/debug/failslab/ignore-gfp-wait
221/sys/kernel/debug/failslab/interval
222/sys/kernel/debug/failslab/probability
223/sys/kernel/debug/failslab/reject-end
224/sys/kernel/debug/failslab/reject-start
225/sys/kernel/debug/failslab/require-end
226/sys/kernel/debug/failslab/require-start
227/sys/kernel/debug/failslab/space
228/sys/kernel/debug/failslab/stacktrace-depth
229/sys/kernel/debug/failslab/task-filter
230/sys/kernel/debug/failslab/times
231/sys/kernel/debug/failslab/verbose
232
233when the below kernel config options are set:
234
235CONFIG_FAULT_INJECTION=y
236CONFIG_DEBUG_KERNEL=y
237CONFIG_FAILSLAB=y (Fault-injection capability for kmalloc)
238(CONFIG_SLAB=y || CONFIG_SLUB=y) if CONFIG_FAILSLAB=y
239CONFIG_FAIL_PAGE_ALLOC=y (Fault-injection capabilitiy for alloc_pages())
240CONFIG_FAIL_MAKE_REQUEST=y (Fault-injection capability for disk IO)
241CONFIG_BLOCK=y if CONFIG_FAIL_MAKE_REQUEST=y
242CONFIG_FAIL_IO_TIMEOUT=y (Faul-injection capability for faking disk interrupts)
243CONFIG_BLOCK=y if CONFIG_FAIL_IO_TIMEOUT=y
244CONFIG_FAULT_INJECTION_DEBUG_FS=y (Debugfs entries for fault-injection capabilities)
245(CONFIG_SYSFS=y && CONFIG_DEBUG_FS=y) if CONFIG_FAULT_INJECTION_DEBUG_FS=y
246CONFIG_FAULT_INJECTION_STACKTRACE_FILTER=y (stacktrace filter for fault-injection capabilities)
247(CONFIG_FAULT_INJECTION_DEBUG_FS=y && CONFIG_STACKTRACE_SUPPORT=y && !CONFIG_X86_64) if
248 CONFIG_FAULT_INJECTION_STACKTRACE_FILTER=y
249
250For more information on Fault injection, please refer to:
251linux-2.6/Documentation/fault-injection/fault-injection.txt,
252
253You should also have made the following entries in your /etc/fstab file
254once the kernel is booted with the above CONFIG options set:
255
256debugfs /sys/kernel/debug/ debugfs
257
258# How the Kernel Fault Injection works for LTP ?
259
2601) Build Kernel with all the above possible kernel CONFIG Options,
2612) Create the above entry in /etc/fstab file,
2623) Reboot in the new kernel,
2634) Goto LTPROOT. Build and Install LTP as per ltp/INSTALL file,
2645) Choose your own test(or default) to run with fault injection as follows:
265 ./runltp -f <command_file> -F <LOOPS>,<FAULT_PROBABILITY>
266
267The algorithm functions like:
268loop (for each testcase)
269begin
270 execute_testcase(inside_stable_kernel)
271 begin
272 insert_fault_into_kernel()
273 loop X Times
274 begin
275 execute_testcase(inside_fault_kernel)
276 end
277 restore_kernel_to_normal()
278 end
279end
280
281# External TODOs:
2821) Add or modify testcases when relevant kernel functionality changes.
283---------------------------------
284
285---------------------------------
286Enabling Kernel Configuration to test ext4 new features
287---------------------------------
288CONFIG_EXT4_FS=y
289CONFIG_EXT4DEV_COMPAT=y
290CONFIG_EXT4_FS_XATTR=y
291CONFIG_EXT4_FS_POSIX_ACL=y
292CONFIG_EXT4_FS_SECURITY=y
293
294Beside that, the following packages are necessary.
295 e2fsprogs
296 e2fsprogs-devel
297 e2fsprogs-libs
298And the version of packages must be 1.41.4 or above.
299
300For more information to build/install/run these tests, look through:
301ltp/testcases/kernel/fs/ext4-new-features/README
302---------------------------------
303
README.md
1Linux Test Project
2==================
3
4Linux Test Project is a joint project started by SGI, OSDL and Bull developed
5and 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
7reliability, robustness, and stability of Linux.
8
9The 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
12source contributors are encouraged to join.
13
14Project pages are located at: http://linux-test-project.github.io/
15
16The latest image is always available at:
17https://github.com/linux-test-project/ltp/releases
18
19The discussion about the project happens at ltp mailing list:
20http://lists.linux.it/listinfo/ltp
21
22The git repository is located at GitHub at:
23https://github.com/linux-test-project/ltp
24
25The patchwork instance is at:
26https://patchwork.ozlabs.org/project/ltp/list/
27
28Warning!
29========
30
31**Be careful with these tests!**
32
33Don't run them on production systems. Growfiles, doio, and iogen in particular
34stress the I/O capabilities of systems and while they should not cause problems
35on properly functioning systems, they are intended to find (or cause) problems.
36
37Quick guide to running the tests
38================================
39
40If you have git, autoconf, automake, m4, the linux headers and the common
41developer packages installed, the chances are the following will work.
42
43```
44$ git clone https://github.com/linux-test-project/ltp.git
45$ cd ltp
46$ make autotools
47$ ./configure
48```
49
50Now you can continue either with compiling and running a single test or with
51compiling and installing the whole testsuite.
52
53Shortcut to running a single test
54---------------------------------
55
56If you need to execute a single test you actually does not need to compile
57whole LTP, if you want to run a syscall testcase following should work.
58
59```
60$ cd testcases/kernel/syscalls/foo
61$ make
62$ PATH=$PATH:$PWD ./foo01
63```
64
65Shell testcases are a bit more complicated since these need a path to a shell
66library as well as to compiled binary helpers, but generally following should
67work.
68
69```
70$ cd testcases/lib
71$ make
72$ cd ../commands/foo
73$ PATH=$PATH:$PWD:$PWD/../../lib/ ./foo01.sh
74```
75
76Open Posix Testsuite has it's own build system which needs Makefiles to be
77generated first, then compilation should work in subdirectories as well.
78
79```
80$ cd testcases/open_posix_testsuite/
81$ make generate-makefiles
82$ cd conformance/interfaces/foo
83$ make
84$ ./foo_1-1.run-test
85```
86
87Compiling and installing all testcases
88--------------------------------------
89
90```
91$ make
92$ make install
93```
94
95This will install LTP to `/opt/ltp`.
96* If you have a problem see `doc/mini-howto-building-ltp-from-git.txt`.
97* If you still have a problem see `INSTALL` and `./configure --help`.
98* Failing that, ask for help on the mailing list or Github.
99
100Some tests will be disabled if the configure script can not find their build
101dependencies.
102
103* If a test returns `TCONF` due to a missing component, check the `./configure`
104 output.
105* If a tests fails due to a missing user or group, see the Quick Start section
106 of `INSTALL`.
107
108To run all the test suites
109
110```
111$ cd /opt/ltp
112$ ./runltp
113```
114
115Note that many test cases have to be executed as root.
116
117To run a particular test suite
118
119```
120$ ./runltp -f syscalls
121```
122
123To run all tests with `madvise` in the name
124
125```
126$ ./runltp -f syscalls -s madvise
127```
128Also see
129
130```
131$ ./runltp --help
132```
133
134Test suites (e.g. syscalls) are defined in the runtest directory. Each file
135contains a list of test cases in a simple format, see doc/ltp-run-files.txt.
136
137Each test case has its own executable or script, these can be executed
138directly
139
140```
141$ testcases/bin/abort01
142```
143
144Some have arguments
145
146```
147$ testcases/bin/fork13 -i 37
148```
149
150The vast majority of test cases accept the -h (help) switch
151
152```
153$ testcases/bin/ioctl01 -h
154```
155
156Many require certain environment variables to be set
157
158```
159$ LTPROOT=/opt/ltp PATH="$PATH:$LTPROOT/testcases/bin" testcases/bin/wc01.sh
160```
161
162Most commonly, the path variable needs to be set and also `LTPROOT`, but there
163are a number of other variables, `runltp` usually sets these for you.
164
165Note that all shell scripts need the `PATH` to be set. However this is not
166limited to shell scripts, many C based tests need environment variables as
167well.
168
169Developers corner
170=================
171
172Before you start you should read following documents:
173
174* `doc/test-writing-guidelines.txt`
175* `doc/build-system-guide.txt`
176
177There is also a step-by-step tutorial:
178
179* `doc/c-test-tutorial-simple.txt`
180
181If something is not covered there don't hesitate to ask on the LTP mailing
182list. Also note that these documents are available online at:
183
184* https://github.com/linux-test-project/ltp/wiki/Test-Writing-Guidelines
185* https://github.com/linux-test-project/ltp/wiki/BuildSystem
186* https://github.com/linux-test-project/ltp/wiki/C-Test-Case-Tutorial
187
188Although we accept GitHub pull requests, the preferred way is sending patches to our mailing list.
189