PlatformDarwin.h

Go to the documentation of this file.

//===-- PlatformDarwin.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
//
//===----------------------------------------------------------------------===//
 
#ifndef LLDB_SOURCE_PLUGINS_PLATFORM_MACOSX_PLATFORMDARWIN_H
#define LLDB_SOURCE_PLUGINS_PLATFORM_MACOSX_PLATFORMDARWIN_H
 
#include "Plugins/Platform/POSIX/PlatformPOSIX.h"
#include "lldb/Host/FileSystem.h"
#include "lldb/Host/ProcessLaunchInfo.h"
#include "lldb/Utility/ArchSpec.h"
#include "lldb/Utility/ConstString.h"
#include "lldb/Utility/FileSpec.h"
#include "lldb/Utility/FileSpecList.h"
#include "lldb/Utility/Status.h"
#include "lldb/Utility/StructuredData.h"
#include "lldb/Utility/XcodeSDK.h"
#include "lldb/lldb-forward.h"
#include "llvm/ADT/SmallVector.h"
#include "llvm/ADT/StringMap.h"
#include "llvm/ADT/StringRef.h"
#include "llvm/Support/Error.h"
#include "llvm/Support/VersionTuple.h"
#include "llvm/TargetParser/Triple.h"
 
#include <mutex>
#include <optional>
#include <string>
#include <vector>
 
namespace lldb_private {
class BreakpointSite;
class Debugger;
class Module;
class ModuleSpec;
class Process;
class ProcessLaunchInfo;
class Stream;
class Target;
 
class PlatformDarwin : public PlatformPOSIX {
public:
  using PlatformPOSIX::PlatformPOSIX;
 
  ~PlatformDarwin() override;
 
  static lldb::PlatformSP CreateInstance(bool force, const ArchSpec *arch);
 
  static void DebuggerInitialize(lldb_private::Debugger &debugger);
 
  static void Initialize();
 
  static void Terminate();
 
  static llvm::StringRef GetPluginNameStatic() { return "darwin"; }
 
  static llvm::StringRef GetDescriptionStatic();
 
  Status PutFile(const FileSpec &source, const FileSpec &destination,
                 uint32_t uid = UINT32_MAX, uint32_t gid = UINT32_MAX) override;
 
  // Platform functions
  Status ResolveSymbolFile(Target &target, const ModuleSpec &sym_spec,
                           FileSpec &sym_file) override;
 
  llvm::SmallDenseMap<FileSpec, LoadScriptFromSymFile>
  LocateExecutableScriptingResourcesForPlatform(
      Target *target, Module &module_spec, Stream &feedback_stream) override;
 
  bool IsSymbolFileTrusted(Module &module) override;
 
  Status GetSharedModule(const ModuleSpec &module_spec, Target &target,
                         lldb::ModuleSP &module_sp,
                         llvm::SmallVectorImpl<lldb::ModuleSP> *old_modules,
                         bool *did_create_ptr) override;
 
  Status GetModuleFromSharedCaches(
      const ModuleSpec &module_spec, Target &target, lldb::ModuleSP &module_sp,
      llvm::SmallVectorImpl<lldb::ModuleSP> *old_modules, bool *did_create_ptr);
 
  size_t GetSoftwareBreakpointTrapOpcode(Target &target,
                                         BreakpointSite *bp_site) override;
 
  lldb::BreakpointSP SetThreadCreationBreakpoint(Target &target) override;
 
  bool ModuleIsExcludedForUnconstrainedSearches(
      Target &target, const lldb::ModuleSP &module_sp) override;
 
  void
  ARMGetSupportedArchitectures(std::vector<ArchSpec> &archs,
                               std::optional<llvm::Triple::OSType> os = {});
 
  void x86GetSupportedArchitectures(std::vector<ArchSpec> &archs);
 
  uint32_t GetResumeCountForLaunchInfo(ProcessLaunchInfo &launch_info) override;
 
  lldb::ProcessSP DebugProcess(ProcessLaunchInfo &launch_info,
                               Debugger &debugger, Target &target,
                               Status &error) override;
 
  void CalculateTrapHandlerSymbolNames() override;
 
  llvm::VersionTuple GetOSVersion(Process *process = nullptr) override;
 
  bool SupportsModules() override { return true; }
 
  std::string GetFullNameForDylib(llvm::StringRef basename) override;
 
  FileSpec LocateExecutable(const char *basename) override;
 
  Status LaunchProcess(ProcessLaunchInfo &launch_info) override;
 
  Args GetExtraStartupCommands() override;
 
  static std::tuple<llvm::VersionTuple, llvm::StringRef>
  ParseVersionBuildDir(llvm::StringRef str);
 
  llvm::Expected<StructuredData::DictionarySP>
  FetchExtendedCrashInformation(Process &process) override;
 
  /// The generic implementation parses the SDKs out of debug info, but only
  /// Darwin SDKs come in public and internal flavors, so detecting a conflict
  /// between the two is done here.
  llvm::Expected<std::pair<XcodeSDKAndSysroot, bool>>
  GetSDKPathFromDebugInfo(Module &module) override;
  using Platform::GetSDKPathFromDebugInfo;
 
  llvm::Expected<std::string>
  ResolveSDKPathFromDebugInfo(Module &module) override;
 
  llvm::Expected<std::string>
  ResolveSDKPathFromDebugInfo(CompileUnit &unit) override;
 
  /// Resolve an XcodeSDK to an on-disk path under a Progress event.
  static llvm::Expected<FileSpec> ResolveXcodeSDK(const XcodeSDK &sdk);
 
  /// Same, but prefer the sysroot the SDK was used from when it exists on
  /// this machine.
  static llvm::Expected<FileSpec>
  ResolveXcodeSDK(const XcodeSDKAndSysroot &sdk);
 
  /// Helper function for \c LocateExecutableScriptingResources
  /// which gathers FileSpecs for executable scripts (currently
  /// just Python) from a .dSYM Python directory.
  ///
  /// \param[out] feedback_stream Any warnings/errors are printed into this
  /// stream.
  ///
  /// \param[in] module_spec FileSpec of the Module for which to locate
  /// scripting resources.
  ///
  /// \param[in] target Target which owns the ScriptInterpreter which is
  /// eventually used for loading the scripting resources.
  ///
  /// \param[in] symfile_spec FileSpec for the SymbolFile inside the Module's
  /// dSYM directory. The scripting resources are loaded from the adjacent
  /// Resources directory in the same dSYM.
  /// E.g., \c /path/to/.dSYM/Contents/Resources/DWARF/a.out
  ///
  static llvm::SmallDenseMap<FileSpec, LoadScriptFromSymFile>
  LocateExecutableScriptingResourcesFromDSYM(Stream &feedback_stream,
                                             FileSpec module_spec,
                                             const Target &target,
                                             const FileSpec &symfile_spec);
 
  llvm::Expected<FileSpecList>
  GetSafeAutoLoadPaths(const Target &target) const override;
 
protected:
  static const char *GetCompatibleArch(ArchSpec::Core core, size_t idx);
 
  struct CrashInfoAnnotations {
    uint64_t version;          // unsigned long
    uint64_t message;          // char *
    uint64_t signature_string; // char *
    uint64_t backtrace;        // char *
    uint64_t message2;         // char *
    uint64_t thread;           // uint64_t
    uint64_t dialog_mode;      // unsigned int
    uint64_t abort_cause;      // unsigned int
  };
 
  /// Extract the `__crash_info` annotations from each of the target's
  /// modules.
  ///
  /// If the platform have a crashed processes with a `__crash_info` section,
  /// extract the section to gather the messages annotations and the abort
  /// cause.
  ///
  /// \param[in] process
  ///     The crashed process.
  ///
  /// \return
  ///     A  structured data array containing at each entry in each entry, the
  ///     module spec, its UUID, the crash messages and the abort cause.
  ///     \b nullptr if process has no crash information annotations.
  StructuredData::ArraySP ExtractCrashInfoAnnotations(Process &process);
 
  /// Extract the `Application Specific Information` messages from a crash
  /// report.
  StructuredData::DictionarySP ExtractAppSpecificInfo(Process &process);
 
  void ReadLibdispatchOffsetsAddress(Process *process);
 
  void ReadLibdispatchOffsets(Process *process);
 
  virtual bool CheckLocalSharedCache() const { return IsHost(); }
 
  struct SDKEnumeratorInfo {
    FileSpec found_path;
    XcodeSDK::Type sdk_type;
  };
 
  static FileSystem::EnumerateDirectoryResult
  DirectoryEnumerator(void *baton, llvm::sys::fs::file_type file_type,
                      llvm::StringRef path);
 
  static FileSpec FindSDKInXcodeForModules(XcodeSDK::Type sdk_type,
                                           const FileSpec &sdks_spec);
 
  static FileSpec GetSDKDirectoryForModules(XcodeSDK::Type sdk_type);
 
  void
  AddClangModuleCompilationOptionsForSDKType(Target *target,
                                             std::vector<std::string> &options,
                                             XcodeSDK::Type sdk_type);
 
  Status FindBundleBinaryInExecSearchPaths(
      const ModuleSpec &module_spec, Target &target, lldb::ModuleSP &module_sp,
      llvm::SmallVectorImpl<lldb::ModuleSP> *old_modules, bool *did_create_ptr);
 
  // The OSType where lldb is running.
  static llvm::Triple::OSType GetHostOSType();
 
  std::string m_developer_directory;
  llvm::StringMap<std::string> m_sdk_path;
  std::mutex m_sdk_path_mutex;
 
private:
  PlatformDarwin(const PlatformDarwin &) = delete;
  const PlatformDarwin &operator=(const PlatformDarwin &) = delete;
};
 
} // namespace lldb_private
 
#endif // LLDB_SOURCE_PLUGINS_PLATFORM_MACOSX_PLATFORMDARWIN_H