1 //===-- SBBreakpointName.cpp ----------------------------------------------===// 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/API/SBBreakpointName.h" 10 #include "lldb/API/SBDebugger.h" 11 #include "lldb/API/SBError.h" 12 #include "lldb/API/SBStream.h" 13 #include "lldb/API/SBStringList.h" 14 #include "lldb/API/SBStructuredData.h" 15 #include "lldb/API/SBTarget.h" 16 #include "lldb/Utility/Instrumentation.h" 17 18 #include "lldb/Breakpoint/BreakpointName.h" 19 #include "lldb/Breakpoint/StoppointCallbackContext.h" 20 #include "lldb/Core/Debugger.h" 21 #include "lldb/Core/StructuredDataImpl.h" 22 #include "lldb/Interpreter/CommandInterpreter.h" 23 #include "lldb/Interpreter/ScriptInterpreter.h" 24 #include "lldb/Target/Target.h" 25 #include "lldb/Target/ThreadSpec.h" 26 #include "lldb/Utility/Stream.h" 27 28 #include "SBBreakpointOptionCommon.h" 29 30 using namespace lldb; 31 using namespace lldb_private; 32 33 namespace lldb 34 { 35 class SBBreakpointNameImpl { 36 public: 37 SBBreakpointNameImpl(TargetSP target_sp, const char *name) { 38 if (!name || name[0] == '\0') 39 return; 40 m_name.assign(name); 41 42 if (!target_sp) 43 return; 44 45 m_target_wp = target_sp; 46 } 47 48 SBBreakpointNameImpl(SBTarget &sb_target, const char *name); 49 bool operator==(const SBBreakpointNameImpl &rhs); 50 bool operator!=(const SBBreakpointNameImpl &rhs); 51 52 // For now we take a simple approach and only keep the name, and relook up 53 // the location when we need it. 54 55 TargetSP GetTarget() const { 56 return m_target_wp.lock(); 57 } 58 59 const char *GetName() const { 60 return m_name.c_str(); 61 } 62 63 bool IsValid() const { 64 return !m_name.empty() && m_target_wp.lock(); 65 } 66 67 lldb_private::BreakpointName *GetBreakpointName() const; 68 69 private: 70 TargetWP m_target_wp; 71 std::string m_name; 72 }; 73 74 SBBreakpointNameImpl::SBBreakpointNameImpl(SBTarget &sb_target, 75 const char *name) { 76 if (!name || name[0] == '\0') 77 return; 78 m_name.assign(name); 79 80 if (!sb_target.IsValid()) 81 return; 82 83 TargetSP target_sp = sb_target.GetSP(); 84 if (!target_sp) 85 return; 86 87 m_target_wp = target_sp; 88 } 89 90 bool SBBreakpointNameImpl::operator==(const SBBreakpointNameImpl &rhs) { 91 return m_name == rhs.m_name && m_target_wp.lock() == rhs.m_target_wp.lock(); 92 } 93 94 bool SBBreakpointNameImpl::operator!=(const SBBreakpointNameImpl &rhs) { 95 return m_name != rhs.m_name || m_target_wp.lock() != rhs.m_target_wp.lock(); 96 } 97 98 lldb_private::BreakpointName *SBBreakpointNameImpl::GetBreakpointName() const { 99 if (!IsValid()) 100 return nullptr; 101 TargetSP target_sp = GetTarget(); 102 if (!target_sp) 103 return nullptr; 104 Status error; 105 return target_sp->FindBreakpointName(ConstString(m_name), true, error); 106 } 107 108 } // namespace lldb 109 110 SBBreakpointName::SBBreakpointName() { LLDB_INSTRUMENT_VA(this); } 111 112 SBBreakpointName::SBBreakpointName(SBTarget &sb_target, const char *name) { 113 LLDB_INSTRUMENT_VA(this, sb_target, name); 114 115 m_impl_up = std::make_unique<SBBreakpointNameImpl>(sb_target, name); 116 // Call FindBreakpointName here to make sure the name is valid, reset if not: 117 BreakpointName *bp_name = GetBreakpointName(); 118 if (!bp_name) 119 m_impl_up.reset(); 120 } 121 122 SBBreakpointName::SBBreakpointName(SBBreakpoint &sb_bkpt, const char *name) { 123 LLDB_INSTRUMENT_VA(this, sb_bkpt, name); 124 125 if (!sb_bkpt.IsValid()) { 126 m_impl_up.reset(); 127 return; 128 } 129 BreakpointSP bkpt_sp = sb_bkpt.GetSP(); 130 Target &target = bkpt_sp->GetTarget(); 131 132 m_impl_up = 133 std::make_unique<SBBreakpointNameImpl>(target.shared_from_this(), name); 134 135 // Call FindBreakpointName here to make sure the name is valid, reset if not: 136 BreakpointName *bp_name = GetBreakpointName(); 137 if (!bp_name) { 138 m_impl_up.reset(); 139 return; 140 } 141 142 // Now copy over the breakpoint's options: 143 target.ConfigureBreakpointName(*bp_name, bkpt_sp->GetOptions(), 144 BreakpointName::Permissions()); 145 } 146 147 SBBreakpointName::SBBreakpointName(const SBBreakpointName &rhs) { 148 LLDB_INSTRUMENT_VA(this, rhs); 149 150 if (!rhs.m_impl_up) 151 return; 152 else 153 m_impl_up = std::make_unique<SBBreakpointNameImpl>( 154 rhs.m_impl_up->GetTarget(), rhs.m_impl_up->GetName()); 155 } 156 157 SBBreakpointName::~SBBreakpointName() = default; 158 159 const SBBreakpointName &SBBreakpointName:: 160 operator=(const SBBreakpointName &rhs) { 161 LLDB_INSTRUMENT_VA(this, rhs); 162 163 if (!rhs.m_impl_up) { 164 m_impl_up.reset(); 165 return *this; 166 } 167 168 m_impl_up = std::make_unique<SBBreakpointNameImpl>(rhs.m_impl_up->GetTarget(), 169 rhs.m_impl_up->GetName()); 170 return *this; 171 } 172 173 bool SBBreakpointName::operator==(const lldb::SBBreakpointName &rhs) { 174 LLDB_INSTRUMENT_VA(this, rhs); 175 176 return *m_impl_up == *rhs.m_impl_up; 177 } 178 179 bool SBBreakpointName::operator!=(const lldb::SBBreakpointName &rhs) { 180 LLDB_INSTRUMENT_VA(this, rhs); 181 182 return *m_impl_up != *rhs.m_impl_up; 183 } 184 185 bool SBBreakpointName::IsValid() const { 186 LLDB_INSTRUMENT_VA(this); 187 return this->operator bool(); 188 } 189 SBBreakpointName::operator bool() const { 190 LLDB_INSTRUMENT_VA(this); 191 192 if (!m_impl_up) 193 return false; 194 return m_impl_up->IsValid(); 195 } 196 197 const char *SBBreakpointName::GetName() const { 198 LLDB_INSTRUMENT_VA(this); 199 200 if (!m_impl_up) 201 return "<Invalid Breakpoint Name Object>"; 202 return m_impl_up->GetName(); 203 } 204 205 void SBBreakpointName::SetEnabled(bool enable) { 206 LLDB_INSTRUMENT_VA(this, enable); 207 208 BreakpointName *bp_name = GetBreakpointName(); 209 if (!bp_name) 210 return; 211 212 std::lock_guard<std::recursive_mutex> guard( 213 m_impl_up->GetTarget()->GetAPIMutex()); 214 215 bp_name->GetOptions().SetEnabled(enable); 216 } 217 218 void SBBreakpointName::UpdateName(BreakpointName &bp_name) { 219 if (!IsValid()) 220 return; 221 222 TargetSP target_sp = m_impl_up->GetTarget(); 223 if (!target_sp) 224 return; 225 target_sp->ApplyNameToBreakpoints(bp_name); 226 227 } 228 229 bool SBBreakpointName::IsEnabled() { 230 LLDB_INSTRUMENT_VA(this); 231 232 BreakpointName *bp_name = GetBreakpointName(); 233 if (!bp_name) 234 return false; 235 236 std::lock_guard<std::recursive_mutex> guard( 237 m_impl_up->GetTarget()->GetAPIMutex()); 238 239 return bp_name->GetOptions().IsEnabled(); 240 } 241 242 void SBBreakpointName::SetOneShot(bool one_shot) { 243 LLDB_INSTRUMENT_VA(this, one_shot); 244 245 BreakpointName *bp_name = GetBreakpointName(); 246 if (!bp_name) 247 return; 248 249 std::lock_guard<std::recursive_mutex> guard( 250 m_impl_up->GetTarget()->GetAPIMutex()); 251 252 bp_name->GetOptions().SetOneShot(one_shot); 253 UpdateName(*bp_name); 254 } 255 256 bool SBBreakpointName::IsOneShot() const { 257 LLDB_INSTRUMENT_VA(this); 258 259 const BreakpointName *bp_name = GetBreakpointName(); 260 if (!bp_name) 261 return false; 262 263 std::lock_guard<std::recursive_mutex> guard( 264 m_impl_up->GetTarget()->GetAPIMutex()); 265 266 return bp_name->GetOptions().IsOneShot(); 267 } 268 269 void SBBreakpointName::SetIgnoreCount(uint32_t count) { 270 LLDB_INSTRUMENT_VA(this, count); 271 272 BreakpointName *bp_name = GetBreakpointName(); 273 if (!bp_name) 274 return; 275 276 std::lock_guard<std::recursive_mutex> guard( 277 m_impl_up->GetTarget()->GetAPIMutex()); 278 279 bp_name->GetOptions().SetIgnoreCount(count); 280 UpdateName(*bp_name); 281 } 282 283 uint32_t SBBreakpointName::GetIgnoreCount() const { 284 LLDB_INSTRUMENT_VA(this); 285 286 BreakpointName *bp_name = GetBreakpointName(); 287 if (!bp_name) 288 return false; 289 290 std::lock_guard<std::recursive_mutex> guard( 291 m_impl_up->GetTarget()->GetAPIMutex()); 292 293 return bp_name->GetOptions().GetIgnoreCount(); 294 } 295 296 void SBBreakpointName::SetCondition(const char *condition) { 297 LLDB_INSTRUMENT_VA(this, condition); 298 299 BreakpointName *bp_name = GetBreakpointName(); 300 if (!bp_name) 301 return; 302 303 std::lock_guard<std::recursive_mutex> guard( 304 m_impl_up->GetTarget()->GetAPIMutex()); 305 306 bp_name->GetOptions().SetCondition(condition); 307 UpdateName(*bp_name); 308 } 309 310 const char *SBBreakpointName::GetCondition() { 311 LLDB_INSTRUMENT_VA(this); 312 313 BreakpointName *bp_name = GetBreakpointName(); 314 if (!bp_name) 315 return nullptr; 316 317 std::lock_guard<std::recursive_mutex> guard( 318 m_impl_up->GetTarget()->GetAPIMutex()); 319 320 return bp_name->GetOptions().GetConditionText(); 321 } 322 323 void SBBreakpointName::SetAutoContinue(bool auto_continue) { 324 LLDB_INSTRUMENT_VA(this, auto_continue); 325 326 BreakpointName *bp_name = GetBreakpointName(); 327 if (!bp_name) 328 return; 329 330 std::lock_guard<std::recursive_mutex> guard( 331 m_impl_up->GetTarget()->GetAPIMutex()); 332 333 bp_name->GetOptions().SetAutoContinue(auto_continue); 334 UpdateName(*bp_name); 335 } 336 337 bool SBBreakpointName::GetAutoContinue() { 338 LLDB_INSTRUMENT_VA(this); 339 340 BreakpointName *bp_name = GetBreakpointName(); 341 if (!bp_name) 342 return false; 343 344 std::lock_guard<std::recursive_mutex> guard( 345 m_impl_up->GetTarget()->GetAPIMutex()); 346 347 return bp_name->GetOptions().IsAutoContinue(); 348 } 349 350 void SBBreakpointName::SetThreadID(tid_t tid) { 351 LLDB_INSTRUMENT_VA(this, tid); 352 353 BreakpointName *bp_name = GetBreakpointName(); 354 if (!bp_name) 355 return; 356 357 std::lock_guard<std::recursive_mutex> guard( 358 m_impl_up->GetTarget()->GetAPIMutex()); 359 360 bp_name->GetOptions().SetThreadID(tid); 361 UpdateName(*bp_name); 362 } 363 364 tid_t SBBreakpointName::GetThreadID() { 365 LLDB_INSTRUMENT_VA(this); 366 367 BreakpointName *bp_name = GetBreakpointName(); 368 if (!bp_name) 369 return LLDB_INVALID_THREAD_ID; 370 371 std::lock_guard<std::recursive_mutex> guard( 372 m_impl_up->GetTarget()->GetAPIMutex()); 373 374 return bp_name->GetOptions().GetThreadSpec()->GetTID(); 375 } 376 377 void SBBreakpointName::SetThreadIndex(uint32_t index) { 378 LLDB_INSTRUMENT_VA(this, index); 379 380 BreakpointName *bp_name = GetBreakpointName(); 381 if (!bp_name) 382 return; 383 384 std::lock_guard<std::recursive_mutex> guard( 385 m_impl_up->GetTarget()->GetAPIMutex()); 386 387 bp_name->GetOptions().GetThreadSpec()->SetIndex(index); 388 UpdateName(*bp_name); 389 } 390 391 uint32_t SBBreakpointName::GetThreadIndex() const { 392 LLDB_INSTRUMENT_VA(this); 393 394 BreakpointName *bp_name = GetBreakpointName(); 395 if (!bp_name) 396 return LLDB_INVALID_THREAD_ID; 397 398 std::lock_guard<std::recursive_mutex> guard( 399 m_impl_up->GetTarget()->GetAPIMutex()); 400 401 return bp_name->GetOptions().GetThreadSpec()->GetIndex(); 402 } 403 404 void SBBreakpointName::SetThreadName(const char *thread_name) { 405 LLDB_INSTRUMENT_VA(this, thread_name); 406 407 BreakpointName *bp_name = GetBreakpointName(); 408 if (!bp_name) 409 return; 410 411 std::lock_guard<std::recursive_mutex> guard( 412 m_impl_up->GetTarget()->GetAPIMutex()); 413 414 bp_name->GetOptions().GetThreadSpec()->SetName(thread_name); 415 UpdateName(*bp_name); 416 } 417 418 const char *SBBreakpointName::GetThreadName() const { 419 LLDB_INSTRUMENT_VA(this); 420 421 BreakpointName *bp_name = GetBreakpointName(); 422 if (!bp_name) 423 return nullptr; 424 425 std::lock_guard<std::recursive_mutex> guard( 426 m_impl_up->GetTarget()->GetAPIMutex()); 427 428 return bp_name->GetOptions().GetThreadSpec()->GetName(); 429 } 430 431 void SBBreakpointName::SetQueueName(const char *queue_name) { 432 LLDB_INSTRUMENT_VA(this, queue_name); 433 434 BreakpointName *bp_name = GetBreakpointName(); 435 if (!bp_name) 436 return; 437 438 std::lock_guard<std::recursive_mutex> guard( 439 m_impl_up->GetTarget()->GetAPIMutex()); 440 441 bp_name->GetOptions().GetThreadSpec()->SetQueueName(queue_name); 442 UpdateName(*bp_name); 443 } 444 445 const char *SBBreakpointName::GetQueueName() const { 446 LLDB_INSTRUMENT_VA(this); 447 448 BreakpointName *bp_name = GetBreakpointName(); 449 if (!bp_name) 450 return nullptr; 451 452 std::lock_guard<std::recursive_mutex> guard( 453 m_impl_up->GetTarget()->GetAPIMutex()); 454 455 return bp_name->GetOptions().GetThreadSpec()->GetQueueName(); 456 } 457 458 void SBBreakpointName::SetCommandLineCommands(SBStringList &commands) { 459 LLDB_INSTRUMENT_VA(this, commands); 460 461 BreakpointName *bp_name = GetBreakpointName(); 462 if (!bp_name) 463 return; 464 if (commands.GetSize() == 0) 465 return; 466 467 468 std::lock_guard<std::recursive_mutex> guard( 469 m_impl_up->GetTarget()->GetAPIMutex()); 470 std::unique_ptr<BreakpointOptions::CommandData> cmd_data_up( 471 new BreakpointOptions::CommandData(*commands, eScriptLanguageNone)); 472 473 bp_name->GetOptions().SetCommandDataCallback(cmd_data_up); 474 UpdateName(*bp_name); 475 } 476 477 bool SBBreakpointName::GetCommandLineCommands(SBStringList &commands) { 478 LLDB_INSTRUMENT_VA(this, commands); 479 480 BreakpointName *bp_name = GetBreakpointName(); 481 if (!bp_name) 482 return false; 483 484 StringList command_list; 485 bool has_commands = 486 bp_name->GetOptions().GetCommandLineCallbacks(command_list); 487 if (has_commands) 488 commands.AppendList(command_list); 489 return has_commands; 490 } 491 492 const char *SBBreakpointName::GetHelpString() const { 493 LLDB_INSTRUMENT_VA(this); 494 495 BreakpointName *bp_name = GetBreakpointName(); 496 if (!bp_name) 497 return ""; 498 499 return bp_name->GetHelp(); 500 } 501 502 void SBBreakpointName::SetHelpString(const char *help_string) { 503 LLDB_INSTRUMENT_VA(this, help_string); 504 505 BreakpointName *bp_name = GetBreakpointName(); 506 if (!bp_name) 507 return; 508 509 510 std::lock_guard<std::recursive_mutex> guard( 511 m_impl_up->GetTarget()->GetAPIMutex()); 512 bp_name->SetHelp(help_string); 513 } 514 515 bool SBBreakpointName::GetDescription(SBStream &s) { 516 LLDB_INSTRUMENT_VA(this, s); 517 518 BreakpointName *bp_name = GetBreakpointName(); 519 if (!bp_name) 520 { 521 s.Printf("No value"); 522 return false; 523 } 524 525 std::lock_guard<std::recursive_mutex> guard( 526 m_impl_up->GetTarget()->GetAPIMutex()); 527 bp_name->GetDescription(s.get(), eDescriptionLevelFull); 528 return true; 529 } 530 531 void SBBreakpointName::SetCallback(SBBreakpointHitCallback callback, 532 void *baton) { 533 LLDB_INSTRUMENT_VA(this, callback, baton); 534 535 BreakpointName *bp_name = GetBreakpointName(); 536 if (!bp_name) 537 return; 538 std::lock_guard<std::recursive_mutex> guard( 539 m_impl_up->GetTarget()->GetAPIMutex()); 540 541 BatonSP baton_sp(new SBBreakpointCallbackBaton(callback, baton)); 542 bp_name->GetOptions().SetCallback(SBBreakpointCallbackBaton 543 ::PrivateBreakpointHitCallback, 544 baton_sp, 545 false); 546 UpdateName(*bp_name); 547 } 548 549 void SBBreakpointName::SetScriptCallbackFunction( 550 const char *callback_function_name) { 551 LLDB_INSTRUMENT_VA(this, callback_function_name); 552 SBStructuredData empty_args; 553 SetScriptCallbackFunction(callback_function_name, empty_args); 554 } 555 556 SBError SBBreakpointName::SetScriptCallbackFunction( 557 const char *callback_function_name, 558 SBStructuredData &extra_args) { 559 LLDB_INSTRUMENT_VA(this, callback_function_name, extra_args); 560 SBError sb_error; 561 BreakpointName *bp_name = GetBreakpointName(); 562 if (!bp_name) { 563 sb_error.SetErrorString("unrecognized breakpoint name"); 564 return sb_error; 565 } 566 567 std::lock_guard<std::recursive_mutex> guard( 568 m_impl_up->GetTarget()->GetAPIMutex()); 569 570 BreakpointOptions &bp_options = bp_name->GetOptions(); 571 Status error; 572 error = m_impl_up->GetTarget() 573 ->GetDebugger() 574 .GetScriptInterpreter() 575 ->SetBreakpointCommandCallbackFunction( 576 bp_options, callback_function_name, 577 extra_args.m_impl_up->GetObjectSP()); 578 sb_error.SetError(error); 579 UpdateName(*bp_name); 580 return sb_error; 581 } 582 583 SBError 584 SBBreakpointName::SetScriptCallbackBody(const char *callback_body_text) { 585 LLDB_INSTRUMENT_VA(this, callback_body_text); 586 587 SBError sb_error; 588 BreakpointName *bp_name = GetBreakpointName(); 589 if (!bp_name) 590 return sb_error; 591 592 std::lock_guard<std::recursive_mutex> guard( 593 m_impl_up->GetTarget()->GetAPIMutex()); 594 595 BreakpointOptions &bp_options = bp_name->GetOptions(); 596 Status error = 597 m_impl_up->GetTarget() 598 ->GetDebugger() 599 .GetScriptInterpreter() 600 ->SetBreakpointCommandCallback(bp_options, callback_body_text); 601 sb_error.SetError(error); 602 if (!sb_error.Fail()) 603 UpdateName(*bp_name); 604 605 return sb_error; 606 } 607 608 bool SBBreakpointName::GetAllowList() const { 609 LLDB_INSTRUMENT_VA(this); 610 611 BreakpointName *bp_name = GetBreakpointName(); 612 if (!bp_name) 613 return false; 614 return bp_name->GetPermissions().GetAllowList(); 615 } 616 617 void SBBreakpointName::SetAllowList(bool value) { 618 LLDB_INSTRUMENT_VA(this, value); 619 620 BreakpointName *bp_name = GetBreakpointName(); 621 if (!bp_name) 622 return; 623 bp_name->GetPermissions().SetAllowList(value); 624 } 625 626 bool SBBreakpointName::GetAllowDelete() { 627 LLDB_INSTRUMENT_VA(this); 628 629 BreakpointName *bp_name = GetBreakpointName(); 630 if (!bp_name) 631 return false; 632 return bp_name->GetPermissions().GetAllowDelete(); 633 } 634 635 void SBBreakpointName::SetAllowDelete(bool value) { 636 LLDB_INSTRUMENT_VA(this, value); 637 638 BreakpointName *bp_name = GetBreakpointName(); 639 if (!bp_name) 640 return; 641 bp_name->GetPermissions().SetAllowDelete(value); 642 } 643 644 bool SBBreakpointName::GetAllowDisable() { 645 LLDB_INSTRUMENT_VA(this); 646 647 BreakpointName *bp_name = GetBreakpointName(); 648 if (!bp_name) 649 return false; 650 return bp_name->GetPermissions().GetAllowDisable(); 651 } 652 653 void SBBreakpointName::SetAllowDisable(bool value) { 654 LLDB_INSTRUMENT_VA(this, value); 655 656 BreakpointName *bp_name = GetBreakpointName(); 657 if (!bp_name) 658 return; 659 bp_name->GetPermissions().SetAllowDisable(value); 660 } 661 662 lldb_private::BreakpointName *SBBreakpointName::GetBreakpointName() const 663 { 664 if (!IsValid()) 665 return nullptr; 666 return m_impl_up->GetBreakpointName(); 667 } 668