contrib/llvm-project/lldb/source/Plugins/Platform/POSIX/PlatformPOSIX.h

   1 //===-- PlatformPOSIX.h -----------------------------------------*- C++ -*-===//
   2 //
   3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
   4 // See https://llvm.org/LICENSE.txt for license information.
   5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
   6 //
   7 //===----------------------------------------------------------------------===//
   8
   9 #ifndef liblldb_PlatformPOSIX_h_
  10 #define liblldb_PlatformPOSIX_h_
  11
  12 #include <map>
  13 #include <memory>
  14
  15 #include "lldb/Interpreter/Options.h"
  16 #include "lldb/Target/RemoteAwarePlatform.h"
  17
  18 class PlatformPOSIX : public lldb_private::RemoteAwarePlatform {
  19 public:
  20   PlatformPOSIX(bool is_host);
  21
  22   ~PlatformPOSIX() override;
  23
  24   // lldb_private::Platform functions
  25
  26   lldb_private::OptionGroupOptions *
  27   GetConnectionOptions(lldb_private::CommandInterpreter &interpreter) override;
  28
  29   lldb_private::Status PutFile(const lldb_private::FileSpec &source,
  30                                const lldb_private::FileSpec &destination,
  31                                uint32_t uid = UINT32_MAX,
  32                                uint32_t gid = UINT32_MAX) override;
  33
  34   lldb_private::Status
  35   GetFile(const lldb_private::FileSpec &source,
  36           const lldb_private::FileSpec &destination) override;
  37
  38   const lldb::UnixSignalsSP &GetRemoteUnixSignals() override;
  39
  40   lldb_private::Status ResolveExecutable(
  41       const lldb_private::ModuleSpec &module_spec, lldb::ModuleSP &module_sp,
  42       const lldb_private::FileSpecList *module_search_paths_ptr) override;
  43
  44   lldb::ProcessSP Attach(lldb_private::ProcessAttachInfo &attach_info,
  45                          lldb_private::Debugger &debugger,
  46                          lldb_private::Target *target, // Can be nullptr, if
  47                                                        // nullptr create a new
  48                                                        // target, else use
  49                                                        // existing one
  50                          lldb_private::Status &error) override;
  51
  52   lldb::ProcessSP DebugProcess(lldb_private::ProcessLaunchInfo &launch_info,
  53                                lldb_private::Debugger &debugger,
  54                                lldb_private::Target *target, // Can be nullptr,
  55                                                              // if nullptr
  56                                                              // create a new
  57                                                              // target, else use
  58                                                              // existing one
  59                                lldb_private::Status &error) override;
  60
  61   std::string GetPlatformSpecificConnectionInformation() override;
  62
  63   void CalculateTrapHandlerSymbolNames() override;
  64
  65   lldb_private::Status ConnectRemote(lldb_private::Args &args) override;
  66
  67   lldb_private::Status DisconnectRemote() override;
  68
  69   uint32_t DoLoadImage(lldb_private::Process *process,
  70                        const lldb_private::FileSpec &remote_file,
  71                        const std::vector<std::string> *paths,
  72                        lldb_private::Status &error,
  73                        lldb_private::FileSpec *loaded_image) override;
  74
  75   lldb_private::Status UnloadImage(lldb_private::Process *process,
  76                                    uint32_t image_token) override;
  77
  78   size_t ConnectToWaitingProcesses(lldb_private::Debugger &debugger,
  79                                    lldb_private::Status &error) override;
  80
  81   lldb_private::ConstString GetFullNameForDylib(lldb_private::ConstString basename) override;
  82
  83 protected:
  84   std::unique_ptr<lldb_private::OptionGroupPlatformRSync>
  85       m_option_group_platform_rsync;
  86   std::unique_ptr<lldb_private::OptionGroupPlatformSSH>
  87       m_option_group_platform_ssh;
  88   std::unique_ptr<lldb_private::OptionGroupPlatformCaching>
  89       m_option_group_platform_caching;
  90
  91   std::map<lldb_private::CommandInterpreter *,
  92            std::unique_ptr<lldb_private::OptionGroupOptions>>
  93       m_options;
  94
  95   lldb_private::Status
  96   EvaluateLibdlExpression(lldb_private::Process *process, const char *expr_cstr,
  97                           llvm::StringRef expr_prefix,
  98                           lldb::ValueObjectSP &result_valobj_sp);
  99
 100   std::unique_ptr<lldb_private::UtilityFunction>
 101   MakeLoadImageUtilityFunction(lldb_private::ExecutionContext &exe_ctx,
 102                                lldb_private::Status &error);
 103
 104   virtual
 105   llvm::StringRef GetLibdlFunctionDeclarations(lldb_private::Process *process);
 106
 107 private:
 108   DISALLOW_COPY_AND_ASSIGN(PlatformPOSIX);
 109 };
 110
 111 #endif // liblldb_PlatformPOSIX_h_