[Debugify] Expose original debug info preservation check as CC1 option
In order to test the preservation of the original Debug Info metadata
in your projects, a front end option could be very useful, since users
usually report that a concrete entity (e.g. variable x, or function fn2())
is missing debug info. The [0] is an example of running the utility
on GDB Project.
This depends on: D82546 and D82545.
Differential Revision: https://reviews.llvm.org/D82547
GitOrigin-RevId: 8420a5332486c682c1aaddbcb58a571869d19832
diff --git a/docs/HowToUpdateDebugInfo.rst b/docs/HowToUpdateDebugInfo.rst
index b9bdc48..58bdc11 100644
--- a/docs/HowToUpdateDebugInfo.rst
+++ b/docs/HowToUpdateDebugInfo.rst
@@ -376,6 +376,17 @@
$ llvm-original-di-preservation.py sample.json sample.html
+Testing of original debug info preservation can be invoked from front-end level
+as follows:
+
+.. code-block:: bash
+
+ # Test each pass.
+ $ clang -Xclang -fverify-debuginfo-preserve -g -O2 sample.c
+
+ # Test each pass and export the issues report into the JSON file.
+ $ clang -Xclang -fverify-debuginfo-preserve -Xclang -fverify-debuginfo-preserve-export=sample.json -g -O2 sample.c
+
Mutation testing for MIR-level transformations
----------------------------------------------
