projects / deliverable / lttng-ivc.git / blame
| Commit | Line | Data |
|---|---|---|
| e2c8ca8a JR |
1 | LTTng inter-version compatibility test suite. |
| 2 | ============================================ | |
| bcc7759d | 3 | |
| e2c8ca8a JR |
4 | This project aim to provide an inter-version compatibility test suite to |
| 5 | document, automate, validate behaviours of the LTTng projects between version | |
| 6 | and prevent unexpected regression. | |
| 7 | ||
| 8 | This project is intended to run inside a Continuous Integration environment. | |
| 9 | A running version will be made available on ci.lttng.org. | |
| 10 | ||
| 11 | A python3 virtual env is recommenced to run this test suite. | |
| 12 | ||
| 13 | The suite is currently run under a python 3.5.3 virtual environment situated at | |
| 14 | the root of the current directly under .venv. | |
| 15 | ||
| 16 | The virtualenv can be configured with the provided requirement.txt | |
| 17 | ||
| 18 | The running environment should provide all dependencies required by | |
| 19 | lttng-ust/lttng-tools/lttng-modules 2.7/2.8/2.9/2.10, babeltrace 1.3/1.4/1.5. | |
| 20 | ||
| 21 | Latest liburcu stable is also recommended. | |
| 721a9e71 JR |
22 | |
| 23 | How to run: | |
| 24 | ========== | |
| 25 | ||
| 26 | 1: python lttng_ivc/bootstrap.py | |
| 10ea99d1 JR |
27 | 2: python lttng_ivc/build_projects.py |
| 28 | 3: pytest -sv lttng_ivc/tests/ | |
| 8b2a61d0 JR |
29 | |
| 30 | With tox: | |
| 31 | ||
| 32 | 1: tox -r ./ | |
| eeda0d58 JR |
33 | |
| 34 | Findings | |
| 35 | ======== | |
| 36 | ||
| 37 | The binding type (ld.so) (now or lazy) is dependent on the gcc/ld distribution | |
| 38 | configuration. Hence, for this test suite, we force the behavior to "now". This | |
| 39 | result in the lookup of all required symbols at launch. This is particularly | |
| 40 | important since we want to prevent inconsistent behavior. Immediate might be | |
| 41 | forced in the future for lttng project but for now we simply force it at | |
| 42 | runtime. |