LIT(1) LLVM LIT(1) (NAME) lit - LLVM (SYNOPSIS) lit [options] [tests] (DESCRIPTION) lit LLVM Clang . lit . lit (tests) . ( TEST DISCOVERY ). ( ) lit ( TEST STATUS RESULTS ). lit . lit . lit (OUTPUT OPTIONS) . lit ( ). EXECUTION OPTIONS . lit SELECTION OPTIONS . lit LIT_OPTS . LIT_OPTS check lit . lit (response files) @path/to/file.rsp . . . lit lit LIT INFRASTRUCTURE . (GENERAL OPTIONS) -h, --help lit . --version lit . -j N, --workers N N . . --config-prefix NAME lit.cfg lit.site.cfg NAME.cfg NAME.site.cfg . -D NAME[=VALUE], --param NAME[=VALUE] NAME VALUE ( ). . (OUTPUT OPTIONS) -q, --quiet . -s, --succinct . --no-progress-bar . -v, --verbose . . . lit 'RUN: at line N' . -vv, --echo-all-commands -v. -a, --show-all -v . -o PATH, --output PATH . --no-progress-bar curses. --show-excluded (excluded). --show-skipped (skipped). --show-unsupported (unsupported). --show-pass (pass). --show-flakypass (flakypass). --show-xfail (xfail). --gtest-sharding (sharding) GoogleTest. --no-gtest-sharding GoogleTest. --path PATH PATH . --vg valgrind ( memcheck). --error-exitcode valgrind valgrind . lit "valgrind" ( ) . --vg-leak --vg . lit "vg_leak" ( ) . --vg-arg ARG --vg valgrind . --no-execute ( ). --xunit-xml-output XUNIT_XML_OUTPUT XML XUnit . --report-failures-only ( TEST STATUS RESULTS ) . --resultdb-output RESULTDB_OUTPUT JSON LuCI ResultDB . --time-trace-output TIME_TRACE_OUTPUT JSON Chrome tracing . --timeout MAXINDIVIDUALTESTTIME ( ). 0 . [: 0] --timeout N N ( ) . 0 0 . --max-time . --max-failures MAX_FAILURES . --max-retries-per-test N N . --max-retries-per-test : o lit --max-retries-per-test o config.test_retry_attempts o ALLOW_RETRIES: ( ). --allow-empty-runs . --per-test-coverage ( LLVM_PROFILE_FILE RUN). config.test_exec_root . --ignore-fail . --skip-test-time-recording (wall time) . --time-tests (wall time) . . lit . --order . test_exec_root .lit_test_times.txt . lit (clean builds) test_source_root . --max-tests N N . --max-time N () N . --timeout . --order {lexical,random,smart} . : o lexical - . . o random - . o smart - . . --shuffle / . --order . -i, --incremental ( : --order=smart ). --filter REGEXP REGEXP . LIT_FILTER lit . --filter-out REGEXP REGEXP . LIT_FILTER_OUT lit . --filter-failed . . --xfail LIST - LIST XFAIL . . LIT_XFAIL lit . . : LIT_XFAIL="affinity/kmp-hw-subset.c;offloading/memory_manager.cpp" XFAIL : libomp :: affinity/kmp-hw-subset.c libomptarget :: nvptx64-nvidia-cuda :: offloading/memory_manager.cpp libomptarget :: x86_64-pc-linux-gnu :: offloading/memory_manager.cpp LIT . nvptx64-nvidia-cuda offloading/memory_manager.cpp XFAIL : LIT_XFAIL="affinity/kmp-hw-subset.c;libomptarget :: x86_64-pc-linux-gnu :: offloading/memory_manager.cpp" --xfail-not LIST XFAIL . LIT_XFAIL_NOT . --xfail LIT_XFAIL . --xfail-not LIT_XFAIL_NOT XFAIL --xfail . XPASS XFAIL . --exclude-xfail XFAIL --xfail-not ( LIT_XFAIL_NOT) . --num-shards M M "" (shard) . --run-shard=N . LIT_NUM_SHARDS . ( ) . --run-shard N --num-shards=M . N 1..M . LIT_RUN_SHARD . --debug lit lit. --show-suites . --show-tests . --show-used-features ( XFAIL UNSUPPORTED REQUIRES) . --update-tests lit_config.test_updaters . (EXIT STATUS) ( ) --ignore-fail lit . . ( ) . (TEST DISCOVERY) lit . lit . lit . lit lit.cfg lit.site.cfg . lit . lit . . lit . lit (out-of-tree) . (TEST STATUS RESULTS) : PASS . FLAKYPASS . ALLOW_RETRIES: . FAIL . . XPASS . ( ). FAIL . UNRESOLVED . . UNSUPPORTED . . TIMEOUT . (UNRESOLVED) (TIMEOUT) (FAIL) (XPASS) . ( ). (OUTPUT OPTIONS) ..SH " LIT (LIT INFRASTRUCTURE)" lit lit . lit . lit test suites . (TEST SUITES) (TEST DISCOVERY) test suite . . lit lit.cfg lit.site.cfg ( --config-prefix ). . --show-suites . . . : lit_config lit ( LitConfig) . config ( TestingConfig) . config : name [] . test_format [] . lit.formats . test_source_root . (out-of-dir builds) . test_exec_root (object directory) . . environment . standalone_tests true (standalone) . . true lit.suffixes lit.excludes . suffixes lit . : ShTest. substitutions lit . : ShTest. unsupported . : ShTest. parent None . root . lit . pipefail (pipe) . false . available_features XFAIL REQUIRES UNSUPPORTED . (TEST DISCOVERY) lit ( test_source_root) . lit . ( (LOCAL CONFIGURATION FILES) ). . ( GoogleTest) << >> ("virtual tests") . (LOCAL CONFIGURATION FILES) lit --- . lit lit.local.cfg . . --- --- . (SUBSTITUTIONS) lit RUN . TestRunner.py : +------------------------+--------------------------------------+ | (Macro) | | | | (Substitution) | +------------------------+--------------------------------------+ |%s | | | | ( | | | | | | ) | +------------------------+--------------------------------------+ |%S | | | | | | | ( | | | | | | | | | ) | +------------------------+--------------------------------------+ |%p | %S | +------------------------+--------------------------------------+ |%{pathsep} | | +------------------------+--------------------------------------+ |%{fs-src-root} | | | | | | | | | | LLVM | | | | +------------------------+--------------------------------------+ |%{fs-tmp-root} | | | | | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{fs-sep} | | | | | +------------------------+--------------------------------------+ |%t | | | | ( | | | | | | | | | | | | | | | ) | +------------------------+--------------------------------------+ |%basename_t | | | | %t | | | .tmp | | | ( | | | | | | %{t:stem} | | | ) | +------------------------+--------------------------------------+ |%% | % | +------------------------+--------------------------------------+ |%/s | %s \ / | | | | | | | +------------------------+--------------------------------------+ |%/S | %S \ / | | | | | | | +------------------------+--------------------------------------+ |%/p | %p \ / | | | | | | | +------------------------+--------------------------------------+ |%/t | %t \ / | | | | | | | +------------------------+--------------------------------------+ |%{s:basename} | | | | %s | +------------------------+--------------------------------------+ |%{t:stem} | | | | %t | | | .tmp ( | | | | | | %basename_t) | +------------------------+--------------------------------------+ |%{s:real} | %s | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{S:real} | %S | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{p:real} | %p | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{t:real} | %t | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{/s:real} | %/s | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{/S:real} | %/S | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{/p:real} | %/p | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{/t:real} | %/t | | | | | | | | | | | | | | | | +------------------------+--------------------------------------+ |%{/s:regex_replacement} | %/s | | | | | | | | | s@@@ sed | | | | +------------------------+--------------------------------------+ |%{/S:regex_replacement} | %/S | | | | | | | | | s@@@ sed | | | | +------------------------+--------------------------------------+ |%{/p:regex_replacement} | %/p | | | | | | | | | s@@@ sed | | | | +------------------------+--------------------------------------+ |%{/t:regex_replacement} | %/t | | | | | | | | | s@@@ sed | | | | +------------------------+--------------------------------------+ |%:s | | | | %/s | | | : | | | | | | . | | | | | | %s | | | / . | +------------------------+--------------------------------------+ |%:S | | | | %/S | | | : | | | | | | . | | | | | | %S | | | / . | +------------------------+--------------------------------------+ |%:p | | | | %/p | | | : | | | | | | . | | | | | | %p | | | / . | +------------------------+--------------------------------------+ |%:t | | | | %/t | | | : | | | | | | . | | | | | | %t | | | / . | +------------------------+--------------------------------------+ |%{readfile:} | | | | | | | . | +------------------------+--------------------------------------+ . (LOCAL CONFIGURATION FILES) . LLVM <> ..SS (TEST RUN OUTPUT FORMAT) lit (verbose) (schema) ( PASS ). ( buildbot) . : : () PASS FAIL XFAIL XPASS UNRESOLVED UNSUPPORTED . IMPROVED REGRESSED . (newline) . (1/300) . ( ALLOW_RETRIES: ) : , of attempts () : TEST '()' ... log message ... "*" ( ) () . A B C D C : PASS: A (1 of 4) PASS: B (2 of 4) FAIL: C (3 of 4) ******************** TEST 'C' FAILED ******************** Test 'C' failed as a result of exit code 1. ******************** PASS: D (4 of 4) (DEFAULT FEATURES) lit available_features . lit : system-darwin system-linux . lit target-x86_64 target-aarch64 . (sanitizers) lit : asan tsan . llvm/utils/lit/lit/llvm/config.py . LIT (LIT EXAMPLE TESTS) lit ExampleTests . (SEE ALSO) valgrind(1) (AUTHORS) LLVM (). (COPYRIGHT) 2003-2026, LLVM Project 22 2026-07-15 LIT(1)