44#include "llvm/ADT/STLExtras.h"
45#include "llvm/ADT/StringTable.h"
46#include "llvm/Support/Error.h"
47#include "llvm/Support/FileSystem.h"
48#include "llvm/Support/Threading.h"
49#include "llvm/Support/VersionTuple.h"
52#include <TargetConditionals.h>
58#define OPTTABLE_STR_TABLE_CODE
59#include "clang/Driver/Options.inc"
60#undef OPTTABLE_STR_TABLE_CODE
64 llvm::StringRef str_ref(
string);
65 llvm::SmallVector<llvm::StringRef> candidates;
66 str_ref.split(candidates,
'|');
67 for (
auto candidate : candidates) {
68 if (!(candidate ==
"EXC_BAD_ACCESS"
69 || candidate ==
"EXC_BAD_INSTRUCTION"
70 || candidate ==
"EXC_ARITHMETIC"
71 || candidate ==
"EXC_RESOURCE"
72 || candidate ==
"EXC_GUARD"
73 || candidate ==
"EXC_SYSCALL")) {
75 candidate.str().c_str());
113 return "Darwin platform plug-in.";
121#define LLDB_PROPERTIES_platformdarwin
122#include "PlatformMacOSXProperties.inc"
124#define LLDB_PROPERTIES_platformdarwin
126#include "PlatformMacOSXPropertiesEnum.inc"
132 static constexpr llvm::StringLiteral g_setting_name(
"darwin");
133 return g_setting_name;
137 m_collection_sp = std::make_shared<OptionValueProperties>(GetSettingName());
138 m_collection_sp->Initialize(g_platformdarwin_properties);
144 const uint32_t idx = ePropertyIgnoredExceptions;
146 m_collection_sp->GetPropertyAtIndexAsOptionValueString(idx);
147 assert(option_value);
152 const uint32_t idx = ePropertyIgnoredExceptions;
154 m_collection_sp->GetPropertyAtIndexAsOptionValueString(idx);
155 assert(option_value);
169 const bool is_global_setting =
false;
172 "Properties for the Darwin platform plug-in.", is_global_setting);
180 std::string ignored_exceptions
182 if (ignored_exceptions.empty())
185 std::string packet =
"QSetIgnoredExceptions:";
186 packet.append(ignored_exceptions);
218 ObjectFile *objfile = symfile->GetObjectFile();
222 llvm::StringRef(symfile_spec.
GetPath())
223 .contains_insensitive(
".dSYM/Contents/Resources/DWARF") &&
226 std::string module_basename(
228 std::string original_module_basename(module_basename);
230 bool was_keyword =
false;
240 std::replace(module_basename.begin(), module_basename.end(),
'.',
242 std::replace(module_basename.begin(), module_basename.end(),
' ',
244 std::replace(module_basename.begin(), module_basename.end(),
'-',
248 if (script_interpreter &&
250 module_basename.insert(module_basename.begin(),
'_');
260 path_string.
Printf(
"%s/../Python/%s.py",
262 module_basename.c_str());
263 original_path_string.
Printf(
264 "%s/../Python/%s.py",
266 original_module_basename.c_str());
275 if (module_basename != original_module_basename &&
277 const char *reason_for_complaint =
278 was_keyword ?
"conflicts with a keyword"
279 :
"contains reserved characters";
282 "warning: the symbol file '%s' contains a debug "
283 "script. However, its name"
284 " '%s' %s and as such cannot be loaded. LLDB will"
285 " load '%s' instead. Consider removing the file with "
286 "the malformed name to"
287 " eliminate this warning.\n",
288 symfile_spec.
GetPath().c_str(),
289 original_path_string.
GetData(), reason_for_complaint,
293 "warning: the symbol file '%s' contains a debug "
294 "script. However, its name"
295 " %s and as such cannot be loaded. If you intend"
296 " to have this script loaded, please rename '%s' to "
298 symfile_spec.
GetPath().c_str(), reason_for_complaint,
303 file_list.
Append(script_fspec);
311 if (module_spec.
GetFilename() == filename_no_extension)
347 module_spec, process, module_sp, module_search_paths_ptr, old_modules,
355 module_search_paths_ptr, old_modules,
359 if (!module_sp && module_search_paths_ptr && platform_file) {
364 if (platform_file == bundle_directory) {
369 new_module_spec, process, module_sp,
nullptr, old_modules,
378 platform_file.
GetPath(platform_path,
sizeof(platform_path));
379 const size_t bundle_directory_len =
380 bundle_directory.
GetPath(bundle_dir,
sizeof(bundle_dir));
382 size_t num_module_search_paths = module_search_paths_ptr->
GetSize();
383 for (
size_t i = 0; i < num_module_search_paths; ++i) {
384 const size_t search_path_len =
386 new_path,
sizeof(new_path));
387 if (search_path_len <
sizeof(new_path)) {
388 snprintf(new_path + search_path_len,
389 sizeof(new_path) - search_path_len,
"/%s",
390 platform_path + bundle_directory_len);
396 new_module_spec, process, module_sp,
nullptr, old_modules,
400 module_sp->SetPlatformFileSpec(new_file_spec);
411 module_sp->SetPlatformFileSpec(module_spec.
GetFileSpec());
418 const uint8_t *trap_opcode =
nullptr;
419 uint32_t trap_opcode_size = 0;
420 bool bp_is_thumb =
false;
424 case llvm::Triple::aarch64_32:
425 case llvm::Triple::aarch64: {
427 static const uint8_t g_arm64_breakpoint_opcode[] = {0x00, 0x00, 0x20, 0xD4};
428 trap_opcode = g_arm64_breakpoint_opcode;
429 trap_opcode_size =
sizeof(g_arm64_breakpoint_opcode);
432 case llvm::Triple::thumb:
435 case llvm::Triple::arm: {
436 static const uint8_t g_arm_breakpoint_opcode[] = {0xFE, 0xDE, 0xFF, 0xE7};
437 static const uint8_t g_thumb_breakpooint_opcode[] = {0xFE, 0xDE};
443 bp_is_thumb = bp_loc_sp->GetAddress().GetAddressClass() ==
447 trap_opcode = g_thumb_breakpooint_opcode;
448 trap_opcode_size =
sizeof(g_thumb_breakpooint_opcode);
451 trap_opcode = g_arm_breakpoint_opcode;
452 trap_opcode_size =
sizeof(g_arm_breakpoint_opcode);
455 case llvm::Triple::ppc:
456 case llvm::Triple::ppc64: {
457 static const uint8_t g_ppc_breakpoint_opcode[] = {0x7F, 0xC0, 0x00, 0x08};
458 trap_opcode = g_ppc_breakpoint_opcode;
459 trap_opcode_size =
sizeof(g_ppc_breakpoint_opcode);
466 if (trap_opcode && trap_opcode_size) {
468 return trap_opcode_size;
478 ObjectFile *obj_file = module_sp->GetObjectFile();
487 std::vector<ArchSpec> &archs) {
488 ArchSpec host_arch = HostInfo::GetArchitecture(HostInfo::eArchKindDefault);
489 archs.push_back(host_arch);
492 archs.push_back(
ArchSpec(
"x86_64-apple-macosx"));
493 archs.push_back(HostInfo::GetArchitecture(HostInfo::eArchKind32));
495 ArchSpec host_arch64 = HostInfo::GetArchitecture(HostInfo::eArchKind64);
497 archs.push_back(HostInfo::GetArchitecture(HostInfo::eArchKind32));
506 static const char *g_arm64e_compatible_archs[] = {
507 "arm64e",
"arm64",
"armv7",
"armv7f",
"armv7k",
"armv7s",
508 "armv7m",
"armv7em",
"armv6m",
"armv6",
"armv5",
"armv4",
509 "arm",
"thumbv7",
"thumbv7f",
"thumbv7k",
"thumbv7s",
"thumbv7m",
510 "thumbv7em",
"thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
512 return {g_arm64e_compatible_archs};
515 static const char *g_arm64_compatible_archs[] = {
516 "arm64",
"armv7",
"armv7f",
"armv7k",
"armv7s",
"armv7m",
517 "armv7em",
"armv6m",
"armv6",
"armv5",
"armv4",
"arm",
518 "thumbv7",
"thumbv7f",
"thumbv7k",
"thumbv7s",
"thumbv7m",
"thumbv7em",
519 "thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
521 return {g_arm64_compatible_archs};
524 static const char *g_armv7_compatible_archs[] = {
525 "armv7",
"armv6m",
"armv6",
"armv5",
"armv4",
"arm",
526 "thumbv7",
"thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
528 return {g_armv7_compatible_archs};
531 static const char *g_armv7f_compatible_archs[] = {
532 "armv7f",
"armv7",
"armv6m",
"armv6",
"armv5",
533 "armv4",
"arm",
"thumbv7f",
"thumbv7",
"thumbv6m",
534 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
536 return {g_armv7f_compatible_archs};
539 static const char *g_armv7k_compatible_archs[] = {
540 "armv7k",
"armv7",
"armv6m",
"armv6",
"armv5",
541 "armv4",
"arm",
"thumbv7k",
"thumbv7",
"thumbv6m",
542 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
544 return {g_armv7k_compatible_archs};
547 static const char *g_armv7s_compatible_archs[] = {
548 "armv7s",
"armv7",
"armv6m",
"armv6",
"armv5",
549 "armv4",
"arm",
"thumbv7s",
"thumbv7",
"thumbv6m",
550 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
552 return {g_armv7s_compatible_archs};
555 static const char *g_armv7m_compatible_archs[] = {
556 "armv7m",
"armv7",
"armv6m",
"armv6",
"armv5",
557 "armv4",
"arm",
"thumbv7m",
"thumbv7",
"thumbv6m",
558 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
560 return {g_armv7m_compatible_archs};
563 static const char *g_armv7em_compatible_archs[] = {
564 "armv7em",
"armv7",
"armv6m",
"armv6",
"armv5",
565 "armv4",
"arm",
"thumbv7em",
"thumbv7",
"thumbv6m",
566 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
568 return {g_armv7em_compatible_archs};
571 static const char *g_armv6m_compatible_archs[] = {
572 "armv6m",
"armv6",
"armv5",
"armv4",
"arm",
573 "thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
575 return {g_armv6m_compatible_archs};
578 static const char *g_armv6_compatible_archs[] = {
579 "armv6",
"armv5",
"armv4",
"arm",
580 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
582 return {g_armv6_compatible_archs};
585 static const char *g_armv5_compatible_archs[] = {
586 "armv5",
"armv4",
"arm",
"thumbv5",
"thumbv4t",
"thumb",
588 return {g_armv5_compatible_archs};
591 static const char *g_armv4_compatible_archs[] = {
597 return {g_armv4_compatible_archs};
607 std::vector<ArchSpec> &archs, std::optional<llvm::Triple::OSType> os) {
612 triple.setArchName(arch);
613 triple.setVendor(llvm::Triple::VendorType::Apple);
621 static FileSpec g_xcode_select_filespec;
623 if (!g_xcode_select_filespec) {
624 FileSpec xcode_select_cmd(
"/usr/bin/xcode-select");
626 int exit_status = -1;
628 std::string command_output;
632 &exit_status, &signo, &command_output,
633 std::chrono::seconds(2),
635 if (status.
Success() && exit_status == 0 && !command_output.empty()) {
636 size_t first_non_newline = command_output.find_last_not_of(
"\r\n");
637 if (first_non_newline != std::string::npos) {
638 command_output.erase(first_non_newline + 1);
640 g_xcode_select_filespec =
FileSpec(command_output);
645 return g_xcode_select_filespec;
650 static const char *g_bp_names[] = {
651 "start_wqthread",
"_pthread_wqthread",
"_pthread_start",
654 static const char *g_bp_modules[] = {
"libsystem_c.dylib",
655 "libSystem.B.dylib"};
658 for (
size_t i = 0; i < std::size(g_bp_modules); i++) {
659 const char *bp_module = g_bp_modules[i];
663 bool internal =
true;
664 bool hardware =
false;
667 std::size(g_bp_names), eFunctionNameTypeFull,
670 bp_sp->SetBreakpointKind(
"thread-creation");
681 std::string shell_string = shell.
GetPath();
682 const char *shell_name = strrchr(shell_string.c_str(),
'/');
683 if (shell_name ==
nullptr)
684 shell_name = shell_string.c_str();
688 if (strcmp(shell_name,
"sh") == 0) {
692 if (launch_info.
GetEnvironment().lookup(
"COMMAND_MODE") ==
"legacy")
695 }
else if (strcmp(shell_name,
"csh") == 0 ||
696 strcmp(shell_name,
"tcsh") == 0 ||
697 strcmp(shell_name,
"zsh") == 0) {
733 static FileSpec g_command_line_tools_filespec;
735 if (!g_command_line_tools_filespec) {
739 g_command_line_tools_filespec = command_line_tools_path;
743 return g_command_line_tools_filespec;
747 void *baton, llvm::sys::fs::file_type file_type, llvm::StringRef path) {
767 const bool find_directories =
true;
768 const bool find_files =
false;
769 const bool find_other =
true;
773 enumerator_info.
sdk_type = sdk_type;
776 sdks_spec.
GetPath(), find_directories, find_files, find_other,
786 FileSpec sdks_spec = HostInfo::GetXcodeContentsDirectory();
810 llvm_unreachable(
"unsupported sdk");
817 llvm::VersionTuple version = HostInfo::GetOSVersion();
819 if (!version.empty()) {
831 FileSpec native_sdk_spec = sdks_spec;
833 native_sdk_name.
Printf(
"MacOSX%u.%u.sdk", version.getMajor(),
834 version.getMinor().value_or(0));
838 return native_sdk_spec;
847std::tuple<llvm::VersionTuple, llvm::StringRef>
849 llvm::StringRef build;
850 llvm::StringRef version_str;
851 llvm::StringRef build_str;
852 std::tie(version_str, build_str) = dir.split(
' ');
853 llvm::VersionTuple version;
854 if (!version.tryParse(version_str) ||
856 if (build_str.consume_front(
"(")) {
857 size_t pos = build_str.find(
')');
858 build = build_str.slice(0, pos);
862 return std::make_tuple(version, build);
865llvm::Expected<StructuredData::DictionarySP>
867 static constexpr llvm::StringLiteral crash_info_key(
"Crash-Info Annotations");
868 static constexpr llvm::StringLiteral asi_info_key(
869 "Application Specific Information");
876 if (!process_dict_sp->GetValueForKeyAsArray(crash_info_key, annotations)) {
878 if (new_annotations_sp && new_annotations_sp->GetSize()) {
879 process_dict_sp->AddItem(crash_info_key, new_annotations_sp);
880 annotations = new_annotations_sp.get();
886 if (!process_dict_sp->GetValueForKeyAsDictionary(asi_info_key,
887 app_specific_info)) {
889 if (new_app_specific_info_sp && new_app_specific_info_sp->GetSize()) {
890 process_dict_sp->AddItem(asi_info_key, new_app_specific_info_sp);
891 app_specific_info = new_app_specific_info_sp.get();
897 return process_dict_sp->
GetSize() ? process_dict_sp :
nullptr;
911 std::string module_name = module->GetSpecificationDescription();
915 if (module_name ==
"/usr/lib/dyld")
919 LLDB_LOG(log,
"Module {0} doesn't have any section!", module_name);
925 LLDB_LOG(log,
"Module {0} doesn't have section {1}!", module_name,
930 addr_t load_addr = crash_info->GetLoadBaseAddress(&target);
933 LLDB_LOG(log,
"Module {0} has an invalid '{1}' section load address: {2}",
934 module_name, section_name, load_addr);
942 expected_size,
error);
944 if (expected_size != bytes_read ||
error.Fail()) {
945 LLDB_LOG(log,
"Failed to read {0} section from memory in module {1}: {2}",
946 section_name, module_name,
error);
953 "Annotation version lower than 5 unsupported! Module {0} has "
954 "version {1} instead.",
955 module_name, annotations.
version);
960 LLDB_LOG(log,
"No message available for module {0}.", module_name);
968 if (message.empty() || bytes_read != message.size() ||
error.Fail()) {
969 LLDB_LOG(log,
"Failed to read the message from memory in module {0}: {1}",
975 if (message.back() ==
'\n')
979 LLDB_LOG(log,
"No message2 available for module {0}.", module_name);
981 std::string message2;
985 if (!message2.empty() && bytes_read == message2.size() &&
error.Success())
986 if (message2.back() ==
'\n')
990 std::make_shared<StructuredData::Dictionary>();
992 entry_sp->AddStringItem(
"image", module->GetFileSpec().GetPath(
false));
993 entry_sp->AddStringItem(
"uuid", module->GetUUID().GetAsString());
994 entry_sp->AddStringItem(
"message", message);
995 entry_sp->AddStringItem(
"message2", message2);
996 entry_sp->AddIntegerItem(
"abort-cause", annotations.
abort_cause);
998 array_sp->AddItem(entry_sp);
1008 if (!metadata_sp || !metadata_sp->GetSize() || !metadata_sp->HasKey(
"asi"))
1012 if (!metadata_sp->GetValueForKeyAsDictionary(
"asi", asi))
1016 std::make_shared<StructuredData::Dictionary>();
1018 auto flatten_asi_dict = [&dict_sp](llvm::StringRef key,
1031 asi->
ForEach(flatten_asi_dict);
1038 const std::vector<std::string> apple_arguments = {
1039 "-x",
"objective-c++",
"-fobjc-arc",
1040 "-fblocks",
"-D_ISO646_H",
"-D__ISO646_H",
1041 "-fgnuc-version=4.2.1"};
1043 options.insert(options.end(), apple_arguments.begin(), apple_arguments.end());
1046 bool use_current_os_version =
false;
1048 auto get_host_os = []() {
return HostInfo::GetTargetTriple().getOS(); };
1051 use_current_os_version = get_host_os() == llvm::Triple::MacOSX;
1054 use_current_os_version = get_host_os() == llvm::Triple::IOS;
1057 use_current_os_version = get_host_os() == llvm::Triple::TvOS;
1060 use_current_os_version = get_host_os() == llvm::Triple::WatchOS;
1063 use_current_os_version = get_host_os() == llvm::Triple::XROS;
1069 llvm::VersionTuple version;
1070 if (use_current_os_version)
1076 if (exe_module_sp) {
1077 ObjectFile *object_file = exe_module_sp->GetObjectFile();
1086#define OPTION(PREFIX_OFFSET, NAME_OFFSET, VAR, ...) \
1087 llvm::StringRef opt_##VAR = OptionStrTable[NAME_OFFSET]; \
1089#include "clang/Driver/Options.inc"
1091 minimum_version_option <<
'-';
1094 minimum_version_option << opt_mmacos_version_min_EQ;
1097 minimum_version_option << opt_mios_simulator_version_min_EQ;
1100 minimum_version_option << opt_mios_version_min_EQ;
1103 minimum_version_option << opt_mtvos_simulator_version_min_EQ;
1106 minimum_version_option << opt_mtvos_version_min_EQ;
1109 minimum_version_option << opt_mwatchos_simulator_version_min_EQ;
1112 minimum_version_option << opt_mwatchos_version_min_EQ;
1122 info.
type = sdk_type;
1123 LLDB_LOGF(log,
"Clang modules on %s are not supported",
1128 minimum_version_option << version.getAsString();
1129 options.emplace_back(std::string(minimum_version_option.
GetString()));
1138 sysroot_spec =
FileSpec(*path_or_err);
1141 path_or_err.takeError(),
1142 "Failed to resolve SDK path: {0}");
1148 std::lock_guard<std::mutex> guard(
m_mutex);
1153 options.push_back(
"-isysroot");
1154 options.push_back(sysroot_spec.
GetPath());
1173 llvm::VersionTuple result;
1174 if (!result.tryParse(env.lookup(
"SIMULATOR_RUNTIME_VERSION")))
1177 std::string dyld_root_path = env.lookup(
"DYLD_ROOT_PATH");
1178 if (!dyld_root_path.empty()) {
1179 dyld_root_path +=
"/System/Library/CoreServices/SystemVersion.plist";
1181 std::string product_version;
1184 if (!result.tryParse(product_version))
1192 return llvm::VersionTuple();
1201 static std::vector<FileSpec> g_executable_dirs;
1205 static llvm::once_flag g_once_flag;
1206 llvm::call_once(g_once_flag, []() {
1209 FileSpec xcode_contents_dir = HostInfo::GetXcodeContentsDirectory();
1210 if (xcode_contents_dir) {
1211 FileSpec xcode_lldb_resources = xcode_contents_dir;
1218 g_executable_dirs.push_back(dir);
1223 if (command_line_tools_dir) {
1224 FileSpec cmd_line_lldb_resources = command_line_tools_dir;
1231 g_executable_dirs.push_back(dir);
1238 for (
const auto &executable_dir : g_executable_dirs) {
1240 executable_file.
SetDirectory(executable_dir.GetDirectory());
1243 return executable_file;
1258 const char *disable_env_var =
"IDE_DISABLED_OS_ACTIVITY_DT_MODE";
1260 if (!env_vars.count(disable_env_var)) {
1263 env_vars.try_emplace(
"OS_ACTIVITY_DT_MODE",
"enable");
1277 if (!module_sp && module_search_paths_ptr && platform_file) {
1286 std::vector<llvm::StringRef> path_parts = platform_file.
GetComponents();
1288 std::reverse(path_parts.begin(), path_parts.end());
1289 const size_t path_parts_size = path_parts.size();
1291 size_t num_module_search_paths = module_search_paths_ptr->
GetSize();
1292 for (
size_t i = 0; i < num_module_search_paths; ++i) {
1296 "PlatformRemoteDarwinDevice::GetSharedModule searching for binary in "
1304 for (
size_t j = 0; j < 4 && j < path_parts_size - 1; ++j) {
1318 for (
int k = j; k >= 0; --k) {
1327 nullptr, old_modules, did_create_ptr));
1330 module_sp->SetPlatformFileSpec(path_to_try);
1341 llvm::StringRef component) {
1342 auto begin = llvm::sys::path::begin(path);
1343 auto end = llvm::sys::path::end(path);
1344 for (
auto it = begin; it != end; ++it) {
1345 if (it->contains(component)) {
1346 llvm::SmallString<128> buffer;
1347 llvm::sys::path::append(buffer, begin, ++it,
1348 llvm::sys::path::Style::posix);
1349 return buffer.str().str();
1356 if (
FileSpec fspec = HostInfo::GetShlibDir())
1362 if (
FileSpec fspec = HostInfo::GetShlibDir())
1368#if !defined(__APPLE__)
1369 return llvm::Triple::MacOSX;
1372 return llvm::Triple::MacOSX;
1374 return llvm::Triple::IOS;
1375#elif TARGET_OS_WATCH
1376 return llvm::Triple::WatchOS;
1378 return llvm::Triple::TvOS;
1379#elif TARGET_OS_BRIDGE
1380 return llvm::Triple::BridgeOS;
1382 return llvm::Triple::XROS;
1384#error "LLDB being compiled for an unrecognized Darwin OS"
1389llvm::Expected<std::pair<XcodeSDK, bool>>
1393 return llvm::createStringError(
1394 llvm::inconvertibleErrorCode(),
1395 llvm::formatv(
"No symbol file available for module '{0}'",
1398 bool found_public_sdk =
false;
1399 bool found_internal_sdk =
false;
1405 found_public_sdk |= !is_internal_sdk;
1406 found_internal_sdk |= is_internal_sdk;
1408 merged_sdk.
Merge(cu_sdk);
1412 const bool found_mismatch = found_internal_sdk && found_public_sdk;
1414 return std::pair{std::move(merged_sdk), found_mismatch};
1417llvm::Expected<std::string>
1421 return llvm::createStringError(
1422 llvm::inconvertibleErrorCode(),
1423 llvm::formatv(
"Failed to parse SDK path from debug-info: {0}",
1424 llvm::toString(sdk_or_err.takeError())));
1426 auto [sdk, _] = std::move(*sdk_or_err);
1428 auto path_or_err = HostInfo::GetSDKRoot(HostInfo::SDKOptions{sdk});
1430 return llvm::createStringError(
1431 llvm::inconvertibleErrorCode(),
1432 llvm::formatv(
"Error while searching for SDK (XcodeSDK '{0}'): {1}",
1434 llvm::toString(path_or_err.takeError())));
1436 return path_or_err->str();
1439llvm::Expected<XcodeSDK>
1443 return llvm::createStringError(
"compile unit has no module");
1444 SymbolFile *sym_file = module_sp->GetSymbolFile();
1446 return llvm::createStringError(
1447 llvm::formatv(
"No symbol file available for module '{0}'",
1448 module_sp->GetFileSpec().GetFilename()));
1453llvm::Expected<std::string>
1457 return llvm::createStringError(
1458 llvm::inconvertibleErrorCode(),
1459 llvm::formatv(
"Failed to parse SDK path from debug-info: {0}",
1460 llvm::toString(sdk_or_err.takeError())));
1462 auto sdk = std::move(*sdk_or_err);
1464 auto path_or_err = HostInfo::GetSDKRoot(HostInfo::SDKOptions{sdk});
1466 return llvm::createStringError(
1467 llvm::inconvertibleErrorCode(),
1468 llvm::formatv(
"Error while searching for SDK (XcodeSDK '{0}'): {1}",
1470 llvm::toString(path_or_err.takeError())));
1472 return path_or_err->str();
static llvm::raw_ostream & error(Stream &strm)
static DynamicLoaderDarwinKernelProperties & GetGlobalProperties()
#define LLDB_LOG(log,...)
The LLDB_LOG* macros defined below are the way to emit log messages.
#define LLDB_LOGF(log,...)
#define LLDB_LOG_ERROR(log, error,...)
bool GetValueAsString(const char *key, std::string &value) const
An architecture specification class.
bool IsExactMatch(const ArchSpec &rhs) const
Shorthand for IsMatch(rhs, ExactMatch).
llvm::Triple::ArchType GetMachine() const
Returns a machine family for the current architecture.
A command line argument class.
void AppendArgument(llvm::StringRef arg_str, char quote_char='\0')
Appends a new argument to the end of the list argument list.
Class that manages the actual breakpoint that will be inserted into the running program.
bool SetTrapOpcode(const uint8_t *trap_opcode, uint32_t trap_opcode_size)
Sets the trap opcode.
lldb::BreakpointLocationSP GetConstituentAtIndex(size_t idx)
This method returns the breakpoint location at index index located at this breakpoint site.
A class that describes a compilation unit.
lldb::ModuleSP CalculateSymbolContextModule() override
A uniqued constant string class.
const char * AsCString(const char *value_if_empty=nullptr) const
Get the string value as a C string.
bool IsEmpty() const
Test for empty string.
const char * GetCString() const
Get the string value as a C string.
A class to manage flag bits.
lldb::ScriptLanguage GetScriptLanguage() const
ScriptInterpreter * GetScriptInterpreter(bool can_create=true, std::optional< lldb::ScriptLanguage > language={})
const FileSpec & GetFileSpecAtIndex(size_t idx) const
Get file at index.
void EmplaceBack(Args &&...args)
Inserts a new FileSpec into the FileSpecList constructed in-place with the given arguments.
void Append(const FileSpec &file)
Append a FileSpec object to the list.
size_t GetSize() const
Get the number of files in the file list.
void AppendPathComponent(llvm::StringRef component)
void SetDirectory(ConstString directory)
Directory string set accessor.
const ConstString & GetFilename() const
Filename string const get accessor.
std::vector< llvm::StringRef > GetComponents() const
Gets the components of the FileSpec's path.
const ConstString & GetDirectory() const
Directory string const get accessor.
ConstString GetFileNameStrippingExtension() const
Return the filename without the extension part.
size_t GetPath(char *path, size_t max_path_length, bool denormalize=true) const
Extract the full path to the file.
ConstString GetPathAsConstString(bool denormalize=true) const
Get the full path as a ConstString.
void SetFilename(ConstString filename)
Filename string set accessor.
void Resolve(llvm::SmallVectorImpl< char > &path)
Resolve path to make it canonical.
void EnumerateDirectory(llvm::Twine path, bool find_directories, bool find_files, bool find_other, EnumerateDirectoryCallbackType callback, void *callback_baton)
@ eEnumerateDirectoryResultNext
Enumerate next entry in the current directory.
bool Exists(const FileSpec &file_spec) const
Returns whether the given file exists.
static FileSystem & Instance()
static bool ResolveExecutableInBundle(FileSpec &file)
When executable files may live within a directory, where the directory represents an executable bundl...
static Status RunShellCommand(llvm::StringRef command, const FileSpec &working_dir, int *status_ptr, int *signo_ptr, std::string *command_output, const Timeout< std::micro > &timeout, bool run_in_shell=true, bool hide_stderr=false)
Run a shell command.
static bool GetProcessInfo(lldb::pid_t pid, ProcessInstanceInfo &proc_info)
static bool GetBundleDirectory(const FileSpec &file, FileSpec &bundle_directory)
If you have an executable that is in a bundle and want to get back to the bundle directory from the p...
ModuleIterable Modules() const
FileSpec & GetSymbolFileSpec()
ArchSpec * GetArchitecturePtr()
A class that describes an executable image and its associated object and symbol files.
virtual SymbolFile * GetSymbolFile(bool can_create=true, Stream *feedback_strm=nullptr)
Get the module's symbol file.
const FileSpec & GetFileSpec() const
Get const accessor for the module file specification.
A plug-in interface definition class for object file parsers.
@ eTypeDynamicLinker
The platform's dynamic linker executable.
virtual llvm::VersionTuple GetMinimumOSVersion()
Get the minimum OS version this object file can run on.
virtual FileSpec & GetFileSpec()
Get accessor to the object file specification.
void SetValidator(ValidatorCallback validator, void *baton=nullptr)
const char * GetCurrentValue() const
virtual llvm::StringRef GetPluginName()=0
static bool RegisterPlugin(llvm::StringRef name, llvm::StringRef description, ABICreateInstance create_callback)
static lldb::OptionValuePropertiesSP GetSettingForPlatformPlugin(Debugger &debugger, llvm::StringRef setting_name)
static bool CreateSettingForPlatformPlugin(Debugger &debugger, const lldb::OptionValuePropertiesSP &properties_sp, llvm::StringRef description, bool is_global_property)
static bool UnregisterPlugin(ABICreateInstance create_callback)
static FileSpec FindSymbolFileInBundle(const FileSpec &dsym_bundle_fspec, const UUID *uuid, const ArchSpec *arch)
Environment & GetEnvironment()
const FileSpec & GetShell() const
static void NoOpMonitorCallback(lldb::pid_t pid, int signal, int status)
A Monitor callback which does not take any action on process events.
void SetMonitorProcessCallback(Host::MonitorChildProcessCallback callback)
A plug-in interface definition class for debugging a process.
lldb::pid_t GetID() const
Returns the pid of the process or LLDB_INVALID_PROCESS_ID if there is no known pid.
size_t ReadMemoryFromInferior(lldb::addr_t vm_addr, void *buf, size_t size, Status &error)
Read of memory from a process.
virtual StructuredData::DictionarySP GetMetadata()
Fetch process defined metadata.
size_t ReadCStringFromMemory(lldb::addr_t vm_addr, char *cstr, size_t cstr_max_len, Status &error)
Read a NULL terminated C string from memory.
StructuredData::DictionarySP GetExtendedCrashInfoDict()
Fetch extended crash information held by the process.
Target & GetTarget()
Get the target object pointer for this module.
virtual bool IsReservedWord(const char *word)
lldb::SectionSP FindSectionByName(ConstString section_dstr) const
static Status FromErrorStringWithFormat(const char *format,...) __attribute__((format(printf
static Status FromErrorString(const char *str)
bool Success() const
Test for success condition.
const char * GetData() const
llvm::StringRef GetString() const
A stream class that can stream formatted output to a file.
size_t Printf(const char *format,...) __attribute__((format(printf
Output printf formatted output to the stream.
void AddItem(const ObjectSP &item)
ObjectSP GetItemAtIndex(size_t idx) const
void ForEach(std::function< bool(llvm::StringRef key, Object *object)> const &callback) const
std::shared_ptr< Dictionary > DictionarySP
std::shared_ptr< Array > ArraySP
Provides public interface for all SymbolFiles.
virtual XcodeSDK ParseXcodeSDK(CompileUnit &comp_unit)
Return the Xcode SDK comp_unit was compiled against.
virtual uint32_t GetNumCompileUnits()=0
virtual lldb::CompUnitSP GetCompileUnitAtIndex(uint32_t idx)=0
lldb::ModuleSP GetExecutableModule()
Gets the module for the main executable.
lldb::BreakpointSP CreateBreakpoint(const FileSpecList *containingModules, const FileSpec &file, uint32_t line_no, uint32_t column, lldb::addr_t offset, LazyBool check_inlines, LazyBool skip_prologue, bool internal, bool request_hardware, LazyBool move_to_nearest_code)
const ModuleList & GetImages() const
Get accessor for the images for this process.
const ArchSpec & GetArchitecture() const
An abstraction for Xcode-style SDKs that works like ArchSpec.
Type
Different types of Xcode SDKs.
void Merge(const XcodeSDK &other)
The merge function follows a strict order to maintain monotonicity:
static std::string GetCanonicalName(Info info)
Return the canonical SDK name, such as "macosx" for the macOS SDK.
bool IsAppleInternalSDK() const
static bool SDKSupportsModules(Type type, llvm::VersionTuple version)
Whether LLDB feels confident importing Clang modules from this SDK.
#define LLDB_INVALID_ADDRESS
A class that represents a running process on the host machine.
Log * GetLog(Cat mask)
Retrieve the Log object for the channel associated with the given log enum.
std::shared_ptr< lldb_private::BreakpointLocation > BreakpointLocationSP
std::shared_ptr< lldb_private::Platform > PlatformSP
@ eLanguageTypeUnknown
Unknown or invalid language value.
std::shared_ptr< lldb_private::Breakpoint > BreakpointSP
std::shared_ptr< lldb_private::Process > ProcessSP
std::shared_ptr< lldb_private::Section > SectionSP
std::shared_ptr< lldb_private::Module > ModuleSP
A parsed SDK directory name.