Debug Info

DebugInfo extracts and normalizes source-level metadata from LLVM IR.

Headers: include/Analysis/DebugInfo/

Implementation: lib/Analysis/DebugInfo/

Overview

This subsystem bridges LLVM debug metadata and Lotus analyses. It is used by bug checkers and reporting code that need stable source locations, loop structure, and metadata-derived identities.

Main components

  • DebugInfoAnalysis extracts reusable debug information from a module.

  • MetadataManager utilities provide instruction-, module-, and annotation-level metadata access.

  • LoopStructure and MetadataEntry help analyses reason about source structure beyond raw IR.

Typical use cases

  • Attach file and line information to bug reports.

  • Recover loop structure or source annotations from LLVM metadata.

  • Support source-aware post-processing of analysis results.

See also