Origins.cpp

Go to the documentation of this file.

//===- Origins.cpp - Origin Implementation -----------------------*- 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
//
//===----------------------------------------------------------------------===//
 
#include "clang/Analysis/Analyses/LifetimeSafety/Origins.h"
#include "clang/AST/ASTContext.h"
#include "clang/AST/Attr.h"
#include "clang/AST/Decl.h"
#include "clang/AST/DeclCXX.h"
#include "clang/AST/DeclTemplate.h"
#include "clang/AST/Expr.h"
#include "clang/AST/ExprCXX.h"
#include "clang/AST/RecursiveASTVisitor.h"
#include "clang/AST/TypeBase.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeAnnotations.h"
#include "clang/Analysis/Analyses/LifetimeSafety/LifetimeStats.h"
#include "clang/Analysis/AnalysisDeclContext.h"
#include "llvm/ADT/StringMap.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,
      const OriginManager &OM, LifetimeSafetyStats &LSStats)
      : ExprToOriginList(ExprToOriginList), OM(OM), LSStats(LSStats) {}
  bool VisitExpr(Expr *E) {
    if (!OM.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;
  const OriginManager &OM;
  LifetimeSafetyStats &LSStats;
};
 
class LifetimeAnnotatedOriginTypeCollector
    : public RecursiveASTVisitor<LifetimeAnnotatedOriginTypeCollector> {
public:
  bool VisitCallExpr(const CallExpr *CE) {
    // Indirect calls (e.g., function pointers) are skipped because lifetime
    // annotations currently apply to declarations, not types.
    if (const auto *FD = CE->getDirectCallee()) {
      collect(FD, FD->getReturnType());
      collectCaptureBy(FD);
    }
    return true;
  }
 
  bool VisitCXXConstructExpr(const CXXConstructExpr *CCE) {
    collect(CCE->getConstructor(), CCE->getType());
    collectCaptureBy(CCE->getConstructor());
    return true;
  }
 
  bool shouldVisitLambdaBody() const { return false; }
  bool shouldVisitTemplateInstantiations() const { return true; }
 
  const llvm::SmallVector<QualType> &getCollectedTypes() const {
    return CollectedTypes;
  }
 
private:
  llvm::SmallVector<QualType> CollectedTypes;
 
  void collect(const FunctionDecl *FD, QualType RetType) {
    if (!FD)
      return;
    FD = getDeclWithMergedLifetimeBoundAttrs(FD);
 
    if (const auto *MD = dyn_cast<CXXMethodDecl>(FD);
        MD && MD->isInstance() && !isa<CXXConstructorDecl>(MD) &&
        implicitObjectParamIsLifetimeBound(MD)) {
      CollectedTypes.push_back(RetType);
      return;
    }
 
    for (const auto *Param : FD->parameters()) {
      if (Param->hasAttr<LifetimeBoundAttr>()) {
        CollectedTypes.push_back(RetType);
        return;
      }
    }
  }
 
  void collectCaptureBy(const FunctionDecl *FD) {
    if (!FD)
      return;
    FD = getDeclWithMergedLifetimeBoundAttrs(FD);
    const auto *MD = dyn_cast<CXXMethodDecl>(FD);
    bool IsInstance = MD && MD->isInstance();
    int Offset = (MD && MD->isImplicitObjectMemberFunction()) ? 1 : 0;
    for (const auto *Param : FD->parameters()) {
      if (auto *Attr = Param->getAttr<LifetimeCaptureByAttr>()) {
        for (int Idx : Attr->params()) {
          if (Idx == LifetimeCaptureByAttr::Global ||
              Idx == LifetimeCaptureByAttr::Unknown ||
              Idx == LifetimeCaptureByAttr::Invalid)
            continue;
          if (Idx == LifetimeCaptureByAttr::This) {
            if (IsInstance)
              CollectedTypes.push_back(MD->getFunctionObjectParameterType());
          } else if (int LogicalIdx = Idx - Offset;
                     LogicalIdx >= 0 &&
                     (unsigned)LogicalIdx < FD->getNumParams()) {
            CollectedTypes.push_back(
                FD->getParamDecl(LogicalIdx)->getType().getNonReferenceType());
          }
        }
      }
    }
  }
};
 
} // namespace
 
bool OriginManager::hasOrigins(QualType QT, bool IntrinsicOnly) const {
  if (QT->isPointerOrReferenceType() || isGslPointerType(QT))
    return true;
  if (!IntrinsicOnly &&
      LifetimeAnnotatedOriginTypes.contains(QT.getCanonicalType().getTypePtr()))
    return true;
  // An `_Atomic(T)` wraps T transparently for lifetime purposes (the atomic
  // holds the same value); see through it.
  if (const auto *AT = QT->getAs<AtomicType>())
    return hasOrigins(AT->getValueType(), IntrinsicOnly);
  const auto *RD = QT->getAsCXXRecordDecl();
  if (!RD)
    return false;
  // Standard library callable wrappers (e.g., std::function) can propagate the
  // stored lambda's origins.
  if (isStdCallableWrapperType(RD))
    return true;
  // TODO: Limit to lambdas for now. This will be extended to user-defined
  // structs with pointer-like fields.
  if (!RD->isLambda())
    return false;
  for (const auto *FD : RD->fields())
    if (hasOrigins(FD->getType(), IntrinsicOnly))
      return true;
  return false;
}
 
/// Determines if an expression has origins that need to be tracked.
///
/// An expression has origins if:
/// - It's a glvalue (has addressable storage), OR
/// - Its type is pointer-like (pointer, reference, or gsl::Pointer), OR
/// - Its type is registered for origin tracking (e.g., return type of a
/// [[clang::lifetimebound]] function)
///
/// Examples:
/// - `int x; x` : has origin (glvalue)
/// - `int* p; p` : has 2 origins (1 for glvalue and 1 for pointer type)
/// - `std::string_view{}` : has 1 origin (prvalue of pointer type)
/// - `42` : no origin (prvalue of non-pointer type)
/// - `x + y` : (where x, y are int) → no origin (prvalue of non-pointer type)
bool OriginManager::hasOrigins(const Expr *E) const {
  return E->isGLValue() || hasOrigins(E->getType());
}
 
/// Returns true if the declaration has its own storage that can be borrowed.
///
/// References generally have no storage - they are aliases to other storage.
/// For example:
///   int x;      // has storage (can issue loans to x's storage)
///   int& r = x; // no storage (r is an alias to x's storage)
///   int* p;     // has storage (the pointer variable p itself has storage)
///
/// TODO: Handle lifetime extension. References initialized by temporaries
/// can have storage when the temporary's lifetime is extended:
///   const int& r = 42; // temporary has storage, lifetime extended
///   Foo&& f = Foo{};   // temporary has storage, lifetime extended
/// Currently, this function returns false for all reference types.
bool doesDeclHaveStorage(const ValueDecl *D) {
  return !D->getType()->isReferenceType();
}
 
OriginManager::OriginManager(const AnalysisDeclContext &AC)
    : AST(AC.getASTContext()) {
  collectLifetimeAnnotatedOriginTypes(AC);
  initializeThisOrigins(AC.getDecl());
}
 
void OriginManager::initializeThisOrigins(const Decl *D) {
  const auto *MD = llvm::dyn_cast_or_null<CXXMethodDecl>(D);
  if (!MD || !MD->isInstance())
    return;
  // Lambdas can capture 'this' from the surrounding context, but in that case
  // 'this' does not refer to the lambda object itself.
  if (const CXXRecordDecl *P = MD->getParent(); P && P->isLambda())
    return;
  ThisOrigins = buildListForType(MD->getThisType(), MD);
}
 
OriginList *OriginManager::createNode(const ValueDecl *D, QualType QT,
                                      bool NamesDeclStorage) {
  OriginID NewID = getNextOriginID();
  AllOrigins.emplace_back(NewID, D, QT.getTypePtrOrNull(), NamesDeclStorage);
  return new (ListAllocator.Allocate<OriginList>()) OriginList(NewID);
}
 
OriginList *OriginManager::createNode(const Expr *E, QualType QT,
                                      bool NamesDeclStorage) {
  OriginID NewID = getNextOriginID();
  AllOrigins.emplace_back(NewID, E, QT.getTypePtrOrNull(), NamesDeclStorage);
  return new (ListAllocator.Allocate<OriginList>()) OriginList(NewID);
}
 
OriginList *OriginManager::createSingleOriginList(OriginID OID) {
  return new (ListAllocator.Allocate<OriginList>()) OriginList(OID);
}
 
template <typename T>
OriginList *OriginManager::buildListForType(QualType QT, const T *Node,
                                            bool NamesDeclStorage) {
  assert(hasOrigins(QT) && "buildListForType called for non-pointer type");
  // `_Atomic(T)` is transparent for lifetime purposes: build the node for T.
  if (const auto *AT = QT->getAs<AtomicType>())
    return buildListForType(AT->getValueType(), Node, NamesDeclStorage);
  OriginList *Head = createNode(Node, QT, NamesDeclStorage);
 
  if (QT->isPointerOrReferenceType()) {
    QualType PointeeTy = QT->getPointeeType();
    // We recurse if the pointee type is pointer-like, to build the next
    // level in the origin tree. E.g., for T*& / View&.
    if (hasOrigins(PointeeTy))
      Head->setInnerOriginList(buildListForType(PointeeTy, Node));
  }
  return Head;
}
 
OriginList *OriginManager::getOrCreateList(const ValueDecl *D) {
  if (!hasOrigins(D->getType()))
    return nullptr;
  auto It = DeclToList.find(D);
  if (It != DeclToList.end())
    return It->second;
  return DeclToList[D] = buildListForType(D->getType(), D);
}
 
OriginList *OriginManager::getOrCreateList(const Expr *E) {
  if (auto *ParenIgnored = E->IgnoreParens(); ParenIgnored != E)
    return getOrCreateList(ParenIgnored);
  // We do not see CFG stmts for ExprWithCleanups. Simply peel them.
  if (const ExprWithCleanups *EWC = dyn_cast<ExprWithCleanups>(E))
    return getOrCreateList(EWC->getSubExpr());
 
  // An OpaqueValueExpr is a placeholder for an already-evaluated subexpression
  // (e.g. the common operand of `a ?: b`) and is not itself a CFG statement, so
  // reuse its source's origins rather than flowing into a fresh node.
  if (const auto *OVE = dyn_cast<OpaqueValueExpr>(E))
    if (const Expr *Src = OVE->getSourceExpr())
      return getOrCreateList(Src);
 
  if (!hasOrigins(E))
    return nullptr;
 
  auto It = ExprToList.find(E);
  if (It != ExprToList.end())
    return It->second;
 
  QualType Type = E->getType();
  // Special handling for 'this' expressions to share origins with the method's
  // implicit object parameter.
  if (isa<CXXThisExpr>(E) && ThisOrigins)
    return *ThisOrigins;
 
  // Special handling for expressions referring to a decl to share origins with
  // the underlying decl.
  const ValueDecl *ReferencedDecl = nullptr;
  if (auto *DRE = dyn_cast<DeclRefExpr>(E))
    ReferencedDecl = DRE->getDecl();
  else if (auto *ME = dyn_cast<MemberExpr>(E))
    if (auto *Field = dyn_cast<FieldDecl>(ME->getMemberDecl());
        Field && isa<CXXThisExpr>(ME->getBase()->IgnoreParenImpCasts()))
      ReferencedDecl = Field;
  if (ReferencedDecl) {
    OriginList *Head = nullptr;
    // For non-reference declarations (e.g., `int* p`), the expression is an
    // lvalue (addressable) that can be borrowed, so we create an outer origin
    // for the lvalue itself, with the pointee being the declaration's list.
    // This models taking the address: `&p` borrows the storage of `p`, not what
    // `p` points to.
    if (doesDeclHaveStorage(ReferencedDecl)) {
      // `this->f` reaches its field through `this` instead of naming it.
      Head = createNode(E, QualType{},
                        /*NamesDeclStorage=*/isa<DeclRefExpr>(E));
      // This ensures origin sharing: multiple expressions to the same
      // declaration share the same underlying origins.
      Head->setInnerOriginList(getOrCreateList(ReferencedDecl));
    } else {
      // For reference-typed declarations (e.g., `int& r = p`) which have no
      // storage, the DeclRefExpr directly reuses the declaration's list since
      // references don't add an extra level of indirection at the expression
      // level.
      Head = getOrCreateList(ReferencedDecl);
    }
    return ExprToList[E] = Head;
  }
 
  // If E is an lvalue , it refers to storage. We model this storage as the
  // first level of origin list, as if it were a reference, because l-values are
  // addressable.
  if (E->isGLValue() && !Type->isReferenceType())
    Type = AST.getLValueReferenceType(Type);
  // A qualification conversion of a glvalue names what its operand names. It is
  // not transparent: for class types it is the node alias notes report.
  bool NamesDeclStorage = false;
  if (const auto *CE = dyn_cast<CastExpr>(E);
      CE && CE->getCastKind() == CK_NoOp && E->isGLValue())
    if (const OriginList *Sub = getOrCreateList(CE->getSubExpr()))
      NamesDeclStorage = getOrigin(Sub->getOuterOriginID()).NamesDeclStorage;
  return ExprToList[E] = buildListForType(Type, E, NamesDeclStorage);
}
 
void OriginManager::dump(OriginID OID, llvm::raw_ostream &OS) const {
  OS << OID << " (";
  Origin O = getOrigin(OID);
  if (const ValueDecl *VD = O.getDecl()) {
    OS << "Decl: " << VD->getNameAsString();
  } else if (const Expr *E = O.getExpr()) {
    OS << "Expr: " << E->getStmtClassName();
    if (auto *DRE = dyn_cast<DeclRefExpr>(E)) {
      if (const ValueDecl *VD = DRE->getDecl())
        OS << ", Decl: " << VD->getNameAsString();
    }
  } else {
    OS << "Unknown";
  }
  if (O.Ty)
    OS << ", Type : " << QualType(O.Ty, 0).getAsString();
  OS << ")";
}
 
const Origin &OriginManager::getOrigin(OriginID ID) const {
  assert(ID.Value < AllOrigins.size());
  return AllOrigins[ID.Value];
}
 
void OriginManager::collectMissingOrigins(Stmt &FunctionBody,
                                          LifetimeSafetyStats &LSStats) {
  MissingOriginCollector Collector(this->ExprToList, *this, LSStats);
  Collector.TraverseStmt(const_cast<Stmt *>(&FunctionBody));
}
 
void OriginManager::collectLifetimeAnnotatedOriginTypes(
    const AnalysisDeclContext &AC) {
  LifetimeAnnotatedOriginTypeCollector Collector;
  if (Stmt *Body = AC.getBody())
    Collector.TraverseStmt(Body);
  if (const auto *CD = dyn_cast<CXXConstructorDecl>(AC.getDecl()))
    for (const auto *Init : CD->inits())
      Collector.TraverseStmt(Init->getInit());
  for (QualType QT : Collector.getCollectedTypes())
    registerLifetimeAnnotatedOriginType(QT);
}
 
void OriginManager::registerLifetimeAnnotatedOriginType(QualType QT) {
  if (!QT->getAsCXXRecordDecl() || hasOrigins(QT))
    return;
 
  LifetimeAnnotatedOriginTypes.insert(QT.getCanonicalType().getTypePtr());
}
 
} // namespace clang::lifetimes::internal