//===-- EPCEHFrameRegistrar.h - EPC based eh-frame registration -*- 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
 
//
 
//===----------------------------------------------------------------------===//
 
//
 
// ExecutorProcessControl based eh-frame registration.
 
//
 
//===----------------------------------------------------------------------===//
 
 
 
#ifndef LLVM_EXECUTIONENGINE_ORC_EPCEHFRAMEREGISTRAR_H
 
#define LLVM_EXECUTIONENGINE_ORC_EPCEHFRAMEREGISTRAR_H
 
 
 
#include "llvm/ExecutionEngine/JITLink/EHFrameSupport.h"
 
#include "llvm/ExecutionEngine/Orc/Shared/ExecutorAddress.h"
 
 
 
namespace llvm {
 
namespace orc {
 
 
 
class ExecutionSession;
 
 
 
/// Register/Deregisters EH frames in a remote process via a
 
/// ExecutorProcessControl instance.
 
class EPCEHFrameRegistrar : public jitlink::EHFrameRegistrar {
 
public:
 
  /// Create from a ExecutorProcessControl instance alone. This will use
 
  /// the EPC's lookupSymbols method to find the registration/deregistration
 
  /// funciton addresses by name.
 
  ///
 
  /// If RegistrationFunctionsDylib is non-None then it will be searched to
 
  /// find the registration functions. If it is None then the process dylib
 
  /// will be loaded to find the registration functions.
 
  static Expected<std::unique_ptr<EPCEHFrameRegistrar>>
 
  Create(ExecutionSession &ES,
 
         std::optional<ExecutorAddr> RegistrationFunctionsDylib = std::nullopt);
 
 
 
  /// Create a EPCEHFrameRegistrar with the given ExecutorProcessControl
 
  /// object and registration/deregistration function addresses.
 
  EPCEHFrameRegistrar(ExecutionSession &ES,
 
                      ExecutorAddr RegisterEHFrameWrapperFnAddr,
 
                      ExecutorAddr DeregisterEHFRameWrapperFnAddr)
 
      : ES(ES), RegisterEHFrameWrapperFnAddr(RegisterEHFrameWrapperFnAddr),
 
        DeregisterEHFrameWrapperFnAddr(DeregisterEHFRameWrapperFnAddr) {}
 
 
 
  Error registerEHFrames(ExecutorAddrRange EHFrameSection) override;
 
  Error deregisterEHFrames(ExecutorAddrRange EHFrameSection) override;
 
 
 
private:
 
  ExecutionSession &ES;
 
  ExecutorAddr RegisterEHFrameWrapperFnAddr;
 
  ExecutorAddr DeregisterEHFrameWrapperFnAddr;
 
};
 
 
 
} // end namespace orc
 
} // end namespace llvm
 
 
 
#endif // LLVM_EXECUTIONENGINE_ORC_EPCEHFRAMEREGISTRAR_H