Skip to content

Commit 6626dc8

Browse files
committed
doc: Add supported distros (kernel, libc, toolchain)
Page put into wiki: https://github.com/linux-test-project/ltp/wiki/Supported-kernel,-libc,-toolchain-versions Acked-by: Cyril Hrubis <[email protected]> Acked-by: Yang Xu <[email protected]> Acked-by: Jan Stancek <[email protected]> Acked-by: Li Wang <[email protected]> Signed-off-by: Petr Vorel <[email protected]>
1 parent bf61f10 commit 6626dc8

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
Supported kernel, libc, toolchain versions
2+
==========================================
3+
4+
1. Build testing with Travis CI
5+
-------------------------------
6+
7+
We test master branch in https://travis-ci.org/github/linux-test-project/ltp/builds[travis CI]
8+
to ensure LTP builds on various distributions including old, current and bleeding edge.
9+
We test both gcc and clang toolchains, various architectures with cross-compilation.
10+
For list of tested distros see
11+
https://github.com/linux-test-project/ltp/blob/master/.travis.yml[.travis.yml].
12+
13+
14+
NOTE: Travis does only build testing, passing the CI means only that the
15+
test compiles fine on variety of different distributions and releases.
16+
Travis also uses the latest distribution image of a particular release.
17+
18+
1.1 Oldest tested distributions
19+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
20+
21+
[align="center",options="header"]
22+
|==============================================================
23+
| Distro | kernel | glibc | gcc | clang
24+
| CentOS 7 | 3.10 | 2.17 | 4.8.5 | -
25+
| Ubuntu 16.04 LTS xenial | 4.4 | 2.23 | 5.3.1 | -
26+
| Debian 9 stretch (oldstable) | 4.9.30 | 2.24 | 6.3.0 | 3.8
27+
|==============================================================
28+
29+
Older distributions are not officially supported, which means that it
30+
may or may not work. It all depends on your luck. It should be possible
31+
to compile latest LTP even on slightly older distributions than we
32+
support with a few manual tweaks, e.g. disabling manually tests for
33+
newly added syscalls, etc. Trivial fixes/workarounds may be accepted,
34+
but users are encouraged to move to a newer distro.
35+
36+
If latest LTP cannot be compiled even with some amount of workarounds,
37+
you may result to older LTP releases, however these are _not_ supported
38+
in any way. Also if you are trying to run LTP on more than 10 years old
39+
distribution you may as well reconsider you life choices.
40+
41+
1.2 Tested architectures
42+
~~~~~~~~~~~~~~~~~~~~~~~~
43+
44+
[align="center",options="header"]
45+
|==================================
46+
| arch | build
47+
| x86_64 | native
48+
| x86 emulation | native
49+
| aarch64 | cross compilation
50+
| ppc64le | cross compilation
51+
| s390x | cross compilation
52+
|==================================
53+
54+
1.3 Supported libc
55+
~~~~~~~~~~~~~~~~~~
56+
57+
[align="center",options="header"]
58+
|==================================
59+
| Libc | Note
60+
| https://www.gnu.org/software/libc/[GNU C Library (glibc)] | Targetted libc, tested both compilation and actual test results.
61+
| https://uclibc-ng.org/[uClibc-ng] | Although not being tested it should work as well as it attempt to maintain a glibc compatible interface.
62+
| https://www.uclibc.org/[uClibc] | Older https://www.uclibc.org/[uClibc] might have problems.
63+
| https://musl.libc.org/[musl] | Not yet fully supported (see
64+
https://github.com/linux-test-project/ltp/blob/master/travis/alpine.sh[travis script]
65+
for list of files which need to be deleted in order to compile under musl).
66+
| binder (Android) | Please use https://android.googlesource.com/platform/external/ltp/[AOSP fork].

0 commit comments

Comments
 (0)