1 //===-- Target.cpp ----------------------------------------------*- C++ -*-===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 9 #include "lldb/Target/Target.h" 10 #include "Plugins/ExpressionParser/Clang/ClangASTSource.h" 11 #include "Plugins/ExpressionParser/Clang/ClangModulesDeclVendor.h" 12 #include "Plugins/ExpressionParser/Clang/ClangPersistentVariables.h" 13 #include "lldb/Breakpoint/BreakpointIDList.h" 14 #include "lldb/Breakpoint/BreakpointResolver.h" 15 #include "lldb/Breakpoint/BreakpointResolverAddress.h" 16 #include "lldb/Breakpoint/BreakpointResolverFileLine.h" 17 #include "lldb/Breakpoint/BreakpointResolverFileRegex.h" 18 #include "lldb/Breakpoint/BreakpointResolverName.h" 19 #include "lldb/Breakpoint/BreakpointResolverScripted.h" 20 #include "lldb/Breakpoint/Watchpoint.h" 21 #include "lldb/Core/Debugger.h" 22 #include "lldb/Core/Module.h" 23 #include "lldb/Core/ModuleSpec.h" 24 #include "lldb/Core/PluginManager.h" 25 #include "lldb/Core/SearchFilter.h" 26 #include "lldb/Core/Section.h" 27 #include "lldb/Core/SourceManager.h" 28 #include "lldb/Core/StreamFile.h" 29 #include "lldb/Core/StructuredDataImpl.h" 30 #include "lldb/Core/ValueObject.h" 31 #include "lldb/Expression/REPL.h" 32 #include "lldb/Expression/UserExpression.h" 33 #include "lldb/Host/Host.h" 34 #include "lldb/Host/PosixApi.h" 35 #include "lldb/Interpreter/CommandInterpreter.h" 36 #include "lldb/Interpreter/CommandReturnObject.h" 37 #include "lldb/Interpreter/OptionGroupWatchpoint.h" 38 #include "lldb/Interpreter/OptionValues.h" 39 #include "lldb/Interpreter/Property.h" 40 #include "lldb/Symbol/ClangASTContext.h" 41 #include "lldb/Symbol/Function.h" 42 #include "lldb/Symbol/ObjectFile.h" 43 #include "lldb/Symbol/Symbol.h" 44 #include "lldb/Target/Language.h" 45 #include "lldb/Target/LanguageRuntime.h" 46 #include "lldb/Target/ObjCLanguageRuntime.h" 47 #include "lldb/Target/Process.h" 48 #include "lldb/Target/SectionLoadList.h" 49 #include "lldb/Target/StackFrame.h" 50 #include "lldb/Target/SystemRuntime.h" 51 #include "lldb/Target/Thread.h" 52 #include "lldb/Target/ThreadSpec.h" 53 #include "lldb/Utility/Event.h" 54 #include "lldb/Utility/FileSpec.h" 55 #include "lldb/Utility/LLDBAssert.h" 56 #include "lldb/Utility/Log.h" 57 #include "lldb/Utility/State.h" 58 #include "lldb/Utility/StreamString.h" 59 #include "lldb/Utility/Timer.h" 60 61 #include <memory> 62 #include <mutex> 63 64 using namespace lldb; 65 using namespace lldb_private; 66 67 constexpr std::chrono::milliseconds EvaluateExpressionOptions::default_timeout; 68 69 Target::Arch::Arch(const ArchSpec &spec) 70 : m_spec(spec), 71 m_plugin_up(PluginManager::CreateArchitectureInstance(spec)) {} 72 73 const Target::Arch& Target::Arch::operator=(const ArchSpec &spec) { 74 m_spec = spec; 75 m_plugin_up = PluginManager::CreateArchitectureInstance(spec); 76 return *this; 77 } 78 79 ConstString &Target::GetStaticBroadcasterClass() { 80 static ConstString class_name("lldb.target"); 81 return class_name; 82 } 83 84 Target::Target(Debugger &debugger, const ArchSpec &target_arch, 85 const lldb::PlatformSP &platform_sp, bool is_dummy_target) 86 : TargetProperties(this), 87 Broadcaster(debugger.GetBroadcasterManager(), 88 Target::GetStaticBroadcasterClass().AsCString()), 89 ExecutionContextScope(), m_debugger(debugger), m_platform_sp(platform_sp), 90 m_mutex(), m_arch(target_arch), m_images(this), m_section_load_history(), 91 m_breakpoint_list(false), m_internal_breakpoint_list(true), 92 m_watchpoint_list(), m_process_sp(), m_search_filter_sp(), 93 m_image_search_paths(ImageSearchPathsChanged, this), m_ast_importer_sp(), 94 m_source_manager_up(), m_stop_hooks(), m_stop_hook_next_id(0), 95 m_valid(true), m_suppress_stop_hooks(false), 96 m_is_dummy_target(is_dummy_target), 97 m_stats_storage(static_cast<int>(StatisticKind::StatisticMax)) 98 99 { 100 SetEventName(eBroadcastBitBreakpointChanged, "breakpoint-changed"); 101 SetEventName(eBroadcastBitModulesLoaded, "modules-loaded"); 102 SetEventName(eBroadcastBitModulesUnloaded, "modules-unloaded"); 103 SetEventName(eBroadcastBitWatchpointChanged, "watchpoint-changed"); 104 SetEventName(eBroadcastBitSymbolsLoaded, "symbols-loaded"); 105 106 CheckInWithManager(); 107 108 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT)); 109 if (log) 110 log->Printf("%p Target::Target()", static_cast<void *>(this)); 111 if (target_arch.IsValid()) { 112 LogIfAnyCategoriesSet(LIBLLDB_LOG_TARGET, 113 "Target::Target created with architecture %s (%s)", 114 target_arch.GetArchitectureName(), 115 target_arch.GetTriple().getTriple().c_str()); 116 } 117 } 118 119 Target::~Target() { 120 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_OBJECT)); 121 if (log) 122 log->Printf("%p Target::~Target()", static_cast<void *>(this)); 123 DeleteCurrentProcess(); 124 } 125 126 void Target::PrimeFromDummyTarget(Target *target) { 127 if (!target) 128 return; 129 130 m_stop_hooks = target->m_stop_hooks; 131 132 for (BreakpointSP breakpoint_sp : target->m_breakpoint_list.Breakpoints()) { 133 if (breakpoint_sp->IsInternal()) 134 continue; 135 136 BreakpointSP new_bp(new Breakpoint(*this, *breakpoint_sp.get())); 137 AddBreakpoint(new_bp, false); 138 } 139 140 for (auto bp_name_entry : target->m_breakpoint_names) 141 { 142 143 BreakpointName *new_bp_name = new BreakpointName(*bp_name_entry.second); 144 AddBreakpointName(new_bp_name); 145 } 146 } 147 148 void Target::Dump(Stream *s, lldb::DescriptionLevel description_level) { 149 // s->Printf("%.*p: ", (int)sizeof(void*) * 2, this); 150 if (description_level != lldb::eDescriptionLevelBrief) { 151 s->Indent(); 152 s->PutCString("Target\n"); 153 s->IndentMore(); 154 m_images.Dump(s); 155 m_breakpoint_list.Dump(s); 156 m_internal_breakpoint_list.Dump(s); 157 s->IndentLess(); 158 } else { 159 Module *exe_module = GetExecutableModulePointer(); 160 if (exe_module) 161 s->PutCString(exe_module->GetFileSpec().GetFilename().GetCString()); 162 else 163 s->PutCString("No executable module."); 164 } 165 } 166 167 void Target::CleanupProcess() { 168 // Do any cleanup of the target we need to do between process instances. 169 // NB It is better to do this before destroying the process in case the 170 // clean up needs some help from the process. 171 m_breakpoint_list.ClearAllBreakpointSites(); 172 m_internal_breakpoint_list.ClearAllBreakpointSites(); 173 // Disable watchpoints just on the debugger side. 174 std::unique_lock<std::recursive_mutex> lock; 175 this->GetWatchpointList().GetListMutex(lock); 176 DisableAllWatchpoints(false); 177 ClearAllWatchpointHitCounts(); 178 ClearAllWatchpointHistoricValues(); 179 } 180 181 void Target::DeleteCurrentProcess() { 182 if (m_process_sp) { 183 m_section_load_history.Clear(); 184 if (m_process_sp->IsAlive()) 185 m_process_sp->Destroy(false); 186 187 m_process_sp->Finalize(); 188 189 CleanupProcess(); 190 191 m_process_sp.reset(); 192 } 193 } 194 195 const lldb::ProcessSP &Target::CreateProcess(ListenerSP listener_sp, 196 llvm::StringRef plugin_name, 197 const FileSpec *crash_file) { 198 if (!listener_sp) 199 listener_sp = GetDebugger().GetListener(); 200 DeleteCurrentProcess(); 201 m_process_sp = Process::FindPlugin(shared_from_this(), plugin_name, 202 listener_sp, crash_file); 203 return m_process_sp; 204 } 205 206 const lldb::ProcessSP &Target::GetProcessSP() const { return m_process_sp; } 207 208 lldb::REPLSP Target::GetREPL(Status &err, lldb::LanguageType language, 209 const char *repl_options, bool can_create) { 210 if (language == eLanguageTypeUnknown) { 211 std::set<LanguageType> repl_languages; 212 213 Language::GetLanguagesSupportingREPLs(repl_languages); 214 215 if (repl_languages.size() == 1) { 216 language = *repl_languages.begin(); 217 } else if (repl_languages.size() == 0) { 218 err.SetErrorStringWithFormat( 219 "LLDB isn't configured with REPL support for any languages."); 220 return REPLSP(); 221 } else { 222 err.SetErrorStringWithFormat( 223 "Multiple possible REPL languages. Please specify a language."); 224 return REPLSP(); 225 } 226 } 227 228 REPLMap::iterator pos = m_repl_map.find(language); 229 230 if (pos != m_repl_map.end()) { 231 return pos->second; 232 } 233 234 if (!can_create) { 235 err.SetErrorStringWithFormat( 236 "Couldn't find an existing REPL for %s, and can't create a new one", 237 Language::GetNameForLanguageType(language)); 238 return lldb::REPLSP(); 239 } 240 241 Debugger *const debugger = nullptr; 242 lldb::REPLSP ret = REPL::Create(err, language, debugger, this, repl_options); 243 244 if (ret) { 245 m_repl_map[language] = ret; 246 return m_repl_map[language]; 247 } 248 249 if (err.Success()) { 250 err.SetErrorStringWithFormat("Couldn't create a REPL for %s", 251 Language::GetNameForLanguageType(language)); 252 } 253 254 return lldb::REPLSP(); 255 } 256 257 void Target::SetREPL(lldb::LanguageType language, lldb::REPLSP repl_sp) { 258 lldbassert(!m_repl_map.count(language)); 259 260 m_repl_map[language] = repl_sp; 261 } 262 263 void Target::Destroy() { 264 std::lock_guard<std::recursive_mutex> guard(m_mutex); 265 m_valid = false; 266 DeleteCurrentProcess(); 267 m_platform_sp.reset(); 268 m_arch = ArchSpec(); 269 ClearModules(true); 270 m_section_load_history.Clear(); 271 const bool notify = false; 272 m_breakpoint_list.RemoveAll(notify); 273 m_internal_breakpoint_list.RemoveAll(notify); 274 m_last_created_breakpoint.reset(); 275 m_last_created_watchpoint.reset(); 276 m_search_filter_sp.reset(); 277 m_image_search_paths.Clear(notify); 278 m_stop_hooks.clear(); 279 m_stop_hook_next_id = 0; 280 m_suppress_stop_hooks = false; 281 } 282 283 BreakpointList &Target::GetBreakpointList(bool internal) { 284 if (internal) 285 return m_internal_breakpoint_list; 286 else 287 return m_breakpoint_list; 288 } 289 290 const BreakpointList &Target::GetBreakpointList(bool internal) const { 291 if (internal) 292 return m_internal_breakpoint_list; 293 else 294 return m_breakpoint_list; 295 } 296 297 BreakpointSP Target::GetBreakpointByID(break_id_t break_id) { 298 BreakpointSP bp_sp; 299 300 if (LLDB_BREAK_ID_IS_INTERNAL(break_id)) 301 bp_sp = m_internal_breakpoint_list.FindBreakpointByID(break_id); 302 else 303 bp_sp = m_breakpoint_list.FindBreakpointByID(break_id); 304 305 return bp_sp; 306 } 307 308 BreakpointSP Target::CreateSourceRegexBreakpoint( 309 const FileSpecList *containingModules, 310 const FileSpecList *source_file_spec_list, 311 const std::unordered_set<std::string> &function_names, 312 RegularExpression &source_regex, bool internal, bool hardware, 313 LazyBool move_to_nearest_code) { 314 SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList( 315 containingModules, source_file_spec_list)); 316 if (move_to_nearest_code == eLazyBoolCalculate) 317 move_to_nearest_code = GetMoveToNearestCode() ? eLazyBoolYes : eLazyBoolNo; 318 BreakpointResolverSP resolver_sp(new BreakpointResolverFileRegex( 319 nullptr, source_regex, function_names, 320 !static_cast<bool>(move_to_nearest_code))); 321 322 return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true); 323 } 324 325 BreakpointSP Target::CreateBreakpoint(const FileSpecList *containingModules, 326 const FileSpec &file, uint32_t line_no, 327 uint32_t column, lldb::addr_t offset, 328 LazyBool check_inlines, 329 LazyBool skip_prologue, bool internal, 330 bool hardware, 331 LazyBool move_to_nearest_code) { 332 FileSpec remapped_file; 333 if (!GetSourcePathMap().ReverseRemapPath(file, remapped_file)) 334 remapped_file = file; 335 336 if (check_inlines == eLazyBoolCalculate) { 337 const InlineStrategy inline_strategy = GetInlineStrategy(); 338 switch (inline_strategy) { 339 case eInlineBreakpointsNever: 340 check_inlines = eLazyBoolNo; 341 break; 342 343 case eInlineBreakpointsHeaders: 344 if (remapped_file.IsSourceImplementationFile()) 345 check_inlines = eLazyBoolNo; 346 else 347 check_inlines = eLazyBoolYes; 348 break; 349 350 case eInlineBreakpointsAlways: 351 check_inlines = eLazyBoolYes; 352 break; 353 } 354 } 355 SearchFilterSP filter_sp; 356 if (check_inlines == eLazyBoolNo) { 357 // Not checking for inlines, we are looking only for matching compile units 358 FileSpecList compile_unit_list; 359 compile_unit_list.Append(remapped_file); 360 filter_sp = GetSearchFilterForModuleAndCUList(containingModules, 361 &compile_unit_list); 362 } else { 363 filter_sp = GetSearchFilterForModuleList(containingModules); 364 } 365 if (skip_prologue == eLazyBoolCalculate) 366 skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo; 367 if (move_to_nearest_code == eLazyBoolCalculate) 368 move_to_nearest_code = GetMoveToNearestCode() ? eLazyBoolYes : eLazyBoolNo; 369 370 BreakpointResolverSP resolver_sp(new BreakpointResolverFileLine( 371 nullptr, remapped_file, line_no, column, offset, check_inlines, 372 skip_prologue, !static_cast<bool>(move_to_nearest_code))); 373 return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true); 374 } 375 376 BreakpointSP Target::CreateBreakpoint(lldb::addr_t addr, bool internal, 377 bool hardware) { 378 Address so_addr; 379 380 // Check for any reason we want to move this breakpoint to other address. 381 addr = GetBreakableLoadAddress(addr); 382 383 // Attempt to resolve our load address if possible, though it is ok if it 384 // doesn't resolve to section/offset. 385 386 // Try and resolve as a load address if possible 387 GetSectionLoadList().ResolveLoadAddress(addr, so_addr); 388 if (!so_addr.IsValid()) { 389 // The address didn't resolve, so just set this as an absolute address 390 so_addr.SetOffset(addr); 391 } 392 BreakpointSP bp_sp(CreateBreakpoint(so_addr, internal, hardware)); 393 return bp_sp; 394 } 395 396 BreakpointSP Target::CreateBreakpoint(const Address &addr, bool internal, 397 bool hardware) { 398 SearchFilterSP filter_sp( 399 new SearchFilterForUnconstrainedSearches(shared_from_this())); 400 BreakpointResolverSP resolver_sp( 401 new BreakpointResolverAddress(nullptr, addr)); 402 return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, false); 403 } 404 405 lldb::BreakpointSP 406 Target::CreateAddressInModuleBreakpoint(lldb::addr_t file_addr, bool internal, 407 const FileSpec *file_spec, 408 bool request_hardware) { 409 SearchFilterSP filter_sp( 410 new SearchFilterForUnconstrainedSearches(shared_from_this())); 411 BreakpointResolverSP resolver_sp( 412 new BreakpointResolverAddress(nullptr, file_addr, file_spec)); 413 return CreateBreakpoint(filter_sp, resolver_sp, internal, request_hardware, 414 false); 415 } 416 417 BreakpointSP Target::CreateBreakpoint( 418 const FileSpecList *containingModules, 419 const FileSpecList *containingSourceFiles, const char *func_name, 420 FunctionNameType func_name_type_mask, LanguageType language, 421 lldb::addr_t offset, LazyBool skip_prologue, bool internal, bool hardware) { 422 BreakpointSP bp_sp; 423 if (func_name) { 424 SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList( 425 containingModules, containingSourceFiles)); 426 427 if (skip_prologue == eLazyBoolCalculate) 428 skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo; 429 if (language == lldb::eLanguageTypeUnknown) 430 language = GetLanguage(); 431 432 BreakpointResolverSP resolver_sp(new BreakpointResolverName( 433 nullptr, func_name, func_name_type_mask, language, Breakpoint::Exact, 434 offset, skip_prologue)); 435 bp_sp = CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true); 436 } 437 return bp_sp; 438 } 439 440 lldb::BreakpointSP 441 Target::CreateBreakpoint(const FileSpecList *containingModules, 442 const FileSpecList *containingSourceFiles, 443 const std::vector<std::string> &func_names, 444 FunctionNameType func_name_type_mask, 445 LanguageType language, lldb::addr_t offset, 446 LazyBool skip_prologue, bool internal, bool hardware) { 447 BreakpointSP bp_sp; 448 size_t num_names = func_names.size(); 449 if (num_names > 0) { 450 SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList( 451 containingModules, containingSourceFiles)); 452 453 if (skip_prologue == eLazyBoolCalculate) 454 skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo; 455 if (language == lldb::eLanguageTypeUnknown) 456 language = GetLanguage(); 457 458 BreakpointResolverSP resolver_sp( 459 new BreakpointResolverName(nullptr, func_names, func_name_type_mask, 460 language, offset, skip_prologue)); 461 bp_sp = CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true); 462 } 463 return bp_sp; 464 } 465 466 BreakpointSP 467 Target::CreateBreakpoint(const FileSpecList *containingModules, 468 const FileSpecList *containingSourceFiles, 469 const char *func_names[], size_t num_names, 470 FunctionNameType func_name_type_mask, 471 LanguageType language, lldb::addr_t offset, 472 LazyBool skip_prologue, bool internal, bool hardware) { 473 BreakpointSP bp_sp; 474 if (num_names > 0) { 475 SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList( 476 containingModules, containingSourceFiles)); 477 478 if (skip_prologue == eLazyBoolCalculate) { 479 if (offset == 0) 480 skip_prologue = GetSkipPrologue() ? eLazyBoolYes : eLazyBoolNo; 481 else 482 skip_prologue = eLazyBoolNo; 483 } 484 if (language == lldb::eLanguageTypeUnknown) 485 language = GetLanguage(); 486 487 BreakpointResolverSP resolver_sp(new BreakpointResolverName( 488 nullptr, func_names, num_names, func_name_type_mask, language, offset, 489 skip_prologue)); 490 resolver_sp->SetOffset(offset); 491 bp_sp = CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true); 492 } 493 return bp_sp; 494 } 495 496 SearchFilterSP 497 Target::GetSearchFilterForModule(const FileSpec *containingModule) { 498 SearchFilterSP filter_sp; 499 if (containingModule != nullptr) { 500 // TODO: We should look into sharing module based search filters 501 // across many breakpoints like we do for the simple target based one 502 filter_sp = std::make_shared<SearchFilterByModule>(shared_from_this(), 503 *containingModule); 504 } else { 505 if (!m_search_filter_sp) 506 m_search_filter_sp = 507 std::make_shared<SearchFilterForUnconstrainedSearches>( 508 shared_from_this()); 509 filter_sp = m_search_filter_sp; 510 } 511 return filter_sp; 512 } 513 514 SearchFilterSP 515 Target::GetSearchFilterForModuleList(const FileSpecList *containingModules) { 516 SearchFilterSP filter_sp; 517 if (containingModules && containingModules->GetSize() != 0) { 518 // TODO: We should look into sharing module based search filters 519 // across many breakpoints like we do for the simple target based one 520 filter_sp = std::make_shared<SearchFilterByModuleList>(shared_from_this(), 521 *containingModules); 522 } else { 523 if (!m_search_filter_sp) 524 m_search_filter_sp = 525 std::make_shared<SearchFilterForUnconstrainedSearches>( 526 shared_from_this()); 527 filter_sp = m_search_filter_sp; 528 } 529 return filter_sp; 530 } 531 532 SearchFilterSP Target::GetSearchFilterForModuleAndCUList( 533 const FileSpecList *containingModules, 534 const FileSpecList *containingSourceFiles) { 535 if (containingSourceFiles == nullptr || containingSourceFiles->GetSize() == 0) 536 return GetSearchFilterForModuleList(containingModules); 537 538 SearchFilterSP filter_sp; 539 if (containingModules == nullptr) { 540 // We could make a special "CU List only SearchFilter". Better yet was if 541 // these could be composable, but that will take a little reworking. 542 543 filter_sp = std::make_shared<SearchFilterByModuleListAndCU>( 544 shared_from_this(), FileSpecList(), *containingSourceFiles); 545 } else { 546 filter_sp = std::make_shared<SearchFilterByModuleListAndCU>( 547 shared_from_this(), *containingModules, *containingSourceFiles); 548 } 549 return filter_sp; 550 } 551 552 BreakpointSP Target::CreateFuncRegexBreakpoint( 553 const FileSpecList *containingModules, 554 const FileSpecList *containingSourceFiles, RegularExpression &func_regex, 555 lldb::LanguageType requested_language, LazyBool skip_prologue, 556 bool internal, bool hardware) { 557 SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList( 558 containingModules, containingSourceFiles)); 559 bool skip = (skip_prologue == eLazyBoolCalculate) 560 ? GetSkipPrologue() 561 : static_cast<bool>(skip_prologue); 562 BreakpointResolverSP resolver_sp(new BreakpointResolverName( 563 nullptr, func_regex, requested_language, 0, skip)); 564 565 return CreateBreakpoint(filter_sp, resolver_sp, internal, hardware, true); 566 } 567 568 lldb::BreakpointSP 569 Target::CreateExceptionBreakpoint(enum lldb::LanguageType language, 570 bool catch_bp, bool throw_bp, bool internal, 571 Args *additional_args, Status *error) { 572 BreakpointSP exc_bkpt_sp = LanguageRuntime::CreateExceptionBreakpoint( 573 *this, language, catch_bp, throw_bp, internal); 574 if (exc_bkpt_sp && additional_args) { 575 Breakpoint::BreakpointPreconditionSP precondition_sp = 576 exc_bkpt_sp->GetPrecondition(); 577 if (precondition_sp && additional_args) { 578 if (error) 579 *error = precondition_sp->ConfigurePrecondition(*additional_args); 580 else 581 precondition_sp->ConfigurePrecondition(*additional_args); 582 } 583 } 584 return exc_bkpt_sp; 585 } 586 587 lldb::BreakpointSP 588 Target::CreateScriptedBreakpoint(const llvm::StringRef class_name, 589 const FileSpecList *containingModules, 590 const FileSpecList *containingSourceFiles, 591 bool internal, 592 bool request_hardware, 593 StructuredData::ObjectSP extra_args_sp, 594 Status *creation_error) 595 { 596 SearchFilterSP filter_sp; 597 598 lldb::SearchDepth depth = lldb::eSearchDepthTarget; 599 bool has_files = containingSourceFiles && containingSourceFiles->GetSize() > 0; 600 bool has_modules = containingModules && containingModules->GetSize() > 0; 601 602 if (has_files && has_modules) { 603 filter_sp = GetSearchFilterForModuleAndCUList( 604 containingModules, containingSourceFiles); 605 } else if (has_files) { 606 filter_sp = GetSearchFilterForModuleAndCUList( 607 nullptr, containingSourceFiles); 608 } else if (has_modules) { 609 filter_sp = GetSearchFilterForModuleList(containingModules); 610 } else { 611 filter_sp = std::make_shared<SearchFilterForUnconstrainedSearches>( 612 shared_from_this()); 613 } 614 615 StructuredDataImpl *extra_args_impl = new StructuredDataImpl(); 616 if (extra_args_sp) 617 extra_args_impl->SetObjectSP(extra_args_sp); 618 619 BreakpointResolverSP resolver_sp(new 620 BreakpointResolverScripted(nullptr, class_name, 621 depth, 622 extra_args_impl, 623 *GetDebugger().GetCommandInterpreter() 624 .GetScriptInterpreter())); 625 return CreateBreakpoint(filter_sp, resolver_sp, internal, false, true); 626 627 } 628 629 630 BreakpointSP Target::CreateBreakpoint(SearchFilterSP &filter_sp, 631 BreakpointResolverSP &resolver_sp, 632 bool internal, bool request_hardware, 633 bool resolve_indirect_symbols) { 634 BreakpointSP bp_sp; 635 if (filter_sp && resolver_sp) { 636 const bool hardware = request_hardware || GetRequireHardwareBreakpoints(); 637 bp_sp.reset(new Breakpoint(*this, filter_sp, resolver_sp, hardware, 638 resolve_indirect_symbols)); 639 resolver_sp->SetBreakpoint(bp_sp.get()); 640 AddBreakpoint(bp_sp, internal); 641 } 642 return bp_sp; 643 } 644 645 void Target::AddBreakpoint(lldb::BreakpointSP bp_sp, bool internal) { 646 if (!bp_sp) 647 return; 648 if (internal) 649 m_internal_breakpoint_list.Add(bp_sp, false); 650 else 651 m_breakpoint_list.Add(bp_sp, true); 652 653 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 654 if (log) { 655 StreamString s; 656 bp_sp->GetDescription(&s, lldb::eDescriptionLevelVerbose); 657 log->Printf("Target::%s (internal = %s) => break_id = %s\n", __FUNCTION__, 658 bp_sp->IsInternal() ? "yes" : "no", s.GetData()); 659 } 660 661 bp_sp->ResolveBreakpoint(); 662 663 if (!internal) { 664 m_last_created_breakpoint = bp_sp; 665 } 666 } 667 668 void Target::AddNameToBreakpoint(BreakpointID &id, 669 const char *name, 670 Status &error) 671 { 672 BreakpointSP bp_sp 673 = m_breakpoint_list.FindBreakpointByID(id.GetBreakpointID()); 674 if (!bp_sp) 675 { 676 StreamString s; 677 id.GetDescription(&s, eDescriptionLevelBrief); 678 error.SetErrorStringWithFormat("Could not find breakpoint %s", 679 s.GetData()); 680 return; 681 } 682 AddNameToBreakpoint(bp_sp, name, error); 683 } 684 685 void Target::AddNameToBreakpoint(BreakpointSP &bp_sp, 686 const char *name, 687 Status &error) 688 { 689 if (!bp_sp) 690 return; 691 692 BreakpointName *bp_name = FindBreakpointName(ConstString(name), true, error); 693 if (!bp_name) 694 return; 695 696 bp_name->ConfigureBreakpoint(bp_sp); 697 bp_sp->AddName(name); 698 } 699 700 void Target::AddBreakpointName(BreakpointName *bp_name) { 701 m_breakpoint_names.insert(std::make_pair(bp_name->GetName(), bp_name)); 702 } 703 704 BreakpointName *Target::FindBreakpointName(const ConstString &name, 705 bool can_create, 706 Status &error) 707 { 708 BreakpointID::StringIsBreakpointName(name.GetStringRef(), error); 709 if (!error.Success()) 710 return nullptr; 711 712 BreakpointNameList::iterator iter = m_breakpoint_names.find(name); 713 if (iter == m_breakpoint_names.end()) { 714 if (!can_create) 715 { 716 error.SetErrorStringWithFormat("Breakpoint name \"%s\" doesn't exist and " 717 "can_create is false.", name.AsCString()); 718 return nullptr; 719 } 720 721 iter = m_breakpoint_names.insert(std::make_pair(name, 722 new BreakpointName(name))) 723 .first; 724 } 725 return (iter->second); 726 } 727 728 void 729 Target::DeleteBreakpointName(const ConstString &name) 730 { 731 BreakpointNameList::iterator iter = m_breakpoint_names.find(name); 732 733 if (iter != m_breakpoint_names.end()) { 734 const char *name_cstr = name.AsCString(); 735 m_breakpoint_names.erase(iter); 736 for (auto bp_sp : m_breakpoint_list.Breakpoints()) 737 bp_sp->RemoveName(name_cstr); 738 } 739 } 740 741 void Target::RemoveNameFromBreakpoint(lldb::BreakpointSP &bp_sp, 742 const ConstString &name) 743 { 744 bp_sp->RemoveName(name.AsCString()); 745 } 746 747 void Target::ConfigureBreakpointName(BreakpointName &bp_name, 748 const BreakpointOptions &new_options, 749 const BreakpointName::Permissions &new_permissions) 750 { 751 bp_name.GetOptions().CopyOverSetOptions(new_options); 752 bp_name.GetPermissions().MergeInto(new_permissions); 753 ApplyNameToBreakpoints(bp_name); 754 } 755 756 void Target::ApplyNameToBreakpoints(BreakpointName &bp_name) { 757 BreakpointList bkpts_with_name(false); 758 m_breakpoint_list.FindBreakpointsByName(bp_name.GetName().AsCString(), 759 bkpts_with_name); 760 761 for (auto bp_sp : bkpts_with_name.Breakpoints()) 762 bp_name.ConfigureBreakpoint(bp_sp); 763 } 764 765 void Target::GetBreakpointNames(std::vector<std::string> &names) 766 { 767 names.clear(); 768 for (auto bp_name : m_breakpoint_names) { 769 names.push_back(bp_name.first.AsCString()); 770 } 771 llvm::sort(names.begin(), names.end()); 772 } 773 774 bool Target::ProcessIsValid() { 775 return (m_process_sp && m_process_sp->IsAlive()); 776 } 777 778 static bool CheckIfWatchpointsSupported(Target *target, Status &error) { 779 uint32_t num_supported_hardware_watchpoints; 780 Status rc = target->GetProcessSP()->GetWatchpointSupportInfo( 781 num_supported_hardware_watchpoints); 782 783 // If unable to determine the # of watchpoints available, 784 // assume they are supported. 785 if (rc.Fail()) 786 return true; 787 788 if (num_supported_hardware_watchpoints == 0) { 789 error.SetErrorStringWithFormat( 790 "Target supports (%u) hardware watchpoint slots.\n", 791 num_supported_hardware_watchpoints); 792 return false; 793 } 794 return true; 795 } 796 797 // See also Watchpoint::SetWatchpointType(uint32_t type) and the 798 // OptionGroupWatchpoint::WatchType enum type. 799 WatchpointSP Target::CreateWatchpoint(lldb::addr_t addr, size_t size, 800 const CompilerType *type, uint32_t kind, 801 Status &error) { 802 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 803 if (log) 804 log->Printf("Target::%s (addr = 0x%8.8" PRIx64 " size = %" PRIu64 805 " type = %u)\n", 806 __FUNCTION__, addr, (uint64_t)size, kind); 807 808 WatchpointSP wp_sp; 809 if (!ProcessIsValid()) { 810 error.SetErrorString("process is not alive"); 811 return wp_sp; 812 } 813 814 if (addr == LLDB_INVALID_ADDRESS || size == 0) { 815 if (size == 0) 816 error.SetErrorString("cannot set a watchpoint with watch_size of 0"); 817 else 818 error.SetErrorStringWithFormat("invalid watch address: %" PRIu64, addr); 819 return wp_sp; 820 } 821 822 if (!LLDB_WATCH_TYPE_IS_VALID(kind)) { 823 error.SetErrorStringWithFormat("invalid watchpoint type: %d", kind); 824 } 825 826 if (!CheckIfWatchpointsSupported(this, error)) 827 return wp_sp; 828 829 // Currently we only support one watchpoint per address, with total number of 830 // watchpoints limited by the hardware which the inferior is running on. 831 832 // Grab the list mutex while doing operations. 833 const bool notify = false; // Don't notify about all the state changes we do 834 // on creating the watchpoint. 835 std::unique_lock<std::recursive_mutex> lock; 836 this->GetWatchpointList().GetListMutex(lock); 837 WatchpointSP matched_sp = m_watchpoint_list.FindByAddress(addr); 838 if (matched_sp) { 839 size_t old_size = matched_sp->GetByteSize(); 840 uint32_t old_type = 841 (matched_sp->WatchpointRead() ? LLDB_WATCH_TYPE_READ : 0) | 842 (matched_sp->WatchpointWrite() ? LLDB_WATCH_TYPE_WRITE : 0); 843 // Return the existing watchpoint if both size and type match. 844 if (size == old_size && kind == old_type) { 845 wp_sp = matched_sp; 846 wp_sp->SetEnabled(false, notify); 847 } else { 848 // Nil the matched watchpoint; we will be creating a new one. 849 m_process_sp->DisableWatchpoint(matched_sp.get(), notify); 850 m_watchpoint_list.Remove(matched_sp->GetID(), true); 851 } 852 } 853 854 if (!wp_sp) { 855 wp_sp = std::make_shared<Watchpoint>(*this, addr, size, type); 856 wp_sp->SetWatchpointType(kind, notify); 857 m_watchpoint_list.Add(wp_sp, true); 858 } 859 860 error = m_process_sp->EnableWatchpoint(wp_sp.get(), notify); 861 if (log) 862 log->Printf("Target::%s (creation of watchpoint %s with id = %u)\n", 863 __FUNCTION__, error.Success() ? "succeeded" : "failed", 864 wp_sp->GetID()); 865 866 if (error.Fail()) { 867 // Enabling the watchpoint on the device side failed. Remove the said 868 // watchpoint from the list maintained by the target instance. 869 m_watchpoint_list.Remove(wp_sp->GetID(), true); 870 // See if we could provide more helpful error message. 871 if (!OptionGroupWatchpoint::IsWatchSizeSupported(size)) 872 error.SetErrorStringWithFormat( 873 "watch size of %" PRIu64 " is not supported", (uint64_t)size); 874 875 wp_sp.reset(); 876 } else 877 m_last_created_watchpoint = wp_sp; 878 return wp_sp; 879 } 880 881 void Target::RemoveAllowedBreakpoints () 882 { 883 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 884 if (log) 885 log->Printf("Target::%s \n", __FUNCTION__); 886 887 m_breakpoint_list.RemoveAllowed(true); 888 889 m_last_created_breakpoint.reset(); 890 } 891 892 void Target::RemoveAllBreakpoints(bool internal_also) { 893 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 894 if (log) 895 log->Printf("Target::%s (internal_also = %s)\n", __FUNCTION__, 896 internal_also ? "yes" : "no"); 897 898 m_breakpoint_list.RemoveAll(true); 899 if (internal_also) 900 m_internal_breakpoint_list.RemoveAll(false); 901 902 m_last_created_breakpoint.reset(); 903 } 904 905 void Target::DisableAllBreakpoints(bool internal_also) { 906 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 907 if (log) 908 log->Printf("Target::%s (internal_also = %s)\n", __FUNCTION__, 909 internal_also ? "yes" : "no"); 910 911 m_breakpoint_list.SetEnabledAll(false); 912 if (internal_also) 913 m_internal_breakpoint_list.SetEnabledAll(false); 914 } 915 916 void Target::DisableAllowedBreakpoints() { 917 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 918 if (log) 919 log->Printf("Target::%s", __FUNCTION__); 920 921 m_breakpoint_list.SetEnabledAllowed(false); 922 } 923 924 void Target::EnableAllBreakpoints(bool internal_also) { 925 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 926 if (log) 927 log->Printf("Target::%s (internal_also = %s)\n", __FUNCTION__, 928 internal_also ? "yes" : "no"); 929 930 m_breakpoint_list.SetEnabledAll(true); 931 if (internal_also) 932 m_internal_breakpoint_list.SetEnabledAll(true); 933 } 934 935 void Target::EnableAllowedBreakpoints() { 936 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 937 if (log) 938 log->Printf("Target::%s", __FUNCTION__); 939 940 m_breakpoint_list.SetEnabledAllowed(true); 941 } 942 943 bool Target::RemoveBreakpointByID(break_id_t break_id) { 944 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 945 if (log) 946 log->Printf("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__, 947 break_id, LLDB_BREAK_ID_IS_INTERNAL(break_id) ? "yes" : "no"); 948 949 if (DisableBreakpointByID(break_id)) { 950 if (LLDB_BREAK_ID_IS_INTERNAL(break_id)) 951 m_internal_breakpoint_list.Remove(break_id, false); 952 else { 953 if (m_last_created_breakpoint) { 954 if (m_last_created_breakpoint->GetID() == break_id) 955 m_last_created_breakpoint.reset(); 956 } 957 m_breakpoint_list.Remove(break_id, true); 958 } 959 return true; 960 } 961 return false; 962 } 963 964 bool Target::DisableBreakpointByID(break_id_t break_id) { 965 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 966 if (log) 967 log->Printf("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__, 968 break_id, LLDB_BREAK_ID_IS_INTERNAL(break_id) ? "yes" : "no"); 969 970 BreakpointSP bp_sp; 971 972 if (LLDB_BREAK_ID_IS_INTERNAL(break_id)) 973 bp_sp = m_internal_breakpoint_list.FindBreakpointByID(break_id); 974 else 975 bp_sp = m_breakpoint_list.FindBreakpointByID(break_id); 976 if (bp_sp) { 977 bp_sp->SetEnabled(false); 978 return true; 979 } 980 return false; 981 } 982 983 bool Target::EnableBreakpointByID(break_id_t break_id) { 984 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_BREAKPOINTS)); 985 if (log) 986 log->Printf("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__, 987 break_id, LLDB_BREAK_ID_IS_INTERNAL(break_id) ? "yes" : "no"); 988 989 BreakpointSP bp_sp; 990 991 if (LLDB_BREAK_ID_IS_INTERNAL(break_id)) 992 bp_sp = m_internal_breakpoint_list.FindBreakpointByID(break_id); 993 else 994 bp_sp = m_breakpoint_list.FindBreakpointByID(break_id); 995 996 if (bp_sp) { 997 bp_sp->SetEnabled(true); 998 return true; 999 } 1000 return false; 1001 } 1002 1003 Status Target::SerializeBreakpointsToFile(const FileSpec &file, 1004 const BreakpointIDList &bp_ids, 1005 bool append) { 1006 Status error; 1007 1008 if (!file) { 1009 error.SetErrorString("Invalid FileSpec."); 1010 return error; 1011 } 1012 1013 std::string path(file.GetPath()); 1014 StructuredData::ObjectSP input_data_sp; 1015 1016 StructuredData::ArraySP break_store_sp; 1017 StructuredData::Array *break_store_ptr = nullptr; 1018 1019 if (append) { 1020 input_data_sp = StructuredData::ParseJSONFromFile(file, error); 1021 if (error.Success()) { 1022 break_store_ptr = input_data_sp->GetAsArray(); 1023 if (!break_store_ptr) { 1024 error.SetErrorStringWithFormat( 1025 "Tried to append to invalid input file %s", path.c_str()); 1026 return error; 1027 } 1028 } 1029 } 1030 1031 if (!break_store_ptr) { 1032 break_store_sp = std::make_shared<StructuredData::Array>(); 1033 break_store_ptr = break_store_sp.get(); 1034 } 1035 1036 StreamFile out_file(path.c_str(), 1037 File::OpenOptions::eOpenOptionTruncate | 1038 File::OpenOptions::eOpenOptionWrite | 1039 File::OpenOptions::eOpenOptionCanCreate | 1040 File::OpenOptions::eOpenOptionCloseOnExec, 1041 lldb::eFilePermissionsFileDefault); 1042 if (!out_file.GetFile().IsValid()) { 1043 error.SetErrorStringWithFormat("Unable to open output file: %s.", 1044 path.c_str()); 1045 return error; 1046 } 1047 1048 std::unique_lock<std::recursive_mutex> lock; 1049 GetBreakpointList().GetListMutex(lock); 1050 1051 if (bp_ids.GetSize() == 0) { 1052 const BreakpointList &breakpoints = GetBreakpointList(); 1053 1054 size_t num_breakpoints = breakpoints.GetSize(); 1055 for (size_t i = 0; i < num_breakpoints; i++) { 1056 Breakpoint *bp = breakpoints.GetBreakpointAtIndex(i).get(); 1057 StructuredData::ObjectSP bkpt_save_sp = bp->SerializeToStructuredData(); 1058 // If a breakpoint can't serialize it, just ignore it for now: 1059 if (bkpt_save_sp) 1060 break_store_ptr->AddItem(bkpt_save_sp); 1061 } 1062 } else { 1063 1064 std::unordered_set<lldb::break_id_t> processed_bkpts; 1065 const size_t count = bp_ids.GetSize(); 1066 for (size_t i = 0; i < count; ++i) { 1067 BreakpointID cur_bp_id = bp_ids.GetBreakpointIDAtIndex(i); 1068 lldb::break_id_t bp_id = cur_bp_id.GetBreakpointID(); 1069 1070 if (bp_id != LLDB_INVALID_BREAK_ID) { 1071 // Only do each breakpoint once: 1072 std::pair<std::unordered_set<lldb::break_id_t>::iterator, bool> 1073 insert_result = processed_bkpts.insert(bp_id); 1074 if (!insert_result.second) 1075 continue; 1076 1077 Breakpoint *bp = GetBreakpointByID(bp_id).get(); 1078 StructuredData::ObjectSP bkpt_save_sp = bp->SerializeToStructuredData(); 1079 // If the user explicitly asked to serialize a breakpoint, and we 1080 // can't, then raise an error: 1081 if (!bkpt_save_sp) { 1082 error.SetErrorStringWithFormat("Unable to serialize breakpoint %d", 1083 bp_id); 1084 return error; 1085 } 1086 break_store_ptr->AddItem(bkpt_save_sp); 1087 } 1088 } 1089 } 1090 1091 break_store_ptr->Dump(out_file, false); 1092 out_file.PutChar('\n'); 1093 return error; 1094 } 1095 1096 Status Target::CreateBreakpointsFromFile(const FileSpec &file, 1097 BreakpointIDList &new_bps) { 1098 std::vector<std::string> no_names; 1099 return CreateBreakpointsFromFile(file, no_names, new_bps); 1100 } 1101 1102 Status Target::CreateBreakpointsFromFile(const FileSpec &file, 1103 std::vector<std::string> &names, 1104 BreakpointIDList &new_bps) { 1105 std::unique_lock<std::recursive_mutex> lock; 1106 GetBreakpointList().GetListMutex(lock); 1107 1108 Status error; 1109 StructuredData::ObjectSP input_data_sp = 1110 StructuredData::ParseJSONFromFile(file, error); 1111 if (!error.Success()) { 1112 return error; 1113 } else if (!input_data_sp || !input_data_sp->IsValid()) { 1114 error.SetErrorStringWithFormat("Invalid JSON from input file: %s.", 1115 file.GetPath().c_str()); 1116 return error; 1117 } 1118 1119 StructuredData::Array *bkpt_array = input_data_sp->GetAsArray(); 1120 if (!bkpt_array) { 1121 error.SetErrorStringWithFormat( 1122 "Invalid breakpoint data from input file: %s.", file.GetPath().c_str()); 1123 return error; 1124 } 1125 1126 size_t num_bkpts = bkpt_array->GetSize(); 1127 size_t num_names = names.size(); 1128 1129 for (size_t i = 0; i < num_bkpts; i++) { 1130 StructuredData::ObjectSP bkpt_object_sp = bkpt_array->GetItemAtIndex(i); 1131 // Peel off the breakpoint key, and feed the rest to the Breakpoint: 1132 StructuredData::Dictionary *bkpt_dict = bkpt_object_sp->GetAsDictionary(); 1133 if (!bkpt_dict) { 1134 error.SetErrorStringWithFormat( 1135 "Invalid breakpoint data for element %zu from input file: %s.", i, 1136 file.GetPath().c_str()); 1137 return error; 1138 } 1139 StructuredData::ObjectSP bkpt_data_sp = 1140 bkpt_dict->GetValueForKey(Breakpoint::GetSerializationKey()); 1141 if (num_names && 1142 !Breakpoint::SerializedBreakpointMatchesNames(bkpt_data_sp, names)) 1143 continue; 1144 1145 BreakpointSP bkpt_sp = 1146 Breakpoint::CreateFromStructuredData(*this, bkpt_data_sp, error); 1147 if (!error.Success()) { 1148 error.SetErrorStringWithFormat( 1149 "Error restoring breakpoint %zu from %s: %s.", i, 1150 file.GetPath().c_str(), error.AsCString()); 1151 return error; 1152 } 1153 new_bps.AddBreakpointID(BreakpointID(bkpt_sp->GetID())); 1154 } 1155 return error; 1156 } 1157 1158 // The flag 'end_to_end', default to true, signifies that the operation is 1159 // performed end to end, for both the debugger and the debuggee. 1160 1161 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end 1162 // to end operations. 1163 bool Target::RemoveAllWatchpoints(bool end_to_end) { 1164 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1165 if (log) 1166 log->Printf("Target::%s\n", __FUNCTION__); 1167 1168 if (!end_to_end) { 1169 m_watchpoint_list.RemoveAll(true); 1170 return true; 1171 } 1172 1173 // Otherwise, it's an end to end operation. 1174 1175 if (!ProcessIsValid()) 1176 return false; 1177 1178 size_t num_watchpoints = m_watchpoint_list.GetSize(); 1179 for (size_t i = 0; i < num_watchpoints; ++i) { 1180 WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i); 1181 if (!wp_sp) 1182 return false; 1183 1184 Status rc = m_process_sp->DisableWatchpoint(wp_sp.get()); 1185 if (rc.Fail()) 1186 return false; 1187 } 1188 m_watchpoint_list.RemoveAll(true); 1189 m_last_created_watchpoint.reset(); 1190 return true; // Success! 1191 } 1192 1193 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end 1194 // to end operations. 1195 bool Target::DisableAllWatchpoints(bool end_to_end) { 1196 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1197 if (log) 1198 log->Printf("Target::%s\n", __FUNCTION__); 1199 1200 if (!end_to_end) { 1201 m_watchpoint_list.SetEnabledAll(false); 1202 return true; 1203 } 1204 1205 // Otherwise, it's an end to end operation. 1206 1207 if (!ProcessIsValid()) 1208 return false; 1209 1210 size_t num_watchpoints = m_watchpoint_list.GetSize(); 1211 for (size_t i = 0; i < num_watchpoints; ++i) { 1212 WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i); 1213 if (!wp_sp) 1214 return false; 1215 1216 Status rc = m_process_sp->DisableWatchpoint(wp_sp.get()); 1217 if (rc.Fail()) 1218 return false; 1219 } 1220 return true; // Success! 1221 } 1222 1223 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end 1224 // to end operations. 1225 bool Target::EnableAllWatchpoints(bool end_to_end) { 1226 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1227 if (log) 1228 log->Printf("Target::%s\n", __FUNCTION__); 1229 1230 if (!end_to_end) { 1231 m_watchpoint_list.SetEnabledAll(true); 1232 return true; 1233 } 1234 1235 // Otherwise, it's an end to end operation. 1236 1237 if (!ProcessIsValid()) 1238 return false; 1239 1240 size_t num_watchpoints = m_watchpoint_list.GetSize(); 1241 for (size_t i = 0; i < num_watchpoints; ++i) { 1242 WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i); 1243 if (!wp_sp) 1244 return false; 1245 1246 Status rc = m_process_sp->EnableWatchpoint(wp_sp.get()); 1247 if (rc.Fail()) 1248 return false; 1249 } 1250 return true; // Success! 1251 } 1252 1253 // Assumption: Caller holds the list mutex lock for m_watchpoint_list. 1254 bool Target::ClearAllWatchpointHitCounts() { 1255 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1256 if (log) 1257 log->Printf("Target::%s\n", __FUNCTION__); 1258 1259 size_t num_watchpoints = m_watchpoint_list.GetSize(); 1260 for (size_t i = 0; i < num_watchpoints; ++i) { 1261 WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i); 1262 if (!wp_sp) 1263 return false; 1264 1265 wp_sp->ResetHitCount(); 1266 } 1267 return true; // Success! 1268 } 1269 1270 // Assumption: Caller holds the list mutex lock for m_watchpoint_list. 1271 bool Target::ClearAllWatchpointHistoricValues() { 1272 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1273 if (log) 1274 log->Printf("Target::%s\n", __FUNCTION__); 1275 1276 size_t num_watchpoints = m_watchpoint_list.GetSize(); 1277 for (size_t i = 0; i < num_watchpoints; ++i) { 1278 WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i); 1279 if (!wp_sp) 1280 return false; 1281 1282 wp_sp->ResetHistoricValues(); 1283 } 1284 return true; // Success! 1285 } 1286 1287 // Assumption: Caller holds the list mutex lock for m_watchpoint_list during 1288 // these operations. 1289 bool Target::IgnoreAllWatchpoints(uint32_t ignore_count) { 1290 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1291 if (log) 1292 log->Printf("Target::%s\n", __FUNCTION__); 1293 1294 if (!ProcessIsValid()) 1295 return false; 1296 1297 size_t num_watchpoints = m_watchpoint_list.GetSize(); 1298 for (size_t i = 0; i < num_watchpoints; ++i) { 1299 WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i); 1300 if (!wp_sp) 1301 return false; 1302 1303 wp_sp->SetIgnoreCount(ignore_count); 1304 } 1305 return true; // Success! 1306 } 1307 1308 // Assumption: Caller holds the list mutex lock for m_watchpoint_list. 1309 bool Target::DisableWatchpointByID(lldb::watch_id_t watch_id) { 1310 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1311 if (log) 1312 log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id); 1313 1314 if (!ProcessIsValid()) 1315 return false; 1316 1317 WatchpointSP wp_sp = m_watchpoint_list.FindByID(watch_id); 1318 if (wp_sp) { 1319 Status rc = m_process_sp->DisableWatchpoint(wp_sp.get()); 1320 if (rc.Success()) 1321 return true; 1322 1323 // Else, fallthrough. 1324 } 1325 return false; 1326 } 1327 1328 // Assumption: Caller holds the list mutex lock for m_watchpoint_list. 1329 bool Target::EnableWatchpointByID(lldb::watch_id_t watch_id) { 1330 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1331 if (log) 1332 log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id); 1333 1334 if (!ProcessIsValid()) 1335 return false; 1336 1337 WatchpointSP wp_sp = m_watchpoint_list.FindByID(watch_id); 1338 if (wp_sp) { 1339 Status rc = m_process_sp->EnableWatchpoint(wp_sp.get()); 1340 if (rc.Success()) 1341 return true; 1342 1343 // Else, fallthrough. 1344 } 1345 return false; 1346 } 1347 1348 // Assumption: Caller holds the list mutex lock for m_watchpoint_list. 1349 bool Target::RemoveWatchpointByID(lldb::watch_id_t watch_id) { 1350 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1351 if (log) 1352 log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id); 1353 1354 WatchpointSP watch_to_remove_sp = m_watchpoint_list.FindByID(watch_id); 1355 if (watch_to_remove_sp == m_last_created_watchpoint) 1356 m_last_created_watchpoint.reset(); 1357 1358 if (DisableWatchpointByID(watch_id)) { 1359 m_watchpoint_list.Remove(watch_id, true); 1360 return true; 1361 } 1362 return false; 1363 } 1364 1365 // Assumption: Caller holds the list mutex lock for m_watchpoint_list. 1366 bool Target::IgnoreWatchpointByID(lldb::watch_id_t watch_id, 1367 uint32_t ignore_count) { 1368 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_WATCHPOINTS)); 1369 if (log) 1370 log->Printf("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id); 1371 1372 if (!ProcessIsValid()) 1373 return false; 1374 1375 WatchpointSP wp_sp = m_watchpoint_list.FindByID(watch_id); 1376 if (wp_sp) { 1377 wp_sp->SetIgnoreCount(ignore_count); 1378 return true; 1379 } 1380 return false; 1381 } 1382 1383 ModuleSP Target::GetExecutableModule() { 1384 // search for the first executable in the module list 1385 for (size_t i = 0; i < m_images.GetSize(); ++i) { 1386 ModuleSP module_sp = m_images.GetModuleAtIndex(i); 1387 lldb_private::ObjectFile *obj = module_sp->GetObjectFile(); 1388 if (obj == nullptr) 1389 continue; 1390 if (obj->GetType() == ObjectFile::Type::eTypeExecutable) 1391 return module_sp; 1392 } 1393 // as fall back return the first module loaded 1394 return m_images.GetModuleAtIndex(0); 1395 } 1396 1397 Module *Target::GetExecutableModulePointer() { 1398 return GetExecutableModule().get(); 1399 } 1400 1401 static void LoadScriptingResourceForModule(const ModuleSP &module_sp, 1402 Target *target) { 1403 Status error; 1404 StreamString feedback_stream; 1405 if (module_sp && 1406 !module_sp->LoadScriptingResourceInTarget(target, error, 1407 &feedback_stream)) { 1408 if (error.AsCString()) 1409 target->GetDebugger().GetErrorFile()->Printf( 1410 "unable to load scripting data for module %s - error reported was " 1411 "%s\n", 1412 module_sp->GetFileSpec().GetFileNameStrippingExtension().GetCString(), 1413 error.AsCString()); 1414 } 1415 if (feedback_stream.GetSize()) 1416 target->GetDebugger().GetErrorFile()->Printf("%s\n", 1417 feedback_stream.GetData()); 1418 } 1419 1420 void Target::ClearModules(bool delete_locations) { 1421 ModulesDidUnload(m_images, delete_locations); 1422 m_section_load_history.Clear(); 1423 m_images.Clear(); 1424 m_scratch_type_system_map.Clear(); 1425 m_ast_importer_sp.reset(); 1426 } 1427 1428 void Target::DidExec() { 1429 // When a process exec's we need to know about it so we can do some cleanup. 1430 m_breakpoint_list.RemoveInvalidLocations(m_arch.GetSpec()); 1431 m_internal_breakpoint_list.RemoveInvalidLocations(m_arch.GetSpec()); 1432 } 1433 1434 void Target::SetExecutableModule(ModuleSP &executable_sp, 1435 LoadDependentFiles load_dependent_files) { 1436 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET)); 1437 ClearModules(false); 1438 1439 if (executable_sp) { 1440 static Timer::Category func_cat(LLVM_PRETTY_FUNCTION); 1441 Timer scoped_timer(func_cat, 1442 "Target::SetExecutableModule (executable = '%s')", 1443 executable_sp->GetFileSpec().GetPath().c_str()); 1444 1445 m_images.Append(executable_sp); // The first image is our executable file 1446 1447 // If we haven't set an architecture yet, reset our architecture based on 1448 // what we found in the executable module. 1449 if (!m_arch.GetSpec().IsValid()) { 1450 m_arch = executable_sp->GetArchitecture(); 1451 LLDB_LOG(log, 1452 "setting architecture to {0} ({1}) based on executable file", 1453 m_arch.GetSpec().GetArchitectureName(), 1454 m_arch.GetSpec().GetTriple().getTriple()); 1455 } 1456 1457 FileSpecList dependent_files; 1458 ObjectFile *executable_objfile = executable_sp->GetObjectFile(); 1459 bool load_dependents = true; 1460 switch (load_dependent_files) { 1461 case eLoadDependentsDefault: 1462 load_dependents = executable_sp->IsExecutable(); 1463 break; 1464 case eLoadDependentsYes: 1465 load_dependents = true; 1466 break; 1467 case eLoadDependentsNo: 1468 load_dependents = false; 1469 break; 1470 } 1471 1472 if (executable_objfile && load_dependents) { 1473 executable_objfile->GetDependentModules(dependent_files); 1474 for (uint32_t i = 0; i < dependent_files.GetSize(); i++) { 1475 FileSpec dependent_file_spec( 1476 dependent_files.GetFileSpecPointerAtIndex(i)); 1477 FileSpec platform_dependent_file_spec; 1478 if (m_platform_sp) 1479 m_platform_sp->GetFileWithUUID(dependent_file_spec, nullptr, 1480 platform_dependent_file_spec); 1481 else 1482 platform_dependent_file_spec = dependent_file_spec; 1483 1484 ModuleSpec module_spec(platform_dependent_file_spec, m_arch.GetSpec()); 1485 ModuleSP image_module_sp(GetSharedModule(module_spec)); 1486 if (image_module_sp) { 1487 ObjectFile *objfile = image_module_sp->GetObjectFile(); 1488 if (objfile) 1489 objfile->GetDependentModules(dependent_files); 1490 } 1491 } 1492 } 1493 } 1494 } 1495 1496 bool Target::SetArchitecture(const ArchSpec &arch_spec, bool set_platform) { 1497 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET)); 1498 bool missing_local_arch = !m_arch.GetSpec().IsValid(); 1499 bool replace_local_arch = true; 1500 bool compatible_local_arch = false; 1501 ArchSpec other(arch_spec); 1502 1503 // Changing the architecture might mean that the currently selected platform 1504 // isn't compatible. Set the platform correctly if we are asked to do so, 1505 // otherwise assume the user will set the platform manually. 1506 if (set_platform) { 1507 if (other.IsValid()) { 1508 auto platform_sp = GetPlatform(); 1509 if (!platform_sp || 1510 !platform_sp->IsCompatibleArchitecture(other, false, nullptr)) { 1511 ArchSpec platform_arch; 1512 auto arch_platform_sp = 1513 Platform::GetPlatformForArchitecture(other, &platform_arch); 1514 if (arch_platform_sp) { 1515 SetPlatform(arch_platform_sp); 1516 if (platform_arch.IsValid()) 1517 other = platform_arch; 1518 } 1519 } 1520 } 1521 } 1522 1523 if (!missing_local_arch) { 1524 if (m_arch.GetSpec().IsCompatibleMatch(arch_spec)) { 1525 other.MergeFrom(m_arch.GetSpec()); 1526 1527 if (m_arch.GetSpec().IsCompatibleMatch(other)) { 1528 compatible_local_arch = true; 1529 bool arch_changed, vendor_changed, os_changed, os_ver_changed, 1530 env_changed; 1531 1532 m_arch.GetSpec().PiecewiseTripleCompare(other, arch_changed, vendor_changed, 1533 os_changed, os_ver_changed, env_changed); 1534 1535 if (!arch_changed && !vendor_changed && !os_changed && !env_changed) 1536 replace_local_arch = false; 1537 } 1538 } 1539 } 1540 1541 if (compatible_local_arch || missing_local_arch) { 1542 // If we haven't got a valid arch spec, or the architectures are compatible 1543 // update the architecture, unless the one we already have is more 1544 // specified 1545 if (replace_local_arch) 1546 m_arch = other; 1547 LLDB_LOG(log, "set architecture to {0} ({1})", 1548 m_arch.GetSpec().GetArchitectureName(), 1549 m_arch.GetSpec().GetTriple().getTriple()); 1550 return true; 1551 } 1552 1553 // If we have an executable file, try to reset the executable to the desired 1554 // architecture 1555 if (log) 1556 log->Printf("Target::SetArchitecture changing architecture to %s (%s)", 1557 arch_spec.GetArchitectureName(), 1558 arch_spec.GetTriple().getTriple().c_str()); 1559 m_arch = other; 1560 ModuleSP executable_sp = GetExecutableModule(); 1561 1562 ClearModules(true); 1563 // Need to do something about unsetting breakpoints. 1564 1565 if (executable_sp) { 1566 if (log) 1567 log->Printf("Target::SetArchitecture Trying to select executable file " 1568 "architecture %s (%s)", 1569 arch_spec.GetArchitectureName(), 1570 arch_spec.GetTriple().getTriple().c_str()); 1571 ModuleSpec module_spec(executable_sp->GetFileSpec(), other); 1572 Status error = ModuleList::GetSharedModule(module_spec, executable_sp, 1573 &GetExecutableSearchPaths(), 1574 nullptr, nullptr); 1575 1576 if (!error.Fail() && executable_sp) { 1577 SetExecutableModule(executable_sp, eLoadDependentsYes); 1578 return true; 1579 } 1580 } 1581 return false; 1582 } 1583 1584 bool Target::MergeArchitecture(const ArchSpec &arch_spec) { 1585 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET)); 1586 if (arch_spec.IsValid()) { 1587 if (m_arch.GetSpec().IsCompatibleMatch(arch_spec)) { 1588 // The current target arch is compatible with "arch_spec", see if we can 1589 // improve our current architecture using bits from "arch_spec" 1590 1591 if (log) 1592 log->Printf("Target::MergeArchitecture target has arch %s, merging with " 1593 "arch %s", 1594 m_arch.GetSpec().GetTriple().getTriple().c_str(), 1595 arch_spec.GetTriple().getTriple().c_str()); 1596 1597 // Merge bits from arch_spec into "merged_arch" and set our architecture 1598 ArchSpec merged_arch(m_arch.GetSpec()); 1599 merged_arch.MergeFrom(arch_spec); 1600 return SetArchitecture(merged_arch); 1601 } else { 1602 // The new architecture is different, we just need to replace it 1603 return SetArchitecture(arch_spec); 1604 } 1605 } 1606 return false; 1607 } 1608 1609 void Target::WillClearList(const ModuleList &module_list) {} 1610 1611 void Target::ModuleAdded(const ModuleList &module_list, 1612 const ModuleSP &module_sp) { 1613 // A module is being added to this target for the first time 1614 if (m_valid) { 1615 ModuleList my_module_list; 1616 my_module_list.Append(module_sp); 1617 LoadScriptingResourceForModule(module_sp, this); 1618 ModulesDidLoad(my_module_list); 1619 } 1620 } 1621 1622 void Target::ModuleRemoved(const ModuleList &module_list, 1623 const ModuleSP &module_sp) { 1624 // A module is being removed from this target. 1625 if (m_valid) { 1626 ModuleList my_module_list; 1627 my_module_list.Append(module_sp); 1628 ModulesDidUnload(my_module_list, false); 1629 } 1630 } 1631 1632 void Target::ModuleUpdated(const ModuleList &module_list, 1633 const ModuleSP &old_module_sp, 1634 const ModuleSP &new_module_sp) { 1635 // A module is replacing an already added module 1636 if (m_valid) { 1637 m_breakpoint_list.UpdateBreakpointsWhenModuleIsReplaced(old_module_sp, 1638 new_module_sp); 1639 m_internal_breakpoint_list.UpdateBreakpointsWhenModuleIsReplaced( 1640 old_module_sp, new_module_sp); 1641 } 1642 } 1643 1644 void Target::ModulesDidLoad(ModuleList &module_list) { 1645 if (m_valid && module_list.GetSize()) { 1646 m_breakpoint_list.UpdateBreakpoints(module_list, true, false); 1647 m_internal_breakpoint_list.UpdateBreakpoints(module_list, true, false); 1648 if (m_process_sp) { 1649 m_process_sp->ModulesDidLoad(module_list); 1650 } 1651 BroadcastEvent(eBroadcastBitModulesLoaded, 1652 new TargetEventData(this->shared_from_this(), module_list)); 1653 } 1654 } 1655 1656 void Target::SymbolsDidLoad(ModuleList &module_list) { 1657 if (m_valid && module_list.GetSize()) { 1658 if (m_process_sp) { 1659 LanguageRuntime *runtime = 1660 m_process_sp->GetLanguageRuntime(lldb::eLanguageTypeObjC); 1661 if (runtime) { 1662 ObjCLanguageRuntime *objc_runtime = (ObjCLanguageRuntime *)runtime; 1663 objc_runtime->SymbolsDidLoad(module_list); 1664 } 1665 } 1666 1667 m_breakpoint_list.UpdateBreakpoints(module_list, true, false); 1668 m_internal_breakpoint_list.UpdateBreakpoints(module_list, true, false); 1669 BroadcastEvent(eBroadcastBitSymbolsLoaded, 1670 new TargetEventData(this->shared_from_this(), module_list)); 1671 } 1672 } 1673 1674 void Target::ModulesDidUnload(ModuleList &module_list, bool delete_locations) { 1675 if (m_valid && module_list.GetSize()) { 1676 UnloadModuleSections(module_list); 1677 m_breakpoint_list.UpdateBreakpoints(module_list, false, delete_locations); 1678 m_internal_breakpoint_list.UpdateBreakpoints(module_list, false, 1679 delete_locations); 1680 BroadcastEvent(eBroadcastBitModulesUnloaded, 1681 new TargetEventData(this->shared_from_this(), module_list)); 1682 } 1683 } 1684 1685 bool Target::ModuleIsExcludedForUnconstrainedSearches( 1686 const FileSpec &module_file_spec) { 1687 if (GetBreakpointsConsultPlatformAvoidList()) { 1688 ModuleList matchingModules; 1689 ModuleSpec module_spec(module_file_spec); 1690 size_t num_modules = GetImages().FindModules(module_spec, matchingModules); 1691 1692 // If there is more than one module for this file spec, only return true if 1693 // ALL the modules are on the 1694 // black list. 1695 if (num_modules > 0) { 1696 for (size_t i = 0; i < num_modules; i++) { 1697 if (!ModuleIsExcludedForUnconstrainedSearches( 1698 matchingModules.GetModuleAtIndex(i))) 1699 return false; 1700 } 1701 return true; 1702 } 1703 } 1704 return false; 1705 } 1706 1707 bool Target::ModuleIsExcludedForUnconstrainedSearches( 1708 const lldb::ModuleSP &module_sp) { 1709 if (GetBreakpointsConsultPlatformAvoidList()) { 1710 if (m_platform_sp) 1711 return m_platform_sp->ModuleIsExcludedForUnconstrainedSearches(*this, 1712 module_sp); 1713 } 1714 return false; 1715 } 1716 1717 size_t Target::ReadMemoryFromFileCache(const Address &addr, void *dst, 1718 size_t dst_len, Status &error) { 1719 SectionSP section_sp(addr.GetSection()); 1720 if (section_sp) { 1721 // If the contents of this section are encrypted, the on-disk file is 1722 // unusable. Read only from live memory. 1723 if (section_sp->IsEncrypted()) { 1724 error.SetErrorString("section is encrypted"); 1725 return 0; 1726 } 1727 ModuleSP module_sp(section_sp->GetModule()); 1728 if (module_sp) { 1729 ObjectFile *objfile = section_sp->GetModule()->GetObjectFile(); 1730 if (objfile) { 1731 size_t bytes_read = objfile->ReadSectionData( 1732 section_sp.get(), addr.GetOffset(), dst, dst_len); 1733 if (bytes_read > 0) 1734 return bytes_read; 1735 else 1736 error.SetErrorStringWithFormat("error reading data from section %s", 1737 section_sp->GetName().GetCString()); 1738 } else 1739 error.SetErrorString("address isn't from a object file"); 1740 } else 1741 error.SetErrorString("address isn't in a module"); 1742 } else 1743 error.SetErrorString("address doesn't contain a section that points to a " 1744 "section in a object file"); 1745 1746 return 0; 1747 } 1748 1749 size_t Target::ReadMemory(const Address &addr, bool prefer_file_cache, 1750 void *dst, size_t dst_len, Status &error, 1751 lldb::addr_t *load_addr_ptr) { 1752 error.Clear(); 1753 1754 // if we end up reading this from process memory, we will fill this with the 1755 // actual load address 1756 if (load_addr_ptr) 1757 *load_addr_ptr = LLDB_INVALID_ADDRESS; 1758 1759 size_t bytes_read = 0; 1760 1761 addr_t load_addr = LLDB_INVALID_ADDRESS; 1762 addr_t file_addr = LLDB_INVALID_ADDRESS; 1763 Address resolved_addr; 1764 if (!addr.IsSectionOffset()) { 1765 SectionLoadList §ion_load_list = GetSectionLoadList(); 1766 if (section_load_list.IsEmpty()) { 1767 // No sections are loaded, so we must assume we are not running yet and 1768 // anything we are given is a file address. 1769 file_addr = addr.GetOffset(); // "addr" doesn't have a section, so its 1770 // offset is the file address 1771 m_images.ResolveFileAddress(file_addr, resolved_addr); 1772 } else { 1773 // We have at least one section loaded. This can be because we have 1774 // manually loaded some sections with "target modules load ..." or 1775 // because we have have a live process that has sections loaded through 1776 // the dynamic loader 1777 load_addr = addr.GetOffset(); // "addr" doesn't have a section, so its 1778 // offset is the load address 1779 section_load_list.ResolveLoadAddress(load_addr, resolved_addr); 1780 } 1781 } 1782 if (!resolved_addr.IsValid()) 1783 resolved_addr = addr; 1784 1785 if (prefer_file_cache) { 1786 bytes_read = ReadMemoryFromFileCache(resolved_addr, dst, dst_len, error); 1787 if (bytes_read > 0) 1788 return bytes_read; 1789 } 1790 1791 if (ProcessIsValid()) { 1792 if (load_addr == LLDB_INVALID_ADDRESS) 1793 load_addr = resolved_addr.GetLoadAddress(this); 1794 1795 if (load_addr == LLDB_INVALID_ADDRESS) { 1796 ModuleSP addr_module_sp(resolved_addr.GetModule()); 1797 if (addr_module_sp && addr_module_sp->GetFileSpec()) 1798 error.SetErrorStringWithFormatv( 1799 "{0:F}[{1:x+}] can't be resolved, {0:F} is not currently loaded", 1800 addr_module_sp->GetFileSpec(), resolved_addr.GetFileAddress()); 1801 else 1802 error.SetErrorStringWithFormat("0x%" PRIx64 " can't be resolved", 1803 resolved_addr.GetFileAddress()); 1804 } else { 1805 bytes_read = m_process_sp->ReadMemory(load_addr, dst, dst_len, error); 1806 if (bytes_read != dst_len) { 1807 if (error.Success()) { 1808 if (bytes_read == 0) 1809 error.SetErrorStringWithFormat( 1810 "read memory from 0x%" PRIx64 " failed", load_addr); 1811 else 1812 error.SetErrorStringWithFormat( 1813 "only %" PRIu64 " of %" PRIu64 1814 " bytes were read from memory at 0x%" PRIx64, 1815 (uint64_t)bytes_read, (uint64_t)dst_len, load_addr); 1816 } 1817 } 1818 if (bytes_read) { 1819 if (load_addr_ptr) 1820 *load_addr_ptr = load_addr; 1821 return bytes_read; 1822 } 1823 // If the address is not section offset we have an address that doesn't 1824 // resolve to any address in any currently loaded shared libraries and we 1825 // failed to read memory so there isn't anything more we can do. If it is 1826 // section offset, we might be able to read cached memory from the object 1827 // file. 1828 if (!resolved_addr.IsSectionOffset()) 1829 return 0; 1830 } 1831 } 1832 1833 if (!prefer_file_cache && resolved_addr.IsSectionOffset()) { 1834 // If we didn't already try and read from the object file cache, then try 1835 // it after failing to read from the process. 1836 return ReadMemoryFromFileCache(resolved_addr, dst, dst_len, error); 1837 } 1838 return 0; 1839 } 1840 1841 size_t Target::ReadCStringFromMemory(const Address &addr, std::string &out_str, 1842 Status &error) { 1843 char buf[256]; 1844 out_str.clear(); 1845 addr_t curr_addr = addr.GetLoadAddress(this); 1846 Address address(addr); 1847 while (1) { 1848 size_t length = ReadCStringFromMemory(address, buf, sizeof(buf), error); 1849 if (length == 0) 1850 break; 1851 out_str.append(buf, length); 1852 // If we got "length - 1" bytes, we didn't get the whole C string, we need 1853 // to read some more characters 1854 if (length == sizeof(buf) - 1) 1855 curr_addr += length; 1856 else 1857 break; 1858 address = Address(curr_addr); 1859 } 1860 return out_str.size(); 1861 } 1862 1863 size_t Target::ReadCStringFromMemory(const Address &addr, char *dst, 1864 size_t dst_max_len, Status &result_error) { 1865 size_t total_cstr_len = 0; 1866 if (dst && dst_max_len) { 1867 result_error.Clear(); 1868 // NULL out everything just to be safe 1869 memset(dst, 0, dst_max_len); 1870 Status error; 1871 addr_t curr_addr = addr.GetLoadAddress(this); 1872 Address address(addr); 1873 1874 // We could call m_process_sp->GetMemoryCacheLineSize() but I don't think 1875 // this really needs to be tied to the memory cache subsystem's cache line 1876 // size, so leave this as a fixed constant. 1877 const size_t cache_line_size = 512; 1878 1879 size_t bytes_left = dst_max_len - 1; 1880 char *curr_dst = dst; 1881 1882 while (bytes_left > 0) { 1883 addr_t cache_line_bytes_left = 1884 cache_line_size - (curr_addr % cache_line_size); 1885 addr_t bytes_to_read = 1886 std::min<addr_t>(bytes_left, cache_line_bytes_left); 1887 size_t bytes_read = 1888 ReadMemory(address, false, curr_dst, bytes_to_read, error); 1889 1890 if (bytes_read == 0) { 1891 result_error = error; 1892 dst[total_cstr_len] = '\0'; 1893 break; 1894 } 1895 const size_t len = strlen(curr_dst); 1896 1897 total_cstr_len += len; 1898 1899 if (len < bytes_to_read) 1900 break; 1901 1902 curr_dst += bytes_read; 1903 curr_addr += bytes_read; 1904 bytes_left -= bytes_read; 1905 address = Address(curr_addr); 1906 } 1907 } else { 1908 if (dst == nullptr) 1909 result_error.SetErrorString("invalid arguments"); 1910 else 1911 result_error.Clear(); 1912 } 1913 return total_cstr_len; 1914 } 1915 1916 size_t Target::ReadScalarIntegerFromMemory(const Address &addr, 1917 bool prefer_file_cache, 1918 uint32_t byte_size, bool is_signed, 1919 Scalar &scalar, Status &error) { 1920 uint64_t uval; 1921 1922 if (byte_size <= sizeof(uval)) { 1923 size_t bytes_read = 1924 ReadMemory(addr, prefer_file_cache, &uval, byte_size, error); 1925 if (bytes_read == byte_size) { 1926 DataExtractor data(&uval, sizeof(uval), m_arch.GetSpec().GetByteOrder(), 1927 m_arch.GetSpec().GetAddressByteSize()); 1928 lldb::offset_t offset = 0; 1929 if (byte_size <= 4) 1930 scalar = data.GetMaxU32(&offset, byte_size); 1931 else 1932 scalar = data.GetMaxU64(&offset, byte_size); 1933 1934 if (is_signed) 1935 scalar.SignExtend(byte_size * 8); 1936 return bytes_read; 1937 } 1938 } else { 1939 error.SetErrorStringWithFormat( 1940 "byte size of %u is too large for integer scalar type", byte_size); 1941 } 1942 return 0; 1943 } 1944 1945 uint64_t Target::ReadUnsignedIntegerFromMemory(const Address &addr, 1946 bool prefer_file_cache, 1947 size_t integer_byte_size, 1948 uint64_t fail_value, 1949 Status &error) { 1950 Scalar scalar; 1951 if (ReadScalarIntegerFromMemory(addr, prefer_file_cache, integer_byte_size, 1952 false, scalar, error)) 1953 return scalar.ULongLong(fail_value); 1954 return fail_value; 1955 } 1956 1957 bool Target::ReadPointerFromMemory(const Address &addr, bool prefer_file_cache, 1958 Status &error, Address &pointer_addr) { 1959 Scalar scalar; 1960 if (ReadScalarIntegerFromMemory(addr, prefer_file_cache, 1961 m_arch.GetSpec().GetAddressByteSize(), false, scalar, 1962 error)) { 1963 addr_t pointer_vm_addr = scalar.ULongLong(LLDB_INVALID_ADDRESS); 1964 if (pointer_vm_addr != LLDB_INVALID_ADDRESS) { 1965 SectionLoadList §ion_load_list = GetSectionLoadList(); 1966 if (section_load_list.IsEmpty()) { 1967 // No sections are loaded, so we must assume we are not running yet and 1968 // anything we are given is a file address. 1969 m_images.ResolveFileAddress(pointer_vm_addr, pointer_addr); 1970 } else { 1971 // We have at least one section loaded. This can be because we have 1972 // manually loaded some sections with "target modules load ..." or 1973 // because we have have a live process that has sections loaded through 1974 // the dynamic loader 1975 section_load_list.ResolveLoadAddress(pointer_vm_addr, pointer_addr); 1976 } 1977 // We weren't able to resolve the pointer value, so just return an 1978 // address with no section 1979 if (!pointer_addr.IsValid()) 1980 pointer_addr.SetOffset(pointer_vm_addr); 1981 return true; 1982 } 1983 } 1984 return false; 1985 } 1986 1987 ModuleSP Target::GetSharedModule(const ModuleSpec &module_spec, 1988 Status *error_ptr) { 1989 ModuleSP module_sp; 1990 1991 Status error; 1992 1993 // First see if we already have this module in our module list. If we do, 1994 // then we're done, we don't need to consult the shared modules list. But 1995 // only do this if we are passed a UUID. 1996 1997 if (module_spec.GetUUID().IsValid()) 1998 module_sp = m_images.FindFirstModule(module_spec); 1999 2000 if (!module_sp) { 2001 ModuleSP old_module_sp; // This will get filled in if we have a new version 2002 // of the library 2003 bool did_create_module = false; 2004 2005 // If there are image search path entries, try to use them first to acquire 2006 // a suitable image. 2007 if (m_image_search_paths.GetSize()) { 2008 ModuleSpec transformed_spec(module_spec); 2009 if (m_image_search_paths.RemapPath( 2010 module_spec.GetFileSpec().GetDirectory(), 2011 transformed_spec.GetFileSpec().GetDirectory())) { 2012 transformed_spec.GetFileSpec().GetFilename() = 2013 module_spec.GetFileSpec().GetFilename(); 2014 error = ModuleList::GetSharedModule(transformed_spec, module_sp, 2015 &GetExecutableSearchPaths(), 2016 &old_module_sp, &did_create_module); 2017 } 2018 } 2019 2020 if (!module_sp) { 2021 // If we have a UUID, we can check our global shared module list in case 2022 // we already have it. If we don't have a valid UUID, then we can't since 2023 // the path in "module_spec" will be a platform path, and we will need to 2024 // let the platform find that file. For example, we could be asking for 2025 // "/usr/lib/dyld" and if we do not have a UUID, we don't want to pick 2026 // the local copy of "/usr/lib/dyld" since our platform could be a remote 2027 // platform that has its own "/usr/lib/dyld" in an SDK or in a local file 2028 // cache. 2029 if (module_spec.GetUUID().IsValid()) { 2030 // We have a UUID, it is OK to check the global module list... 2031 error = ModuleList::GetSharedModule(module_spec, module_sp, 2032 &GetExecutableSearchPaths(), 2033 &old_module_sp, &did_create_module); 2034 } 2035 2036 if (!module_sp) { 2037 // The platform is responsible for finding and caching an appropriate 2038 // module in the shared module cache. 2039 if (m_platform_sp) { 2040 error = m_platform_sp->GetSharedModule( 2041 module_spec, m_process_sp.get(), module_sp, 2042 &GetExecutableSearchPaths(), &old_module_sp, &did_create_module); 2043 } else { 2044 error.SetErrorString("no platform is currently set"); 2045 } 2046 } 2047 } 2048 2049 // We found a module that wasn't in our target list. Let's make sure that 2050 // there wasn't an equivalent module in the list already, and if there was, 2051 // let's remove it. 2052 if (module_sp) { 2053 ObjectFile *objfile = module_sp->GetObjectFile(); 2054 if (objfile) { 2055 switch (objfile->GetType()) { 2056 case ObjectFile::eTypeCoreFile: /// A core file that has a checkpoint of 2057 /// a program's execution state 2058 case ObjectFile::eTypeExecutable: /// A normal executable 2059 case ObjectFile::eTypeDynamicLinker: /// The platform's dynamic linker 2060 /// executable 2061 case ObjectFile::eTypeObjectFile: /// An intermediate object file 2062 case ObjectFile::eTypeSharedLibrary: /// A shared library that can be 2063 /// used during execution 2064 break; 2065 case ObjectFile::eTypeDebugInfo: /// An object file that contains only 2066 /// debug information 2067 if (error_ptr) 2068 error_ptr->SetErrorString("debug info files aren't valid target " 2069 "modules, please specify an executable"); 2070 return ModuleSP(); 2071 case ObjectFile::eTypeStubLibrary: /// A library that can be linked 2072 /// against but not used for 2073 /// execution 2074 if (error_ptr) 2075 error_ptr->SetErrorString("stub libraries aren't valid target " 2076 "modules, please specify an executable"); 2077 return ModuleSP(); 2078 default: 2079 if (error_ptr) 2080 error_ptr->SetErrorString( 2081 "unsupported file type, please specify an executable"); 2082 return ModuleSP(); 2083 } 2084 // GetSharedModule is not guaranteed to find the old shared module, for 2085 // instance in the common case where you pass in the UUID, it is only 2086 // going to find the one module matching the UUID. In fact, it has no 2087 // good way to know what the "old module" relevant to this target is, 2088 // since there might be many copies of a module with this file spec in 2089 // various running debug sessions, but only one of them will belong to 2090 // this target. So let's remove the UUID from the module list, and look 2091 // in the target's module list. Only do this if there is SOMETHING else 2092 // in the module spec... 2093 if (!old_module_sp) { 2094 if (module_spec.GetUUID().IsValid() && 2095 !module_spec.GetFileSpec().GetFilename().IsEmpty() && 2096 !module_spec.GetFileSpec().GetDirectory().IsEmpty()) { 2097 ModuleSpec module_spec_copy(module_spec.GetFileSpec()); 2098 module_spec_copy.GetUUID().Clear(); 2099 2100 ModuleList found_modules; 2101 size_t num_found = 2102 m_images.FindModules(module_spec_copy, found_modules); 2103 if (num_found == 1) { 2104 old_module_sp = found_modules.GetModuleAtIndex(0); 2105 } 2106 } 2107 } 2108 2109 // Preload symbols outside of any lock, so hopefully we can do this for 2110 // each library in parallel. 2111 if (GetPreloadSymbols()) 2112 module_sp->PreloadSymbols(); 2113 2114 if (old_module_sp && 2115 m_images.GetIndexForModule(old_module_sp.get()) != 2116 LLDB_INVALID_INDEX32) { 2117 m_images.ReplaceModule(old_module_sp, module_sp); 2118 Module *old_module_ptr = old_module_sp.get(); 2119 old_module_sp.reset(); 2120 ModuleList::RemoveSharedModuleIfOrphaned(old_module_ptr); 2121 } else 2122 m_images.Append(module_sp); 2123 } else 2124 module_sp.reset(); 2125 } 2126 } 2127 if (error_ptr) 2128 *error_ptr = error; 2129 return module_sp; 2130 } 2131 2132 TargetSP Target::CalculateTarget() { return shared_from_this(); } 2133 2134 ProcessSP Target::CalculateProcess() { return m_process_sp; } 2135 2136 ThreadSP Target::CalculateThread() { return ThreadSP(); } 2137 2138 StackFrameSP Target::CalculateStackFrame() { return StackFrameSP(); } 2139 2140 void Target::CalculateExecutionContext(ExecutionContext &exe_ctx) { 2141 exe_ctx.Clear(); 2142 exe_ctx.SetTargetPtr(this); 2143 } 2144 2145 PathMappingList &Target::GetImageSearchPathList() { 2146 return m_image_search_paths; 2147 } 2148 2149 void Target::ImageSearchPathsChanged(const PathMappingList &path_list, 2150 void *baton) { 2151 Target *target = (Target *)baton; 2152 ModuleSP exe_module_sp(target->GetExecutableModule()); 2153 if (exe_module_sp) 2154 target->SetExecutableModule(exe_module_sp, eLoadDependentsYes); 2155 } 2156 2157 TypeSystem *Target::GetScratchTypeSystemForLanguage(Status *error, 2158 lldb::LanguageType language, 2159 bool create_on_demand) { 2160 if (!m_valid) 2161 return nullptr; 2162 2163 if (error) { 2164 error->Clear(); 2165 } 2166 2167 if (language == eLanguageTypeMipsAssembler // GNU AS and LLVM use it for all 2168 // assembly code 2169 || language == eLanguageTypeUnknown) { 2170 std::set<lldb::LanguageType> languages_for_types; 2171 std::set<lldb::LanguageType> languages_for_expressions; 2172 2173 Language::GetLanguagesSupportingTypeSystems(languages_for_types, 2174 languages_for_expressions); 2175 2176 if (languages_for_expressions.count(eLanguageTypeC)) { 2177 language = eLanguageTypeC; // LLDB's default. Override by setting the 2178 // target language. 2179 } else { 2180 if (languages_for_expressions.empty()) { 2181 return nullptr; 2182 } else { 2183 language = *languages_for_expressions.begin(); 2184 } 2185 } 2186 } 2187 2188 return m_scratch_type_system_map.GetTypeSystemForLanguage(language, this, 2189 create_on_demand); 2190 } 2191 2192 PersistentExpressionState * 2193 Target::GetPersistentExpressionStateForLanguage(lldb::LanguageType language) { 2194 TypeSystem *type_system = 2195 GetScratchTypeSystemForLanguage(nullptr, language, true); 2196 2197 if (type_system) { 2198 return type_system->GetPersistentExpressionState(); 2199 } else { 2200 return nullptr; 2201 } 2202 } 2203 2204 UserExpression *Target::GetUserExpressionForLanguage( 2205 llvm::StringRef expr, llvm::StringRef prefix, lldb::LanguageType language, 2206 Expression::ResultType desired_type, 2207 const EvaluateExpressionOptions &options, 2208 ValueObject *ctx_obj, Status &error) { 2209 Status type_system_error; 2210 2211 TypeSystem *type_system = 2212 GetScratchTypeSystemForLanguage(&type_system_error, language); 2213 UserExpression *user_expr = nullptr; 2214 2215 if (!type_system) { 2216 error.SetErrorStringWithFormat( 2217 "Could not find type system for language %s: %s", 2218 Language::GetNameForLanguageType(language), 2219 type_system_error.AsCString()); 2220 return nullptr; 2221 } 2222 2223 user_expr = type_system->GetUserExpression(expr, prefix, language, 2224 desired_type, options, ctx_obj); 2225 if (!user_expr) 2226 error.SetErrorStringWithFormat( 2227 "Could not create an expression for language %s", 2228 Language::GetNameForLanguageType(language)); 2229 2230 return user_expr; 2231 } 2232 2233 FunctionCaller *Target::GetFunctionCallerForLanguage( 2234 lldb::LanguageType language, const CompilerType &return_type, 2235 const Address &function_address, const ValueList &arg_value_list, 2236 const char *name, Status &error) { 2237 Status type_system_error; 2238 TypeSystem *type_system = 2239 GetScratchTypeSystemForLanguage(&type_system_error, language); 2240 FunctionCaller *persistent_fn = nullptr; 2241 2242 if (!type_system) { 2243 error.SetErrorStringWithFormat( 2244 "Could not find type system for language %s: %s", 2245 Language::GetNameForLanguageType(language), 2246 type_system_error.AsCString()); 2247 return persistent_fn; 2248 } 2249 2250 persistent_fn = type_system->GetFunctionCaller(return_type, function_address, 2251 arg_value_list, name); 2252 if (!persistent_fn) 2253 error.SetErrorStringWithFormat( 2254 "Could not create an expression for language %s", 2255 Language::GetNameForLanguageType(language)); 2256 2257 return persistent_fn; 2258 } 2259 2260 UtilityFunction * 2261 Target::GetUtilityFunctionForLanguage(const char *text, 2262 lldb::LanguageType language, 2263 const char *name, Status &error) { 2264 Status type_system_error; 2265 TypeSystem *type_system = 2266 GetScratchTypeSystemForLanguage(&type_system_error, language); 2267 UtilityFunction *utility_fn = nullptr; 2268 2269 if (!type_system) { 2270 error.SetErrorStringWithFormat( 2271 "Could not find type system for language %s: %s", 2272 Language::GetNameForLanguageType(language), 2273 type_system_error.AsCString()); 2274 return utility_fn; 2275 } 2276 2277 utility_fn = type_system->GetUtilityFunction(text, name); 2278 if (!utility_fn) 2279 error.SetErrorStringWithFormat( 2280 "Could not create an expression for language %s", 2281 Language::GetNameForLanguageType(language)); 2282 2283 return utility_fn; 2284 } 2285 2286 ClangASTContext *Target::GetScratchClangASTContext(bool create_on_demand) { 2287 if (m_valid) { 2288 if (TypeSystem *type_system = GetScratchTypeSystemForLanguage( 2289 nullptr, eLanguageTypeC, create_on_demand)) 2290 return llvm::dyn_cast<ClangASTContext>(type_system); 2291 } 2292 return nullptr; 2293 } 2294 2295 ClangASTImporterSP Target::GetClangASTImporter() { 2296 if (m_valid) { 2297 if (!m_ast_importer_sp) { 2298 m_ast_importer_sp = std::make_shared<ClangASTImporter>(); 2299 } 2300 return m_ast_importer_sp; 2301 } 2302 return ClangASTImporterSP(); 2303 } 2304 2305 void Target::SettingsInitialize() { Process::SettingsInitialize(); } 2306 2307 void Target::SettingsTerminate() { Process::SettingsTerminate(); } 2308 2309 FileSpecList Target::GetDefaultExecutableSearchPaths() { 2310 TargetPropertiesSP properties_sp(Target::GetGlobalProperties()); 2311 if (properties_sp) 2312 return properties_sp->GetExecutableSearchPaths(); 2313 return FileSpecList(); 2314 } 2315 2316 FileSpecList Target::GetDefaultDebugFileSearchPaths() { 2317 TargetPropertiesSP properties_sp(Target::GetGlobalProperties()); 2318 if (properties_sp) 2319 return properties_sp->GetDebugFileSearchPaths(); 2320 return FileSpecList(); 2321 } 2322 2323 FileSpecList Target::GetDefaultClangModuleSearchPaths() { 2324 TargetPropertiesSP properties_sp(Target::GetGlobalProperties()); 2325 if (properties_sp) 2326 return properties_sp->GetClangModuleSearchPaths(); 2327 return FileSpecList(); 2328 } 2329 2330 ArchSpec Target::GetDefaultArchitecture() { 2331 TargetPropertiesSP properties_sp(Target::GetGlobalProperties()); 2332 if (properties_sp) 2333 return properties_sp->GetDefaultArchitecture(); 2334 return ArchSpec(); 2335 } 2336 2337 void Target::SetDefaultArchitecture(const ArchSpec &arch) { 2338 TargetPropertiesSP properties_sp(Target::GetGlobalProperties()); 2339 if (properties_sp) { 2340 LogIfAnyCategoriesSet( 2341 LIBLLDB_LOG_TARGET, "Target::SetDefaultArchitecture setting target's " 2342 "default architecture to %s (%s)", 2343 arch.GetArchitectureName(), arch.GetTriple().getTriple().c_str()); 2344 return properties_sp->SetDefaultArchitecture(arch); 2345 } 2346 } 2347 2348 Target *Target::GetTargetFromContexts(const ExecutionContext *exe_ctx_ptr, 2349 const SymbolContext *sc_ptr) { 2350 // The target can either exist in the "process" of ExecutionContext, or in 2351 // the "target_sp" member of SymbolContext. This accessor helper function 2352 // will get the target from one of these locations. 2353 2354 Target *target = nullptr; 2355 if (sc_ptr != nullptr) 2356 target = sc_ptr->target_sp.get(); 2357 if (target == nullptr && exe_ctx_ptr) 2358 target = exe_ctx_ptr->GetTargetPtr(); 2359 return target; 2360 } 2361 2362 ExpressionResults Target::EvaluateExpression( 2363 llvm::StringRef expr, ExecutionContextScope *exe_scope, 2364 lldb::ValueObjectSP &result_valobj_sp, 2365 const EvaluateExpressionOptions &options, std::string *fixed_expression, 2366 ValueObject *ctx_obj) { 2367 result_valobj_sp.reset(); 2368 2369 ExpressionResults execution_results = eExpressionSetupError; 2370 2371 if (expr.empty()) 2372 return execution_results; 2373 2374 // We shouldn't run stop hooks in expressions. Be sure to reset this if you 2375 // return anywhere within this function. 2376 bool old_suppress_value = m_suppress_stop_hooks; 2377 m_suppress_stop_hooks = true; 2378 2379 ExecutionContext exe_ctx; 2380 2381 if (exe_scope) { 2382 exe_scope->CalculateExecutionContext(exe_ctx); 2383 } else if (m_process_sp) { 2384 m_process_sp->CalculateExecutionContext(exe_ctx); 2385 } else { 2386 CalculateExecutionContext(exe_ctx); 2387 } 2388 2389 // Make sure we aren't just trying to see the value of a persistent variable 2390 // (something like "$0") 2391 lldb::ExpressionVariableSP persistent_var_sp; 2392 // Only check for persistent variables the expression starts with a '$' 2393 if (expr[0] == '$') 2394 persistent_var_sp = GetScratchTypeSystemForLanguage(nullptr, eLanguageTypeC) 2395 ->GetPersistentExpressionState() 2396 ->GetVariable(expr); 2397 2398 if (persistent_var_sp) { 2399 result_valobj_sp = persistent_var_sp->GetValueObject(); 2400 execution_results = eExpressionCompleted; 2401 } else { 2402 llvm::StringRef prefix = GetExpressionPrefixContents(); 2403 Status error; 2404 execution_results = UserExpression::Evaluate(exe_ctx, options, expr, prefix, 2405 result_valobj_sp, error, 2406 0, // Line Number 2407 fixed_expression, 2408 nullptr, // Module 2409 ctx_obj); 2410 } 2411 2412 m_suppress_stop_hooks = old_suppress_value; 2413 2414 return execution_results; 2415 } 2416 2417 lldb::ExpressionVariableSP 2418 Target::GetPersistentVariable(const ConstString &name) { 2419 lldb::ExpressionVariableSP variable_sp; 2420 m_scratch_type_system_map.ForEach( 2421 [name, &variable_sp](TypeSystem *type_system) -> bool { 2422 if (PersistentExpressionState *persistent_state = 2423 type_system->GetPersistentExpressionState()) { 2424 variable_sp = persistent_state->GetVariable(name); 2425 2426 if (variable_sp) 2427 return false; // Stop iterating the ForEach 2428 } 2429 return true; // Keep iterating the ForEach 2430 }); 2431 return variable_sp; 2432 } 2433 2434 lldb::addr_t Target::GetPersistentSymbol(const ConstString &name) { 2435 lldb::addr_t address = LLDB_INVALID_ADDRESS; 2436 2437 m_scratch_type_system_map.ForEach( 2438 [name, &address](TypeSystem *type_system) -> bool { 2439 if (PersistentExpressionState *persistent_state = 2440 type_system->GetPersistentExpressionState()) { 2441 address = persistent_state->LookupSymbol(name); 2442 if (address != LLDB_INVALID_ADDRESS) 2443 return false; // Stop iterating the ForEach 2444 } 2445 return true; // Keep iterating the ForEach 2446 }); 2447 return address; 2448 } 2449 2450 lldb::addr_t Target::GetCallableLoadAddress(lldb::addr_t load_addr, 2451 AddressClass addr_class) const { 2452 auto arch_plugin = GetArchitecturePlugin(); 2453 return arch_plugin ? 2454 arch_plugin->GetCallableLoadAddress(load_addr, addr_class) : load_addr; 2455 } 2456 2457 lldb::addr_t Target::GetOpcodeLoadAddress(lldb::addr_t load_addr, 2458 AddressClass addr_class) const { 2459 auto arch_plugin = GetArchitecturePlugin(); 2460 return arch_plugin ? 2461 arch_plugin->GetOpcodeLoadAddress(load_addr, addr_class) : load_addr; 2462 } 2463 2464 lldb::addr_t Target::GetBreakableLoadAddress(lldb::addr_t addr) { 2465 auto arch_plugin = GetArchitecturePlugin(); 2466 return arch_plugin ? 2467 arch_plugin->GetBreakableLoadAddress(addr, *this) : addr; 2468 } 2469 2470 SourceManager &Target::GetSourceManager() { 2471 if (!m_source_manager_up) 2472 m_source_manager_up.reset(new SourceManager(shared_from_this())); 2473 return *m_source_manager_up; 2474 } 2475 2476 ClangModulesDeclVendor *Target::GetClangModulesDeclVendor() { 2477 static std::mutex s_clang_modules_decl_vendor_mutex; // If this is contended 2478 // we can make it 2479 // per-target 2480 2481 { 2482 std::lock_guard<std::mutex> guard(s_clang_modules_decl_vendor_mutex); 2483 2484 if (!m_clang_modules_decl_vendor_up) { 2485 m_clang_modules_decl_vendor_up.reset( 2486 ClangModulesDeclVendor::Create(*this)); 2487 } 2488 } 2489 2490 return m_clang_modules_decl_vendor_up.get(); 2491 } 2492 2493 Target::StopHookSP Target::CreateStopHook() { 2494 lldb::user_id_t new_uid = ++m_stop_hook_next_id; 2495 Target::StopHookSP stop_hook_sp(new StopHook(shared_from_this(), new_uid)); 2496 m_stop_hooks[new_uid] = stop_hook_sp; 2497 return stop_hook_sp; 2498 } 2499 2500 bool Target::RemoveStopHookByID(lldb::user_id_t user_id) { 2501 size_t num_removed = m_stop_hooks.erase(user_id); 2502 return (num_removed != 0); 2503 } 2504 2505 void Target::RemoveAllStopHooks() { m_stop_hooks.clear(); } 2506 2507 Target::StopHookSP Target::GetStopHookByID(lldb::user_id_t user_id) { 2508 StopHookSP found_hook; 2509 2510 StopHookCollection::iterator specified_hook_iter; 2511 specified_hook_iter = m_stop_hooks.find(user_id); 2512 if (specified_hook_iter != m_stop_hooks.end()) 2513 found_hook = (*specified_hook_iter).second; 2514 return found_hook; 2515 } 2516 2517 bool Target::SetStopHookActiveStateByID(lldb::user_id_t user_id, 2518 bool active_state) { 2519 StopHookCollection::iterator specified_hook_iter; 2520 specified_hook_iter = m_stop_hooks.find(user_id); 2521 if (specified_hook_iter == m_stop_hooks.end()) 2522 return false; 2523 2524 (*specified_hook_iter).second->SetIsActive(active_state); 2525 return true; 2526 } 2527 2528 void Target::SetAllStopHooksActiveState(bool active_state) { 2529 StopHookCollection::iterator pos, end = m_stop_hooks.end(); 2530 for (pos = m_stop_hooks.begin(); pos != end; pos++) { 2531 (*pos).second->SetIsActive(active_state); 2532 } 2533 } 2534 2535 void Target::RunStopHooks() { 2536 if (m_suppress_stop_hooks) 2537 return; 2538 2539 if (!m_process_sp) 2540 return; 2541 2542 // Somebody might have restarted the process: 2543 if (m_process_sp->GetState() != eStateStopped) 2544 return; 2545 2546 // <rdar://problem/12027563> make sure we check that we are not stopped 2547 // because of us running a user expression since in that case we do not want 2548 // to run the stop-hooks 2549 if (m_process_sp->GetModIDRef().IsLastResumeForUserExpression()) 2550 return; 2551 2552 if (m_stop_hooks.empty()) 2553 return; 2554 2555 StopHookCollection::iterator pos, end = m_stop_hooks.end(); 2556 2557 // If there aren't any active stop hooks, don't bother either: 2558 bool any_active_hooks = false; 2559 for (pos = m_stop_hooks.begin(); pos != end; pos++) { 2560 if ((*pos).second->IsActive()) { 2561 any_active_hooks = true; 2562 break; 2563 } 2564 } 2565 if (!any_active_hooks) 2566 return; 2567 2568 CommandReturnObject result; 2569 2570 std::vector<ExecutionContext> exc_ctx_with_reasons; 2571 std::vector<SymbolContext> sym_ctx_with_reasons; 2572 2573 ThreadList &cur_threadlist = m_process_sp->GetThreadList(); 2574 size_t num_threads = cur_threadlist.GetSize(); 2575 for (size_t i = 0; i < num_threads; i++) { 2576 lldb::ThreadSP cur_thread_sp = cur_threadlist.GetThreadAtIndex(i); 2577 if (cur_thread_sp->ThreadStoppedForAReason()) { 2578 lldb::StackFrameSP cur_frame_sp = cur_thread_sp->GetStackFrameAtIndex(0); 2579 exc_ctx_with_reasons.push_back(ExecutionContext( 2580 m_process_sp.get(), cur_thread_sp.get(), cur_frame_sp.get())); 2581 sym_ctx_with_reasons.push_back( 2582 cur_frame_sp->GetSymbolContext(eSymbolContextEverything)); 2583 } 2584 } 2585 2586 // If no threads stopped for a reason, don't run the stop-hooks. 2587 size_t num_exe_ctx = exc_ctx_with_reasons.size(); 2588 if (num_exe_ctx == 0) 2589 return; 2590 2591 result.SetImmediateOutputStream(m_debugger.GetAsyncOutputStream()); 2592 result.SetImmediateErrorStream(m_debugger.GetAsyncErrorStream()); 2593 2594 bool keep_going = true; 2595 bool hooks_ran = false; 2596 bool print_hook_header = (m_stop_hooks.size() != 1); 2597 bool print_thread_header = (num_exe_ctx != 1); 2598 2599 for (pos = m_stop_hooks.begin(); keep_going && pos != end; pos++) { 2600 // result.Clear(); 2601 StopHookSP cur_hook_sp = (*pos).second; 2602 if (!cur_hook_sp->IsActive()) 2603 continue; 2604 2605 bool any_thread_matched = false; 2606 for (size_t i = 0; keep_going && i < num_exe_ctx; i++) { 2607 if ((cur_hook_sp->GetSpecifier() == nullptr || 2608 cur_hook_sp->GetSpecifier()->SymbolContextMatches( 2609 sym_ctx_with_reasons[i])) && 2610 (cur_hook_sp->GetThreadSpecifier() == nullptr || 2611 cur_hook_sp->GetThreadSpecifier()->ThreadPassesBasicTests( 2612 exc_ctx_with_reasons[i].GetThreadRef()))) { 2613 if (!hooks_ran) { 2614 hooks_ran = true; 2615 } 2616 if (print_hook_header && !any_thread_matched) { 2617 const char *cmd = 2618 (cur_hook_sp->GetCommands().GetSize() == 1 2619 ? cur_hook_sp->GetCommands().GetStringAtIndex(0) 2620 : nullptr); 2621 if (cmd) 2622 result.AppendMessageWithFormat("\n- Hook %" PRIu64 " (%s)\n", 2623 cur_hook_sp->GetID(), cmd); 2624 else 2625 result.AppendMessageWithFormat("\n- Hook %" PRIu64 "\n", 2626 cur_hook_sp->GetID()); 2627 any_thread_matched = true; 2628 } 2629 2630 if (print_thread_header) 2631 result.AppendMessageWithFormat( 2632 "-- Thread %d\n", 2633 exc_ctx_with_reasons[i].GetThreadPtr()->GetIndexID()); 2634 2635 CommandInterpreterRunOptions options; 2636 options.SetStopOnContinue(true); 2637 options.SetStopOnError(true); 2638 options.SetEchoCommands(false); 2639 options.SetPrintResults(true); 2640 options.SetAddToHistory(false); 2641 2642 GetDebugger().GetCommandInterpreter().HandleCommands( 2643 cur_hook_sp->GetCommands(), &exc_ctx_with_reasons[i], options, 2644 result); 2645 2646 // If the command started the target going again, we should bag out of 2647 // running the stop hooks. 2648 if ((result.GetStatus() == eReturnStatusSuccessContinuingNoResult) || 2649 (result.GetStatus() == eReturnStatusSuccessContinuingResult)) { 2650 // But only complain if there were more stop hooks to do: 2651 StopHookCollection::iterator tmp = pos; 2652 if (++tmp != end) 2653 result.AppendMessageWithFormat("\nAborting stop hooks, hook %" PRIu64 2654 " set the program running.\n", 2655 cur_hook_sp->GetID()); 2656 keep_going = false; 2657 } 2658 } 2659 } 2660 } 2661 2662 result.GetImmediateOutputStream()->Flush(); 2663 result.GetImmediateErrorStream()->Flush(); 2664 } 2665 2666 const TargetPropertiesSP &Target::GetGlobalProperties() { 2667 // NOTE: intentional leak so we don't crash if global destructor chain gets 2668 // called as other threads still use the result of this function 2669 static TargetPropertiesSP *g_settings_sp_ptr = 2670 new TargetPropertiesSP(new TargetProperties(nullptr)); 2671 return *g_settings_sp_ptr; 2672 } 2673 2674 Status Target::Install(ProcessLaunchInfo *launch_info) { 2675 Status error; 2676 PlatformSP platform_sp(GetPlatform()); 2677 if (platform_sp) { 2678 if (platform_sp->IsRemote()) { 2679 if (platform_sp->IsConnected()) { 2680 // Install all files that have an install path, and always install the 2681 // main executable when connected to a remote platform 2682 const ModuleList &modules = GetImages(); 2683 const size_t num_images = modules.GetSize(); 2684 for (size_t idx = 0; idx < num_images; ++idx) { 2685 ModuleSP module_sp(modules.GetModuleAtIndex(idx)); 2686 if (module_sp) { 2687 const bool is_main_executable = module_sp == GetExecutableModule(); 2688 FileSpec local_file(module_sp->GetFileSpec()); 2689 if (local_file) { 2690 FileSpec remote_file(module_sp->GetRemoteInstallFileSpec()); 2691 if (!remote_file) { 2692 if (is_main_executable) // TODO: add setting for always 2693 // installing main executable??? 2694 { 2695 // Always install the main executable 2696 remote_file = platform_sp->GetRemoteWorkingDirectory(); 2697 remote_file.AppendPathComponent( 2698 module_sp->GetFileSpec().GetFilename().GetCString()); 2699 } 2700 } 2701 if (remote_file) { 2702 error = platform_sp->Install(local_file, remote_file); 2703 if (error.Success()) { 2704 module_sp->SetPlatformFileSpec(remote_file); 2705 if (is_main_executable) { 2706 platform_sp->SetFilePermissions(remote_file, 0700); 2707 if (launch_info) 2708 launch_info->SetExecutableFile(remote_file, false); 2709 } 2710 } else 2711 break; 2712 } 2713 } 2714 } 2715 } 2716 } 2717 } 2718 } 2719 return error; 2720 } 2721 2722 bool Target::ResolveLoadAddress(addr_t load_addr, Address &so_addr, 2723 uint32_t stop_id) { 2724 return m_section_load_history.ResolveLoadAddress(stop_id, load_addr, so_addr); 2725 } 2726 2727 bool Target::ResolveFileAddress(lldb::addr_t file_addr, 2728 Address &resolved_addr) { 2729 return m_images.ResolveFileAddress(file_addr, resolved_addr); 2730 } 2731 2732 bool Target::SetSectionLoadAddress(const SectionSP §ion_sp, 2733 addr_t new_section_load_addr, 2734 bool warn_multiple) { 2735 const addr_t old_section_load_addr = 2736 m_section_load_history.GetSectionLoadAddress( 2737 SectionLoadHistory::eStopIDNow, section_sp); 2738 if (old_section_load_addr != new_section_load_addr) { 2739 uint32_t stop_id = 0; 2740 ProcessSP process_sp(GetProcessSP()); 2741 if (process_sp) 2742 stop_id = process_sp->GetStopID(); 2743 else 2744 stop_id = m_section_load_history.GetLastStopID(); 2745 if (m_section_load_history.SetSectionLoadAddress( 2746 stop_id, section_sp, new_section_load_addr, warn_multiple)) 2747 return true; // Return true if the section load address was changed... 2748 } 2749 return false; // Return false to indicate nothing changed 2750 } 2751 2752 size_t Target::UnloadModuleSections(const ModuleList &module_list) { 2753 size_t section_unload_count = 0; 2754 size_t num_modules = module_list.GetSize(); 2755 for (size_t i = 0; i < num_modules; ++i) { 2756 section_unload_count += 2757 UnloadModuleSections(module_list.GetModuleAtIndex(i)); 2758 } 2759 return section_unload_count; 2760 } 2761 2762 size_t Target::UnloadModuleSections(const lldb::ModuleSP &module_sp) { 2763 uint32_t stop_id = 0; 2764 ProcessSP process_sp(GetProcessSP()); 2765 if (process_sp) 2766 stop_id = process_sp->GetStopID(); 2767 else 2768 stop_id = m_section_load_history.GetLastStopID(); 2769 SectionList *sections = module_sp->GetSectionList(); 2770 size_t section_unload_count = 0; 2771 if (sections) { 2772 const uint32_t num_sections = sections->GetNumSections(0); 2773 for (uint32_t i = 0; i < num_sections; ++i) { 2774 section_unload_count += m_section_load_history.SetSectionUnloaded( 2775 stop_id, sections->GetSectionAtIndex(i)); 2776 } 2777 } 2778 return section_unload_count; 2779 } 2780 2781 bool Target::SetSectionUnloaded(const lldb::SectionSP §ion_sp) { 2782 uint32_t stop_id = 0; 2783 ProcessSP process_sp(GetProcessSP()); 2784 if (process_sp) 2785 stop_id = process_sp->GetStopID(); 2786 else 2787 stop_id = m_section_load_history.GetLastStopID(); 2788 return m_section_load_history.SetSectionUnloaded(stop_id, section_sp); 2789 } 2790 2791 bool Target::SetSectionUnloaded(const lldb::SectionSP §ion_sp, 2792 addr_t load_addr) { 2793 uint32_t stop_id = 0; 2794 ProcessSP process_sp(GetProcessSP()); 2795 if (process_sp) 2796 stop_id = process_sp->GetStopID(); 2797 else 2798 stop_id = m_section_load_history.GetLastStopID(); 2799 return m_section_load_history.SetSectionUnloaded(stop_id, section_sp, 2800 load_addr); 2801 } 2802 2803 void Target::ClearAllLoadedSections() { m_section_load_history.Clear(); } 2804 2805 Status Target::Launch(ProcessLaunchInfo &launch_info, Stream *stream) { 2806 Status error; 2807 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_TARGET)); 2808 2809 if (log) 2810 log->Printf("Target::%s() called for %s", __FUNCTION__, 2811 launch_info.GetExecutableFile().GetPath().c_str()); 2812 2813 StateType state = eStateInvalid; 2814 2815 // Scope to temporarily get the process state in case someone has manually 2816 // remotely connected already to a process and we can skip the platform 2817 // launching. 2818 { 2819 ProcessSP process_sp(GetProcessSP()); 2820 2821 if (process_sp) { 2822 state = process_sp->GetState(); 2823 if (log) 2824 log->Printf( 2825 "Target::%s the process exists, and its current state is %s", 2826 __FUNCTION__, StateAsCString(state)); 2827 } else { 2828 if (log) 2829 log->Printf("Target::%s the process instance doesn't currently exist.", 2830 __FUNCTION__); 2831 } 2832 } 2833 2834 launch_info.GetFlags().Set(eLaunchFlagDebug); 2835 2836 // Get the value of synchronous execution here. If you wait till after you 2837 // have started to run, then you could have hit a breakpoint, whose command 2838 // might switch the value, and then you'll pick up that incorrect value. 2839 Debugger &debugger = GetDebugger(); 2840 const bool synchronous_execution = 2841 debugger.GetCommandInterpreter().GetSynchronous(); 2842 2843 PlatformSP platform_sp(GetPlatform()); 2844 2845 FinalizeFileActions(launch_info); 2846 2847 if (state == eStateConnected) { 2848 if (launch_info.GetFlags().Test(eLaunchFlagLaunchInTTY)) { 2849 error.SetErrorString( 2850 "can't launch in tty when launching through a remote connection"); 2851 return error; 2852 } 2853 } 2854 2855 if (!launch_info.GetArchitecture().IsValid()) 2856 launch_info.GetArchitecture() = GetArchitecture(); 2857 2858 // If we're not already connected to the process, and if we have a platform 2859 // that can launch a process for debugging, go ahead and do that here. 2860 if (state != eStateConnected && platform_sp && 2861 platform_sp->CanDebugProcess()) { 2862 if (log) 2863 log->Printf("Target::%s asking the platform to debug the process", 2864 __FUNCTION__); 2865 2866 // If there was a previous process, delete it before we make the new one. 2867 // One subtle point, we delete the process before we release the reference 2868 // to m_process_sp. That way even if we are the last owner, the process 2869 // will get Finalized before it gets destroyed. 2870 DeleteCurrentProcess(); 2871 2872 m_process_sp = 2873 GetPlatform()->DebugProcess(launch_info, debugger, this, error); 2874 2875 } else { 2876 if (log) 2877 log->Printf("Target::%s the platform doesn't know how to debug a " 2878 "process, getting a process plugin to do this for us.", 2879 __FUNCTION__); 2880 2881 if (state == eStateConnected) { 2882 assert(m_process_sp); 2883 } else { 2884 // Use a Process plugin to construct the process. 2885 const char *plugin_name = launch_info.GetProcessPluginName(); 2886 CreateProcess(launch_info.GetListener(), plugin_name, nullptr); 2887 } 2888 2889 // Since we didn't have a platform launch the process, launch it here. 2890 if (m_process_sp) 2891 error = m_process_sp->Launch(launch_info); 2892 } 2893 2894 if (!m_process_sp) { 2895 if (error.Success()) 2896 error.SetErrorString("failed to launch or debug process"); 2897 return error; 2898 } 2899 2900 if (error.Success()) { 2901 if (synchronous_execution || 2902 !launch_info.GetFlags().Test(eLaunchFlagStopAtEntry)) { 2903 ListenerSP hijack_listener_sp(launch_info.GetHijackListener()); 2904 if (!hijack_listener_sp) { 2905 hijack_listener_sp = 2906 Listener::MakeListener("lldb.Target.Launch.hijack"); 2907 launch_info.SetHijackListener(hijack_listener_sp); 2908 m_process_sp->HijackProcessEvents(hijack_listener_sp); 2909 } 2910 2911 StateType state = m_process_sp->WaitForProcessToStop( 2912 llvm::None, nullptr, false, hijack_listener_sp, nullptr); 2913 2914 if (state == eStateStopped) { 2915 if (!launch_info.GetFlags().Test(eLaunchFlagStopAtEntry)) { 2916 if (synchronous_execution) { 2917 error = m_process_sp->PrivateResume(); 2918 if (error.Success()) { 2919 state = m_process_sp->WaitForProcessToStop( 2920 llvm::None, nullptr, true, hijack_listener_sp, stream); 2921 const bool must_be_alive = 2922 false; // eStateExited is ok, so this must be false 2923 if (!StateIsStoppedState(state, must_be_alive)) { 2924 error.SetErrorStringWithFormat("process isn't stopped: %s", 2925 StateAsCString(state)); 2926 } 2927 } 2928 } else { 2929 m_process_sp->RestoreProcessEvents(); 2930 error = m_process_sp->PrivateResume(); 2931 } 2932 if (!error.Success()) { 2933 Status error2; 2934 error2.SetErrorStringWithFormat( 2935 "process resume at entry point failed: %s", error.AsCString()); 2936 error = error2; 2937 } 2938 } 2939 } else if (state == eStateExited) { 2940 bool with_shell = !!launch_info.GetShell(); 2941 const int exit_status = m_process_sp->GetExitStatus(); 2942 const char *exit_desc = m_process_sp->GetExitDescription(); 2943 #define LAUNCH_SHELL_MESSAGE \ 2944 "\n'r' and 'run' are aliases that default to launching through a " \ 2945 "shell.\nTry launching without going through a shell by using 'process " \ 2946 "launch'." 2947 if (exit_desc && exit_desc[0]) { 2948 if (with_shell) 2949 error.SetErrorStringWithFormat( 2950 "process exited with status %i (%s)" LAUNCH_SHELL_MESSAGE, 2951 exit_status, exit_desc); 2952 else 2953 error.SetErrorStringWithFormat("process exited with status %i (%s)", 2954 exit_status, exit_desc); 2955 } else { 2956 if (with_shell) 2957 error.SetErrorStringWithFormat( 2958 "process exited with status %i" LAUNCH_SHELL_MESSAGE, 2959 exit_status); 2960 else 2961 error.SetErrorStringWithFormat("process exited with status %i", 2962 exit_status); 2963 } 2964 } else { 2965 error.SetErrorStringWithFormat( 2966 "initial process state wasn't stopped: %s", StateAsCString(state)); 2967 } 2968 } 2969 m_process_sp->RestoreProcessEvents(); 2970 } else { 2971 Status error2; 2972 error2.SetErrorStringWithFormat("process launch failed: %s", 2973 error.AsCString()); 2974 error = error2; 2975 } 2976 return error; 2977 } 2978 2979 Status Target::Attach(ProcessAttachInfo &attach_info, Stream *stream) { 2980 auto state = eStateInvalid; 2981 auto process_sp = GetProcessSP(); 2982 if (process_sp) { 2983 state = process_sp->GetState(); 2984 if (process_sp->IsAlive() && state != eStateConnected) { 2985 if (state == eStateAttaching) 2986 return Status("process attach is in progress"); 2987 return Status("a process is already being debugged"); 2988 } 2989 } 2990 2991 const ModuleSP old_exec_module_sp = GetExecutableModule(); 2992 2993 // If no process info was specified, then use the target executable name as 2994 // the process to attach to by default 2995 if (!attach_info.ProcessInfoSpecified()) { 2996 if (old_exec_module_sp) 2997 attach_info.GetExecutableFile().GetFilename() = 2998 old_exec_module_sp->GetPlatformFileSpec().GetFilename(); 2999 3000 if (!attach_info.ProcessInfoSpecified()) { 3001 return Status("no process specified, create a target with a file, or " 3002 "specify the --pid or --name"); 3003 } 3004 } 3005 3006 const auto platform_sp = 3007 GetDebugger().GetPlatformList().GetSelectedPlatform(); 3008 ListenerSP hijack_listener_sp; 3009 const bool async = attach_info.GetAsync(); 3010 if (!async) { 3011 hijack_listener_sp = 3012 Listener::MakeListener("lldb.Target.Attach.attach.hijack"); 3013 attach_info.SetHijackListener(hijack_listener_sp); 3014 } 3015 3016 Status error; 3017 if (state != eStateConnected && platform_sp != nullptr && 3018 platform_sp->CanDebugProcess()) { 3019 SetPlatform(platform_sp); 3020 process_sp = platform_sp->Attach(attach_info, GetDebugger(), this, error); 3021 } else { 3022 if (state != eStateConnected) { 3023 const char *plugin_name = attach_info.GetProcessPluginName(); 3024 process_sp = 3025 CreateProcess(attach_info.GetListenerForProcess(GetDebugger()), 3026 plugin_name, nullptr); 3027 if (process_sp == nullptr) { 3028 error.SetErrorStringWithFormat( 3029 "failed to create process using plugin %s", 3030 (plugin_name) ? plugin_name : "null"); 3031 return error; 3032 } 3033 } 3034 if (hijack_listener_sp) 3035 process_sp->HijackProcessEvents(hijack_listener_sp); 3036 error = process_sp->Attach(attach_info); 3037 } 3038 3039 if (error.Success() && process_sp) { 3040 if (async) { 3041 process_sp->RestoreProcessEvents(); 3042 } else { 3043 state = process_sp->WaitForProcessToStop( 3044 llvm::None, nullptr, false, attach_info.GetHijackListener(), stream); 3045 process_sp->RestoreProcessEvents(); 3046 3047 if (state != eStateStopped) { 3048 const char *exit_desc = process_sp->GetExitDescription(); 3049 if (exit_desc) 3050 error.SetErrorStringWithFormat("%s", exit_desc); 3051 else 3052 error.SetErrorString( 3053 "process did not stop (no such process or permission problem?)"); 3054 process_sp->Destroy(false); 3055 } 3056 } 3057 } 3058 return error; 3059 } 3060 3061 void Target::FinalizeFileActions(ProcessLaunchInfo &info) { 3062 Log *log(lldb_private::GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS)); 3063 3064 // Finalize the file actions, and if none were given, default to opening up a 3065 // pseudo terminal 3066 PlatformSP platform_sp = GetPlatform(); 3067 const bool default_to_use_pty = 3068 m_platform_sp ? m_platform_sp->IsHost() : false; 3069 LLDB_LOG( 3070 log, 3071 "have platform={0}, platform_sp->IsHost()={1}, default_to_use_pty={2}", 3072 bool(platform_sp), 3073 platform_sp ? (platform_sp->IsHost() ? "true" : "false") : "n/a", 3074 default_to_use_pty); 3075 3076 // If nothing for stdin or stdout or stderr was specified, then check the 3077 // process for any default settings that were set with "settings set" 3078 if (info.GetFileActionForFD(STDIN_FILENO) == nullptr || 3079 info.GetFileActionForFD(STDOUT_FILENO) == nullptr || 3080 info.GetFileActionForFD(STDERR_FILENO) == nullptr) { 3081 LLDB_LOG(log, "at least one of stdin/stdout/stderr was not set, evaluating " 3082 "default handling"); 3083 3084 if (info.GetFlags().Test(eLaunchFlagLaunchInTTY)) { 3085 // Do nothing, if we are launching in a remote terminal no file actions 3086 // should be done at all. 3087 return; 3088 } 3089 3090 if (info.GetFlags().Test(eLaunchFlagDisableSTDIO)) { 3091 LLDB_LOG(log, "eLaunchFlagDisableSTDIO set, adding suppression action " 3092 "for stdin, stdout and stderr"); 3093 info.AppendSuppressFileAction(STDIN_FILENO, true, false); 3094 info.AppendSuppressFileAction(STDOUT_FILENO, false, true); 3095 info.AppendSuppressFileAction(STDERR_FILENO, false, true); 3096 } else { 3097 // Check for any values that might have gotten set with any of: (lldb) 3098 // settings set target.input-path (lldb) settings set target.output-path 3099 // (lldb) settings set target.error-path 3100 FileSpec in_file_spec; 3101 FileSpec out_file_spec; 3102 FileSpec err_file_spec; 3103 // Only override with the target settings if we don't already have an 3104 // action for in, out or error 3105 if (info.GetFileActionForFD(STDIN_FILENO) == nullptr) 3106 in_file_spec = GetStandardInputPath(); 3107 if (info.GetFileActionForFD(STDOUT_FILENO) == nullptr) 3108 out_file_spec = GetStandardOutputPath(); 3109 if (info.GetFileActionForFD(STDERR_FILENO) == nullptr) 3110 err_file_spec = GetStandardErrorPath(); 3111 3112 LLDB_LOG(log, "target stdin='{0}', target stdout='{1}', stderr='{1}'", 3113 in_file_spec, out_file_spec, err_file_spec); 3114 3115 if (in_file_spec) { 3116 info.AppendOpenFileAction(STDIN_FILENO, in_file_spec, true, false); 3117 LLDB_LOG(log, "appended stdin open file action for {0}", in_file_spec); 3118 } 3119 3120 if (out_file_spec) { 3121 info.AppendOpenFileAction(STDOUT_FILENO, out_file_spec, false, true); 3122 LLDB_LOG(log, "appended stdout open file action for {0}", 3123 out_file_spec); 3124 } 3125 3126 if (err_file_spec) { 3127 info.AppendOpenFileAction(STDERR_FILENO, err_file_spec, false, true); 3128 LLDB_LOG(log, "appended stderr open file action for {0}", 3129 err_file_spec); 3130 } 3131 3132 if (default_to_use_pty && 3133 (!in_file_spec || !out_file_spec || !err_file_spec)) { 3134 llvm::Error Err = info.SetUpPtyRedirection(); 3135 LLDB_LOG_ERROR(log, std::move(Err), "SetUpPtyRedirection failed: {0}"); 3136 } 3137 } 3138 } 3139 } 3140 3141 //-------------------------------------------------------------- 3142 // Target::StopHook 3143 //-------------------------------------------------------------- 3144 Target::StopHook::StopHook(lldb::TargetSP target_sp, lldb::user_id_t uid) 3145 : UserID(uid), m_target_sp(target_sp), m_commands(), m_specifier_sp(), 3146 m_thread_spec_up(), m_active(true) {} 3147 3148 Target::StopHook::StopHook(const StopHook &rhs) 3149 : UserID(rhs.GetID()), m_target_sp(rhs.m_target_sp), 3150 m_commands(rhs.m_commands), m_specifier_sp(rhs.m_specifier_sp), 3151 m_thread_spec_up(), m_active(rhs.m_active) { 3152 if (rhs.m_thread_spec_up) 3153 m_thread_spec_up.reset(new ThreadSpec(*rhs.m_thread_spec_up)); 3154 } 3155 3156 Target::StopHook::~StopHook() = default; 3157 3158 void Target::StopHook::SetSpecifier(SymbolContextSpecifier *specifier) { 3159 m_specifier_sp.reset(specifier); 3160 } 3161 3162 void Target::StopHook::SetThreadSpecifier(ThreadSpec *specifier) { 3163 m_thread_spec_up.reset(specifier); 3164 } 3165 3166 void Target::StopHook::GetDescription(Stream *s, 3167 lldb::DescriptionLevel level) const { 3168 int indent_level = s->GetIndentLevel(); 3169 3170 s->SetIndentLevel(indent_level + 2); 3171 3172 s->Printf("Hook: %" PRIu64 "\n", GetID()); 3173 if (m_active) 3174 s->Indent("State: enabled\n"); 3175 else 3176 s->Indent("State: disabled\n"); 3177 3178 if (m_specifier_sp) { 3179 s->Indent(); 3180 s->PutCString("Specifier:\n"); 3181 s->SetIndentLevel(indent_level + 4); 3182 m_specifier_sp->GetDescription(s, level); 3183 s->SetIndentLevel(indent_level + 2); 3184 } 3185 3186 if (m_thread_spec_up) { 3187 StreamString tmp; 3188 s->Indent("Thread:\n"); 3189 m_thread_spec_up->GetDescription(&tmp, level); 3190 s->SetIndentLevel(indent_level + 4); 3191 s->Indent(tmp.GetString()); 3192 s->PutCString("\n"); 3193 s->SetIndentLevel(indent_level + 2); 3194 } 3195 3196 s->Indent("Commands: \n"); 3197 s->SetIndentLevel(indent_level + 4); 3198 uint32_t num_commands = m_commands.GetSize(); 3199 for (uint32_t i = 0; i < num_commands; i++) { 3200 s->Indent(m_commands.GetStringAtIndex(i)); 3201 s->PutCString("\n"); 3202 } 3203 s->SetIndentLevel(indent_level); 3204 } 3205 3206 //-------------------------------------------------------------- 3207 // class TargetProperties 3208 //-------------------------------------------------------------- 3209 3210 // clang-format off 3211 static constexpr OptionEnumValueElement g_dynamic_value_types[] = { 3212 {eNoDynamicValues, "no-dynamic-values", 3213 "Don't calculate the dynamic type of values"}, 3214 {eDynamicCanRunTarget, "run-target", "Calculate the dynamic type of values " 3215 "even if you have to run the target."}, 3216 {eDynamicDontRunTarget, "no-run-target", 3217 "Calculate the dynamic type of values, but don't run the target."} }; 3218 3219 OptionEnumValues lldb_private::GetDynamicValueTypes() { 3220 return OptionEnumValues(g_dynamic_value_types); 3221 } 3222 3223 static constexpr OptionEnumValueElement g_inline_breakpoint_enums[] = { 3224 {eInlineBreakpointsNever, "never", "Never look for inline breakpoint " 3225 "locations (fastest). This setting " 3226 "should only be used if you know that " 3227 "no inlining occurs in your programs."}, 3228 {eInlineBreakpointsHeaders, "headers", 3229 "Only check for inline breakpoint locations when setting breakpoints in " 3230 "header files, but not when setting breakpoint in implementation source " 3231 "files (default)."}, 3232 {eInlineBreakpointsAlways, "always", 3233 "Always look for inline breakpoint locations when setting file and line " 3234 "breakpoints (slower but most accurate)."} }; 3235 3236 typedef enum x86DisassemblyFlavor { 3237 eX86DisFlavorDefault, 3238 eX86DisFlavorIntel, 3239 eX86DisFlavorATT 3240 } x86DisassemblyFlavor; 3241 3242 static constexpr OptionEnumValueElement g_x86_dis_flavor_value_types[] = { 3243 {eX86DisFlavorDefault, "default", "Disassembler default (currently att)."}, 3244 {eX86DisFlavorIntel, "intel", "Intel disassembler flavor."}, 3245 {eX86DisFlavorATT, "att", "AT&T disassembler flavor."} }; 3246 3247 static constexpr OptionEnumValueElement g_hex_immediate_style_values[] = { 3248 {Disassembler::eHexStyleC, "c", "C-style (0xffff)."}, 3249 {Disassembler::eHexStyleAsm, "asm", "Asm-style (0ffffh)."} }; 3250 3251 static constexpr OptionEnumValueElement g_load_script_from_sym_file_values[] = { 3252 {eLoadScriptFromSymFileTrue, "true", 3253 "Load debug scripts inside symbol files"}, 3254 {eLoadScriptFromSymFileFalse, "false", 3255 "Do not load debug scripts inside symbol files."}, 3256 {eLoadScriptFromSymFileWarn, "warn", 3257 "Warn about debug scripts inside symbol files but do not load them."} }; 3258 3259 static constexpr 3260 OptionEnumValueElement g_load_current_working_dir_lldbinit_values[] = { 3261 {eLoadCWDlldbinitTrue, "true", 3262 "Load .lldbinit files from current directory"}, 3263 {eLoadCWDlldbinitFalse, "false", 3264 "Do not load .lldbinit files from current directory"}, 3265 {eLoadCWDlldbinitWarn, "warn", 3266 "Warn about loading .lldbinit files from current directory"} }; 3267 3268 static constexpr OptionEnumValueElement g_memory_module_load_level_values[] = { 3269 {eMemoryModuleLoadLevelMinimal, "minimal", 3270 "Load minimal information when loading modules from memory. Currently " 3271 "this setting loads sections only."}, 3272 {eMemoryModuleLoadLevelPartial, "partial", 3273 "Load partial information when loading modules from memory. Currently " 3274 "this setting loads sections and function bounds."}, 3275 {eMemoryModuleLoadLevelComplete, "complete", 3276 "Load complete information when loading modules from memory. Currently " 3277 "this setting loads sections and all symbols."} }; 3278 3279 static constexpr PropertyDefinition g_properties[] = { 3280 {"default-arch", OptionValue::eTypeArch, true, 0, nullptr, {}, 3281 "Default architecture to choose, when there's a choice."}, 3282 {"move-to-nearest-code", OptionValue::eTypeBoolean, false, true, nullptr, 3283 {}, "Move breakpoints to nearest code."}, 3284 {"language", OptionValue::eTypeLanguage, false, eLanguageTypeUnknown, 3285 nullptr, {}, 3286 "The language to use when interpreting expressions entered in commands."}, 3287 {"expr-prefix", OptionValue::eTypeFileSpec, false, 0, nullptr, {}, 3288 "Path to a file containing expressions to be prepended to all " 3289 "expressions."}, 3290 {"prefer-dynamic-value", OptionValue::eTypeEnum, false, 3291 eDynamicDontRunTarget, nullptr, OptionEnumValues(g_dynamic_value_types), 3292 "Should printed values be shown as their dynamic value."}, 3293 {"enable-synthetic-value", OptionValue::eTypeBoolean, false, true, nullptr, 3294 {}, "Should synthetic values be used by default whenever available."}, 3295 {"skip-prologue", OptionValue::eTypeBoolean, false, true, nullptr, {}, 3296 "Skip function prologues when setting breakpoints by name."}, 3297 {"source-map", OptionValue::eTypePathMap, false, 0, nullptr, {}, 3298 "Source path remappings are used to track the change of location between " 3299 "a source file when built, and " 3300 "where it exists on the current system. It consists of an array of " 3301 "duples, the first element of each duple is " 3302 "some part (starting at the root) of the path to the file when it was " 3303 "built, " 3304 "and the second is where the remainder of the original build hierarchy is " 3305 "rooted on the local system. " 3306 "Each element of the array is checked in order and the first one that " 3307 "results in a match wins."}, 3308 {"exec-search-paths", OptionValue::eTypeFileSpecList, false, 0, nullptr, 3309 {}, "Executable search paths to use when locating executable files " 3310 "whose paths don't match the local file system."}, 3311 {"debug-file-search-paths", OptionValue::eTypeFileSpecList, false, 0, 3312 nullptr, {}, 3313 "List of directories to be searched when locating debug symbol files. " 3314 "See also symbols.enable-external-lookup."}, 3315 {"clang-module-search-paths", OptionValue::eTypeFileSpecList, false, 0, 3316 nullptr, {}, 3317 "List of directories to be searched when locating modules for Clang."}, 3318 {"auto-import-clang-modules", OptionValue::eTypeBoolean, false, true, 3319 nullptr, {}, 3320 "Automatically load Clang modules referred to by the program."}, 3321 {"auto-apply-fixits", OptionValue::eTypeBoolean, false, true, nullptr, 3322 {}, "Automatically apply fix-it hints to expressions."}, 3323 {"notify-about-fixits", OptionValue::eTypeBoolean, false, true, nullptr, 3324 {}, "Print the fixed expression text."}, 3325 {"save-jit-objects", OptionValue::eTypeBoolean, false, false, nullptr, 3326 {}, "Save intermediate object files generated by the LLVM JIT"}, 3327 {"max-children-count", OptionValue::eTypeSInt64, false, 256, nullptr, 3328 {}, "Maximum number of children to expand in any level of depth."}, 3329 {"max-string-summary-length", OptionValue::eTypeSInt64, false, 1024, 3330 nullptr, {}, 3331 "Maximum number of characters to show when using %s in summary strings."}, 3332 {"max-memory-read-size", OptionValue::eTypeSInt64, false, 1024, nullptr, 3333 {}, "Maximum number of bytes that 'memory read' will fetch before " 3334 "--force must be specified."}, 3335 {"breakpoints-use-platform-avoid-list", OptionValue::eTypeBoolean, false, 3336 true, nullptr, {}, "Consult the platform module avoid list when " 3337 "setting non-module specific breakpoints."}, 3338 {"arg0", OptionValue::eTypeString, false, 0, nullptr, {}, 3339 "The first argument passed to the program in the argument array which can " 3340 "be different from the executable itself."}, 3341 {"run-args", OptionValue::eTypeArgs, false, 0, nullptr, {}, 3342 "A list containing all the arguments to be passed to the executable when " 3343 "it is run. Note that this does NOT include the argv[0] which is in " 3344 "target.arg0."}, 3345 {"env-vars", OptionValue::eTypeDictionary, false, OptionValue::eTypeString, 3346 nullptr, {}, "A list of all the environment variables to be passed " 3347 "to the executable's environment, and their values."}, 3348 {"inherit-env", OptionValue::eTypeBoolean, false, true, nullptr, {}, 3349 "Inherit the environment from the process that is running LLDB."}, 3350 {"input-path", OptionValue::eTypeFileSpec, false, 0, nullptr, {}, 3351 "The file/path to be used by the executable program for reading its " 3352 "standard input."}, 3353 {"output-path", OptionValue::eTypeFileSpec, false, 0, nullptr, {}, 3354 "The file/path to be used by the executable program for writing its " 3355 "standard output."}, 3356 {"error-path", OptionValue::eTypeFileSpec, false, 0, nullptr, {}, 3357 "The file/path to be used by the executable program for writing its " 3358 "standard error."}, 3359 {"detach-on-error", OptionValue::eTypeBoolean, false, true, nullptr, 3360 {}, "debugserver will detach (rather than killing) a process if it " 3361 "loses connection with lldb."}, 3362 {"preload-symbols", OptionValue::eTypeBoolean, false, true, nullptr, {}, 3363 "Enable loading of symbol tables before they are needed."}, 3364 {"disable-aslr", OptionValue::eTypeBoolean, false, true, nullptr, {}, 3365 "Disable Address Space Layout Randomization (ASLR)"}, 3366 {"disable-stdio", OptionValue::eTypeBoolean, false, false, nullptr, {}, 3367 "Disable stdin/stdout for process (e.g. for a GUI application)"}, 3368 {"inline-breakpoint-strategy", OptionValue::eTypeEnum, false, 3369 eInlineBreakpointsAlways, nullptr, 3370 OptionEnumValues(g_inline_breakpoint_enums), 3371 "The strategy to use when settings breakpoints by file and line. " 3372 "Breakpoint locations can end up being inlined by the compiler, so that a " 3373 "compile unit 'a.c' might contain an inlined function from another source " 3374 "file. " 3375 "Usually this is limited to breakpoint locations from inlined functions " 3376 "from header or other include files, or more accurately " 3377 "non-implementation source files. " 3378 "Sometimes code might #include implementation files and cause inlined " 3379 "breakpoint locations in inlined implementation files. " 3380 "Always checking for inlined breakpoint locations can be expensive " 3381 "(memory and time), so if you have a project with many headers " 3382 "and find that setting breakpoints is slow, then you can change this " 3383 "setting to headers. " 3384 "This setting allows you to control exactly which strategy is used when " 3385 "setting " 3386 "file and line breakpoints."}, 3387 // FIXME: This is the wrong way to do per-architecture settings, but we 3388 // don't have a general per architecture settings system in place yet. 3389 {"x86-disassembly-flavor", OptionValue::eTypeEnum, false, 3390 eX86DisFlavorDefault, nullptr, 3391 OptionEnumValues(g_x86_dis_flavor_value_types), 3392 "The default disassembly flavor to use for x86 or x86-64 targets."}, 3393 {"use-hex-immediates", OptionValue::eTypeBoolean, false, true, nullptr, 3394 {}, "Show immediates in disassembly as hexadecimal."}, 3395 {"hex-immediate-style", OptionValue::eTypeEnum, false, 3396 Disassembler::eHexStyleC, nullptr, 3397 OptionEnumValues(g_hex_immediate_style_values), 3398 "Which style to use for printing hexadecimal disassembly values."}, 3399 {"use-fast-stepping", OptionValue::eTypeBoolean, false, true, nullptr, 3400 {}, "Use a fast stepping algorithm based on running from branch to " 3401 "branch rather than instruction single-stepping."}, 3402 {"load-script-from-symbol-file", OptionValue::eTypeEnum, false, 3403 eLoadScriptFromSymFileWarn, nullptr, 3404 OptionEnumValues(g_load_script_from_sym_file_values), 3405 "Allow LLDB to load scripting resources embedded in symbol files when " 3406 "available."}, 3407 {"load-cwd-lldbinit", OptionValue::eTypeEnum, false, eLoadCWDlldbinitWarn, 3408 nullptr, OptionEnumValues(g_load_current_working_dir_lldbinit_values), 3409 "Allow LLDB to .lldbinit files from the current directory automatically."}, 3410 {"memory-module-load-level", OptionValue::eTypeEnum, false, 3411 eMemoryModuleLoadLevelComplete, nullptr, 3412 OptionEnumValues(g_memory_module_load_level_values), 3413 "Loading modules from memory can be slow as reading the symbol tables and " 3414 "other data can take a long time depending on your connection to the " 3415 "debug target. " 3416 "This setting helps users control how much information gets loaded when " 3417 "loading modules from memory." 3418 "'complete' is the default value for this setting which will load all " 3419 "sections and symbols by reading them from memory (slowest, most " 3420 "accurate). " 3421 "'partial' will load sections and attempt to find function bounds without " 3422 "downloading the symbol table (faster, still accurate, missing symbol " 3423 "names). " 3424 "'minimal' is the fastest setting and will load section data with no " 3425 "symbols, but should rarely be used as stack frames in these memory " 3426 "regions will be inaccurate and not provide any context (fastest). "}, 3427 {"display-expression-in-crashlogs", OptionValue::eTypeBoolean, false, false, 3428 nullptr, {}, "Expressions that crash will show up in crash logs if " 3429 "the host system supports executable specific crash log " 3430 "strings and this setting is set to true."}, 3431 {"trap-handler-names", OptionValue::eTypeArray, true, 3432 OptionValue::eTypeString, nullptr, {}, 3433 "A list of trap handler function names, e.g. a common Unix user process " 3434 "one is _sigtramp."}, 3435 {"display-runtime-support-values", OptionValue::eTypeBoolean, false, false, 3436 nullptr, {}, "If true, LLDB will show variables that are meant to " 3437 "support the operation of a language's runtime support."}, 3438 {"display-recognized-arguments", OptionValue::eTypeBoolean, false, false, 3439 nullptr, {}, "Show recognized arguments in variable listings by default."}, 3440 {"non-stop-mode", OptionValue::eTypeBoolean, false, 0, nullptr, {}, 3441 "Disable lock-step debugging, instead control threads independently."}, 3442 {"require-hardware-breakpoint", OptionValue::eTypeBoolean, false, 0, 3443 nullptr, {}, "Require all breakpoints to be hardware breakpoints."}}; 3444 // clang-format on 3445 3446 enum { 3447 ePropertyDefaultArch, 3448 ePropertyMoveToNearestCode, 3449 ePropertyLanguage, 3450 ePropertyExprPrefix, 3451 ePropertyPreferDynamic, 3452 ePropertyEnableSynthetic, 3453 ePropertySkipPrologue, 3454 ePropertySourceMap, 3455 ePropertyExecutableSearchPaths, 3456 ePropertyDebugFileSearchPaths, 3457 ePropertyClangModuleSearchPaths, 3458 ePropertyAutoImportClangModules, 3459 ePropertyAutoApplyFixIts, 3460 ePropertyNotifyAboutFixIts, 3461 ePropertySaveObjects, 3462 ePropertyMaxChildrenCount, 3463 ePropertyMaxSummaryLength, 3464 ePropertyMaxMemReadSize, 3465 ePropertyBreakpointUseAvoidList, 3466 ePropertyArg0, 3467 ePropertyRunArgs, 3468 ePropertyEnvVars, 3469 ePropertyInheritEnv, 3470 ePropertyInputPath, 3471 ePropertyOutputPath, 3472 ePropertyErrorPath, 3473 ePropertyDetachOnError, 3474 ePropertyPreloadSymbols, 3475 ePropertyDisableASLR, 3476 ePropertyDisableSTDIO, 3477 ePropertyInlineStrategy, 3478 ePropertyDisassemblyFlavor, 3479 ePropertyUseHexImmediates, 3480 ePropertyHexImmediateStyle, 3481 ePropertyUseFastStepping, 3482 ePropertyLoadScriptFromSymbolFile, 3483 ePropertyLoadCWDlldbinitFile, 3484 ePropertyMemoryModuleLoadLevel, 3485 ePropertyDisplayExpressionsInCrashlogs, 3486 ePropertyTrapHandlerNames, 3487 ePropertyDisplayRuntimeSupportValues, 3488 ePropertyDisplayRecognizedArguments, 3489 ePropertyNonStopModeEnabled, 3490 ePropertyRequireHardwareBreakpoints, 3491 ePropertyExperimental, 3492 }; 3493 3494 class TargetOptionValueProperties : public OptionValueProperties { 3495 public: 3496 TargetOptionValueProperties(const ConstString &name) 3497 : OptionValueProperties(name), m_target(nullptr), m_got_host_env(false) {} 3498 3499 // This constructor is used when creating TargetOptionValueProperties when it 3500 // is part of a new lldb_private::Target instance. It will copy all current 3501 // global property values as needed 3502 TargetOptionValueProperties(Target *target, 3503 const TargetPropertiesSP &target_properties_sp) 3504 : OptionValueProperties(*target_properties_sp->GetValueProperties()), 3505 m_target(target), m_got_host_env(false) {} 3506 3507 const Property *GetPropertyAtIndex(const ExecutionContext *exe_ctx, 3508 bool will_modify, 3509 uint32_t idx) const override { 3510 // When getting the value for a key from the target options, we will always 3511 // try and grab the setting from the current target if there is one. Else 3512 // we just use the one from this instance. 3513 if (idx == ePropertyEnvVars) 3514 GetHostEnvironmentIfNeeded(); 3515 3516 if (exe_ctx) { 3517 Target *target = exe_ctx->GetTargetPtr(); 3518 if (target) { 3519 TargetOptionValueProperties *target_properties = 3520 static_cast<TargetOptionValueProperties *>( 3521 target->GetValueProperties().get()); 3522 if (this != target_properties) 3523 return target_properties->ProtectedGetPropertyAtIndex(idx); 3524 } 3525 } 3526 return ProtectedGetPropertyAtIndex(idx); 3527 } 3528 3529 lldb::TargetSP GetTargetSP() { return m_target->shared_from_this(); } 3530 3531 protected: 3532 void GetHostEnvironmentIfNeeded() const { 3533 if (!m_got_host_env) { 3534 if (m_target) { 3535 m_got_host_env = true; 3536 const uint32_t idx = ePropertyInheritEnv; 3537 if (GetPropertyAtIndexAsBoolean( 3538 nullptr, idx, g_properties[idx].default_uint_value != 0)) { 3539 PlatformSP platform_sp(m_target->GetPlatform()); 3540 if (platform_sp) { 3541 Environment env = platform_sp->GetEnvironment(); 3542 OptionValueDictionary *env_dict = 3543 GetPropertyAtIndexAsOptionValueDictionary(nullptr, 3544 ePropertyEnvVars); 3545 if (env_dict) { 3546 const bool can_replace = false; 3547 for (const auto &KV : env) { 3548 // Don't allow existing keys to be replaced with ones we get 3549 // from the platform environment 3550 env_dict->SetValueForKey( 3551 ConstString(KV.first()), 3552 OptionValueSP(new OptionValueString(KV.second.c_str())), 3553 can_replace); 3554 } 3555 } 3556 } 3557 } 3558 } 3559 } 3560 } 3561 Target *m_target; 3562 mutable bool m_got_host_env; 3563 }; 3564 3565 //---------------------------------------------------------------------- 3566 // TargetProperties 3567 //---------------------------------------------------------------------- 3568 static constexpr PropertyDefinition g_experimental_properties[]{ 3569 {"inject-local-vars", OptionValue::eTypeBoolean, true, true, nullptr, 3570 {}, 3571 "If true, inject local variables explicitly into the expression text. " 3572 "This will fix symbol resolution when there are name collisions between " 3573 "ivars and local variables. " 3574 "But it can make expressions run much more slowly."}, 3575 {"use-modern-type-lookup", OptionValue::eTypeBoolean, true, false, nullptr, 3576 {}, "If true, use Clang's modern type lookup infrastructure."}}; 3577 3578 enum { ePropertyInjectLocalVars = 0, ePropertyUseModernTypeLookup }; 3579 3580 class TargetExperimentalOptionValueProperties : public OptionValueProperties { 3581 public: 3582 TargetExperimentalOptionValueProperties() 3583 : OptionValueProperties( 3584 ConstString(Properties::GetExperimentalSettingsName())) {} 3585 }; 3586 3587 TargetExperimentalProperties::TargetExperimentalProperties() 3588 : Properties(OptionValuePropertiesSP( 3589 new TargetExperimentalOptionValueProperties())) { 3590 m_collection_sp->Initialize(g_experimental_properties); 3591 } 3592 3593 //---------------------------------------------------------------------- 3594 // TargetProperties 3595 //---------------------------------------------------------------------- 3596 TargetProperties::TargetProperties(Target *target) 3597 : Properties(), m_launch_info() { 3598 if (target) { 3599 m_collection_sp = std::make_shared<TargetOptionValueProperties>( 3600 target, Target::GetGlobalProperties()); 3601 3602 // Set callbacks to update launch_info whenever "settins set" updated any 3603 // of these properties 3604 m_collection_sp->SetValueChangedCallback( 3605 ePropertyArg0, TargetProperties::Arg0ValueChangedCallback, this); 3606 m_collection_sp->SetValueChangedCallback( 3607 ePropertyRunArgs, TargetProperties::RunArgsValueChangedCallback, this); 3608 m_collection_sp->SetValueChangedCallback( 3609 ePropertyEnvVars, TargetProperties::EnvVarsValueChangedCallback, this); 3610 m_collection_sp->SetValueChangedCallback( 3611 ePropertyInputPath, TargetProperties::InputPathValueChangedCallback, 3612 this); 3613 m_collection_sp->SetValueChangedCallback( 3614 ePropertyOutputPath, TargetProperties::OutputPathValueChangedCallback, 3615 this); 3616 m_collection_sp->SetValueChangedCallback( 3617 ePropertyErrorPath, TargetProperties::ErrorPathValueChangedCallback, 3618 this); 3619 m_collection_sp->SetValueChangedCallback( 3620 ePropertyDetachOnError, 3621 TargetProperties::DetachOnErrorValueChangedCallback, this); 3622 m_collection_sp->SetValueChangedCallback( 3623 ePropertyDisableASLR, TargetProperties::DisableASLRValueChangedCallback, 3624 this); 3625 m_collection_sp->SetValueChangedCallback( 3626 ePropertyDisableSTDIO, 3627 TargetProperties::DisableSTDIOValueChangedCallback, this); 3628 3629 m_experimental_properties_up.reset(new TargetExperimentalProperties()); 3630 m_collection_sp->AppendProperty( 3631 ConstString(Properties::GetExperimentalSettingsName()), 3632 ConstString("Experimental settings - setting these won't produce " 3633 "errors if the setting is not present."), 3634 true, m_experimental_properties_up->GetValueProperties()); 3635 3636 // Update m_launch_info once it was created 3637 Arg0ValueChangedCallback(this, nullptr); 3638 RunArgsValueChangedCallback(this, nullptr); 3639 // EnvVarsValueChangedCallback(this, nullptr); // FIXME: cause segfault in 3640 // Target::GetPlatform() 3641 InputPathValueChangedCallback(this, nullptr); 3642 OutputPathValueChangedCallback(this, nullptr); 3643 ErrorPathValueChangedCallback(this, nullptr); 3644 DetachOnErrorValueChangedCallback(this, nullptr); 3645 DisableASLRValueChangedCallback(this, nullptr); 3646 DisableSTDIOValueChangedCallback(this, nullptr); 3647 } else { 3648 m_collection_sp = 3649 std::make_shared<TargetOptionValueProperties>(ConstString("target")); 3650 m_collection_sp->Initialize(g_properties); 3651 m_experimental_properties_up.reset(new TargetExperimentalProperties()); 3652 m_collection_sp->AppendProperty( 3653 ConstString(Properties::GetExperimentalSettingsName()), 3654 ConstString("Experimental settings - setting these won't produce " 3655 "errors if the setting is not present."), 3656 true, m_experimental_properties_up->GetValueProperties()); 3657 m_collection_sp->AppendProperty( 3658 ConstString("process"), ConstString("Settings specific to processes."), 3659 true, Process::GetGlobalProperties()->GetValueProperties()); 3660 } 3661 } 3662 3663 TargetProperties::~TargetProperties() = default; 3664 3665 bool TargetProperties::GetInjectLocalVariables( 3666 ExecutionContext *exe_ctx) const { 3667 const Property *exp_property = m_collection_sp->GetPropertyAtIndex( 3668 exe_ctx, false, ePropertyExperimental); 3669 OptionValueProperties *exp_values = 3670 exp_property->GetValue()->GetAsProperties(); 3671 if (exp_values) 3672 return exp_values->GetPropertyAtIndexAsBoolean( 3673 exe_ctx, ePropertyInjectLocalVars, true); 3674 else 3675 return true; 3676 } 3677 3678 void TargetProperties::SetInjectLocalVariables(ExecutionContext *exe_ctx, 3679 bool b) { 3680 const Property *exp_property = 3681 m_collection_sp->GetPropertyAtIndex(exe_ctx, true, ePropertyExperimental); 3682 OptionValueProperties *exp_values = 3683 exp_property->GetValue()->GetAsProperties(); 3684 if (exp_values) 3685 exp_values->SetPropertyAtIndexAsBoolean(exe_ctx, ePropertyInjectLocalVars, 3686 true); 3687 } 3688 3689 bool TargetProperties::GetUseModernTypeLookup() const { 3690 const Property *exp_property = m_collection_sp->GetPropertyAtIndex( 3691 nullptr, false, ePropertyExperimental); 3692 OptionValueProperties *exp_values = 3693 exp_property->GetValue()->GetAsProperties(); 3694 if (exp_values) 3695 return exp_values->GetPropertyAtIndexAsBoolean( 3696 nullptr, ePropertyUseModernTypeLookup, true); 3697 else 3698 return true; 3699 } 3700 3701 ArchSpec TargetProperties::GetDefaultArchitecture() const { 3702 OptionValueArch *value = m_collection_sp->GetPropertyAtIndexAsOptionValueArch( 3703 nullptr, ePropertyDefaultArch); 3704 if (value) 3705 return value->GetCurrentValue(); 3706 return ArchSpec(); 3707 } 3708 3709 void TargetProperties::SetDefaultArchitecture(const ArchSpec &arch) { 3710 OptionValueArch *value = m_collection_sp->GetPropertyAtIndexAsOptionValueArch( 3711 nullptr, ePropertyDefaultArch); 3712 if (value) 3713 return value->SetCurrentValue(arch, true); 3714 } 3715 3716 bool TargetProperties::GetMoveToNearestCode() const { 3717 const uint32_t idx = ePropertyMoveToNearestCode; 3718 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3719 nullptr, idx, g_properties[idx].default_uint_value != 0); 3720 } 3721 3722 lldb::DynamicValueType TargetProperties::GetPreferDynamicValue() const { 3723 const uint32_t idx = ePropertyPreferDynamic; 3724 return (lldb::DynamicValueType) 3725 m_collection_sp->GetPropertyAtIndexAsEnumeration( 3726 nullptr, idx, g_properties[idx].default_uint_value); 3727 } 3728 3729 bool TargetProperties::SetPreferDynamicValue(lldb::DynamicValueType d) { 3730 const uint32_t idx = ePropertyPreferDynamic; 3731 return m_collection_sp->SetPropertyAtIndexAsEnumeration(nullptr, idx, d); 3732 } 3733 3734 bool TargetProperties::GetPreloadSymbols() const { 3735 const uint32_t idx = ePropertyPreloadSymbols; 3736 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3737 nullptr, idx, g_properties[idx].default_uint_value != 0); 3738 } 3739 3740 void TargetProperties::SetPreloadSymbols(bool b) { 3741 const uint32_t idx = ePropertyPreloadSymbols; 3742 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 3743 } 3744 3745 bool TargetProperties::GetDisableASLR() const { 3746 const uint32_t idx = ePropertyDisableASLR; 3747 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3748 nullptr, idx, g_properties[idx].default_uint_value != 0); 3749 } 3750 3751 void TargetProperties::SetDisableASLR(bool b) { 3752 const uint32_t idx = ePropertyDisableASLR; 3753 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 3754 } 3755 3756 bool TargetProperties::GetDetachOnError() const { 3757 const uint32_t idx = ePropertyDetachOnError; 3758 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3759 nullptr, idx, g_properties[idx].default_uint_value != 0); 3760 } 3761 3762 void TargetProperties::SetDetachOnError(bool b) { 3763 const uint32_t idx = ePropertyDetachOnError; 3764 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 3765 } 3766 3767 bool TargetProperties::GetDisableSTDIO() const { 3768 const uint32_t idx = ePropertyDisableSTDIO; 3769 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3770 nullptr, idx, g_properties[idx].default_uint_value != 0); 3771 } 3772 3773 void TargetProperties::SetDisableSTDIO(bool b) { 3774 const uint32_t idx = ePropertyDisableSTDIO; 3775 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 3776 } 3777 3778 const char *TargetProperties::GetDisassemblyFlavor() const { 3779 const uint32_t idx = ePropertyDisassemblyFlavor; 3780 const char *return_value; 3781 3782 x86DisassemblyFlavor flavor_value = 3783 (x86DisassemblyFlavor)m_collection_sp->GetPropertyAtIndexAsEnumeration( 3784 nullptr, idx, g_properties[idx].default_uint_value); 3785 return_value = g_x86_dis_flavor_value_types[flavor_value].string_value; 3786 return return_value; 3787 } 3788 3789 InlineStrategy TargetProperties::GetInlineStrategy() const { 3790 const uint32_t idx = ePropertyInlineStrategy; 3791 return (InlineStrategy)m_collection_sp->GetPropertyAtIndexAsEnumeration( 3792 nullptr, idx, g_properties[idx].default_uint_value); 3793 } 3794 3795 llvm::StringRef TargetProperties::GetArg0() const { 3796 const uint32_t idx = ePropertyArg0; 3797 return m_collection_sp->GetPropertyAtIndexAsString(nullptr, idx, llvm::StringRef()); 3798 } 3799 3800 void TargetProperties::SetArg0(llvm::StringRef arg) { 3801 const uint32_t idx = ePropertyArg0; 3802 m_collection_sp->SetPropertyAtIndexAsString( 3803 nullptr, idx, arg); 3804 m_launch_info.SetArg0(arg); 3805 } 3806 3807 bool TargetProperties::GetRunArguments(Args &args) const { 3808 const uint32_t idx = ePropertyRunArgs; 3809 return m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, args); 3810 } 3811 3812 void TargetProperties::SetRunArguments(const Args &args) { 3813 const uint32_t idx = ePropertyRunArgs; 3814 m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, args); 3815 m_launch_info.GetArguments() = args; 3816 } 3817 3818 Environment TargetProperties::GetEnvironment() const { 3819 // TODO: Get rid of the Args intermediate step 3820 Args env; 3821 const uint32_t idx = ePropertyEnvVars; 3822 m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, env); 3823 return Environment(env); 3824 } 3825 3826 void TargetProperties::SetEnvironment(Environment env) { 3827 // TODO: Get rid of the Args intermediate step 3828 const uint32_t idx = ePropertyEnvVars; 3829 m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, Args(env)); 3830 m_launch_info.GetEnvironment() = std::move(env); 3831 } 3832 3833 bool TargetProperties::GetSkipPrologue() const { 3834 const uint32_t idx = ePropertySkipPrologue; 3835 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3836 nullptr, idx, g_properties[idx].default_uint_value != 0); 3837 } 3838 3839 PathMappingList &TargetProperties::GetSourcePathMap() const { 3840 const uint32_t idx = ePropertySourceMap; 3841 OptionValuePathMappings *option_value = 3842 m_collection_sp->GetPropertyAtIndexAsOptionValuePathMappings(nullptr, 3843 false, idx); 3844 assert(option_value); 3845 return option_value->GetCurrentValue(); 3846 } 3847 3848 FileSpecList &TargetProperties::GetExecutableSearchPaths() { 3849 const uint32_t idx = ePropertyExecutableSearchPaths; 3850 OptionValueFileSpecList *option_value = 3851 m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr, 3852 false, idx); 3853 assert(option_value); 3854 return option_value->GetCurrentValue(); 3855 } 3856 3857 FileSpecList &TargetProperties::GetDebugFileSearchPaths() { 3858 const uint32_t idx = ePropertyDebugFileSearchPaths; 3859 OptionValueFileSpecList *option_value = 3860 m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr, 3861 false, idx); 3862 assert(option_value); 3863 return option_value->GetCurrentValue(); 3864 } 3865 3866 FileSpecList &TargetProperties::GetClangModuleSearchPaths() { 3867 const uint32_t idx = ePropertyClangModuleSearchPaths; 3868 OptionValueFileSpecList *option_value = 3869 m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpecList(nullptr, 3870 false, idx); 3871 assert(option_value); 3872 return option_value->GetCurrentValue(); 3873 } 3874 3875 bool TargetProperties::GetEnableAutoImportClangModules() const { 3876 const uint32_t idx = ePropertyAutoImportClangModules; 3877 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3878 nullptr, idx, g_properties[idx].default_uint_value != 0); 3879 } 3880 3881 bool TargetProperties::GetEnableAutoApplyFixIts() const { 3882 const uint32_t idx = ePropertyAutoApplyFixIts; 3883 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3884 nullptr, idx, g_properties[idx].default_uint_value != 0); 3885 } 3886 3887 bool TargetProperties::GetEnableNotifyAboutFixIts() const { 3888 const uint32_t idx = ePropertyNotifyAboutFixIts; 3889 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3890 nullptr, idx, g_properties[idx].default_uint_value != 0); 3891 } 3892 3893 bool TargetProperties::GetEnableSaveObjects() const { 3894 const uint32_t idx = ePropertySaveObjects; 3895 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3896 nullptr, idx, g_properties[idx].default_uint_value != 0); 3897 } 3898 3899 bool TargetProperties::GetEnableSyntheticValue() const { 3900 const uint32_t idx = ePropertyEnableSynthetic; 3901 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3902 nullptr, idx, g_properties[idx].default_uint_value != 0); 3903 } 3904 3905 uint32_t TargetProperties::GetMaximumNumberOfChildrenToDisplay() const { 3906 const uint32_t idx = ePropertyMaxChildrenCount; 3907 return m_collection_sp->GetPropertyAtIndexAsSInt64( 3908 nullptr, idx, g_properties[idx].default_uint_value); 3909 } 3910 3911 uint32_t TargetProperties::GetMaximumSizeOfStringSummary() const { 3912 const uint32_t idx = ePropertyMaxSummaryLength; 3913 return m_collection_sp->GetPropertyAtIndexAsSInt64( 3914 nullptr, idx, g_properties[idx].default_uint_value); 3915 } 3916 3917 uint32_t TargetProperties::GetMaximumMemReadSize() const { 3918 const uint32_t idx = ePropertyMaxMemReadSize; 3919 return m_collection_sp->GetPropertyAtIndexAsSInt64( 3920 nullptr, idx, g_properties[idx].default_uint_value); 3921 } 3922 3923 FileSpec TargetProperties::GetStandardInputPath() const { 3924 const uint32_t idx = ePropertyInputPath; 3925 return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx); 3926 } 3927 3928 void TargetProperties::SetStandardInputPath(llvm::StringRef path) { 3929 const uint32_t idx = ePropertyInputPath; 3930 m_collection_sp->SetPropertyAtIndexAsString(nullptr, idx, path); 3931 } 3932 3933 FileSpec TargetProperties::GetStandardOutputPath() const { 3934 const uint32_t idx = ePropertyOutputPath; 3935 return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx); 3936 } 3937 3938 void TargetProperties::SetStandardOutputPath(llvm::StringRef path) { 3939 const uint32_t idx = ePropertyOutputPath; 3940 m_collection_sp->SetPropertyAtIndexAsString(nullptr, idx, path); 3941 } 3942 3943 FileSpec TargetProperties::GetStandardErrorPath() const { 3944 const uint32_t idx = ePropertyErrorPath; 3945 return m_collection_sp->GetPropertyAtIndexAsFileSpec(nullptr, idx); 3946 } 3947 3948 void TargetProperties::SetStandardErrorPath(llvm::StringRef path) { 3949 const uint32_t idx = ePropertyErrorPath; 3950 m_collection_sp->SetPropertyAtIndexAsString(nullptr, idx, path); 3951 } 3952 3953 LanguageType TargetProperties::GetLanguage() const { 3954 OptionValueLanguage *value = 3955 m_collection_sp->GetPropertyAtIndexAsOptionValueLanguage( 3956 nullptr, ePropertyLanguage); 3957 if (value) 3958 return value->GetCurrentValue(); 3959 return LanguageType(); 3960 } 3961 3962 llvm::StringRef TargetProperties::GetExpressionPrefixContents() { 3963 const uint32_t idx = ePropertyExprPrefix; 3964 OptionValueFileSpec *file = 3965 m_collection_sp->GetPropertyAtIndexAsOptionValueFileSpec(nullptr, false, 3966 idx); 3967 if (file) { 3968 DataBufferSP data_sp(file->GetFileContents()); 3969 if (data_sp) 3970 return llvm::StringRef( 3971 reinterpret_cast<const char *>(data_sp->GetBytes()), 3972 data_sp->GetByteSize()); 3973 } 3974 return ""; 3975 } 3976 3977 bool TargetProperties::GetBreakpointsConsultPlatformAvoidList() { 3978 const uint32_t idx = ePropertyBreakpointUseAvoidList; 3979 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3980 nullptr, idx, g_properties[idx].default_uint_value != 0); 3981 } 3982 3983 bool TargetProperties::GetUseHexImmediates() const { 3984 const uint32_t idx = ePropertyUseHexImmediates; 3985 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3986 nullptr, idx, g_properties[idx].default_uint_value != 0); 3987 } 3988 3989 bool TargetProperties::GetUseFastStepping() const { 3990 const uint32_t idx = ePropertyUseFastStepping; 3991 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3992 nullptr, idx, g_properties[idx].default_uint_value != 0); 3993 } 3994 3995 bool TargetProperties::GetDisplayExpressionsInCrashlogs() const { 3996 const uint32_t idx = ePropertyDisplayExpressionsInCrashlogs; 3997 return m_collection_sp->GetPropertyAtIndexAsBoolean( 3998 nullptr, idx, g_properties[idx].default_uint_value != 0); 3999 } 4000 4001 LoadScriptFromSymFile TargetProperties::GetLoadScriptFromSymbolFile() const { 4002 const uint32_t idx = ePropertyLoadScriptFromSymbolFile; 4003 return (LoadScriptFromSymFile) 4004 m_collection_sp->GetPropertyAtIndexAsEnumeration( 4005 nullptr, idx, g_properties[idx].default_uint_value); 4006 } 4007 4008 LoadCWDlldbinitFile TargetProperties::GetLoadCWDlldbinitFile() const { 4009 const uint32_t idx = ePropertyLoadCWDlldbinitFile; 4010 return (LoadCWDlldbinitFile)m_collection_sp->GetPropertyAtIndexAsEnumeration( 4011 nullptr, idx, g_properties[idx].default_uint_value); 4012 } 4013 4014 Disassembler::HexImmediateStyle TargetProperties::GetHexImmediateStyle() const { 4015 const uint32_t idx = ePropertyHexImmediateStyle; 4016 return (Disassembler::HexImmediateStyle) 4017 m_collection_sp->GetPropertyAtIndexAsEnumeration( 4018 nullptr, idx, g_properties[idx].default_uint_value); 4019 } 4020 4021 MemoryModuleLoadLevel TargetProperties::GetMemoryModuleLoadLevel() const { 4022 const uint32_t idx = ePropertyMemoryModuleLoadLevel; 4023 return (MemoryModuleLoadLevel) 4024 m_collection_sp->GetPropertyAtIndexAsEnumeration( 4025 nullptr, idx, g_properties[idx].default_uint_value); 4026 } 4027 4028 bool TargetProperties::GetUserSpecifiedTrapHandlerNames(Args &args) const { 4029 const uint32_t idx = ePropertyTrapHandlerNames; 4030 return m_collection_sp->GetPropertyAtIndexAsArgs(nullptr, idx, args); 4031 } 4032 4033 void TargetProperties::SetUserSpecifiedTrapHandlerNames(const Args &args) { 4034 const uint32_t idx = ePropertyTrapHandlerNames; 4035 m_collection_sp->SetPropertyAtIndexFromArgs(nullptr, idx, args); 4036 } 4037 4038 bool TargetProperties::GetDisplayRuntimeSupportValues() const { 4039 const uint32_t idx = ePropertyDisplayRuntimeSupportValues; 4040 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, false); 4041 } 4042 4043 void TargetProperties::SetDisplayRuntimeSupportValues(bool b) { 4044 const uint32_t idx = ePropertyDisplayRuntimeSupportValues; 4045 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 4046 } 4047 4048 bool TargetProperties::GetDisplayRecognizedArguments() const { 4049 const uint32_t idx = ePropertyDisplayRecognizedArguments; 4050 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, false); 4051 } 4052 4053 void TargetProperties::SetDisplayRecognizedArguments(bool b) { 4054 const uint32_t idx = ePropertyDisplayRecognizedArguments; 4055 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 4056 } 4057 4058 bool TargetProperties::GetNonStopModeEnabled() const { 4059 const uint32_t idx = ePropertyNonStopModeEnabled; 4060 return m_collection_sp->GetPropertyAtIndexAsBoolean(nullptr, idx, false); 4061 } 4062 4063 void TargetProperties::SetNonStopModeEnabled(bool b) { 4064 const uint32_t idx = ePropertyNonStopModeEnabled; 4065 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 4066 } 4067 4068 const ProcessLaunchInfo &TargetProperties::GetProcessLaunchInfo() { 4069 m_launch_info.SetArg0(GetArg0()); // FIXME: Arg0 callback doesn't work 4070 return m_launch_info; 4071 } 4072 4073 void TargetProperties::SetProcessLaunchInfo( 4074 const ProcessLaunchInfo &launch_info) { 4075 m_launch_info = launch_info; 4076 SetArg0(launch_info.GetArg0()); 4077 SetRunArguments(launch_info.GetArguments()); 4078 SetEnvironment(launch_info.GetEnvironment()); 4079 const FileAction *input_file_action = 4080 launch_info.GetFileActionForFD(STDIN_FILENO); 4081 if (input_file_action) { 4082 SetStandardInputPath(input_file_action->GetPath()); 4083 } 4084 const FileAction *output_file_action = 4085 launch_info.GetFileActionForFD(STDOUT_FILENO); 4086 if (output_file_action) { 4087 SetStandardOutputPath(output_file_action->GetPath()); 4088 } 4089 const FileAction *error_file_action = 4090 launch_info.GetFileActionForFD(STDERR_FILENO); 4091 if (error_file_action) { 4092 SetStandardErrorPath(error_file_action->GetPath()); 4093 } 4094 SetDetachOnError(launch_info.GetFlags().Test(lldb::eLaunchFlagDetachOnError)); 4095 SetDisableASLR(launch_info.GetFlags().Test(lldb::eLaunchFlagDisableASLR)); 4096 SetDisableSTDIO(launch_info.GetFlags().Test(lldb::eLaunchFlagDisableSTDIO)); 4097 } 4098 4099 bool TargetProperties::GetRequireHardwareBreakpoints() const { 4100 const uint32_t idx = ePropertyRequireHardwareBreakpoints; 4101 return m_collection_sp->GetPropertyAtIndexAsBoolean( 4102 nullptr, idx, g_properties[idx].default_uint_value != 0); 4103 } 4104 4105 void TargetProperties::SetRequireHardwareBreakpoints(bool b) { 4106 const uint32_t idx = ePropertyRequireHardwareBreakpoints; 4107 m_collection_sp->SetPropertyAtIndexAsBoolean(nullptr, idx, b); 4108 } 4109 4110 void TargetProperties::Arg0ValueChangedCallback(void *target_property_ptr, 4111 OptionValue *) { 4112 TargetProperties *this_ = 4113 reinterpret_cast<TargetProperties *>(target_property_ptr); 4114 this_->m_launch_info.SetArg0(this_->GetArg0()); 4115 } 4116 4117 void TargetProperties::RunArgsValueChangedCallback(void *target_property_ptr, 4118 OptionValue *) { 4119 TargetProperties *this_ = 4120 reinterpret_cast<TargetProperties *>(target_property_ptr); 4121 Args args; 4122 if (this_->GetRunArguments(args)) 4123 this_->m_launch_info.GetArguments() = args; 4124 } 4125 4126 void TargetProperties::EnvVarsValueChangedCallback(void *target_property_ptr, 4127 OptionValue *) { 4128 TargetProperties *this_ = 4129 reinterpret_cast<TargetProperties *>(target_property_ptr); 4130 this_->m_launch_info.GetEnvironment() = this_->GetEnvironment(); 4131 } 4132 4133 void TargetProperties::InputPathValueChangedCallback(void *target_property_ptr, 4134 OptionValue *) { 4135 TargetProperties *this_ = 4136 reinterpret_cast<TargetProperties *>(target_property_ptr); 4137 this_->m_launch_info.AppendOpenFileAction( 4138 STDIN_FILENO, this_->GetStandardInputPath(), true, false); 4139 } 4140 4141 void TargetProperties::OutputPathValueChangedCallback(void *target_property_ptr, 4142 OptionValue *) { 4143 TargetProperties *this_ = 4144 reinterpret_cast<TargetProperties *>(target_property_ptr); 4145 this_->m_launch_info.AppendOpenFileAction( 4146 STDOUT_FILENO, this_->GetStandardOutputPath(), false, true); 4147 } 4148 4149 void TargetProperties::ErrorPathValueChangedCallback(void *target_property_ptr, 4150 OptionValue *) { 4151 TargetProperties *this_ = 4152 reinterpret_cast<TargetProperties *>(target_property_ptr); 4153 this_->m_launch_info.AppendOpenFileAction( 4154 STDERR_FILENO, this_->GetStandardErrorPath(), false, true); 4155 } 4156 4157 void TargetProperties::DetachOnErrorValueChangedCallback( 4158 void *target_property_ptr, OptionValue *) { 4159 TargetProperties *this_ = 4160 reinterpret_cast<TargetProperties *>(target_property_ptr); 4161 if (this_->GetDetachOnError()) 4162 this_->m_launch_info.GetFlags().Set(lldb::eLaunchFlagDetachOnError); 4163 else 4164 this_->m_launch_info.GetFlags().Clear(lldb::eLaunchFlagDetachOnError); 4165 } 4166 4167 void TargetProperties::DisableASLRValueChangedCallback( 4168 void *target_property_ptr, OptionValue *) { 4169 TargetProperties *this_ = 4170 reinterpret_cast<TargetProperties *>(target_property_ptr); 4171 if (this_->GetDisableASLR()) 4172 this_->m_launch_info.GetFlags().Set(lldb::eLaunchFlagDisableASLR); 4173 else 4174 this_->m_launch_info.GetFlags().Clear(lldb::eLaunchFlagDisableASLR); 4175 } 4176 4177 void TargetProperties::DisableSTDIOValueChangedCallback( 4178 void *target_property_ptr, OptionValue *) { 4179 TargetProperties *this_ = 4180 reinterpret_cast<TargetProperties *>(target_property_ptr); 4181 if (this_->GetDisableSTDIO()) 4182 this_->m_launch_info.GetFlags().Set(lldb::eLaunchFlagDisableSTDIO); 4183 else 4184 this_->m_launch_info.GetFlags().Clear(lldb::eLaunchFlagDisableSTDIO); 4185 } 4186 4187 //---------------------------------------------------------------------- 4188 // Target::TargetEventData 4189 //---------------------------------------------------------------------- 4190 4191 Target::TargetEventData::TargetEventData(const lldb::TargetSP &target_sp) 4192 : EventData(), m_target_sp(target_sp), m_module_list() {} 4193 4194 Target::TargetEventData::TargetEventData(const lldb::TargetSP &target_sp, 4195 const ModuleList &module_list) 4196 : EventData(), m_target_sp(target_sp), m_module_list(module_list) {} 4197 4198 Target::TargetEventData::~TargetEventData() = default; 4199 4200 const ConstString &Target::TargetEventData::GetFlavorString() { 4201 static ConstString g_flavor("Target::TargetEventData"); 4202 return g_flavor; 4203 } 4204 4205 void Target::TargetEventData::Dump(Stream *s) const { 4206 for (size_t i = 0; i < m_module_list.GetSize(); ++i) { 4207 if (i != 0) 4208 *s << ", "; 4209 m_module_list.GetModuleAtIndex(i)->GetDescription( 4210 s, lldb::eDescriptionLevelBrief); 4211 } 4212 } 4213 4214 const Target::TargetEventData * 4215 Target::TargetEventData::GetEventDataFromEvent(const Event *event_ptr) { 4216 if (event_ptr) { 4217 const EventData *event_data = event_ptr->GetData(); 4218 if (event_data && 4219 event_data->GetFlavor() == TargetEventData::GetFlavorString()) 4220 return static_cast<const TargetEventData *>(event_ptr->GetData()); 4221 } 4222 return nullptr; 4223 } 4224 4225 TargetSP Target::TargetEventData::GetTargetFromEvent(const Event *event_ptr) { 4226 TargetSP target_sp; 4227 const TargetEventData *event_data = GetEventDataFromEvent(event_ptr); 4228 if (event_data) 4229 target_sp = event_data->m_target_sp; 4230 return target_sp; 4231 } 4232 4233 ModuleList 4234 Target::TargetEventData::GetModuleListFromEvent(const Event *event_ptr) { 4235 ModuleList module_list; 4236 const TargetEventData *event_data = GetEventDataFromEvent(event_ptr); 4237 if (event_data) 4238 module_list = event_data->m_module_list; 4239 return module_list; 4240 } 4241