A lot of comments in LLDB are surrounded by an ASCII line to delimit the begging and end of the comment. Its use is not really consistent across the code base, sometimes the lines are longer, sometimes they are shorter and sometimes they are omitted. Furthermore, it looks kind of weird with the 80 column limit, where the comment actually extends past the line, but not by much. Furthermore, when /// is used for Doxygen comments, it looks particularly odd. And when // is used, it incorrectly gives the impression that it's actually a Doxygen comment. I assume these lines were added to improve distinguishing between comments and code. However, given that todays editors and IDEs do a great job at highlighting comments, I think it's worth to drop this for the sake of consistency. The alternative is fixing all the inconsistencies, which would create a lot more churn. Differential revision: https://reviews.llvm.org/D60508 llvm-svn: 358135
110 lines
3.8 KiB
C++
110 lines
3.8 KiB
C++
//===-- PlatformRemoteDarwinDevice.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 liblldb_PlatformRemoteDarwinDevice_h_
|
|
#define liblldb_PlatformRemoteDarwinDevice_h_
|
|
|
|
#include <string>
|
|
|
|
#include "PlatformDarwin.h"
|
|
#include "lldb/Utility/FileSpec.h"
|
|
|
|
#include "llvm/Support/FileSystem.h"
|
|
|
|
class PlatformRemoteDarwinDevice : public PlatformDarwin {
|
|
public:
|
|
PlatformRemoteDarwinDevice();
|
|
|
|
~PlatformRemoteDarwinDevice() override;
|
|
|
|
// lldb_private::Platform functions
|
|
lldb_private::Status ResolveExecutable(
|
|
const lldb_private::ModuleSpec &module_spec, lldb::ModuleSP &module_sp,
|
|
const lldb_private::FileSpecList *module_search_paths_ptr) override;
|
|
|
|
void GetStatus(lldb_private::Stream &strm) override;
|
|
|
|
virtual lldb_private::Status
|
|
GetSymbolFile(const lldb_private::FileSpec &platform_file,
|
|
const lldb_private::UUID *uuid_ptr,
|
|
lldb_private::FileSpec &local_file);
|
|
|
|
lldb_private::Status
|
|
GetSharedModule(const lldb_private::ModuleSpec &module_spec,
|
|
lldb_private::Process *process, lldb::ModuleSP &module_sp,
|
|
const lldb_private::FileSpecList *module_search_paths_ptr,
|
|
lldb::ModuleSP *old_module_sp_ptr,
|
|
bool *did_create_ptr) override;
|
|
|
|
void
|
|
AddClangModuleCompilationOptions(lldb_private::Target *target,
|
|
std::vector<std::string> &options) override {
|
|
return PlatformDarwin::AddClangModuleCompilationOptionsForSDKType(
|
|
target, options, PlatformDarwin::SDKType::iPhoneOS);
|
|
}
|
|
|
|
protected:
|
|
struct SDKDirectoryInfo {
|
|
SDKDirectoryInfo(const lldb_private::FileSpec &sdk_dir_spec);
|
|
lldb_private::FileSpec directory;
|
|
lldb_private::ConstString build;
|
|
llvm::VersionTuple version;
|
|
bool user_cached;
|
|
};
|
|
|
|
typedef std::vector<SDKDirectoryInfo> SDKDirectoryInfoCollection;
|
|
|
|
std::mutex m_sdk_dir_mutex;
|
|
SDKDirectoryInfoCollection m_sdk_directory_infos;
|
|
std::string m_device_support_directory;
|
|
std::string m_device_support_directory_for_os_version;
|
|
std::string m_build_update;
|
|
uint32_t m_last_module_sdk_idx;
|
|
uint32_t m_connected_module_sdk_idx;
|
|
|
|
bool UpdateSDKDirectoryInfosIfNeeded();
|
|
|
|
const char *GetDeviceSupportDirectory();
|
|
|
|
const char *GetDeviceSupportDirectoryForOSVersion();
|
|
|
|
const SDKDirectoryInfo *GetSDKDirectoryForLatestOSVersion();
|
|
|
|
const SDKDirectoryInfo *GetSDKDirectoryForCurrentOSVersion();
|
|
|
|
static lldb_private::FileSystem::EnumerateDirectoryResult
|
|
GetContainedFilesIntoVectorOfStringsCallback(void *baton,
|
|
llvm::sys::fs::file_type ft,
|
|
llvm::StringRef path);
|
|
|
|
uint32_t FindFileInAllSDKs(const char *platform_file_path,
|
|
lldb_private::FileSpecList &file_list);
|
|
|
|
bool GetFileInSDK(const char *platform_file_path, uint32_t sdk_idx,
|
|
lldb_private::FileSpec &local_file);
|
|
|
|
uint32_t FindFileInAllSDKs(const lldb_private::FileSpec &platform_file,
|
|
lldb_private::FileSpecList &file_list);
|
|
|
|
uint32_t GetConnectedSDKIndex();
|
|
|
|
// Get index of SDK in SDKDirectoryInfoCollection by its pointer and return
|
|
// UINT32_MAX if that SDK not found.
|
|
uint32_t GetSDKIndexBySDKDirectoryInfo(const SDKDirectoryInfo *sdk_info);
|
|
|
|
|
|
virtual void GetDeviceSupportDirectoryNames (std::vector<std::string> &dirnames) = 0;
|
|
|
|
virtual std::string GetPlatformName () = 0;
|
|
|
|
private:
|
|
DISALLOW_COPY_AND_ASSIGN(PlatformRemoteDarwinDevice);
|
|
};
|
|
|
|
#endif // liblldb_PlatformRemoteDarwinDevice_h_
|