Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
21 commits
Select commit Hold shift + click to select a range
fd8693c
Adding the lifetime stats collection logic to AnalysisBasedWarnings
DEBADRIBASAK Nov 5, 2025
3ff81d6
Correcting the signature of getMissingOrigins
DEBADRIBASAK Nov 5, 2025
984582f
Merge branch 'main' into lifetime-stats
DEBADRIBASAK Nov 5, 2025
499d3b0
Adding a LifetimeSafetyStats struct to keep track of missing origins …
DEBADRIBASAK Nov 18, 2025
f274e84
Merge branch 'main' into lifetime-stats
DEBADRIBASAK Nov 18, 2025
8341778
Moving the missing origin calculation logic after lifetime analysis u…
DEBADRIBASAK Nov 26, 2025
56b2dd9
Removing an outdated comment
DEBADRIBASAK Nov 26, 2025
0081a95
Merge branch 'main' into lifetime-stats
DEBADRIBASAK Nov 27, 2025
0ca0f58
Made MissingOriginCollector internal to Origins.cpp
DEBADRIBASAK Nov 27, 2025
a30fa2e
Introducing a dedicated file for LifetimeSafetyStats and changing the…
DEBADRIBASAK Nov 27, 2025
8264809
Separating the StmtClassName and QualType for missing origin counts a…
DEBADRIBASAK Nov 28, 2025
6f123ed
Removing unused headers from AnalysisBasedWarnings
DEBADRIBASAK Nov 28, 2025
06f232e
Accepting LifetimeStats instead of individual maps inside Missingorig…
DEBADRIBASAK Dec 3, 2025
ea1eca9
Modified the LifetimeStats to use constant pointer to Type returned b…
DEBADRIBASAK Dec 11, 2025
f0d444c
Fomatting changes in variable names
DEBADRIBASAK Dec 11, 2025
cf92f90
Added a LIT test for missing origins stats and put a nullptr check in…
DEBADRIBASAK Dec 17, 2025
f0dab14
Merge branch 'main' into lifetime-stats
DEBADRIBASAK Dec 18, 2025
e03a850
Modifying the missing origin calculation logic after multi-origin tra…
DEBADRIBASAK Dec 18, 2025
2f68912
Removing hasOrigin functions from LifetimeAnnotations. This logic is …
DEBADRIBASAK Dec 19, 2025
0bf4b2f
Merge branch 'main' into lifetime-stats
DEBADRIBASAK Dec 19, 2025
27a4b26
Merge branch 'main' into lifetime-stats
DEBADRIBASAK Dec 19, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,10 @@
#define LLVM_CLANG_ANALYSIS_ANALYSES_LIFETIMESAFETY_H

#include "clang/Analysis/Analyses/LifetimeSafety/Facts.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LiveOrigins.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LoanPropagation.h"
#include "clang/Analysis/Analyses/LifetimeSafety/Origins.h"
#include "clang/Analysis/AnalysisDeclContext.h"

namespace clang::lifetimes {
Expand Down Expand Up @@ -62,9 +64,14 @@ class LifetimeSafetyReporter {

/// The main entry point for the analysis.
void runLifetimeSafetyAnalysis(AnalysisDeclContext &AC,
LifetimeSafetyReporter *Reporter);
LifetimeSafetyReporter *Reporter,
LifetimeSafetyStats &Stats, bool CollectStats);

namespace internal {

void collectLifetimeStats(AnalysisDeclContext &AC, OriginManager &OM,
LifetimeSafetyStats &Stats);

/// An object to hold the factories for immutable collections, ensuring
/// that all created states share the same underlying memory management.
struct LifetimeFactory {
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
//===- LifetimeStats.h - Lifetime Safety Statistics --------------*- C++-* -===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===------------------------------------------------------------------------===//
//
// This file declares the data structures and utility function for collection of
// statistics related to Lifetime Safety analysis.
//
//===------------------------------------------------------------------------===//

#ifndef LLVM_CLANG_ANALYSIS_ANALYSES_LIFETIMESAFETY_LIFETIMESTATS_H
#define LLVM_CLANG_ANALYSIS_ANALYSES_LIFETIMESAFETY_LIFETIMESTATS_H

#include "clang/AST/TypeBase.h"
#include "llvm/ADT/DenseMap.h"
#include "llvm/ADT/StringMap.h"

namespace clang::lifetimes {
/// A structure to hold the statistics related to LifetimeAnalysis.
/// These are accumulated across all analyzed functions and printed
/// when -print-stats is enabled.
struct LifetimeSafetyStats {
/// A map from `StmtClassName` to their missing origin counts.
llvm::StringMap<unsigned> ExprStmtClassToMissingOriginCount;
/// A map from `QualType` to their missing origin counts.
llvm::DenseMap<const clang::Type *, unsigned> ExprTypeToMissingOriginCount;
};

/// Utility function to print missing origin stats.
void printStats(const LifetimeSafetyStats &Stats);
} // namespace clang::lifetimes

#endif // LLVM_CLANG_ANALYSIS_ANALYSES_LIFETIMESAFETY_LIFETIMESTATS_H
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,9 @@
#include "clang/AST/Decl.h"
#include "clang/AST/Expr.h"
#include "clang/AST/TypeBase.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "clang/Analysis/Analyses/LifetimeSafety/Utils.h"
#include "llvm/Support/raw_ostream.h"

namespace clang::lifetimes::internal {

Expand Down Expand Up @@ -150,6 +152,9 @@ class OriginManager {

void dump(OriginID OID, llvm::raw_ostream &OS) const;

/// Collects statistics about expressions that lack associated origins.
void collectMissingOrigins(Stmt &FunctionBody, LifetimeSafetyStats &LSStats);

private:
OriginID getNextOriginID() { return NextOriginID++; }

Expand Down
8 changes: 6 additions & 2 deletions clang/include/clang/Sema/AnalysisBasedWarnings.h
Original file line number Diff line number Diff line change
Expand Up @@ -14,9 +14,8 @@
#define LLVM_CLANG_SEMA_ANALYSISBASEDWARNINGS_H

#include "clang/AST/Decl.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "clang/Sema/ScopeInfo.h"
#include "llvm/ADT/DenseMap.h"
#include "llvm/ADT/MapVector.h"
#include <memory>

namespace clang {
Expand Down Expand Up @@ -101,6 +100,11 @@ class AnalysisBasedWarnings {
/// a single function.
unsigned MaxUninitAnalysisBlockVisitsPerFunction;

/// Statistics collected during lifetime safety analysis.
/// These are accumulated across all analyzed functions and printed
/// when -print-stats is enabled.
clang::lifetimes::LifetimeSafetyStats LSStats;

/// @}

public:
Expand Down
1 change: 1 addition & 0 deletions clang/lib/Analysis/LifetimeSafety/CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ add_clang_library(clangAnalysisLifetimeSafety
LifetimeAnnotations.cpp
LifetimeSafety.cpp
LiveOrigins.cpp
LifetimeStats.cpp
Loans.cpp
LoanPropagation.cpp
Origins.cpp
Expand Down
15 changes: 14 additions & 1 deletion clang/lib/Analysis/LifetimeSafety/LifetimeSafety.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,10 @@
#include "clang/Analysis/Analyses/LifetimeSafety/Checker.h"
#include "clang/Analysis/Analyses/LifetimeSafety/Facts.h"
#include "clang/Analysis/Analyses/LifetimeSafety/FactsGenerator.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LiveOrigins.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LoanPropagation.h"
#include "clang/Analysis/Analyses/LifetimeSafety/Origins.h"
#include "clang/Analysis/AnalysisDeclContext.h"
#include "clang/Analysis/CFG.h"
#include "llvm/ADT/FoldingSet.h"
Expand Down Expand Up @@ -90,11 +92,22 @@ void LifetimeSafetyAnalysis::run() {

runLifetimeChecker(*LoanPropagation, *LiveOrigins, *FactMgr, AC, Reporter);
}

void collectLifetimeStats(AnalysisDeclContext &AC, OriginManager &OM,
LifetimeSafetyStats &Stats) {
Stmt *FunctionBody = AC.getBody();
if (FunctionBody == nullptr)
return;
OM.collectMissingOrigins(*FunctionBody, Stats);
}
} // namespace internal

void runLifetimeSafetyAnalysis(AnalysisDeclContext &AC,
LifetimeSafetyReporter *Reporter) {
LifetimeSafetyReporter *Reporter,
LifetimeSafetyStats &Stats, bool CollectStats) {
internal::LifetimeSafetyAnalysis Analysis(AC, Reporter);
Analysis.run();
if (CollectStats)
collectLifetimeStats(AC, Analysis.getFactManager().getOriginMgr(), Stats);
}
} // namespace clang::lifetimes
36 changes: 36 additions & 0 deletions clang/lib/Analysis/LifetimeSafety/LifetimeStats.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
//===- LifetimeStats.cpp - Lifetime Safety Statistics -*------------ C++-*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
//
// This file defines the data structures and utility function for collection of
// staticstics related to Lifetimesafety analysis.
//
//===----------------------------------------------------------------------===//

#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "clang/AST/TypeBase.h"
#include "llvm/Support/raw_ostream.h"

namespace clang::lifetimes {
void printStats(const LifetimeSafetyStats &Stats) {
llvm::errs() << "\n*** LifetimeSafety Missing Origin per QualType: "
"(QualType : count) :\n\n";
unsigned TotalMissingOrigins = 0;
for (const auto &[ExprType, MissingOriginCount] : Stats.ExprTypeToMissingOriginCount) {
QualType QT = QualType(ExprType, 0);
llvm::errs() << QT.getAsString() << " : " << MissingOriginCount << '\n';
TotalMissingOrigins += MissingOriginCount;
}
llvm::errs() << "\n\n*** LifetimeSafety Missing Origin per StmtClassName: "
"(StmtClassName : count) :\n\n";
for (const auto &[ExprStmtClassName, MissingOriginCount] : Stats.ExprStmtClassToMissingOriginCount) {
llvm::errs() << ExprStmtClassName << " : " << MissingOriginCount << '\n';
}
llvm::errs() << "\nTotal missing origins: " << TotalMissingOrigins << "\n";
llvm::errs() << "\n****************************************\n";
}
} // namespace clang::lifetimes
38 changes: 38 additions & 0 deletions clang/lib/Analysis/LifetimeSafety/Origins.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,10 @@
//===----------------------------------------------------------------------===//

#include "clang/Analysis/Analyses/LifetimeSafety/Origins.h"
#include "clang/AST/Expr.h"
#include "clang/AST/RecursiveASTVisitor.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "llvm/ADT/StringMap.h"
#include "clang/AST/ASTContext.h"
#include "clang/AST/Attr.h"
#include "clang/AST/DeclCXX.h"
Expand All @@ -15,6 +19,34 @@
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeAnnotations.h"

namespace clang::lifetimes::internal {
namespace {
/// A utility class to traverse the function body in the analysis
/// context and collect the count of expressions with missing origins.
class MissingOriginCollector
: public RecursiveASTVisitor<MissingOriginCollector> {
public:
MissingOriginCollector(
const llvm::DenseMap<const clang::Expr *, OriginList *> &ExprToOriginList,
LifetimeSafetyStats &LSStats)
: ExprToOriginList(ExprToOriginList), LSStats(LSStats) {}
bool VisitExpr(Expr *E) {
if (!hasOrigins(E))
return true;
// Check if we have an origin for this expression.
if (!ExprToOriginList.contains(E)) {
// No origin found: count this as missing origin.
LSStats.ExprTypeToMissingOriginCount[E->getType().getTypePtr()]++;
LSStats.ExprStmtClassToMissingOriginCount[std::string(
E->getStmtClassName())]++;
}
return true;
}

private:
const llvm::DenseMap<const clang::Expr *, OriginList *> &ExprToOriginList;
LifetimeSafetyStats &LSStats;
};
} // namespace

bool hasOrigins(QualType QT) {
return QT->isPointerOrReferenceType() || isGslPointerType(QT);
Expand Down Expand Up @@ -157,4 +189,10 @@ const Origin &OriginManager::getOrigin(OriginID ID) const {
return AllOrigins[ID.Value];
}

void OriginManager::collectMissingOrigins(Stmt &FunctionBody,
LifetimeSafetyStats &LSStats) {
MissingOriginCollector Collector(this->ExprToList, LSStats);
Collector.TraverseStmt(const_cast<Stmt *>(&FunctionBody));
}

} // namespace clang::lifetimes::internal
4 changes: 3 additions & 1 deletion clang/lib/Sema/AnalysisBasedWarnings.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -3135,7 +3135,8 @@ void clang::sema::AnalysisBasedWarnings::IssueWarnings(
if (EnableLifetimeSafetyAnalysis && S.getLangOpts().CPlusPlus) {
if (AC.getCFG()) {
lifetimes::LifetimeSafetyReporterImpl LifetimeSafetyReporter(S);
lifetimes::runLifetimeSafetyAnalysis(AC, &LifetimeSafetyReporter);
lifetimes::runLifetimeSafetyAnalysis(AC, &LifetimeSafetyReporter, LSStats,
S.CollectStats);
}
}
// Check for violations of "called once" parameter properties.
Expand Down Expand Up @@ -3231,4 +3232,5 @@ void clang::sema::AnalysisBasedWarnings::PrintStats() const {
<< " average block visits per function.\n"
<< " " << MaxUninitAnalysisBlockVisitsPerFunction
<< " max block visits per function.\n";
clang::lifetimes::printStats(LSStats);
}
5 changes: 5 additions & 0 deletions clang/test/Sema/warn-lifetime-safety-missing-origin-stats.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
// RUN: %clang_cc1 -print-stats -fexperimental-lifetime-safety -Wexperimental-lifetime-safety %s 2>&1 | FileCheck %s


// CHECK: *** LifetimeSafety Missing Origin per QualType: (QualType : count) :
// CHECK: *** LifetimeSafety Missing Origin per StmtClassName: (StmtClassName : count) :