44#include "llvm/ADT/STLExtras.h"
45#include "llvm/Support/Error.h"
46#include "llvm/Support/FileSystem.h"
47#include "llvm/Support/Threading.h"
48#include "llvm/Support/VersionTuple.h"
51#include <TargetConditionals.h>
59 llvm::StringRef str_ref(
string);
60 llvm::SmallVector<llvm::StringRef> candidates;
61 str_ref.split(candidates,
'|');
62 for (
auto candidate : candidates) {
63 if (!(candidate ==
"EXC_BAD_ACCESS"
64 || candidate ==
"EXC_BAD_INSTRUCTION"
65 || candidate ==
"EXC_ARITHMETIC"
66 || candidate ==
"EXC_RESOURCE"
67 || candidate ==
"EXC_GUARD"
68 || candidate ==
"EXC_SYSCALL")) {
69 error.SetErrorStringWithFormat(
"invalid exception type: '%s'",
70 candidate.str().c_str());
108 return "Darwin platform plug-in.";
116#define LLDB_PROPERTIES_platformdarwin
117#include "PlatformMacOSXProperties.inc"
119#define LLDB_PROPERTIES_platformdarwin
121#include "PlatformMacOSXPropertiesEnum.inc"
127 static constexpr llvm::StringLiteral g_setting_name(
"darwin");
128 return g_setting_name;
132 m_collection_sp = std::make_shared<OptionValueProperties>(GetSettingName());
133 m_collection_sp->Initialize(g_platformdarwin_properties);
139 const uint32_t idx = ePropertyIgnoredExceptions;
141 m_collection_sp->GetPropertyAtIndexAsOptionValueString(idx);
142 assert(option_value);
147 const uint32_t idx = ePropertyIgnoredExceptions;
149 m_collection_sp->GetPropertyAtIndexAsOptionValueString(idx);
150 assert(option_value);
164 const bool is_global_setting =
false;
167 "Properties for the Darwin platform plug-in.", is_global_setting);
175 std::string ignored_exceptions
177 if (ignored_exceptions.empty())
180 std::string packet =
"QSetIgnoredExceptions:";
181 packet.append(ignored_exceptions);
213 ObjectFile *objfile = symfile->GetObjectFile();
217 llvm::StringRef(symfile_spec.
GetPath())
218 .contains_insensitive(
".dSYM/Contents/Resources/DWARF") &&
221 std::string module_basename(
223 std::string original_module_basename(module_basename);
225 bool was_keyword =
false;
235 std::replace(module_basename.begin(), module_basename.end(),
'.',
237 std::replace(module_basename.begin(), module_basename.end(),
' ',
239 std::replace(module_basename.begin(), module_basename.end(),
'-',
243 if (script_interpreter &&
245 module_basename.insert(module_basename.begin(),
'_');
255 path_string.
Printf(
"%s/../Python/%s.py",
257 module_basename.c_str());
258 original_path_string.
Printf(
259 "%s/../Python/%s.py",
261 original_module_basename.c_str());
270 if (module_basename != original_module_basename &&
272 const char *reason_for_complaint =
273 was_keyword ?
"conflicts with a keyword"
274 :
"contains reserved characters";
277 "warning: the symbol file '%s' contains a debug "
278 "script. However, its name"
279 " '%s' %s and as such cannot be loaded. LLDB will"
280 " load '%s' instead. Consider removing the file with "
281 "the malformed name to"
282 " eliminate this warning.\n",
283 symfile_spec.
GetPath().c_str(),
284 original_path_string.
GetData(), reason_for_complaint,
288 "warning: the symbol file '%s' contains a debug "
289 "script. However, its name"
290 " %s and as such cannot be loaded. If you intend"
291 " to have this script loaded, please rename '%s' to "
293 symfile_spec.
GetPath().c_str(), reason_for_complaint,
298 file_list.
Append(script_fspec);
306 if (module_spec.
GetFilename() == filename_no_extension)
342 module_spec, process, module_sp, module_search_paths_ptr, old_modules,
350 module_search_paths_ptr, old_modules,
354 if (!module_sp && module_search_paths_ptr && platform_file) {
359 if (platform_file == bundle_directory) {
364 new_module_spec, process, module_sp,
nullptr, old_modules,
373 platform_file.
GetPath(platform_path,
sizeof(platform_path));
374 const size_t bundle_directory_len =
375 bundle_directory.
GetPath(bundle_dir,
sizeof(bundle_dir));
377 size_t num_module_search_paths = module_search_paths_ptr->
GetSize();
378 for (
size_t i = 0; i < num_module_search_paths; ++i) {
379 const size_t search_path_len =
381 new_path,
sizeof(new_path));
382 if (search_path_len <
sizeof(new_path)) {
383 snprintf(new_path + search_path_len,
384 sizeof(new_path) - search_path_len,
"/%s",
385 platform_path + bundle_directory_len);
391 new_module_spec, process, module_sp,
nullptr, old_modules,
395 module_sp->SetPlatformFileSpec(new_file_spec);
406 module_sp->SetPlatformFileSpec(module_spec.
GetFileSpec());
413 const uint8_t *trap_opcode =
nullptr;
414 uint32_t trap_opcode_size = 0;
415 bool bp_is_thumb =
false;
419 case llvm::Triple::aarch64_32:
420 case llvm::Triple::aarch64: {
422 static const uint8_t g_arm64_breakpoint_opcode[] = {0x00, 0x00, 0x20, 0xD4};
423 trap_opcode = g_arm64_breakpoint_opcode;
424 trap_opcode_size =
sizeof(g_arm64_breakpoint_opcode);
427 case llvm::Triple::thumb:
430 case llvm::Triple::arm: {
431 static const uint8_t g_arm_breakpoint_opcode[] = {0xFE, 0xDE, 0xFF, 0xE7};
432 static const uint8_t g_thumb_breakpooint_opcode[] = {0xFE, 0xDE};
438 bp_is_thumb = bp_loc_sp->GetAddress().GetAddressClass() ==
442 trap_opcode = g_thumb_breakpooint_opcode;
443 trap_opcode_size =
sizeof(g_thumb_breakpooint_opcode);
446 trap_opcode = g_arm_breakpoint_opcode;
447 trap_opcode_size =
sizeof(g_arm_breakpoint_opcode);
450 case llvm::Triple::ppc:
451 case llvm::Triple::ppc64: {
452 static const uint8_t g_ppc_breakpoint_opcode[] = {0x7F, 0xC0, 0x00, 0x08};
453 trap_opcode = g_ppc_breakpoint_opcode;
454 trap_opcode_size =
sizeof(g_ppc_breakpoint_opcode);
461 if (trap_opcode && trap_opcode_size) {
463 return trap_opcode_size;
473 ObjectFile *obj_file = module_sp->GetObjectFile();
482 std::vector<ArchSpec> &archs) {
483 ArchSpec host_arch = HostInfo::GetArchitecture(HostInfo::eArchKindDefault);
484 archs.push_back(host_arch);
487 archs.push_back(
ArchSpec(
"x86_64-apple-macosx"));
488 archs.push_back(HostInfo::GetArchitecture(HostInfo::eArchKind32));
490 ArchSpec host_arch64 = HostInfo::GetArchitecture(HostInfo::eArchKind64);
492 archs.push_back(HostInfo::GetArchitecture(HostInfo::eArchKind32));
501 static const char *g_arm64e_compatible_archs[] = {
502 "arm64e",
"arm64",
"armv7",
"armv7f",
"armv7k",
"armv7s",
503 "armv7m",
"armv7em",
"armv6m",
"armv6",
"armv5",
"armv4",
504 "arm",
"thumbv7",
"thumbv7f",
"thumbv7k",
"thumbv7s",
"thumbv7m",
505 "thumbv7em",
"thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
507 return {g_arm64e_compatible_archs};
510 static const char *g_arm64_compatible_archs[] = {
511 "arm64",
"armv7",
"armv7f",
"armv7k",
"armv7s",
"armv7m",
512 "armv7em",
"armv6m",
"armv6",
"armv5",
"armv4",
"arm",
513 "thumbv7",
"thumbv7f",
"thumbv7k",
"thumbv7s",
"thumbv7m",
"thumbv7em",
514 "thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
516 return {g_arm64_compatible_archs};
519 static const char *g_armv7_compatible_archs[] = {
520 "armv7",
"armv6m",
"armv6",
"armv5",
"armv4",
"arm",
521 "thumbv7",
"thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
523 return {g_armv7_compatible_archs};
526 static const char *g_armv7f_compatible_archs[] = {
527 "armv7f",
"armv7",
"armv6m",
"armv6",
"armv5",
528 "armv4",
"arm",
"thumbv7f",
"thumbv7",
"thumbv6m",
529 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
531 return {g_armv7f_compatible_archs};
534 static const char *g_armv7k_compatible_archs[] = {
535 "armv7k",
"armv7",
"armv6m",
"armv6",
"armv5",
536 "armv4",
"arm",
"thumbv7k",
"thumbv7",
"thumbv6m",
537 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
539 return {g_armv7k_compatible_archs};
542 static const char *g_armv7s_compatible_archs[] = {
543 "armv7s",
"armv7",
"armv6m",
"armv6",
"armv5",
544 "armv4",
"arm",
"thumbv7s",
"thumbv7",
"thumbv6m",
545 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
547 return {g_armv7s_compatible_archs};
550 static const char *g_armv7m_compatible_archs[] = {
551 "armv7m",
"armv7",
"armv6m",
"armv6",
"armv5",
552 "armv4",
"arm",
"thumbv7m",
"thumbv7",
"thumbv6m",
553 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
555 return {g_armv7m_compatible_archs};
558 static const char *g_armv7em_compatible_archs[] = {
559 "armv7em",
"armv7",
"armv6m",
"armv6",
"armv5",
560 "armv4",
"arm",
"thumbv7em",
"thumbv7",
"thumbv6m",
561 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
563 return {g_armv7em_compatible_archs};
566 static const char *g_armv6m_compatible_archs[] = {
567 "armv6m",
"armv6",
"armv5",
"armv4",
"arm",
568 "thumbv6m",
"thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
570 return {g_armv6m_compatible_archs};
573 static const char *g_armv6_compatible_archs[] = {
574 "armv6",
"armv5",
"armv4",
"arm",
575 "thumbv6",
"thumbv5",
"thumbv4t",
"thumb",
577 return {g_armv6_compatible_archs};
580 static const char *g_armv5_compatible_archs[] = {
581 "armv5",
"armv4",
"arm",
"thumbv5",
"thumbv4t",
"thumb",
583 return {g_armv5_compatible_archs};
586 static const char *g_armv4_compatible_archs[] = {
592 return {g_armv4_compatible_archs};
602 std::vector<ArchSpec> &archs, std::optional<llvm::Triple::OSType> os) {
607 triple.setArchName(arch);
608 triple.setVendor(llvm::Triple::VendorType::Apple);
616 static FileSpec g_xcode_select_filespec;
618 if (!g_xcode_select_filespec) {
619 FileSpec xcode_select_cmd(
"/usr/bin/xcode-select");
621 int exit_status = -1;
623 std::string command_output;
627 &exit_status, &signo, &command_output,
628 std::chrono::seconds(2),
630 if (status.
Success() && exit_status == 0 && !command_output.empty()) {
631 size_t first_non_newline = command_output.find_last_not_of(
"\r\n");
632 if (first_non_newline != std::string::npos) {
633 command_output.erase(first_non_newline + 1);
635 g_xcode_select_filespec =
FileSpec(command_output);
640 return g_xcode_select_filespec;
645 static const char *g_bp_names[] = {
646 "start_wqthread",
"_pthread_wqthread",
"_pthread_start",
649 static const char *g_bp_modules[] = {
"libsystem_c.dylib",
650 "libSystem.B.dylib"};
653 for (
size_t i = 0; i < std::size(g_bp_modules); i++) {
654 const char *bp_module = g_bp_modules[i];
658 bool internal =
true;
659 bool hardware =
false;
662 std::size(g_bp_names), eFunctionNameTypeFull,
665 bp_sp->SetBreakpointKind(
"thread-creation");
676 std::string shell_string = shell.
GetPath();
677 const char *shell_name = strrchr(shell_string.c_str(),
'/');
678 if (shell_name ==
nullptr)
679 shell_name = shell_string.c_str();
683 if (strcmp(shell_name,
"sh") == 0) {
687 if (launch_info.
GetEnvironment().lookup(
"COMMAND_MODE") ==
"legacy")
690 }
else if (strcmp(shell_name,
"csh") == 0 ||
691 strcmp(shell_name,
"tcsh") == 0 ||
692 strcmp(shell_name,
"zsh") == 0) {
717 error.SetErrorString(
"the platform is not currently connected");
727 static FileSpec g_command_line_tools_filespec;
729 if (!g_command_line_tools_filespec) {
733 g_command_line_tools_filespec = command_line_tools_path;
737 return g_command_line_tools_filespec;
741 void *baton, llvm::sys::fs::file_type file_type, llvm::StringRef path) {
761 const bool find_directories =
true;
762 const bool find_files =
false;
763 const bool find_other =
true;
767 enumerator_info.
sdk_type = sdk_type;
770 sdks_spec.
GetPath(), find_directories, find_files, find_other,
780 FileSpec sdks_spec = HostInfo::GetXcodeContentsDirectory();
801 llvm_unreachable(
"unsupported sdk");
808 llvm::VersionTuple version = HostInfo::GetOSVersion();
810 if (!version.empty()) {
822 FileSpec native_sdk_spec = sdks_spec;
824 native_sdk_name.
Printf(
"MacOSX%u.%u.sdk", version.getMajor(),
825 version.getMinor().value_or(0));
829 return native_sdk_spec;
838std::tuple<llvm::VersionTuple, llvm::StringRef>
840 llvm::StringRef build;
841 llvm::StringRef version_str;
842 llvm::StringRef build_str;
843 std::tie(version_str, build_str) = dir.split(
' ');
844 llvm::VersionTuple version;
845 if (!version.tryParse(version_str) ||
847 if (build_str.consume_front(
"(")) {
848 size_t pos = build_str.find(
')');
849 build = build_str.slice(0, pos);
853 return std::make_tuple(version, build);
856llvm::Expected<StructuredData::DictionarySP>
859 std::make_shared<StructuredData::Dictionary>();
862 if (annotations && annotations->GetSize())
863 extended_crash_info->AddItem(
"Crash-Info Annotations", annotations);
867 if (app_specific_info && app_specific_info->GetSize())
868 extended_crash_info->AddItem(
"Application Specific Information",
871 return extended_crash_info->GetSize() ? extended_crash_info :
nullptr;
885 std::string module_name = module->GetSpecificationDescription();
889 if (module_name ==
"/usr/lib/dyld")
893 LLDB_LOG(log,
"Module {0} doesn't have any section!", module_name);
899 LLDB_LOG(log,
"Module {0} doesn't have section {1}!", module_name,
904 addr_t load_addr = crash_info->GetLoadBaseAddress(&target);
907 LLDB_LOG(log,
"Module {0} has an invalid '{1}' section load address: {2}",
908 module_name, section_name, load_addr);
916 expected_size,
error);
918 if (expected_size != bytes_read ||
error.Fail()) {
919 LLDB_LOG(log,
"Failed to read {0} section from memory in module {1}: {2}",
920 section_name, module_name,
error);
927 "Annotation version lower than 5 unsupported! Module {0} has "
928 "version {1} instead.",
929 module_name, annotations.
version);
934 LLDB_LOG(log,
"No message available for module {0}.", module_name);
942 if (message.empty() || bytes_read != message.size() ||
error.Fail()) {
943 LLDB_LOG(log,
"Failed to read the message from memory in module {0}: {1}",
949 if (message.back() ==
'\n')
953 LLDB_LOG(log,
"No message2 available for module {0}.", module_name);
955 std::string message2;
959 if (!message2.empty() && bytes_read == message2.size() &&
error.Success())
960 if (message2.back() ==
'\n')
964 std::make_shared<StructuredData::Dictionary>();
966 entry_sp->AddStringItem(
"image", module->GetFileSpec().GetPath(
false));
967 entry_sp->AddStringItem(
"uuid", module->GetUUID().GetAsString());
968 entry_sp->AddStringItem(
"message", message);
969 entry_sp->AddStringItem(
"message2", message2);
970 entry_sp->AddIntegerItem(
"abort-cause", annotations.
abort_cause);
972 array_sp->AddItem(entry_sp);
982 if (!metadata_sp || !metadata_sp->GetSize() || !metadata_sp->HasKey(
"asi"))
986 if (!metadata_sp->GetValueForKeyAsDictionary(
"asi", asi))
990 std::make_shared<StructuredData::Dictionary>();
992 auto flatten_asi_dict = [&dict_sp](llvm::StringRef key,
1005 asi->
ForEach(flatten_asi_dict);
1012 const std::vector<std::string> apple_arguments = {
1013 "-x",
"objective-c++",
"-fobjc-arc",
1014 "-fblocks",
"-D_ISO646_H",
"-D__ISO646_H",
1015 "-fgnuc-version=4.2.1"};
1017 options.insert(options.end(), apple_arguments.begin(), apple_arguments.end());
1020 bool use_current_os_version =
false;
1022 auto get_host_os = []() {
return HostInfo::GetTargetTriple().getOS(); };
1025 use_current_os_version = get_host_os() == llvm::Triple::MacOSX;
1028 use_current_os_version = get_host_os() == llvm::Triple::IOS;
1031 use_current_os_version = get_host_os() == llvm::Triple::TvOS;
1034 use_current_os_version = get_host_os() == llvm::Triple::WatchOS;
1040 llvm::VersionTuple version;
1041 if (use_current_os_version)
1047 if (exe_module_sp) {
1048 ObjectFile *object_file = exe_module_sp->GetObjectFile();
1055#define OPTION(PREFIX, NAME, VAR, ...) \
1056 llvm::StringRef opt_##VAR = NAME; \
1058#include "clang/Driver/Options.inc"
1060 minimum_version_option <<
'-';
1063 minimum_version_option << opt_mmacos_version_min_EQ;
1066 minimum_version_option << opt_mios_simulator_version_min_EQ;
1069 minimum_version_option << opt_mios_version_min_EQ;
1072 minimum_version_option << opt_mtvos_simulator_version_min_EQ;
1075 minimum_version_option << opt_mtvos_version_min_EQ;
1078 minimum_version_option << opt_mwatchos_simulator_version_min_EQ;
1081 minimum_version_option << opt_mwatchos_version_min_EQ;
1088 info.
type = sdk_type;
1089 LLDB_LOGF(log,
"Clang modules on %s are not supported",
1094 minimum_version_option << version.getAsString();
1095 options.emplace_back(std::string(minimum_version_option.
GetString()));
1104 sysroot_spec =
FileSpec(*path_or_err);
1107 path_or_err.takeError(),
1108 "Failed to resolve SDK path: {0}");
1114 std::lock_guard<std::mutex> guard(
m_mutex);
1119 options.push_back(
"-isysroot");
1120 options.push_back(sysroot_spec.
GetPath());
1139 llvm::VersionTuple result;
1140 if (!result.tryParse(env.lookup(
"SIMULATOR_RUNTIME_VERSION")))
1143 std::string dyld_root_path = env.lookup(
"DYLD_ROOT_PATH");
1144 if (!dyld_root_path.empty()) {
1145 dyld_root_path +=
"/System/Library/CoreServices/SystemVersion.plist";
1147 std::string product_version;
1150 if (!result.tryParse(product_version))
1158 return llvm::VersionTuple();
1167 static std::vector<FileSpec> g_executable_dirs;
1171 static llvm::once_flag g_once_flag;
1172 llvm::call_once(g_once_flag, []() {
1175 FileSpec xcode_contents_dir = HostInfo::GetXcodeContentsDirectory();
1176 if (xcode_contents_dir) {
1177 FileSpec xcode_lldb_resources = xcode_contents_dir;
1184 g_executable_dirs.push_back(dir);
1189 if (command_line_tools_dir) {
1190 FileSpec cmd_line_lldb_resources = command_line_tools_dir;
1197 g_executable_dirs.push_back(dir);
1204 for (
const auto &executable_dir : g_executable_dirs) {
1206 executable_file.
SetDirectory(executable_dir.GetDirectory());
1209 return executable_file;
1224 const char *disable_env_var =
"IDE_DISABLED_OS_ACTIVITY_DT_MODE";
1226 if (!env_vars.count(disable_env_var)) {
1229 env_vars.try_emplace(
"OS_ACTIVITY_DT_MODE",
"enable");
1243 if (!module_sp && module_search_paths_ptr && platform_file) {
1252 std::vector<llvm::StringRef> path_parts = platform_file.
GetComponents();
1254 std::reverse(path_parts.begin(), path_parts.end());
1255 const size_t path_parts_size = path_parts.size();
1257 size_t num_module_search_paths = module_search_paths_ptr->
GetSize();
1258 for (
size_t i = 0; i < num_module_search_paths; ++i) {
1262 "PlatformRemoteDarwinDevice::GetSharedModule searching for binary in "
1270 for (
size_t j = 0; j < 4 && j < path_parts_size - 1; ++j) {
1284 for (
int k = j; k >= 0; --k) {
1293 nullptr, old_modules, did_create_ptr));
1296 module_sp->SetPlatformFileSpec(path_to_try);
1307 llvm::StringRef component) {
1308 auto begin = llvm::sys::path::begin(path);
1309 auto end = llvm::sys::path::end(path);
1310 for (
auto it = begin; it != end; ++it) {
1311 if (it->contains(component)) {
1312 llvm::SmallString<128> buffer;
1313 llvm::sys::path::append(buffer, begin, ++it,
1314 llvm::sys::path::Style::posix);
1315 return buffer.str().str();
1322 if (
FileSpec fspec = HostInfo::GetShlibDir())
1328 if (
FileSpec fspec = HostInfo::GetShlibDir())
1334#if !defined(__APPLE__)
1335 return llvm::Triple::MacOSX;
1338 return llvm::Triple::MacOSX;
1340 return llvm::Triple::IOS;
1341#elif TARGET_OS_WATCH
1342 return llvm::Triple::WatchOS;
1344 return llvm::Triple::TvOS;
1345#elif TARGET_OS_BRIDGE
1346 return llvm::Triple::BridgeOS;
1348#error "LLDB being compiled for an unrecognized Darwin OS"
1353llvm::Expected<std::pair<XcodeSDK, bool>>
1357 return llvm::createStringError(
1358 llvm::inconvertibleErrorCode(),
1359 llvm::formatv(
"No symbol file available for module '{0}'",
1362 bool found_public_sdk =
false;
1363 bool found_internal_sdk =
false;
1369 found_public_sdk |= !is_internal_sdk;
1370 found_internal_sdk |= is_internal_sdk;
1372 merged_sdk.
Merge(cu_sdk);
1376 const bool found_mismatch = found_internal_sdk && found_public_sdk;
1378 return std::pair{std::move(merged_sdk), found_mismatch};
1381llvm::Expected<std::string>
1385 return llvm::createStringError(
1386 llvm::inconvertibleErrorCode(),
1387 llvm::formatv(
"Failed to parse SDK path from debug-info: {0}",
1388 llvm::toString(sdk_or_err.takeError())));
1390 auto [sdk, _] = std::move(*sdk_or_err);
1392 auto path_or_err = HostInfo::GetSDKRoot(HostInfo::SDKOptions{sdk});
1394 return llvm::createStringError(
1395 llvm::inconvertibleErrorCode(),
1396 llvm::formatv(
"Error while searching for SDK (XcodeSDK '{0}'): {1}",
1398 llvm::toString(path_or_err.takeError())));
1400 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 GetOwnerAtIndex(size_t idx)
This method returns the breakpoint location at index index located at this breakpoint site.
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)
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.
Target & GetTarget()
Get the target object pointer for this module.
virtual bool IsReservedWord(const char *word)
lldb::SectionSP FindSectionByName(ConstString section_dstr) const
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
static FileSpec FindSymbolFileInBundle(const FileSpec &dsym_bundle_fspec, const lldb_private::UUID *uuid, const ArchSpec *arch)
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.