Skip to content

Latest commit

 

History

History
80 lines (60 loc) · 2.21 KB

README.rst

File metadata and controls

80 lines (60 loc) · 2.21 KB
Raw

LLVM Toolchain Integration Test Suite

An agglomeration of integration tests for the LLVM Toolchain. Unlike the various existing llvm testing suites, this is meant to be used in an installed environment to detect packaging issues.

This is an initiative started by Debian/Ubuntu and Fedora maintainers to agregate the testing effort. Hopefully, this project will be also a forcing function to bring more consistency in the LLVM toolchain packaging.

Requirements

The lit tool is used to run the tests and cmake is used for the configuration step.

Usage

From source directory:

> mkdir _build && cd _build
> cmake ..
> make check

Sensible configuration variables

  • LIT: path to the lit program
  • CLANG_BINARY: path to the clang binary to check
  • CLANGXX_BINARY: path to the clang++ binary to check
  • CLANG_TIDY_BINARY: path to the clang tidy binary to check
  • LLD_BINARY: path to the lld binary to check
  • LLDB_BINARY: path to the lldb binary to check
  • ENABLE_COMPILER_RT: ON (the default) if we assume compiler-rt is available
  • ENABLE_LIBCXX: ON (the default) if we assume libc++ is available
  • ENABLE_STATIC_LIBCXX: ON (the default) if we assume libc++.a is available
  • ENABLE_LIBUNWIND: ON (the default) if we assume libunwind is available
  • ENABLE_HWASAN: Run hwasan tests. Autodetected based on the host system.
  • ENABLE_LIBOMP: Run libomp tests. Autodetected based on the system. It can
    be manually forced via -DENABLE_LIBOMP=<ON|OFF> at cmake configure time

Writing new tests

Just drop a new file under tests/, using the lit format. Please use the following substitutions and requirements:

Lit substitutions

  • %clang
  • %clangxx
  • %clang-tidy
  • %lldb
  • %lld
  • %scan-build
  • %scan-view
  • %scan-build-py

requirements

  • clang
  • clangxx
  • clang-tidy
  • lldb
  • lld
  • scanbuild
  • scanbuild-py
  • scanview

License

See LICENSE.txt