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

[via llvm-commits]

github-actions[bot] wrote:

<!--PREMERGE ADVISOR COMMENT: Windows-->
# :window: Windows x64 Test Results

* 133429 tests passed
* 3085 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: 3221225501

Command Output (stdout):
--
# RUN: at line 1
c:\_work\llvm-project\llvm-project\build\bin\opt.exe -disable-output -passes=instcombine -ir-tracker-database=C:\_work\llvm-project\llvm-project\build\test\Other\Output\ir-tracker-db.ll.tmp.db C:\_work\llvm-project\llvm-project\llvm\test\Other\ir-tracker-db.ll
# executed command: 'c:\_work\llvm-project\llvm-project\build\bin\opt.exe' -disable-output -passes=instcombine '-ir-tracker-database=C:\_work\llvm-project\llvm-project\build\test\Other\Output\ir-tracker-db.ll.tmp.db' 'C:\_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: c:\\_work\\llvm-project\\llvm-project\\build\\bin\\opt.exe -disable-output -passes=instcombine -ir-tracker-database=C:\\_work\\llvm-project\\llvm-project\\build\\test\\Other\\Output\\ir-tracker-db.ll.tmp.db C:\\_work\\llvm-project\\llvm-project\\llvm\\test\\Other\\ir-tracker-db.ll
# | Exception Code: 0xC000001D
# |  #0 0x00007ff6723d6506 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x926506)
# |  #1 0x00007ff81230bb04 (C:\Windows\System32\ucrtbase.dll+0x7bb04)
# |  #2 0x00007ff81230cad1 (C:\Windows\System32\ucrtbase.dll+0x7cad1)
# |  #3 0x00007ff671ed86ca (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x4286ca)
# |  #4 0x00007ff671ed84a5 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x4284a5)
# |  #5 0x00007ff672b7c633 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x10cc633)
# |  #6 0x00007ff671dded59 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x32ed59)
# |  #7 0x00007ff671ab6fb7 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x6fb7)
# |  #8 0x00007ff671ab1025 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x1025)
# |  #9 0x00007ff676586160 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x4ad6160)
# | #10 0x00007ff816a14cb0 (C:\Windows\System32\KERNEL32.DLL+0x14cb0)
# | #11 0x00007ff825a1edcb (C:\Windows\SYSTEM32\ntdll.dll+0x7edcb)
# `-----------------------------
# error: command failed with exit status: 0xc000001d

--

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

```
Exit Code: 3221225501

Command Output (stdout):
--
# RUN: at line 1
c:\_work\llvm-project\llvm-project\build\bin\opt.exe -disable-output -passes=no-op-module -ir-tracker-database=C:\_work\llvm-project\llvm-project\build\test\tools\llvm-ir-tracker\Output\show.ll.tmp.db C:\_work\llvm-project\llvm-project\llvm\test\tools\llvm-ir-tracker\show.ll
# executed command: 'c:\_work\llvm-project\llvm-project\build\bin\opt.exe' -disable-output -passes=no-op-module '-ir-tracker-database=C:\_work\llvm-project\llvm-project\build\test\tools\llvm-ir-tracker\Output\show.ll.tmp.db' 'C:\_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: c:\\_work\\llvm-project\\llvm-project\\build\\bin\\opt.exe -disable-output -passes=no-op-module -ir-tracker-database=C:\\_work\\llvm-project\\llvm-project\\build\\test\\tools\\llvm-ir-tracker\\Output\\show.ll.tmp.db C:\\_work\\llvm-project\\llvm-project\\llvm\\test\\tools\\llvm-ir-tracker\\show.ll
# | Exception Code: 0xC000001D
# |  #0 0x00007ff6723d6506 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x926506)
# |  #1 0x00007ff81230bb04 (C:\Windows\System32\ucrtbase.dll+0x7bb04)
# |  #2 0x00007ff81230cad1 (C:\Windows\System32\ucrtbase.dll+0x7cad1)
# |  #3 0x00007ff671ed86ca (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x4286ca)
# |  #4 0x00007ff671ed84a5 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x4284a5)
# |  #5 0x00007ff672b7c633 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x10cc633)
# |  #6 0x00007ff671dded59 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x32ed59)
# |  #7 0x00007ff671ab6fb7 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x6fb7)
# |  #8 0x00007ff671ab1025 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x1025)
# |  #9 0x00007ff676586160 (c:\_work\llvm-project\llvm-project\build\bin\opt.exe+0x4ad6160)
# | #10 0x00007ff816a14cb0 (C:\Windows\System32\KERNEL32.DLL+0x14cb0)
# | #11 0x00007ff825a1edcb (C:\Windows\SYSTEM32\ntdll.dll+0x7edcb)
# `-----------------------------
# error: command failed with exit status: 0xc000001d

--

```
</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