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;
144 const uint32_t idx = ePropertyIgnoredExceptions;
147 assert(option_value);
152 const uint32_t idx = ePropertyIgnoredExceptions;
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);
214 FileSpec module_spec =
module.GetFileSpec();
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 llvm::replace(module_basename,
'.',
'_');
241 llvm::replace(module_basename,
' ',
'_');
242 llvm::replace(module_basename,
'-',
'_');
245 if (script_interpreter &&
247 module_basename.insert(module_basename.begin(),
'_');
257 path_string.
Printf(
"%s/../Python/%s.py",
259 module_basename.c_str());
260 original_path_string.
Printf(
261 "%s/../Python/%s.py",
263 original_module_basename.c_str());
272 if (module_basename != original_module_basename &&
274 const char *reason_for_complaint =
275 was_keyword ?
"conflicts with a keyword"
276 :
"contains reserved characters";
279 "warning: the symbol file '%s' contains a debug "
280 "script. However, its name"
281 " '%s' %s and as such cannot be loaded. LLDB will"
282 " load '%s' instead. Consider removing the file with "
283 "the malformed name to"
284 " eliminate this warning.\n",
285 symfile_spec.
GetPath().c_str(),
286 original_path_string.
GetData(), reason_for_complaint,
290 "warning: the symbol file '%s' contains a debug "
291 "script. However, its name"
292 " %s and as such cannot be loaded. If you intend"
293 " to have this script loaded, please rename '%s' to "
295 symfile_spec.
GetPath().c_str(), reason_for_complaint,
300 file_list.
Append(script_fspec);
308 if (module_spec.
GetFilename() == filename_no_extension)
344 module_spec, process, module_sp, module_search_paths_ptr, old_modules,
352 module_search_paths_ptr, old_modules,
356 if (!module_sp && module_search_paths_ptr && platform_file) {
361 if (platform_file == bundle_directory) {
366 new_module_spec, process, module_sp,
nullptr, old_modules,
375 platform_file.
GetPath(platform_path,
sizeof(platform_path));
376 const size_t bundle_directory_len =
377 bundle_directory.
GetPath(bundle_dir,
sizeof(bundle_dir));
379 size_t num_module_search_paths = module_search_paths_ptr->
GetSize();
380 for (
size_t i = 0; i < num_module_search_paths; ++i) {
381 const size_t search_path_len =
383 new_path,
sizeof(new_path));
384 if (search_path_len <
sizeof(new_path)) {
385 snprintf(new_path + search_path_len,
386 sizeof(new_path) - search_path_len,
"/%s",
387 platform_path + bundle_directory_len);
393 new_module_spec, process, module_sp,
nullptr, old_modules,
397 module_sp->SetPlatformFileSpec(new_file_spec);
408 module_sp->SetPlatformFileSpec(module_spec.
GetFileSpec());
415 const uint8_t *trap_opcode =
nullptr;
416 uint32_t trap_opcode_size = 0;
417 bool bp_is_thumb =
false;
421 case llvm::Triple::aarch64_32:
422 case llvm::Triple::aarch64: {
424 static const uint8_t g_arm64_breakpoint_opcode[] = {0x00, 0x00, 0x20, 0xD4};
425 trap_opcode = g_arm64_breakpoint_opcode;
426 trap_opcode_size =
sizeof(g_arm64_breakpoint_opcode);
429 case llvm::Triple::thumb:
432 case llvm::Triple::arm: {
433 static const uint8_t g_arm_breakpoint_opcode[] = {0xFE, 0xDE, 0xFF, 0xE7};
434 static const uint8_t g_thumb_breakpooint_opcode[] = {0xFE, 0xDE};
440 bp_is_thumb = bp_loc_sp->GetAddress().GetAddressClass() ==
444 trap_opcode = g_thumb_breakpooint_opcode;
445 trap_opcode_size =
sizeof(g_thumb_breakpooint_opcode);
448 trap_opcode = g_arm_breakpoint_opcode;
449 trap_opcode_size =
sizeof(g_arm_breakpoint_opcode);
452 case llvm::Triple::ppc:
453 case llvm::Triple::ppc64: {
454 static const uint8_t g_ppc_breakpoint_opcode[] = {0x7F, 0xC0, 0x00, 0x08};
455 trap_opcode = g_ppc_breakpoint_opcode;
456 trap_opcode_size =
sizeof(g_ppc_breakpoint_opcode);
463 if (trap_opcode && trap_opcode_size) {
465 return trap_opcode_size;
475 ObjectFile *obj_file = module_sp->GetObjectFile();
484 std::vector<ArchSpec> &archs) {
485 ArchSpec host_arch = HostInfo::GetArchitecture(HostInfo::eArchKindDefault);
486 archs.push_back(host_arch);
489 archs.push_back(
ArchSpec(
"x86_64-apple-macosx"));
490 archs.push_back(HostInfo::GetArchitecture(HostInfo::eArchKind32));
492 ArchSpec host_arch64 = HostInfo::GetArchitecture(HostInfo::eArchKind64);
494 archs.push_back(HostInfo::GetArchitecture(HostInfo::eArchKind32));
503 static const char *g_arm64e_compatible_archs[] = {
504 "arm64e",
"arm64",
"armv7",
"armv7f",
"armv7k",
"armv7s",
505 "armv7m",
"armv7em",
"armv6m",
"armv6",
"armv5",
"armv4",
506 "arm",
"thumbv7",
"thumbv7f",
"thumbv7k",
"thumbv7s",
"thumbv7m",
507 "thumbv7em",
"thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
509 return {g_arm64e_compatible_archs};
512 static const char *g_arm64_compatible_archs[] = {
513 "arm64",
"armv7",
"armv7f",
"armv7k",
"armv7s",
"armv7m",
514 "armv7em",
"armv6m",
"armv6",
"armv5",
"armv4",
"arm",
515 "thumbv7",
"thumbv7f",
"thumbv7k",
"thumbv7s",
"thumbv7m",
"thumbv7em",
516 "thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
518 return {g_arm64_compatible_archs};
521 static const char *g_armv7_compatible_archs[] = {
522 "armv7",
"armv6m",
"armv6",
"armv5",
"armv4",
"arm",
523 "thumbv7",
"thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
525 return {g_armv7_compatible_archs};
528 static const char *g_armv7f_compatible_archs[] = {
529 "armv7f",
"armv7",
"armv6m",
"armv6",
"armv5",
530 "armv4",
"arm",
"thumbv7f",
"thumbv7",
"thumbv6m",
531 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
533 return {g_armv7f_compatible_archs};
536 static const char *g_armv7k_compatible_archs[] = {
537 "armv7k",
"armv7",
"armv6m",
"armv6",
"armv5",
538 "armv4",
"arm",
"thumbv7k",
"thumbv7",
"thumbv6m",
539 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
541 return {g_armv7k_compatible_archs};
544 static const char *g_armv7s_compatible_archs[] = {
545 "armv7s",
"armv7",
"armv6m",
"armv6",
"armv5",
546 "armv4",
"arm",
"thumbv7s",
"thumbv7",
"thumbv6m",
547 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
549 return {g_armv7s_compatible_archs};
552 static const char *g_armv7m_compatible_archs[] = {
553 "armv7m",
"armv7",
"armv6m",
"armv6",
"armv5",
554 "armv4",
"arm",
"thumbv7m",
"thumbv7",
"thumbv6m",
555 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
557 return {g_armv7m_compatible_archs};
560 static const char *g_armv7em_compatible_archs[] = {
561 "armv7em",
"armv7",
"armv6m",
"armv6",
"armv5",
562 "armv4",
"arm",
"thumbv7em",
"thumbv7",
"thumbv6m",
563 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
565 return {g_armv7em_compatible_archs};
568 static const char *g_armv6m_compatible_archs[] = {
569 "armv6m",
"armv6",
"armv5",
"armv4",
"arm",
570 "thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
572 return {g_armv6m_compatible_archs};
575 static const char *g_armv6_compatible_archs[] = {
576 "armv6",
"armv5",
"armv4",
"arm",
577 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
579 return {g_armv6_compatible_archs};
582 static const char *g_armv5_compatible_archs[] = {
583 "armv5",
"armv4",
"arm",
"thumbv5",
"thumbv4t",
"thumb",
585 return {g_armv5_compatible_archs};
588 static const char *g_armv4_compatible_archs[] = {
594 return {g_armv4_compatible_archs};
604 std::vector<ArchSpec> &archs, std::optional<llvm::Triple::OSType> os) {
609 triple.setArchName(arch);
610 triple.setVendor(llvm::Triple::VendorType::Apple);
618 static FileSpec g_xcode_select_filespec;
620 if (!g_xcode_select_filespec) {
621 FileSpec xcode_select_cmd(
"/usr/bin/xcode-select");
623 int exit_status = -1;
625 std::string command_output;
629 &exit_status, &signo, &command_output,
630 std::chrono::seconds(2),
632 if (status.
Success() && exit_status == 0 && !command_output.empty()) {
633 size_t first_non_newline = command_output.find_last_not_of(
"\r\n");
634 if (first_non_newline != std::string::npos) {
635 command_output.erase(first_non_newline + 1);
637 g_xcode_select_filespec =
FileSpec(command_output);
642 return g_xcode_select_filespec;
647 static const char *g_bp_names[] = {
648 "start_wqthread",
"_pthread_wqthread",
"_pthread_start",
651 static const char *g_bp_modules[] = {
"libsystem_c.dylib",
"libSystem.B.dylib",
652 "libsystem_pthread.dylib"};
655 for (
size_t i = 0; i < std::size(g_bp_modules); i++) {
656 const char *bp_module = g_bp_modules[i];
660 bool internal =
true;
661 bool hardware =
false;
664 std::size(g_bp_names), eFunctionNameTypeFull,
667 bp_sp->SetBreakpointKind(
"thread-creation");
678 std::string shell_string = shell.
GetPath();
679 const char *shell_name = strrchr(shell_string.c_str(),
'/');
680 if (shell_name ==
nullptr)
681 shell_name = shell_string.c_str();
685 if (strcmp(shell_name,
"sh") == 0) {
689 if (launch_info.
GetEnvironment().lookup(
"COMMAND_MODE") ==
"legacy")
692 }
else if (strcmp(shell_name,
"csh") == 0 ||
693 strcmp(shell_name,
"tcsh") == 0 ||
694 strcmp(shell_name,
"zsh") == 0) {
730 static FileSpec g_command_line_tools_filespec;
732 if (!g_command_line_tools_filespec) {
736 g_command_line_tools_filespec = command_line_tools_path;
740 return g_command_line_tools_filespec;
744 void *baton, llvm::sys::fs::file_type file_type, llvm::StringRef path) {
764 const bool find_directories =
true;
765 const bool find_files =
false;
766 const bool find_other =
true;
770 enumerator_info.
sdk_type = sdk_type;
773 sdks_spec.
GetPath(), find_directories, find_files, find_other,
783 FileSpec sdks_spec = HostInfo::GetXcodeContentsDirectory();
807 llvm_unreachable(
"unsupported sdk");
814 llvm::VersionTuple version = HostInfo::GetOSVersion();
816 if (!version.empty()) {
828 FileSpec native_sdk_spec = sdks_spec;
830 native_sdk_name.
Printf(
"MacOSX%u.%u.sdk", version.getMajor(),
831 version.getMinor().value_or(0));
835 return native_sdk_spec;
844std::tuple<llvm::VersionTuple, llvm::StringRef>
846 llvm::StringRef build;
847 llvm::StringRef version_str;
848 llvm::StringRef build_str;
849 std::tie(version_str, build_str) = dir.split(
' ');
850 llvm::VersionTuple version;
851 if (!version.tryParse(version_str) ||
853 if (build_str.consume_front(
"(")) {
854 size_t pos = build_str.find(
')');
855 build = build_str.slice(0, pos);
859 return std::make_tuple(version, build);
862llvm::Expected<StructuredData::DictionarySP>
864 static constexpr llvm::StringLiteral crash_info_key(
"Crash-Info Annotations");
865 static constexpr llvm::StringLiteral asi_info_key(
866 "Application Specific Information");
873 if (!process_dict_sp->GetValueForKeyAsArray(crash_info_key, annotations)) {
875 if (new_annotations_sp && new_annotations_sp->GetSize()) {
876 process_dict_sp->AddItem(crash_info_key, new_annotations_sp);
877 annotations = new_annotations_sp.get();
883 if (!process_dict_sp->GetValueForKeyAsDictionary(asi_info_key,
884 app_specific_info)) {
886 if (new_app_specific_info_sp && new_app_specific_info_sp->GetSize()) {
887 process_dict_sp->AddItem(asi_info_key, new_app_specific_info_sp);
888 app_specific_info = new_app_specific_info_sp.get();
894 return process_dict_sp->GetSize() ? process_dict_sp :
nullptr;
908 std::string module_name =
module->GetSpecificationDescription();
912 if (module_name ==
"/usr/lib/dyld")
916 LLDB_LOG(log,
"Module {0} doesn't have any section!", module_name);
922 LLDB_LOG(log,
"Module {0} doesn't have section {1}!", module_name,
927 addr_t load_addr = crash_info->GetLoadBaseAddress(&target);
930 LLDB_LOG(log,
"Module {0} has an invalid '{1}' section load address: {2}",
931 module_name, section_name, load_addr);
939 expected_size,
error);
941 if (expected_size != bytes_read ||
error.Fail()) {
942 LLDB_LOG(log,
"Failed to read {0} section from memory in module {1}: {2}",
943 section_name, module_name,
error);
950 "Annotation version lower than 5 unsupported! Module {0} has "
951 "version {1} instead.",
952 module_name, annotations.
version);
957 LLDB_LOG(log,
"No message available for module {0}.", module_name);
965 if (message.empty() || bytes_read != message.size() ||
error.Fail()) {
966 LLDB_LOG(log,
"Failed to read the message from memory in module {0}: {1}",
972 if (message.back() ==
'\n')
976 LLDB_LOG(log,
"No message2 available for module {0}.", module_name);
978 std::string message2;
982 if (!message2.empty() && bytes_read == message2.size() &&
error.Success())
983 if (message2.back() ==
'\n')
987 std::make_shared<StructuredData::Dictionary>();
989 entry_sp->AddStringItem(
"image", module->GetFileSpec().GetPath(
false));
990 entry_sp->AddStringItem(
"uuid", module->GetUUID().GetAsString());
991 entry_sp->AddStringItem(
"message", message);
992 entry_sp->AddStringItem(
"message2", message2);
993 entry_sp->AddIntegerItem(
"abort-cause", annotations.
abort_cause);
995 array_sp->AddItem(entry_sp);
1005 if (!metadata_sp || !metadata_sp->GetSize() || !metadata_sp->HasKey(
"asi"))
1009 if (!metadata_sp->GetValueForKeyAsDictionary(
"asi", asi))
1013 std::make_shared<StructuredData::Dictionary>();
1015 auto flatten_asi_dict = [&dict_sp](llvm::StringRef key,
1028 asi->
ForEach(flatten_asi_dict);
1033static llvm::Expected<lldb_private::FileSpec>
1038 return llvm::createStringError(
"Failed to get module from target");
1040 SymbolFile *sym_file = exe_module_sp->GetSymbolFile();
1042 return llvm::createStringError(
"Failed to get symbol file from executable");
1045 return llvm::createStringError(
1046 "Failed to resolve SDK for target: executable's symbol file has no "
1053 merged_sdk.
Merge(cu_sdk);
1063 auto path_or_err = HostInfo::GetSDKRoot(HostInfo::SDKOptions{merged_sdk});
1065 return llvm::createStringError(
1066 llvm::formatv(
"Failed to resolve SDK path: {0}",
1067 llvm::toString(path_or_err.takeError())));
1074 const std::vector<std::string> apple_arguments = {
1075 "-x",
"objective-c++",
"-fobjc-arc",
1076 "-fblocks",
"-D_ISO646_H",
"-D__ISO646_H",
1077 "-fgnuc-version=4.2.1"};
1079 options.insert(options.end(), apple_arguments.begin(), apple_arguments.end());
1082 bool use_current_os_version =
false;
1084 auto get_host_os = []() {
return HostInfo::GetTargetTriple().getOS(); };
1087 use_current_os_version = get_host_os() == llvm::Triple::MacOSX;
1090 use_current_os_version = get_host_os() == llvm::Triple::IOS;
1093 use_current_os_version = get_host_os() == llvm::Triple::TvOS;
1096 use_current_os_version = get_host_os() == llvm::Triple::WatchOS;
1099 use_current_os_version = get_host_os() == llvm::Triple::XROS;
1105 llvm::VersionTuple version;
1106 if (use_current_os_version)
1112 if (exe_module_sp) {
1113 ObjectFile *object_file = exe_module_sp->GetObjectFile();
1122#define OPTION(PREFIX_OFFSET, NAME_OFFSET, VAR, ...) \
1123 llvm::StringRef opt_##VAR = OptionStrTable[NAME_OFFSET]; \
1125#include "clang/Driver/Options.inc"
1127 minimum_version_option <<
'-';
1130 minimum_version_option << opt_mmacos_version_min_EQ;
1133 minimum_version_option << opt_mios_simulator_version_min_EQ;
1136 minimum_version_option << opt_mios_version_min_EQ;
1139 minimum_version_option << opt_mtvos_simulator_version_min_EQ;
1142 minimum_version_option << opt_mtvos_version_min_EQ;
1145 minimum_version_option << opt_mwatchos_simulator_version_min_EQ;
1148 minimum_version_option << opt_mwatchos_version_min_EQ;
1158 info.
type = sdk_type;
1159 LLDB_LOGF(log,
"Clang modules on %s are not supported",
1164 minimum_version_option << version.getAsString();
1165 options.emplace_back(std::string(minimum_version_option.
GetString()));
1172 if (!sysroot_spec_or_err) {
1174 sysroot_spec_or_err.takeError(),
1175 "Failed to resolve sysroot: {0}");
1177 sysroot_spec = *sysroot_spec_or_err;
1182 std::lock_guard<std::mutex> guard(
m_mutex);
1187 options.push_back(
"-isysroot");
1188 options.push_back(sysroot_spec.
GetPath());
1207 llvm::VersionTuple result;
1208 if (!result.tryParse(env.lookup(
"SIMULATOR_RUNTIME_VERSION")))
1211 std::string dyld_root_path = env.lookup(
"DYLD_ROOT_PATH");
1212 if (!dyld_root_path.empty()) {
1213 dyld_root_path +=
"/System/Library/CoreServices/SystemVersion.plist";
1215 std::string product_version;
1218 if (!result.tryParse(product_version))
1226 return llvm::VersionTuple();
1235 static std::vector<FileSpec> g_executable_dirs;
1239 static llvm::once_flag g_once_flag;
1240 llvm::call_once(g_once_flag, []() {
1243 FileSpec xcode_contents_dir = HostInfo::GetXcodeContentsDirectory();
1244 if (xcode_contents_dir) {
1245 FileSpec xcode_lldb_resources = xcode_contents_dir;
1252 g_executable_dirs.push_back(dir);
1257 if (command_line_tools_dir) {
1258 FileSpec cmd_line_lldb_resources = command_line_tools_dir;
1265 g_executable_dirs.push_back(dir);
1272 for (
const auto &executable_dir : g_executable_dirs) {
1274 executable_file.
SetDirectory(executable_dir.GetDirectory());
1277 return executable_file;
1292 const char *disable_env_var =
"IDE_DISABLED_OS_ACTIVITY_DT_MODE";
1294 if (!env_vars.count(disable_env_var)) {
1297 env_vars.try_emplace(
"OS_ACTIVITY_DT_MODE",
"enable");
1311 if (!module_sp && module_search_paths_ptr && platform_file) {
1320 std::vector<llvm::StringRef> path_parts = platform_file.
GetComponents();
1322 std::reverse(path_parts.begin(), path_parts.end());
1323 const size_t path_parts_size = path_parts.size();
1325 size_t num_module_search_paths = module_search_paths_ptr->
GetSize();
1326 for (
size_t i = 0; i < num_module_search_paths; ++i) {
1330 "PlatformRemoteDarwinDevice::GetSharedModule searching for binary in "
1338 for (
size_t j = 0; j < 4 && j < path_parts_size - 1; ++j) {
1352 for (
int k = j; k >= 0; --k) {
1361 nullptr, old_modules, did_create_ptr));
1364 module_sp->SetPlatformFileSpec(path_to_try);
1375#if !defined(__APPLE__)
1376 return llvm::Triple::MacOSX;
1379 return llvm::Triple::MacOSX;
1381 return llvm::Triple::IOS;
1382#elif TARGET_OS_WATCH
1383 return llvm::Triple::WatchOS;
1385 return llvm::Triple::TvOS;
1386#elif TARGET_OS_BRIDGE
1387 return llvm::Triple::BridgeOS;
1389 return llvm::Triple::XROS;
1391#error "LLDB being compiled for an unrecognized Darwin OS"
1396llvm::Expected<std::pair<XcodeSDK, bool>>
1398 SymbolFile *sym_file =
module.GetSymbolFile();
1400 return llvm::createStringError(
1401 llvm::inconvertibleErrorCode(),
1402 llvm::formatv(
"No symbol file available for module '{0}'",
1406 return llvm::createStringError(
1407 llvm::formatv(
"Could not resolve SDK for module '{0}'. Symbol file has "
1408 "no compile units.",
1411 bool found_public_sdk =
false;
1412 bool found_internal_sdk =
false;
1418 found_public_sdk |= !is_internal_sdk;
1419 found_internal_sdk |= is_internal_sdk;
1421 merged_sdk.
Merge(cu_sdk);
1425 const bool found_mismatch = found_internal_sdk && found_public_sdk;
1427 return std::pair{std::move(merged_sdk), found_mismatch};
1430llvm::Expected<std::string>
1434 return llvm::createStringError(
1435 llvm::inconvertibleErrorCode(),
1436 llvm::formatv(
"Failed to parse SDK path from debug-info: {0}",
1437 llvm::toString(sdk_or_err.takeError())));
1439 auto [sdk, _] = std::move(*sdk_or_err);
1442 return sdk.GetSysroot().GetPath();
1444 auto path_or_err = HostInfo::GetSDKRoot(HostInfo::SDKOptions{sdk});
1446 return llvm::createStringError(
1447 llvm::inconvertibleErrorCode(),
1448 llvm::formatv(
"Error while searching for SDK (XcodeSDK '{0}'): {1}",
1450 llvm::toString(path_or_err.takeError())));
1452 return path_or_err->str();
1455llvm::Expected<XcodeSDK>
1459 return llvm::createStringError(
"compile unit has no module");
1460 SymbolFile *sym_file = module_sp->GetSymbolFile();
1462 return llvm::createStringError(
1463 llvm::formatv(
"No symbol file available for module '{0}'",
1464 module_sp->GetFileSpec().GetFilename()));
1469llvm::Expected<std::string>
1473 return llvm::createStringError(
1474 llvm::inconvertibleErrorCode(),
1475 llvm::formatv(
"Failed to parse SDK path from debug-info: {0}",
1476 llvm::toString(sdk_or_err.takeError())));
1478 auto sdk = std::move(*sdk_or_err);
1480 auto path_or_err = HostInfo::GetSDKRoot(HostInfo::SDKOptions{sdk});
1482 return llvm::createStringError(
1483 llvm::inconvertibleErrorCode(),
1484 llvm::formatv(
"Error while searching for SDK (XcodeSDK '{0}'): {1}",
1486 llvm::toString(path_or_err.takeError())));
1488 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.
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.
lldb::OptionValuePropertiesSP m_collection_sp
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
Debugger & GetDebugger() const
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.
const FileSpec & GetSysroot() const
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.