1 //===-- CommandObjectBreakpointCommand.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 "CommandObjectBreakpointCommand.h"
10 #include "CommandObjectBreakpoint.h"
11 #include "lldb/Breakpoint/Breakpoint.h"
12 #include "lldb/Breakpoint/BreakpointIDList.h"
13 #include "lldb/Breakpoint/BreakpointLocation.h"
14 #include "lldb/Core/IOHandler.h"
15 #include "lldb/Host/OptionParser.h"
16 #include "lldb/Interpreter/CommandInterpreter.h"
17 #include "lldb/Interpreter/CommandOptionArgumentTable.h"
18 #include "lldb/Interpreter/CommandReturnObject.h"
19 #include "lldb/Interpreter/OptionArgParser.h"
20 #include "lldb/Interpreter/OptionGroupPythonClassWithDict.h"
21 #include "lldb/Target/Target.h"
22
23 using namespace lldb;
24 using namespace lldb_private;
25
26 #define LLDB_OPTIONS_breakpoint_command_add
27 #include "CommandOptions.inc"
28
29 class CommandObjectBreakpointCommandAdd : public CommandObjectParsed,
30 public IOHandlerDelegateMultiline {
31 public:
CommandObjectBreakpointCommandAdd(CommandInterpreter & interpreter)32 CommandObjectBreakpointCommandAdd(CommandInterpreter &interpreter)
33 : CommandObjectParsed(interpreter, "add",
34 "Add LLDB commands to a breakpoint, to be executed "
35 "whenever the breakpoint is hit. "
36 "The commands added to the breakpoint replace any "
37 "commands previously added to it."
38 " If no breakpoint is specified, adds the "
39 "commands to the last created breakpoint.",
40 nullptr),
41 IOHandlerDelegateMultiline("DONE",
42 IOHandlerDelegate::Completion::LLDBCommand),
43 m_func_options("breakpoint command", false, 'F') {
44 SetHelpLong(
45 R"(
46 General information about entering breakpoint commands
47 ------------------------------------------------------
48
49 )"
50 "This command will prompt for commands to be executed when the specified \
51 breakpoint is hit. Each command is typed on its own line following the '> ' \
52 prompt until 'DONE' is entered."
53 R"(
54
55 )"
56 "Syntactic errors may not be detected when initially entered, and many \
57 malformed commands can silently fail when executed. If your breakpoint commands \
58 do not appear to be executing, double-check the command syntax."
59 R"(
60
61 )"
62 "Note: You may enter any debugger command exactly as you would at the debugger \
63 prompt. There is no limit to the number of commands supplied, but do NOT enter \
64 more than one command per line."
65 R"(
66
67 Special information about PYTHON breakpoint commands
68 ----------------------------------------------------
69
70 )"
71 "You may enter either one or more lines of Python, including function \
72 definitions or calls to functions that will have been imported by the time \
73 the code executes. Single line breakpoint commands will be interpreted 'as is' \
74 when the breakpoint is hit. Multiple lines of Python will be wrapped in a \
75 generated function, and a call to the function will be attached to the breakpoint."
76 R"(
77
78 This auto-generated function is passed in three arguments:
79
80 frame: an lldb.SBFrame object for the frame which hit breakpoint.
81
82 bp_loc: an lldb.SBBreakpointLocation object that represents the breakpoint location that was hit.
83
84 dict: the python session dictionary hit.
85
86 )"
87 "When specifying a python function with the --python-function option, you need \
88 to supply the function name prepended by the module name:"
89 R"(
90
91 --python-function myutils.breakpoint_callback
92
93 The function itself must have either of the following prototypes:
94
95 def breakpoint_callback(frame, bp_loc, internal_dict):
96 # Your code goes here
97
98 or:
99
100 def breakpoint_callback(frame, bp_loc, extra_args, internal_dict):
101 # Your code goes here
102
103 )"
104 "The arguments are the same as the arguments passed to generated functions as \
105 described above. In the second form, any -k and -v pairs provided to the command will \
106 be packaged into a SBDictionary in an SBStructuredData and passed as the extra_args parameter. \
107 \n\n\
108 Note that the global variable 'lldb.frame' will NOT be updated when \
109 this function is called, so be sure to use the 'frame' argument. The 'frame' argument \
110 can get you to the thread via frame.GetThread(), the thread can get you to the \
111 process via thread.GetProcess(), and the process can get you back to the target \
112 via process.GetTarget()."
113 R"(
114
115 )"
116 "Important Note: As Python code gets collected into functions, access to global \
117 variables requires explicit scoping using the 'global' keyword. Be sure to use correct \
118 Python syntax, including indentation, when entering Python breakpoint commands."
119 R"(
120
121 Example Python one-line breakpoint command:
122
123 (lldb) breakpoint command add -s python 1
124 Enter your Python command(s). Type 'DONE' to end.
125 def function (frame, bp_loc, internal_dict):
126 """frame: the lldb.SBFrame for the location at which you stopped
127 bp_loc: an lldb.SBBreakpointLocation for the breakpoint location information
128 internal_dict: an LLDB support object not to be used"""
129 print("Hit this breakpoint!")
130 DONE
131
132 As a convenience, this also works for a short Python one-liner:
133
134 (lldb) breakpoint command add -s python 1 -o 'import time; print(time.asctime())'
135 (lldb) run
136 Launching '.../a.out' (x86_64)
137 (lldb) Fri Sep 10 12:17:45 2010
138 Process 21778 Stopped
139 * thread #1: tid = 0x2e03, 0x0000000100000de8 a.out`c + 7 at main.c:39, stop reason = breakpoint 1.1, queue = com.apple.main-thread
140 36
141 37 int c(int val)
142 38 {
143 39 -> return val + 3;
144 40 }
145 41
146 42 int main (int argc, char const *argv[])
147
148 Example multiple line Python breakpoint command:
149
150 (lldb) breakpoint command add -s p 1
151 Enter your Python command(s). Type 'DONE' to end.
152 def function (frame, bp_loc, internal_dict):
153 """frame: the lldb.SBFrame for the location at which you stopped
154 bp_loc: an lldb.SBBreakpointLocation for the breakpoint location information
155 internal_dict: an LLDB support object not to be used"""
156 global bp_count
157 bp_count = bp_count + 1
158 print("Hit this breakpoint " + repr(bp_count) + " times!")
159 DONE
160
161 )"
162 "In this case, since there is a reference to a global variable, \
163 'bp_count', you will also need to make sure 'bp_count' exists and is \
164 initialized:"
165 R"(
166
167 (lldb) script
168 >>> bp_count = 0
169 >>> quit()
170
171 )"
172 "Your Python code, however organized, can optionally return a value. \
173 If the returned value is False, that tells LLDB not to stop at the breakpoint \
174 to which the code is associated. Returning anything other than False, or even \
175 returning None, or even omitting a return statement entirely, will cause \
176 LLDB to stop."
177 R"(
178
179 )"
180 "Final Note: A warning that no breakpoint command was generated when there \
181 are no syntax errors may indicate that a function was declared but never called.");
182
183 m_all_options.Append(&m_options);
184 m_all_options.Append(&m_func_options, LLDB_OPT_SET_2 | LLDB_OPT_SET_3,
185 LLDB_OPT_SET_2);
186 m_all_options.Finalize();
187
188 CommandArgumentEntry arg;
189 CommandArgumentData bp_id_arg;
190
191 // Define the first (and only) variant of this arg.
192 bp_id_arg.arg_type = eArgTypeBreakpointID;
193 bp_id_arg.arg_repetition = eArgRepeatOptional;
194
195 // There is only one variant this argument could be; put it into the
196 // argument entry.
197 arg.push_back(bp_id_arg);
198
199 // Push the data for the first argument into the m_arguments vector.
200 m_arguments.push_back(arg);
201 }
202
203 ~CommandObjectBreakpointCommandAdd() override = default;
204
GetOptions()205 Options *GetOptions() override { return &m_all_options; }
206
IOHandlerActivated(IOHandler & io_handler,bool interactive)207 void IOHandlerActivated(IOHandler &io_handler, bool interactive) override {
208 StreamFileSP output_sp(io_handler.GetOutputStreamFileSP());
209 if (output_sp && interactive) {
210 output_sp->PutCString(g_reader_instructions);
211 output_sp->Flush();
212 }
213 }
214
IOHandlerInputComplete(IOHandler & io_handler,std::string & line)215 void IOHandlerInputComplete(IOHandler &io_handler,
216 std::string &line) override {
217 io_handler.SetIsDone(true);
218
219 std::vector<std::reference_wrapper<BreakpointOptions>> *bp_options_vec =
220 (std::vector<std::reference_wrapper<BreakpointOptions>> *)
221 io_handler.GetUserData();
222 for (BreakpointOptions &bp_options : *bp_options_vec) {
223 auto cmd_data = std::make_unique<BreakpointOptions::CommandData>();
224 cmd_data->user_source.SplitIntoLines(line.c_str(), line.size());
225 bp_options.SetCommandDataCallback(cmd_data);
226 }
227 }
228
CollectDataForBreakpointCommandCallback(std::vector<std::reference_wrapper<BreakpointOptions>> & bp_options_vec,CommandReturnObject & result)229 void CollectDataForBreakpointCommandCallback(
230 std::vector<std::reference_wrapper<BreakpointOptions>> &bp_options_vec,
231 CommandReturnObject &result) {
232 m_interpreter.GetLLDBCommandsFromIOHandler(
233 "> ", // Prompt
234 *this, // IOHandlerDelegate
235 &bp_options_vec); // Baton for the "io_handler" that will be passed back
236 // into our IOHandlerDelegate functions
237 }
238
239 /// Set a one-liner as the callback for the breakpoint.
SetBreakpointCommandCallback(std::vector<std::reference_wrapper<BreakpointOptions>> & bp_options_vec,const char * oneliner)240 void SetBreakpointCommandCallback(
241 std::vector<std::reference_wrapper<BreakpointOptions>> &bp_options_vec,
242 const char *oneliner) {
243 for (BreakpointOptions &bp_options : bp_options_vec) {
244 auto cmd_data = std::make_unique<BreakpointOptions::CommandData>();
245
246 cmd_data->user_source.AppendString(oneliner);
247 cmd_data->stop_on_error = m_options.m_stop_on_error;
248
249 bp_options.SetCommandDataCallback(cmd_data);
250 }
251 }
252
253 class CommandOptions : public OptionGroup {
254 public:
255 CommandOptions() = default;
256
257 ~CommandOptions() override = default;
258
SetOptionValue(uint32_t option_idx,llvm::StringRef option_arg,ExecutionContext * execution_context)259 Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg,
260 ExecutionContext *execution_context) override {
261 Status error;
262 const int short_option =
263 g_breakpoint_command_add_options[option_idx].short_option;
264
265 switch (short_option) {
266 case 'o':
267 m_use_one_liner = true;
268 m_one_liner = std::string(option_arg);
269 break;
270
271 case 's':
272 m_script_language = (lldb::ScriptLanguage)OptionArgParser::ToOptionEnum(
273 option_arg,
274 g_breakpoint_command_add_options[option_idx].enum_values,
275 eScriptLanguageNone, error);
276 switch (m_script_language) {
277 case eScriptLanguagePython:
278 case eScriptLanguageLua:
279 m_use_script_language = true;
280 break;
281 case eScriptLanguageNone:
282 case eScriptLanguageUnknown:
283 m_use_script_language = false;
284 break;
285 }
286 break;
287
288 case 'e': {
289 bool success = false;
290 m_stop_on_error =
291 OptionArgParser::ToBoolean(option_arg, false, &success);
292 if (!success)
293 error.SetErrorStringWithFormat(
294 "invalid value for stop-on-error: \"%s\"",
295 option_arg.str().c_str());
296 } break;
297
298 case 'D':
299 m_use_dummy = true;
300 break;
301
302 default:
303 llvm_unreachable("Unimplemented option");
304 }
305 return error;
306 }
307
OptionParsingStarting(ExecutionContext * execution_context)308 void OptionParsingStarting(ExecutionContext *execution_context) override {
309 m_use_commands = true;
310 m_use_script_language = false;
311 m_script_language = eScriptLanguageNone;
312
313 m_use_one_liner = false;
314 m_stop_on_error = true;
315 m_one_liner.clear();
316 m_use_dummy = false;
317 }
318
GetDefinitions()319 llvm::ArrayRef<OptionDefinition> GetDefinitions() override {
320 return llvm::ArrayRef(g_breakpoint_command_add_options);
321 }
322
323 // Instance variables to hold the values for command options.
324
325 bool m_use_commands = false;
326 bool m_use_script_language = false;
327 lldb::ScriptLanguage m_script_language = eScriptLanguageNone;
328
329 // Instance variables to hold the values for one_liner options.
330 bool m_use_one_liner = false;
331 std::string m_one_liner;
332 bool m_stop_on_error;
333 bool m_use_dummy;
334 };
335
336 protected:
DoExecute(Args & command,CommandReturnObject & result)337 bool DoExecute(Args &command, CommandReturnObject &result) override {
338 Target &target = GetSelectedOrDummyTarget(m_options.m_use_dummy);
339
340 const BreakpointList &breakpoints = target.GetBreakpointList();
341 size_t num_breakpoints = breakpoints.GetSize();
342
343 if (num_breakpoints == 0) {
344 result.AppendError("No breakpoints exist to have commands added");
345 return false;
346 }
347
348 if (!m_func_options.GetName().empty()) {
349 m_options.m_use_one_liner = false;
350 if (!m_options.m_use_script_language) {
351 m_options.m_script_language = GetDebugger().GetScriptLanguage();
352 m_options.m_use_script_language = true;
353 }
354 }
355
356 BreakpointIDList valid_bp_ids;
357 CommandObjectMultiwordBreakpoint::VerifyBreakpointOrLocationIDs(
358 command, &target, result, &valid_bp_ids,
359 BreakpointName::Permissions::PermissionKinds::listPerm);
360
361 m_bp_options_vec.clear();
362
363 if (result.Succeeded()) {
364 const size_t count = valid_bp_ids.GetSize();
365
366 for (size_t i = 0; i < count; ++i) {
367 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex(i);
368 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID) {
369 Breakpoint *bp =
370 target.GetBreakpointByID(cur_bp_id.GetBreakpointID()).get();
371 if (cur_bp_id.GetLocationID() == LLDB_INVALID_BREAK_ID) {
372 // This breakpoint does not have an associated location.
373 m_bp_options_vec.push_back(bp->GetOptions());
374 } else {
375 BreakpointLocationSP bp_loc_sp(
376 bp->FindLocationByID(cur_bp_id.GetLocationID()));
377 // This breakpoint does have an associated location. Get its
378 // breakpoint options.
379 if (bp_loc_sp)
380 m_bp_options_vec.push_back(bp_loc_sp->GetLocationOptions());
381 }
382 }
383 }
384
385 // If we are using script language, get the script interpreter in order
386 // to set or collect command callback. Otherwise, call the methods
387 // associated with this object.
388 if (m_options.m_use_script_language) {
389 Status error;
390 ScriptInterpreter *script_interp = GetDebugger().GetScriptInterpreter(
391 /*can_create=*/true, m_options.m_script_language);
392 // Special handling for one-liner specified inline.
393 if (m_options.m_use_one_liner) {
394 error = script_interp->SetBreakpointCommandCallback(
395 m_bp_options_vec, m_options.m_one_liner.c_str());
396 } else if (!m_func_options.GetName().empty()) {
397 error = script_interp->SetBreakpointCommandCallbackFunction(
398 m_bp_options_vec, m_func_options.GetName().c_str(),
399 m_func_options.GetStructuredData());
400 } else {
401 script_interp->CollectDataForBreakpointCommandCallback(
402 m_bp_options_vec, result);
403 }
404 if (!error.Success())
405 result.SetError(error);
406 } else {
407 // Special handling for one-liner specified inline.
408 if (m_options.m_use_one_liner)
409 SetBreakpointCommandCallback(m_bp_options_vec,
410 m_options.m_one_liner.c_str());
411 else
412 CollectDataForBreakpointCommandCallback(m_bp_options_vec, result);
413 }
414 }
415
416 return result.Succeeded();
417 }
418
419 private:
420 CommandOptions m_options;
421 OptionGroupPythonClassWithDict m_func_options;
422 OptionGroupOptions m_all_options;
423
424 std::vector<std::reference_wrapper<BreakpointOptions>>
425 m_bp_options_vec; // This stores the
426 // breakpoint options that
427 // we are currently
428 // collecting commands for. In the CollectData... calls we need to hand this
429 // off to the IOHandler, which may run asynchronously. So we have to have
430 // some way to keep it alive, and not leak it. Making it an ivar of the
431 // command object, which never goes away achieves this. Note that if we were
432 // able to run the same command concurrently in one interpreter we'd have to
433 // make this "per invocation". But there are many more reasons why it is not
434 // in general safe to do that in lldb at present, so it isn't worthwhile to
435 // come up with a more complex mechanism to address this particular weakness
436 // right now.
437 static const char *g_reader_instructions;
438 };
439
440 const char *CommandObjectBreakpointCommandAdd::g_reader_instructions =
441 "Enter your debugger command(s). Type 'DONE' to end.\n";
442
443 // CommandObjectBreakpointCommandDelete
444
445 #define LLDB_OPTIONS_breakpoint_command_delete
446 #include "CommandOptions.inc"
447
448 class CommandObjectBreakpointCommandDelete : public CommandObjectParsed {
449 public:
CommandObjectBreakpointCommandDelete(CommandInterpreter & interpreter)450 CommandObjectBreakpointCommandDelete(CommandInterpreter &interpreter)
451 : CommandObjectParsed(interpreter, "delete",
452 "Delete the set of commands from a breakpoint.",
453 nullptr) {
454 CommandArgumentEntry arg;
455 CommandArgumentData bp_id_arg;
456
457 // Define the first (and only) variant of this arg.
458 bp_id_arg.arg_type = eArgTypeBreakpointID;
459 bp_id_arg.arg_repetition = eArgRepeatPlain;
460
461 // There is only one variant this argument could be; put it into the
462 // argument entry.
463 arg.push_back(bp_id_arg);
464
465 // Push the data for the first argument into the m_arguments vector.
466 m_arguments.push_back(arg);
467 }
468
469 ~CommandObjectBreakpointCommandDelete() override = default;
470
GetOptions()471 Options *GetOptions() override { return &m_options; }
472
473 class CommandOptions : public Options {
474 public:
475 CommandOptions() = default;
476
477 ~CommandOptions() override = default;
478
SetOptionValue(uint32_t option_idx,llvm::StringRef option_arg,ExecutionContext * execution_context)479 Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg,
480 ExecutionContext *execution_context) override {
481 Status error;
482 const int short_option = m_getopt_table[option_idx].val;
483
484 switch (short_option) {
485 case 'D':
486 m_use_dummy = true;
487 break;
488
489 default:
490 llvm_unreachable("Unimplemented option");
491 }
492
493 return error;
494 }
495
OptionParsingStarting(ExecutionContext * execution_context)496 void OptionParsingStarting(ExecutionContext *execution_context) override {
497 m_use_dummy = false;
498 }
499
GetDefinitions()500 llvm::ArrayRef<OptionDefinition> GetDefinitions() override {
501 return llvm::ArrayRef(g_breakpoint_command_delete_options);
502 }
503
504 // Instance variables to hold the values for command options.
505 bool m_use_dummy = false;
506 };
507
508 protected:
DoExecute(Args & command,CommandReturnObject & result)509 bool DoExecute(Args &command, CommandReturnObject &result) override {
510 Target &target = GetSelectedOrDummyTarget(m_options.m_use_dummy);
511
512 const BreakpointList &breakpoints = target.GetBreakpointList();
513 size_t num_breakpoints = breakpoints.GetSize();
514
515 if (num_breakpoints == 0) {
516 result.AppendError("No breakpoints exist to have commands deleted");
517 return false;
518 }
519
520 if (command.empty()) {
521 result.AppendError(
522 "No breakpoint specified from which to delete the commands");
523 return false;
524 }
525
526 BreakpointIDList valid_bp_ids;
527 CommandObjectMultiwordBreakpoint::VerifyBreakpointOrLocationIDs(
528 command, &target, result, &valid_bp_ids,
529 BreakpointName::Permissions::PermissionKinds::listPerm);
530
531 if (result.Succeeded()) {
532 const size_t count = valid_bp_ids.GetSize();
533 for (size_t i = 0; i < count; ++i) {
534 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex(i);
535 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID) {
536 Breakpoint *bp =
537 target.GetBreakpointByID(cur_bp_id.GetBreakpointID()).get();
538 if (cur_bp_id.GetLocationID() != LLDB_INVALID_BREAK_ID) {
539 BreakpointLocationSP bp_loc_sp(
540 bp->FindLocationByID(cur_bp_id.GetLocationID()));
541 if (bp_loc_sp)
542 bp_loc_sp->ClearCallback();
543 else {
544 result.AppendErrorWithFormat("Invalid breakpoint ID: %u.%u.\n",
545 cur_bp_id.GetBreakpointID(),
546 cur_bp_id.GetLocationID());
547 return false;
548 }
549 } else {
550 bp->ClearCallback();
551 }
552 }
553 }
554 }
555 return result.Succeeded();
556 }
557
558 private:
559 CommandOptions m_options;
560 };
561
562 // CommandObjectBreakpointCommandList
563
564 class CommandObjectBreakpointCommandList : public CommandObjectParsed {
565 public:
CommandObjectBreakpointCommandList(CommandInterpreter & interpreter)566 CommandObjectBreakpointCommandList(CommandInterpreter &interpreter)
567 : CommandObjectParsed(interpreter, "list",
568 "List the script or set of commands to be "
569 "executed when the breakpoint is hit.",
570 nullptr, eCommandRequiresTarget) {
571 CommandArgumentEntry arg;
572 CommandArgumentData bp_id_arg;
573
574 // Define the first (and only) variant of this arg.
575 bp_id_arg.arg_type = eArgTypeBreakpointID;
576 bp_id_arg.arg_repetition = eArgRepeatPlain;
577
578 // There is only one variant this argument could be; put it into the
579 // argument entry.
580 arg.push_back(bp_id_arg);
581
582 // Push the data for the first argument into the m_arguments vector.
583 m_arguments.push_back(arg);
584 }
585
586 ~CommandObjectBreakpointCommandList() override = default;
587
588 protected:
DoExecute(Args & command,CommandReturnObject & result)589 bool DoExecute(Args &command, CommandReturnObject &result) override {
590 Target *target = &GetSelectedTarget();
591
592 const BreakpointList &breakpoints = target->GetBreakpointList();
593 size_t num_breakpoints = breakpoints.GetSize();
594
595 if (num_breakpoints == 0) {
596 result.AppendError("No breakpoints exist for which to list commands");
597 return false;
598 }
599
600 if (command.empty()) {
601 result.AppendError(
602 "No breakpoint specified for which to list the commands");
603 return false;
604 }
605
606 BreakpointIDList valid_bp_ids;
607 CommandObjectMultiwordBreakpoint::VerifyBreakpointOrLocationIDs(
608 command, target, result, &valid_bp_ids,
609 BreakpointName::Permissions::PermissionKinds::listPerm);
610
611 if (result.Succeeded()) {
612 const size_t count = valid_bp_ids.GetSize();
613 for (size_t i = 0; i < count; ++i) {
614 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex(i);
615 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID) {
616 Breakpoint *bp =
617 target->GetBreakpointByID(cur_bp_id.GetBreakpointID()).get();
618
619 if (bp) {
620 BreakpointLocationSP bp_loc_sp;
621 if (cur_bp_id.GetLocationID() != LLDB_INVALID_BREAK_ID) {
622 bp_loc_sp = bp->FindLocationByID(cur_bp_id.GetLocationID());
623 if (!bp_loc_sp) {
624 result.AppendErrorWithFormat("Invalid breakpoint ID: %u.%u.\n",
625 cur_bp_id.GetBreakpointID(),
626 cur_bp_id.GetLocationID());
627 return false;
628 }
629 }
630
631 StreamString id_str;
632 BreakpointID::GetCanonicalReference(&id_str,
633 cur_bp_id.GetBreakpointID(),
634 cur_bp_id.GetLocationID());
635 const Baton *baton = nullptr;
636 if (bp_loc_sp)
637 baton =
638 bp_loc_sp
639 ->GetOptionsSpecifyingKind(BreakpointOptions::eCallback)
640 .GetBaton();
641 else
642 baton = bp->GetOptions().GetBaton();
643
644 if (baton) {
645 result.GetOutputStream().Printf("Breakpoint %s:\n",
646 id_str.GetData());
647 baton->GetDescription(result.GetOutputStream().AsRawOstream(),
648 eDescriptionLevelFull,
649 result.GetOutputStream().GetIndentLevel() +
650 2);
651 } else {
652 result.AppendMessageWithFormat(
653 "Breakpoint %s does not have an associated command.\n",
654 id_str.GetData());
655 }
656 }
657 result.SetStatus(eReturnStatusSuccessFinishResult);
658 } else {
659 result.AppendErrorWithFormat("Invalid breakpoint ID: %u.\n",
660 cur_bp_id.GetBreakpointID());
661 }
662 }
663 }
664
665 return result.Succeeded();
666 }
667 };
668
669 // CommandObjectBreakpointCommand
670
CommandObjectBreakpointCommand(CommandInterpreter & interpreter)671 CommandObjectBreakpointCommand::CommandObjectBreakpointCommand(
672 CommandInterpreter &interpreter)
673 : CommandObjectMultiword(
674 interpreter, "command",
675 "Commands for adding, removing and listing "
676 "LLDB commands executed when a breakpoint is "
677 "hit.",
678 "command <sub-command> [<sub-command-options>] <breakpoint-id>") {
679 CommandObjectSP add_command_object(
680 new CommandObjectBreakpointCommandAdd(interpreter));
681 CommandObjectSP delete_command_object(
682 new CommandObjectBreakpointCommandDelete(interpreter));
683 CommandObjectSP list_command_object(
684 new CommandObjectBreakpointCommandList(interpreter));
685
686 add_command_object->SetCommandName("breakpoint command add");
687 delete_command_object->SetCommandName("breakpoint command delete");
688 list_command_object->SetCommandName("breakpoint command list");
689
690 LoadSubCommand("add", add_command_object);
691 LoadSubCommand("delete", delete_command_object);
692 LoadSubCommand("list", list_command_object);
693 }
694
695 CommandObjectBreakpointCommand::~CommandObjectBreakpointCommand() = default;
696