70 lines
2.5 KiB
C++
70 lines
2.5 KiB
C++
//===-- ModelInjector.h -----------------------------------------*- 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
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
///
|
|
/// \file
|
|
/// This file defines the clang::ento::ModelInjector class which implements the
|
|
/// clang::CodeInjector interface. This class is responsible for injecting
|
|
/// function definitions that were synthesized from model files.
|
|
///
|
|
/// Model files allow definitions of functions to be lazily constituted for functions
|
|
/// which lack bodies in the original source code. This allows the analyzer
|
|
/// to more precisely analyze code that calls such functions, analyzing the
|
|
/// artificial definitions (which typically approximate the semantics of the
|
|
/// called function) when called by client code. These definitions are
|
|
/// reconstituted lazily, on-demand, by the static analyzer engine.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_CLANG_SA_FRONTEND_MODELINJECTOR_H
|
|
#define LLVM_CLANG_SA_FRONTEND_MODELINJECTOR_H
|
|
|
|
#include "clang/Analysis/CodeInjector.h"
|
|
#include "llvm/ADT/StringMap.h"
|
|
|
|
namespace clang {
|
|
|
|
class CompilerInstance;
|
|
class ASTUnit;
|
|
class ASTReader;
|
|
class NamedDecl;
|
|
class Module;
|
|
|
|
namespace ento {
|
|
class ModelInjector : public CodeInjector {
|
|
public:
|
|
ModelInjector(CompilerInstance &CI);
|
|
Stmt *getBody(const FunctionDecl *D) override;
|
|
Stmt *getBody(const ObjCMethodDecl *D) override;
|
|
|
|
private:
|
|
/// Synthesize a body for a declaration
|
|
///
|
|
/// This method first looks up the appropriate model file based on the
|
|
/// model-path configuration option and the name of the declaration that is
|
|
/// looked up. If no model were synthesized yet for a function with that name
|
|
/// it will create a new compiler instance to parse the model file using the
|
|
/// ASTContext, Preprocessor, SourceManager of the original compiler instance.
|
|
/// The former resources are shared between the two compiler instance, so the
|
|
/// newly created instance have to "leak" these objects, since they are owned
|
|
/// by the original instance.
|
|
///
|
|
/// The model-path should be either an absolute path or relative to the
|
|
/// working directory of the compiler.
|
|
void onBodySynthesis(const NamedDecl *D);
|
|
|
|
CompilerInstance &CI;
|
|
|
|
// FIXME: double memoization is redundant, with memoization both here and in
|
|
// BodyFarm.
|
|
llvm::StringMap<Stmt *> Bodies;
|
|
};
|
|
}
|
|
}
|
|
|
|
#endif
|