README

   1 LTTng inter-version compatibility test suite.
   2 ============================================
   3
   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.
  22
  23 How to run:
  24 ==========
  25
  26 1: python lttng_ivc/bootstrap.py
  27 2: python lttng_ivc/build_projects.py
  28 3: pytest -sv lttng_ivc/tests/
  29
  30 With tox:
  31
  32 1: tox -r ./
  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.