[llvm] Add IR tracker query tool and documentation (PR #191856)

Mon Apr 13 10:54:16 PDT 2026

github-actions[bot] wrote:

<!--PREMERGE ADVISOR COMMENT: Linux-->
# :penguin: Linux x64 Test Results

* 172556 tests passed
* 3137 tests skipped
* 2 tests failed

## Failed Tests
(click on a test name to see its output)

### LLVM
<details>
<summary>LLVM.Other/ir-tracker-db.ll</summary>

```
Exit Code: -6

Command Output (stdout):
--
# RUN: at line 1
/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt -disable-output -passes=instcombine -ir-tracker-database=/home/gha/actions-runner/_work/llvm-project/llvm-project/build/test/Other/Output/ir-tracker-db.ll.tmp.db /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/test/Other/ir-tracker-db.ll
# executed command: /home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt -disable-output -passes=instcombine -ir-tracker-database=/home/gha/actions-runner/_work/llvm-project/llvm-project/build/test/Other/Output/ir-tracker-db.ll.tmp.db /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/test/Other/ir-tracker-db.ll
# .---command stderr------------
# | LLVM ERROR: -ir-tracker-database requires an LLVM build linked against SQLite3
# | PLEASE submit a bug report to https://github.com/llvm/llvm-project/issues/ and include the crash backtrace and instructions to reproduce the bug.
# | Stack dump:
# | 0.	Program arguments: /home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt -disable-output -passes=instcombine -ir-tracker-database=/home/gha/actions-runner/_work/llvm-project/llvm-project/build/test/Other/Output/ir-tracker-db.ll.tmp.db /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/test/Other/ir-tracker-db.ll
# |  #0 0x00000000051359b8 llvm::sys::PrintStackTrace(llvm::raw_ostream&, int) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/Unix/Signals.inc:880:13
# |  #1 0x0000000005132811 llvm::sys::RunSignalHandlers() /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/Signals.cpp:109:18
# |  #2 0x0000000005136b01 SignalHandler(int, siginfo_t*, void*) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/Unix/Signals.inc:448:38
# |  #3 0x00007ce7404ea330 (/lib/x86_64-linux-gnu/libc.so.6+0x45330)
# |  #4 0x00007ce740543b2c pthread_kill (/lib/x86_64-linux-gnu/libc.so.6+0x9eb2c)
# |  #5 0x00007ce7404ea27e raise (/lib/x86_64-linux-gnu/libc.so.6+0x4527e)
# |  #6 0x00007ce7404cd8ff abort (/lib/x86_64-linux-gnu/libc.so.6+0x288ff)
# |  #7 0x00000000050fac65 llvm::report_fatal_error(llvm::Twine const&, bool) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/ErrorHandling.cpp:137:5
# |  #8 0x00000000050faaa6 (/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt+0x50faaa6)
# |  #9 0x000000000661b8ba (/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt+0x661b8ba)
# | #10 0x00000000065f4a82 StringRef /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/include/llvm/ADT/StringRef.h:107:9
# | #11 0x00000000065f4a82 StringRef /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/include/llvm/ADT/StringRef.h:94:9
# | #12 0x00000000065f4a82 DebugifyEachInstrumentation /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/include/llvm/Transforms/Utils/Debugify.h:196:52
# | #13 0x00000000065f4a82 llvm::runPassPipeline(llvm::StringRef, llvm::Module&, llvm::TargetMachine*, llvm::TargetLibraryInfoImpl*, llvm::ToolOutputFile*, llvm::ToolOutputFile*, llvm::ToolOutputFile*, llvm::StringRef, llvm::ArrayRef<llvm::PassPlugin>, llvm::ArrayRef<std::function<void (llvm::PassBuilder&)>>, llvm::opt_tool::OutputKind, llvm::opt_tool::VerifierKind, bool, bool, bool, bool, bool, bool, bool, bool) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/tools/opt/NewPMDriver.cpp:440:31
# | #14 0x00000000050d4898 optMain /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/tools/opt/optdriver.cpp:0:10
# | #15 0x00007ce7404cf1ca (/lib/x86_64-linux-gnu/libc.so.6+0x2a1ca)
# | #16 0x00007ce7404cf28b __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x2a28b)
# | #17 0x00000000050ce365 _start (/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt+0x50ce365)
# `-----------------------------
# error: command failed with exit status: -6

--

```
</details>
<details>
<summary>LLVM.tools/llvm-ir-tracker/show.ll</summary>

```
Exit Code: -6

Command Output (stdout):
--
# RUN: at line 1
/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt -disable-output -passes=no-op-module -ir-tracker-database=/home/gha/actions-runner/_work/llvm-project/llvm-project/build/test/tools/llvm-ir-tracker/Output/show.ll.tmp.db /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/test/tools/llvm-ir-tracker/show.ll
# executed command: /home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt -disable-output -passes=no-op-module -ir-tracker-database=/home/gha/actions-runner/_work/llvm-project/llvm-project/build/test/tools/llvm-ir-tracker/Output/show.ll.tmp.db /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/test/tools/llvm-ir-tracker/show.ll
# .---command stderr------------
# | LLVM ERROR: -ir-tracker-database requires an LLVM build linked against SQLite3
# | PLEASE submit a bug report to https://github.com/llvm/llvm-project/issues/ and include the crash backtrace and instructions to reproduce the bug.
# | Stack dump:
# | 0.	Program arguments: /home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt -disable-output -passes=no-op-module -ir-tracker-database=/home/gha/actions-runner/_work/llvm-project/llvm-project/build/test/tools/llvm-ir-tracker/Output/show.ll.tmp.db /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/test/tools/llvm-ir-tracker/show.ll
# |  #0 0x00000000051359b8 llvm::sys::PrintStackTrace(llvm::raw_ostream&, int) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/Unix/Signals.inc:880:13
# |  #1 0x0000000005132811 llvm::sys::RunSignalHandlers() /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/Signals.cpp:109:18
# |  #2 0x0000000005136b01 SignalHandler(int, siginfo_t*, void*) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/Unix/Signals.inc:448:38
# |  #3 0x00007f3111de2330 (/lib/x86_64-linux-gnu/libc.so.6+0x45330)
# |  #4 0x00007f3111e3bb2c pthread_kill (/lib/x86_64-linux-gnu/libc.so.6+0x9eb2c)
# |  #5 0x00007f3111de227e raise (/lib/x86_64-linux-gnu/libc.so.6+0x4527e)
# |  #6 0x00007f3111dc58ff abort (/lib/x86_64-linux-gnu/libc.so.6+0x288ff)
# |  #7 0x00000000050fac65 llvm::report_fatal_error(llvm::Twine const&, bool) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/lib/Support/ErrorHandling.cpp:137:5
# |  #8 0x00000000050faaa6 (/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt+0x50faaa6)
# |  #9 0x000000000661b8ba (/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt+0x661b8ba)
# | #10 0x00000000065f4a82 StringRef /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/include/llvm/ADT/StringRef.h:107:9
# | #11 0x00000000065f4a82 StringRef /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/include/llvm/ADT/StringRef.h:94:9
# | #12 0x00000000065f4a82 DebugifyEachInstrumentation /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/include/llvm/Transforms/Utils/Debugify.h:196:52
# | #13 0x00000000065f4a82 llvm::runPassPipeline(llvm::StringRef, llvm::Module&, llvm::TargetMachine*, llvm::TargetLibraryInfoImpl*, llvm::ToolOutputFile*, llvm::ToolOutputFile*, llvm::ToolOutputFile*, llvm::StringRef, llvm::ArrayRef<llvm::PassPlugin>, llvm::ArrayRef<std::function<void (llvm::PassBuilder&)>>, llvm::opt_tool::OutputKind, llvm::opt_tool::VerifierKind, bool, bool, bool, bool, bool, bool, bool, bool) /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/tools/opt/NewPMDriver.cpp:440:31
# | #14 0x00000000050d4898 optMain /home/gha/actions-runner/_work/llvm-project/llvm-project/llvm/tools/opt/optdriver.cpp:0:10
# | #15 0x00007f3111dc71ca (/lib/x86_64-linux-gnu/libc.so.6+0x2a1ca)
# | #16 0x00007f3111dc728b __libc_start_main (/lib/x86_64-linux-gnu/libc.so.6+0x2a28b)
# | #17 0x00000000050ce365 _start (/home/gha/actions-runner/_work/llvm-project/llvm-project/build/bin/opt+0x50ce365)
# `-----------------------------
# error: command failed with exit status: -6

--

```
</details>

If these failures are unrelated to your changes (for example tests are broken or flaky at HEAD), please open an issue at https://github.com/llvm/llvm-project/issues and add the `infrastructure` label.

https://github.com/llvm/llvm-project/pull/191856