1 //===-- CommandObjectBreakpoint.cpp -----------------------------*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #include "lldb/lldb-python.h"
12 #include "CommandObjectBreakpoint.h"
13 #include "CommandObjectBreakpointCommand.h"
17 // Other libraries and framework includes
19 #include "lldb/Breakpoint/Breakpoint.h"
20 #include "lldb/Breakpoint/BreakpointIDList.h"
21 #include "lldb/Breakpoint/BreakpointLocation.h"
22 #include "lldb/Interpreter/Options.h"
23 #include "lldb/Core/RegularExpression.h"
24 #include "lldb/Core/StreamString.h"
25 #include "lldb/Interpreter/CommandInterpreter.h"
26 #include "lldb/Interpreter/CommandReturnObject.h"
27 #include "lldb/Target/Target.h"
28 #include "lldb/Interpreter/CommandCompletions.h"
29 #include "lldb/Target/StackFrame.h"
30 #include "lldb/Target/Thread.h"
31 #include "lldb/Target/ThreadSpec.h"
36 using namespace lldb_private;
39 AddBreakpointDescription (Stream *s, Breakpoint *bp, lldb::DescriptionLevel level)
42 bp->GetDescription (s, level, true);
47 //-------------------------------------------------------------------------
48 // CommandObjectBreakpointSet
49 //-------------------------------------------------------------------------
52 class CommandObjectBreakpointSet : public CommandObjectParsed
56 typedef enum BreakpointSetType
62 eSetTypeFunctionRegexp,
67 CommandObjectBreakpointSet (CommandInterpreter &interpreter) :
68 CommandObjectParsed (interpreter,
70 "Sets a breakpoint or set of breakpoints in the executable.",
71 "breakpoint set <cmd-options>"),
72 m_options (interpreter)
78 ~CommandObjectBreakpointSet () {}
86 class CommandOptions : public Options
90 CommandOptions (CommandInterpreter &interpreter) :
91 Options (interpreter),
97 m_func_name_type_mask (eFunctionNameTypeNone),
99 m_source_text_regexp(),
103 m_thread_id(LLDB_INVALID_THREAD_ID),
104 m_thread_index (UINT32_MAX),
110 m_language (eLanguageTypeUnknown),
111 m_skip_prologue (eLazyBoolCalculate),
118 ~CommandOptions () {}
121 SetOptionValue (uint32_t option_idx, const char *option_arg)
124 const int short_option = m_getopt_table[option_idx].val;
126 switch (short_option)
130 ExecutionContext exe_ctx (m_interpreter.GetExecutionContext());
131 m_load_addr = Args::StringToAddress(&exe_ctx, option_arg, LLDB_INVALID_ADDRESS, &error);
136 m_func_names.push_back (option_arg);
137 m_func_name_type_mask |= eFunctionNameTypeBase;
141 m_column = Args::StringToUInt32 (option_arg, 0);
145 m_condition.assign(option_arg);
150 LanguageType language = LanguageRuntime::GetLanguageTypeFromString (option_arg);
154 case eLanguageTypeC89:
156 case eLanguageTypeC99:
157 case eLanguageTypeC11:
158 m_language = eLanguageTypeC;
160 case eLanguageTypeC_plus_plus:
161 case eLanguageTypeC_plus_plus_03:
162 case eLanguageTypeC_plus_plus_11:
163 m_language = eLanguageTypeC_plus_plus;
165 case eLanguageTypeObjC:
166 m_language = eLanguageTypeObjC;
168 case eLanguageTypeObjC_plus_plus:
169 error.SetErrorStringWithFormat ("Set exception breakpoints separately for c++ and objective-c");
171 case eLanguageTypeUnknown:
172 error.SetErrorStringWithFormat ("Unknown language type: '%s' for exception breakpoint", option_arg);
175 error.SetErrorStringWithFormat ("Unsupported language type: '%s' for exception breakpoint", option_arg);
181 m_filenames.AppendIfUnique (FileSpec(option_arg, false));
185 m_func_names.push_back (option_arg);
186 m_func_name_type_mask |= eFunctionNameTypeFull;
192 m_catch_bp = Args::StringToBoolean (option_arg, true, &success);
194 error.SetErrorStringWithFormat ("Invalid boolean value for on-catch option: '%s'", option_arg);
204 m_ignore_count = Args::StringToUInt32(option_arg, UINT32_MAX, 0);
205 if (m_ignore_count == UINT32_MAX)
206 error.SetErrorStringWithFormat ("invalid ignore count '%s'", option_arg);
214 value = Args::StringToBoolean (option_arg, true, &success);
216 m_skip_prologue = eLazyBoolYes;
218 m_skip_prologue = eLazyBoolNo;
221 error.SetErrorStringWithFormat ("Invalid boolean value for skip prologue option: '%s'", option_arg);
226 m_line_num = Args::StringToUInt32 (option_arg, 0);
230 m_func_names.push_back (option_arg);
231 m_func_name_type_mask |= eFunctionNameTypeMethod;
235 m_func_names.push_back (option_arg);
236 m_func_name_type_mask |= eFunctionNameTypeAuto;
244 m_source_text_regexp.assign (option_arg);
248 m_queue_name.assign (option_arg);
252 m_func_regexp.assign (option_arg);
257 m_modules.AppendIfUnique (FileSpec (option_arg, false));
262 m_func_names.push_back (option_arg);
263 m_func_name_type_mask |= eFunctionNameTypeSelector;
268 m_thread_id = Args::StringToUInt64(option_arg, LLDB_INVALID_THREAD_ID, 0);
269 if (m_thread_id == LLDB_INVALID_THREAD_ID)
270 error.SetErrorStringWithFormat ("invalid thread id string '%s'", option_arg);
275 m_thread_name.assign (option_arg);
281 m_throw_bp = Args::StringToBoolean (option_arg, true, &success);
283 error.SetErrorStringWithFormat ("Invalid boolean value for on-throw option: '%s'", option_arg);
289 m_thread_index = Args::StringToUInt32(option_arg, UINT32_MAX, 0);
290 if (m_thread_id == UINT32_MAX)
291 error.SetErrorStringWithFormat ("invalid thread index string '%s'", option_arg);
297 error.SetErrorStringWithFormat ("unrecognized option '%c'", short_option);
304 OptionParsingStarting ()
310 m_func_names.clear();
311 m_func_name_type_mask = eFunctionNameTypeNone;
312 m_func_regexp.clear();
313 m_source_text_regexp.clear();
315 m_load_addr = LLDB_INVALID_ADDRESS;
317 m_thread_id = LLDB_INVALID_THREAD_ID;
318 m_thread_index = UINT32_MAX;
319 m_thread_name.clear();
320 m_queue_name.clear();
324 m_language = eLanguageTypeUnknown;
325 m_skip_prologue = eLazyBoolCalculate;
329 const OptionDefinition*
332 return g_option_table;
335 // Options table: Required for subclasses of Options.
337 static OptionDefinition g_option_table[];
339 // Instance variables to hold the values for command options.
341 std::string m_condition;
342 FileSpecList m_filenames;
345 std::vector<std::string> m_func_names;
346 uint32_t m_func_name_type_mask;
347 std::string m_func_regexp;
348 std::string m_source_text_regexp;
349 FileSpecList m_modules;
350 lldb::addr_t m_load_addr;
351 uint32_t m_ignore_count;
352 lldb::tid_t m_thread_id;
353 uint32_t m_thread_index;
354 std::string m_thread_name;
355 std::string m_queue_name;
358 bool m_hardware; // Request to use hardware breakpoints
359 lldb::LanguageType m_language;
360 LazyBool m_skip_prologue;
367 DoExecute (Args& command,
368 CommandReturnObject &result)
370 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
373 result.AppendError ("Invalid target. Must set target before setting breakpoints (see 'target create' command).");
374 result.SetStatus (eReturnStatusFailed);
378 // The following are the various types of breakpoints that could be set:
379 // 1). -f -l -p [-s -g] (setting breakpoint by source location)
380 // 2). -a [-s -g] (setting breakpoint by address)
381 // 3). -n [-s -g] (setting breakpoint by function name)
382 // 4). -r [-s -g] (setting breakpoint by function name regular expression)
383 // 5). -p -f (setting a breakpoint by comparing a reg-exp to source text)
384 // 6). -E [-w -h] (setting a breakpoint for exceptions for a given language.)
386 BreakpointSetType break_type = eSetTypeInvalid;
388 if (m_options.m_line_num != 0)
389 break_type = eSetTypeFileAndLine;
390 else if (m_options.m_load_addr != LLDB_INVALID_ADDRESS)
391 break_type = eSetTypeAddress;
392 else if (!m_options.m_func_names.empty())
393 break_type = eSetTypeFunctionName;
394 else if (!m_options.m_func_regexp.empty())
395 break_type = eSetTypeFunctionRegexp;
396 else if (!m_options.m_source_text_regexp.empty())
397 break_type = eSetTypeSourceRegexp;
398 else if (m_options.m_language != eLanguageTypeUnknown)
399 break_type = eSetTypeException;
401 Breakpoint *bp = NULL;
402 FileSpec module_spec;
403 const bool internal = false;
407 case eSetTypeFileAndLine: // Breakpoint by source position
410 const size_t num_files = m_options.m_filenames.GetSize();
413 if (!GetDefaultFile (target, file, result))
415 result.AppendError("No file supplied and no default file available.");
416 result.SetStatus (eReturnStatusFailed);
420 else if (num_files > 1)
422 result.AppendError("Only one file at a time is allowed for file and line breakpoints.");
423 result.SetStatus (eReturnStatusFailed);
427 file = m_options.m_filenames.GetFileSpecAtIndex(0);
429 // Only check for inline functions if
430 LazyBool check_inlines = eLazyBoolCalculate;
432 bp = target->CreateBreakpoint (&(m_options.m_modules),
434 m_options.m_line_num,
436 m_options.m_skip_prologue,
438 m_options.m_hardware).get();
442 case eSetTypeAddress: // Breakpoint by address
443 bp = target->CreateBreakpoint (m_options.m_load_addr,
445 m_options.m_hardware).get();
448 case eSetTypeFunctionName: // Breakpoint by function name
450 uint32_t name_type_mask = m_options.m_func_name_type_mask;
452 if (name_type_mask == 0)
453 name_type_mask = eFunctionNameTypeAuto;
455 bp = target->CreateBreakpoint (&(m_options.m_modules),
456 &(m_options.m_filenames),
457 m_options.m_func_names,
459 m_options.m_skip_prologue,
461 m_options.m_hardware).get();
465 case eSetTypeFunctionRegexp: // Breakpoint by regular expression function name
467 RegularExpression regexp(m_options.m_func_regexp.c_str());
468 if (!regexp.IsValid())
471 regexp.GetErrorAsCString(err_str, sizeof(err_str));
472 result.AppendErrorWithFormat("Function name regular expression could not be compiled: \"%s\"",
474 result.SetStatus (eReturnStatusFailed);
478 bp = target->CreateFuncRegexBreakpoint (&(m_options.m_modules),
479 &(m_options.m_filenames),
481 m_options.m_skip_prologue,
483 m_options.m_hardware).get();
486 case eSetTypeSourceRegexp: // Breakpoint by regexp on source text.
488 const size_t num_files = m_options.m_filenames.GetSize();
493 if (!GetDefaultFile (target, file, result))
495 result.AppendError ("No files provided and could not find default file.");
496 result.SetStatus (eReturnStatusFailed);
501 m_options.m_filenames.Append (file);
505 RegularExpression regexp(m_options.m_source_text_regexp.c_str());
506 if (!regexp.IsValid())
509 regexp.GetErrorAsCString(err_str, sizeof(err_str));
510 result.AppendErrorWithFormat("Source text regular expression could not be compiled: \"%s\"",
512 result.SetStatus (eReturnStatusFailed);
515 bp = target->CreateSourceRegexBreakpoint (&(m_options.m_modules),
516 &(m_options.m_filenames),
519 m_options.m_hardware).get();
522 case eSetTypeException:
524 bp = target->CreateExceptionBreakpoint (m_options.m_language,
525 m_options.m_catch_bp,
526 m_options.m_throw_bp,
527 m_options.m_hardware).get();
534 // Now set the various options that were passed in:
537 if (m_options.m_thread_id != LLDB_INVALID_THREAD_ID)
538 bp->SetThreadID (m_options.m_thread_id);
540 if (m_options.m_thread_index != UINT32_MAX)
541 bp->GetOptions()->GetThreadSpec()->SetIndex(m_options.m_thread_index);
543 if (!m_options.m_thread_name.empty())
544 bp->GetOptions()->GetThreadSpec()->SetName(m_options.m_thread_name.c_str());
546 if (!m_options.m_queue_name.empty())
547 bp->GetOptions()->GetThreadSpec()->SetQueueName(m_options.m_queue_name.c_str());
549 if (m_options.m_ignore_count != 0)
550 bp->GetOptions()->SetIgnoreCount(m_options.m_ignore_count);
552 if (!m_options.m_condition.empty())
553 bp->GetOptions()->SetCondition(m_options.m_condition.c_str());
555 bp->SetOneShot (m_options.m_one_shot);
560 Stream &output_stream = result.GetOutputStream();
561 const bool show_locations = false;
562 bp->GetDescription(&output_stream, lldb::eDescriptionLevelInitial, show_locations);
563 // Don't print out this warning for exception breakpoints. They can get set before the target
564 // is set, but we won't know how to actually set the breakpoint till we run.
565 if (bp->GetNumLocations() == 0 && break_type != eSetTypeException)
566 output_stream.Printf ("WARNING: Unable to resolve breakpoint to any actual locations.\n");
567 result.SetStatus (eReturnStatusSuccessFinishResult);
571 result.AppendError ("Breakpoint creation failed: No breakpoint created.");
572 result.SetStatus (eReturnStatusFailed);
575 return result.Succeeded();
580 GetDefaultFile (Target *target, FileSpec &file, CommandReturnObject &result)
582 uint32_t default_line;
583 // First use the Source Manager's default file.
584 // Then use the current stack frame's file.
585 if (!target->GetSourceManager().GetDefaultFileAndLine(file, default_line))
587 StackFrame *cur_frame = m_exe_ctx.GetFramePtr();
588 if (cur_frame == NULL)
590 result.AppendError ("No selected frame to use to find the default file.");
591 result.SetStatus (eReturnStatusFailed);
594 else if (!cur_frame->HasDebugInformation())
596 result.AppendError ("Cannot use the selected frame to find the default file, it has no debug info.");
597 result.SetStatus (eReturnStatusFailed);
602 const SymbolContext &sc = cur_frame->GetSymbolContext (eSymbolContextLineEntry);
603 if (sc.line_entry.file)
605 file = sc.line_entry.file;
609 result.AppendError ("Can't find the file for the selected frame to use as the default file.");
610 result.SetStatus (eReturnStatusFailed);
618 CommandOptions m_options;
620 // If an additional option set beyond LLDB_OPTION_SET_10 is added, make sure to
621 // update the numbers passed to LLDB_OPT_SET_FROM_TO(...) appropriately.
622 #define LLDB_OPT_FILE ( LLDB_OPT_SET_FROM_TO(1, 9) & ~LLDB_OPT_SET_2 )
623 #define LLDB_OPT_NOT_10 ( LLDB_OPT_SET_FROM_TO(1, 10) & ~LLDB_OPT_SET_10 )
624 #define LLDB_OPT_SKIP_PROLOGUE ( LLDB_OPT_SET_1 | LLDB_OPT_SET_FROM_TO(3,8) )
627 CommandObjectBreakpointSet::CommandOptions::g_option_table[] =
629 { LLDB_OPT_NOT_10, false, "shlib", 's', OptionParser::eRequiredArgument, NULL, NULL, CommandCompletions::eModuleCompletion, eArgTypeShlibName,
630 "Set the breakpoint only in this shared library. "
631 "Can repeat this option multiple times to specify multiple shared libraries."},
633 { LLDB_OPT_SET_ALL, false, "ignore-count", 'i', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeCount,
634 "Set the number of times this breakpoint is skipped before stopping." },
636 { LLDB_OPT_SET_ALL, false, "one-shot", 'o', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone,
637 "The breakpoint is deleted the first time it causes a stop." },
639 { LLDB_OPT_SET_ALL, false, "condition", 'c', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeExpression,
640 "The breakpoint stops only if this condition expression evaluates to true."},
642 { LLDB_OPT_SET_ALL, false, "thread-index", 'x', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeThreadIndex,
643 "The breakpoint stops only for the thread whose indeX matches this argument."},
645 { LLDB_OPT_SET_ALL, false, "thread-id", 't', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeThreadID,
646 "The breakpoint stops only for the thread whose TID matches this argument."},
648 { LLDB_OPT_SET_ALL, false, "thread-name", 'T', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeThreadName,
649 "The breakpoint stops only for the thread whose thread name matches this argument."},
651 { LLDB_OPT_SET_ALL, false, "hardware", 'H', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone,
652 "Require the breakpoint to use hardware breakpoints."},
654 { LLDB_OPT_SET_ALL, false, "queue-name", 'q', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeQueueName,
655 "The breakpoint stops only for threads in the queue whose name is given by this argument."},
657 { LLDB_OPT_FILE, false, "file", 'f', OptionParser::eRequiredArgument, NULL, NULL, CommandCompletions::eSourceFileCompletion, eArgTypeFilename,
658 "Specifies the source file in which to set this breakpoint. "
659 "Note, by default lldb only looks for files that are #included if they use the standard include file extensions. "
660 "To set breakpoints on .c/.cpp/.m/.mm files that are #included, set target.inline-breakpoint-strategy"
663 { LLDB_OPT_SET_1, true, "line", 'l', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeLineNum,
664 "Specifies the line number on which to set this breakpoint."},
666 // Comment out this option for the moment, as we don't actually use it, but will in the future.
667 // This way users won't see it, but the infrastructure is left in place.
668 // { 0, false, "column", 'C', OptionParser::eRequiredArgument, NULL, "<column>",
669 // "Set the breakpoint by source location at this particular column."},
671 { LLDB_OPT_SET_2, true, "address", 'a', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeAddressOrExpression,
672 "Set the breakpoint by address, at the specified address."},
674 { LLDB_OPT_SET_3, true, "name", 'n', OptionParser::eRequiredArgument, NULL, NULL, CommandCompletions::eSymbolCompletion, eArgTypeFunctionName,
675 "Set the breakpoint by function name. Can be repeated multiple times to make one breakpoint for multiple names" },
677 { LLDB_OPT_SET_4, true, "fullname", 'F', OptionParser::eRequiredArgument, NULL, NULL, CommandCompletions::eSymbolCompletion, eArgTypeFullName,
678 "Set the breakpoint by fully qualified function names. For C++ this means namespaces and all arguments, and "
679 "for Objective C this means a full function prototype with class and selector. "
680 "Can be repeated multiple times to make one breakpoint for multiple names." },
682 { LLDB_OPT_SET_5, true, "selector", 'S', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeSelector,
683 "Set the breakpoint by ObjC selector name. Can be repeated multiple times to make one breakpoint for multiple Selectors." },
685 { LLDB_OPT_SET_6, true, "method", 'M', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeMethod,
686 "Set the breakpoint by C++ method names. Can be repeated multiple times to make one breakpoint for multiple methods." },
688 { LLDB_OPT_SET_7, true, "func-regex", 'r', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeRegularExpression,
689 "Set the breakpoint by function name, evaluating a regular-expression to find the function name(s)." },
691 { LLDB_OPT_SET_8, true, "basename", 'b', OptionParser::eRequiredArgument, NULL, NULL, CommandCompletions::eSymbolCompletion, eArgTypeFunctionName,
692 "Set the breakpoint by function basename (C++ namespaces and arguments will be ignored). "
693 "Can be repeated multiple times to make one breakpoint for multiple symbols." },
695 { LLDB_OPT_SET_9, true, "source-pattern-regexp", 'p', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeRegularExpression,
696 "Set the breakpoint by specifying a regular expression which is matched against the source text in a source file or files "
697 "specified with the -f option. The -f option can be specified more than once. "
698 "If no source files are specified, uses the current \"default source file\"" },
700 { LLDB_OPT_SET_10, true, "language-exception", 'E', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeLanguage,
701 "Set the breakpoint on exceptions thrown by the specified language (without options, on throw but not catch.)" },
703 { LLDB_OPT_SET_10, false, "on-throw", 'w', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeBoolean,
704 "Set the breakpoint on exception throW." },
706 { LLDB_OPT_SET_10, false, "on-catch", 'h', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeBoolean,
707 "Set the breakpoint on exception catcH." },
709 { LLDB_OPT_SKIP_PROLOGUE, false, "skip-prologue", 'K', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeBoolean,
710 "sKip the prologue if the breakpoint is at the beginning of a function. If not set the target.skip-prologue setting is used." },
712 { 0, false, NULL, 0, 0, NULL, NULL, 0, eArgTypeNone, NULL }
715 //-------------------------------------------------------------------------
716 // CommandObjectBreakpointModify
717 //-------------------------------------------------------------------------
720 class CommandObjectBreakpointModify : public CommandObjectParsed
724 CommandObjectBreakpointModify (CommandInterpreter &interpreter) :
725 CommandObjectParsed (interpreter,
727 "Modify the options on a breakpoint or set of breakpoints in the executable. "
728 "If no breakpoint is specified, acts on the last created breakpoint. "
729 "With the exception of -e, -d and -i, passing an empty argument clears the modification.",
731 m_options (interpreter)
733 CommandArgumentEntry arg;
734 CommandObject::AddIDsArgumentData(arg, eArgTypeBreakpointID, eArgTypeBreakpointIDRange);
735 // Add the entry for the first argument for this command to the object's arguments vector.
736 m_arguments.push_back (arg);
741 ~CommandObjectBreakpointModify () {}
749 class CommandOptions : public Options
753 CommandOptions (CommandInterpreter &interpreter) :
754 Options (interpreter),
756 m_thread_id(LLDB_INVALID_THREAD_ID),
757 m_thread_id_passed(false),
758 m_thread_index (UINT32_MAX),
759 m_thread_index_passed(false),
764 m_enable_passed (false),
765 m_enable_value (false),
766 m_name_passed (false),
767 m_queue_passed (false),
768 m_condition_passed (false),
769 m_one_shot_passed (false)
774 ~CommandOptions () {}
777 SetOptionValue (uint32_t option_idx, const char *option_arg)
780 const int short_option = m_getopt_table[option_idx].val;
782 switch (short_option)
785 if (option_arg != NULL)
786 m_condition.assign (option_arg);
789 m_condition_passed = true;
792 m_enable_passed = true;
793 m_enable_value = false;
796 m_enable_passed = true;
797 m_enable_value = true;
801 m_ignore_count = Args::StringToUInt32(option_arg, UINT32_MAX, 0);
802 if (m_ignore_count == UINT32_MAX)
803 error.SetErrorStringWithFormat ("invalid ignore count '%s'", option_arg);
809 value = Args::StringToBoolean(option_arg, false, &success);
812 m_one_shot_passed = true;
816 error.SetErrorStringWithFormat("invalid boolean value '%s' passed for -o option", option_arg);
821 if (option_arg[0] == '\0')
823 m_thread_id = LLDB_INVALID_THREAD_ID;
824 m_thread_id_passed = true;
828 m_thread_id = Args::StringToUInt64(option_arg, LLDB_INVALID_THREAD_ID, 0);
829 if (m_thread_id == LLDB_INVALID_THREAD_ID)
830 error.SetErrorStringWithFormat ("invalid thread id string '%s'", option_arg);
832 m_thread_id_passed = true;
837 if (option_arg != NULL)
838 m_thread_name.assign (option_arg);
840 m_thread_name.clear();
841 m_name_passed = true;
844 if (option_arg != NULL)
845 m_queue_name.assign (option_arg);
847 m_queue_name.clear();
848 m_queue_passed = true;
852 if (option_arg[0] == '\n')
854 m_thread_index = UINT32_MAX;
855 m_thread_index_passed = true;
859 m_thread_index = Args::StringToUInt32 (option_arg, UINT32_MAX, 0);
860 if (m_thread_id == UINT32_MAX)
861 error.SetErrorStringWithFormat ("invalid thread index string '%s'", option_arg);
863 m_thread_index_passed = true;
868 error.SetErrorStringWithFormat ("unrecognized option '%c'", short_option);
875 OptionParsingStarting ()
878 m_thread_id = LLDB_INVALID_THREAD_ID;
879 m_thread_id_passed = false;
880 m_thread_index = UINT32_MAX;
881 m_thread_index_passed = false;
882 m_thread_name.clear();
883 m_queue_name.clear();
886 m_enable_passed = false;
887 m_queue_passed = false;
888 m_name_passed = false;
889 m_condition_passed = false;
890 m_one_shot_passed = false;
893 const OptionDefinition*
896 return g_option_table;
900 // Options table: Required for subclasses of Options.
902 static OptionDefinition g_option_table[];
904 // Instance variables to hold the values for command options.
906 uint32_t m_ignore_count;
907 lldb::tid_t m_thread_id;
908 bool m_thread_id_passed;
909 uint32_t m_thread_index;
910 bool m_thread_index_passed;
911 std::string m_thread_name;
912 std::string m_queue_name;
913 std::string m_condition;
915 bool m_enable_passed;
919 bool m_condition_passed;
920 bool m_one_shot_passed;
926 DoExecute (Args& command, CommandReturnObject &result)
928 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
931 result.AppendError ("Invalid target. No existing target or breakpoints.");
932 result.SetStatus (eReturnStatusFailed);
936 Mutex::Locker locker;
937 target->GetBreakpointList().GetListMutex(locker);
939 BreakpointIDList valid_bp_ids;
941 CommandObjectMultiwordBreakpoint::VerifyBreakpointIDs (command, target, result, &valid_bp_ids);
943 if (result.Succeeded())
945 const size_t count = valid_bp_ids.GetSize();
946 for (size_t i = 0; i < count; ++i)
948 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex (i);
950 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID)
952 Breakpoint *bp = target->GetBreakpointByID (cur_bp_id.GetBreakpointID()).get();
953 if (cur_bp_id.GetLocationID() != LLDB_INVALID_BREAK_ID)
955 BreakpointLocation *location = bp->FindLocationByID (cur_bp_id.GetLocationID()).get();
958 if (m_options.m_thread_id_passed)
959 location->SetThreadID (m_options.m_thread_id);
961 if (m_options.m_thread_index_passed)
962 location->SetThreadIndex(m_options.m_thread_index);
964 if (m_options.m_name_passed)
965 location->SetThreadName(m_options.m_thread_name.c_str());
967 if (m_options.m_queue_passed)
968 location->SetQueueName(m_options.m_queue_name.c_str());
970 if (m_options.m_ignore_count != 0)
971 location->SetIgnoreCount(m_options.m_ignore_count);
973 if (m_options.m_enable_passed)
974 location->SetEnabled (m_options.m_enable_value);
976 if (m_options.m_condition_passed)
977 location->SetCondition (m_options.m_condition.c_str());
982 if (m_options.m_thread_id_passed)
983 bp->SetThreadID (m_options.m_thread_id);
985 if (m_options.m_thread_index_passed)
986 bp->SetThreadIndex(m_options.m_thread_index);
988 if (m_options.m_name_passed)
989 bp->SetThreadName(m_options.m_thread_name.c_str());
991 if (m_options.m_queue_passed)
992 bp->SetQueueName(m_options.m_queue_name.c_str());
994 if (m_options.m_ignore_count != 0)
995 bp->SetIgnoreCount(m_options.m_ignore_count);
997 if (m_options.m_enable_passed)
998 bp->SetEnabled (m_options.m_enable_value);
1000 if (m_options.m_condition_passed)
1001 bp->SetCondition (m_options.m_condition.c_str());
1007 return result.Succeeded();
1011 CommandOptions m_options;
1014 #pragma mark Modify::CommandOptions
1016 CommandObjectBreakpointModify::CommandOptions::g_option_table[] =
1018 { LLDB_OPT_SET_ALL, false, "ignore-count", 'i', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeCount, "Set the number of times this breakpoint is skipped before stopping." },
1019 { LLDB_OPT_SET_ALL, false, "one-shot", 'o', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeBoolean, "The breakpoint is deleted the first time it stop causes a stop." },
1020 { LLDB_OPT_SET_ALL, false, "thread-index", 'x', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeThreadIndex, "The breakpoint stops only for the thread whose index matches this argument."},
1021 { LLDB_OPT_SET_ALL, false, "thread-id", 't', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeThreadID, "The breakpoint stops only for the thread whose TID matches this argument."},
1022 { LLDB_OPT_SET_ALL, false, "thread-name", 'T', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeThreadName, "The breakpoint stops only for the thread whose thread name matches this argument."},
1023 { LLDB_OPT_SET_ALL, false, "queue-name", 'q', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeQueueName, "The breakpoint stops only for threads in the queue whose name is given by this argument."},
1024 { LLDB_OPT_SET_ALL, false, "condition", 'c', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeExpression, "The breakpoint stops only if this condition expression evaluates to true."},
1025 { LLDB_OPT_SET_1, false, "enable", 'e', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone, "Enable the breakpoint."},
1026 { LLDB_OPT_SET_2, false, "disable", 'd', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone, "Disable the breakpoint."},
1027 { 0, false, NULL, 0 , 0, NULL, NULL, 0, eArgTypeNone, NULL }
1030 //-------------------------------------------------------------------------
1031 // CommandObjectBreakpointEnable
1032 //-------------------------------------------------------------------------
1035 class CommandObjectBreakpointEnable : public CommandObjectParsed
1038 CommandObjectBreakpointEnable (CommandInterpreter &interpreter) :
1039 CommandObjectParsed (interpreter,
1041 "Enable the specified disabled breakpoint(s). If no breakpoints are specified, enable all of them.",
1044 CommandArgumentEntry arg;
1045 CommandObject::AddIDsArgumentData(arg, eArgTypeBreakpointID, eArgTypeBreakpointIDRange);
1046 // Add the entry for the first argument for this command to the object's arguments vector.
1047 m_arguments.push_back (arg);
1052 ~CommandObjectBreakpointEnable () {}
1056 DoExecute (Args& command, CommandReturnObject &result)
1058 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
1061 result.AppendError ("Invalid target. No existing target or breakpoints.");
1062 result.SetStatus (eReturnStatusFailed);
1066 Mutex::Locker locker;
1067 target->GetBreakpointList().GetListMutex(locker);
1069 const BreakpointList &breakpoints = target->GetBreakpointList();
1071 size_t num_breakpoints = breakpoints.GetSize();
1073 if (num_breakpoints == 0)
1075 result.AppendError ("No breakpoints exist to be enabled.");
1076 result.SetStatus (eReturnStatusFailed);
1080 if (command.GetArgumentCount() == 0)
1082 // No breakpoint selected; enable all currently set breakpoints.
1083 target->EnableAllBreakpoints ();
1084 result.AppendMessageWithFormat ("All breakpoints enabled. (%" PRIu64 " breakpoints)\n", (uint64_t)num_breakpoints);
1085 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1089 // Particular breakpoint selected; enable that breakpoint.
1090 BreakpointIDList valid_bp_ids;
1091 CommandObjectMultiwordBreakpoint::VerifyBreakpointIDs (command, target, result, &valid_bp_ids);
1093 if (result.Succeeded())
1095 int enable_count = 0;
1097 const size_t count = valid_bp_ids.GetSize();
1098 for (size_t i = 0; i < count; ++i)
1100 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex (i);
1102 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID)
1104 Breakpoint *breakpoint = target->GetBreakpointByID (cur_bp_id.GetBreakpointID()).get();
1105 if (cur_bp_id.GetLocationID() != LLDB_INVALID_BREAK_ID)
1107 BreakpointLocation *location = breakpoint->FindLocationByID (cur_bp_id.GetLocationID()).get();
1110 location->SetEnabled (true);
1116 breakpoint->SetEnabled (true);
1121 result.AppendMessageWithFormat ("%d breakpoints enabled.\n", enable_count + loc_count);
1122 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1126 return result.Succeeded();
1130 //-------------------------------------------------------------------------
1131 // CommandObjectBreakpointDisable
1132 //-------------------------------------------------------------------------
1133 #pragma mark Disable
1135 class CommandObjectBreakpointDisable : public CommandObjectParsed
1138 CommandObjectBreakpointDisable (CommandInterpreter &interpreter) :
1139 CommandObjectParsed (interpreter,
1140 "breakpoint disable",
1141 "Disable the specified breakpoint(s) without removing it/them. If no breakpoints are specified, disable them all.",
1145 "Disable the specified breakpoint(s) without removing it/them. \n\
1146 If no breakpoints are specified, disable them all.\n\
1148 Note: disabling a breakpoint will cause none of its locations to be hit\n\
1149 regardless of whether they are enabled or disabled. So the sequence: \n\
1151 (lldb) break disable 1\n\
1152 (lldb) break enable 1.1\n\
1154 will NOT cause location 1.1 to get hit. To achieve that, do:\n\
1156 (lldb) break disable 1.*\n\
1157 (lldb) break enable 1.1\n\
1159 The first command disables all the locations of breakpoint 1, \n\
1160 the second re-enables the first location."
1163 CommandArgumentEntry arg;
1164 CommandObject::AddIDsArgumentData(arg, eArgTypeBreakpointID, eArgTypeBreakpointIDRange);
1165 // Add the entry for the first argument for this command to the object's arguments vector.
1166 m_arguments.push_back (arg);
1172 ~CommandObjectBreakpointDisable () {}
1176 DoExecute (Args& command, CommandReturnObject &result)
1178 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
1181 result.AppendError ("Invalid target. No existing target or breakpoints.");
1182 result.SetStatus (eReturnStatusFailed);
1186 Mutex::Locker locker;
1187 target->GetBreakpointList().GetListMutex(locker);
1189 const BreakpointList &breakpoints = target->GetBreakpointList();
1190 size_t num_breakpoints = breakpoints.GetSize();
1192 if (num_breakpoints == 0)
1194 result.AppendError ("No breakpoints exist to be disabled.");
1195 result.SetStatus (eReturnStatusFailed);
1199 if (command.GetArgumentCount() == 0)
1201 // No breakpoint selected; disable all currently set breakpoints.
1202 target->DisableAllBreakpoints ();
1203 result.AppendMessageWithFormat ("All breakpoints disabled. (%" PRIu64 " breakpoints)\n", (uint64_t)num_breakpoints);
1204 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1208 // Particular breakpoint selected; disable that breakpoint.
1209 BreakpointIDList valid_bp_ids;
1211 CommandObjectMultiwordBreakpoint::VerifyBreakpointIDs (command, target, result, &valid_bp_ids);
1213 if (result.Succeeded())
1215 int disable_count = 0;
1217 const size_t count = valid_bp_ids.GetSize();
1218 for (size_t i = 0; i < count; ++i)
1220 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex (i);
1222 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID)
1224 Breakpoint *breakpoint = target->GetBreakpointByID (cur_bp_id.GetBreakpointID()).get();
1225 if (cur_bp_id.GetLocationID() != LLDB_INVALID_BREAK_ID)
1227 BreakpointLocation *location = breakpoint->FindLocationByID (cur_bp_id.GetLocationID()).get();
1230 location->SetEnabled (false);
1236 breakpoint->SetEnabled (false);
1241 result.AppendMessageWithFormat ("%d breakpoints disabled.\n", disable_count + loc_count);
1242 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1246 return result.Succeeded();
1251 //-------------------------------------------------------------------------
1252 // CommandObjectBreakpointList
1253 //-------------------------------------------------------------------------
1256 class CommandObjectBreakpointList : public CommandObjectParsed
1259 CommandObjectBreakpointList (CommandInterpreter &interpreter) :
1260 CommandObjectParsed (interpreter,
1262 "List some or all breakpoints at configurable levels of detail.",
1264 m_options (interpreter)
1266 CommandArgumentEntry arg;
1267 CommandArgumentData bp_id_arg;
1269 // Define the first (and only) variant of this arg.
1270 bp_id_arg.arg_type = eArgTypeBreakpointID;
1271 bp_id_arg.arg_repetition = eArgRepeatOptional;
1273 // There is only one variant this argument could be; put it into the argument entry.
1274 arg.push_back (bp_id_arg);
1276 // Push the data for the first argument into the m_arguments vector.
1277 m_arguments.push_back (arg);
1282 ~CommandObjectBreakpointList () {}
1290 class CommandOptions : public Options
1294 CommandOptions (CommandInterpreter &interpreter) :
1295 Options (interpreter),
1296 m_level (lldb::eDescriptionLevelBrief) // Breakpoint List defaults to brief descriptions
1301 ~CommandOptions () {}
1304 SetOptionValue (uint32_t option_idx, const char *option_arg)
1307 const int short_option = m_getopt_table[option_idx].val;
1309 switch (short_option)
1312 m_level = lldb::eDescriptionLevelBrief;
1315 m_level = lldb::eDescriptionLevelFull;
1318 m_level = lldb::eDescriptionLevelVerbose;
1324 error.SetErrorStringWithFormat ("unrecognized option '%c'", short_option);
1332 OptionParsingStarting ()
1334 m_level = lldb::eDescriptionLevelFull;
1338 const OptionDefinition *
1341 return g_option_table;
1344 // Options table: Required for subclasses of Options.
1346 static OptionDefinition g_option_table[];
1348 // Instance variables to hold the values for command options.
1350 lldb::DescriptionLevel m_level;
1357 DoExecute (Args& command, CommandReturnObject &result)
1359 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
1362 result.AppendError ("Invalid target. No current target or breakpoints.");
1363 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1367 const BreakpointList &breakpoints = target->GetBreakpointList(m_options.m_internal);
1368 Mutex::Locker locker;
1369 target->GetBreakpointList(m_options.m_internal).GetListMutex(locker);
1371 size_t num_breakpoints = breakpoints.GetSize();
1373 if (num_breakpoints == 0)
1375 result.AppendMessage ("No breakpoints currently set.");
1376 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1380 Stream &output_stream = result.GetOutputStream();
1382 if (command.GetArgumentCount() == 0)
1384 // No breakpoint selected; show info about all currently set breakpoints.
1385 result.AppendMessage ("Current breakpoints:");
1386 for (size_t i = 0; i < num_breakpoints; ++i)
1388 Breakpoint *breakpoint = breakpoints.GetBreakpointAtIndex (i).get();
1389 AddBreakpointDescription (&output_stream, breakpoint, m_options.m_level);
1391 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1395 // Particular breakpoints selected; show info about that breakpoint.
1396 BreakpointIDList valid_bp_ids;
1397 CommandObjectMultiwordBreakpoint::VerifyBreakpointIDs (command, target, result, &valid_bp_ids);
1399 if (result.Succeeded())
1401 for (size_t i = 0; i < valid_bp_ids.GetSize(); ++i)
1403 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex (i);
1404 Breakpoint *breakpoint = target->GetBreakpointByID (cur_bp_id.GetBreakpointID()).get();
1405 AddBreakpointDescription (&output_stream, breakpoint, m_options.m_level);
1407 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1411 result.AppendError ("Invalid breakpoint id.");
1412 result.SetStatus (eReturnStatusFailed);
1416 return result.Succeeded();
1420 CommandOptions m_options;
1423 #pragma mark List::CommandOptions
1425 CommandObjectBreakpointList::CommandOptions::g_option_table[] =
1427 { LLDB_OPT_SET_ALL, false, "internal", 'i', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone,
1428 "Show debugger internal breakpoints" },
1430 { LLDB_OPT_SET_1, false, "brief", 'b', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone,
1431 "Give a brief description of the breakpoint (no location info)."},
1433 // FIXME: We need to add an "internal" command, and then add this sort of thing to it.
1434 // But I need to see it for now, and don't want to wait.
1435 { LLDB_OPT_SET_2, false, "full", 'f', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone,
1436 "Give a full description of the breakpoint and its locations."},
1438 { LLDB_OPT_SET_3, false, "verbose", 'v', OptionParser::eNoArgument, NULL, NULL, 0, eArgTypeNone,
1439 "Explain everything we know about the breakpoint (for debugging debugger bugs)." },
1441 { 0, false, NULL, 0, 0, NULL, NULL, 0, eArgTypeNone, NULL }
1444 //-------------------------------------------------------------------------
1445 // CommandObjectBreakpointClear
1446 //-------------------------------------------------------------------------
1449 class CommandObjectBreakpointClear : public CommandObjectParsed
1453 typedef enum BreakpointClearType
1456 eClearTypeFileAndLine
1457 } BreakpointClearType;
1459 CommandObjectBreakpointClear (CommandInterpreter &interpreter) :
1460 CommandObjectParsed (interpreter,
1462 "Clears a breakpoint or set of breakpoints in the executable.",
1463 "breakpoint clear <cmd-options>"),
1464 m_options (interpreter)
1469 ~CommandObjectBreakpointClear () {}
1477 class CommandOptions : public Options
1481 CommandOptions (CommandInterpreter &interpreter) :
1482 Options (interpreter),
1489 ~CommandOptions () {}
1492 SetOptionValue (uint32_t option_idx, const char *option_arg)
1495 const int short_option = m_getopt_table[option_idx].val;
1497 switch (short_option)
1500 m_filename.assign (option_arg);
1504 m_line_num = Args::StringToUInt32 (option_arg, 0);
1508 error.SetErrorStringWithFormat ("unrecognized option '%c'", short_option);
1516 OptionParsingStarting ()
1522 const OptionDefinition*
1525 return g_option_table;
1528 // Options table: Required for subclasses of Options.
1530 static OptionDefinition g_option_table[];
1532 // Instance variables to hold the values for command options.
1534 std::string m_filename;
1535 uint32_t m_line_num;
1541 DoExecute (Args& command, CommandReturnObject &result)
1543 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
1546 result.AppendError ("Invalid target. No existing target or breakpoints.");
1547 result.SetStatus (eReturnStatusFailed);
1551 // The following are the various types of breakpoints that could be cleared:
1552 // 1). -f -l (clearing breakpoint by source location)
1554 BreakpointClearType break_type = eClearTypeInvalid;
1556 if (m_options.m_line_num != 0)
1557 break_type = eClearTypeFileAndLine;
1559 Mutex::Locker locker;
1560 target->GetBreakpointList().GetListMutex(locker);
1562 BreakpointList &breakpoints = target->GetBreakpointList();
1563 size_t num_breakpoints = breakpoints.GetSize();
1565 // Early return if there's no breakpoint at all.
1566 if (num_breakpoints == 0)
1568 result.AppendError ("Breakpoint clear: No breakpoint cleared.");
1569 result.SetStatus (eReturnStatusFailed);
1570 return result.Succeeded();
1573 // Find matching breakpoints and delete them.
1575 // First create a copy of all the IDs.
1576 std::vector<break_id_t> BreakIDs;
1577 for (size_t i = 0; i < num_breakpoints; ++i)
1578 BreakIDs.push_back(breakpoints.GetBreakpointAtIndex(i).get()->GetID());
1580 int num_cleared = 0;
1584 case eClearTypeFileAndLine: // Breakpoint by source position
1586 const ConstString filename(m_options.m_filename.c_str());
1587 BreakpointLocationCollection loc_coll;
1589 for (size_t i = 0; i < num_breakpoints; ++i)
1591 Breakpoint *bp = breakpoints.FindBreakpointByID(BreakIDs[i]).get();
1593 if (bp->GetMatchingFileLine(filename, m_options.m_line_num, loc_coll))
1595 // If the collection size is 0, it's a full match and we can just remove the breakpoint.
1596 if (loc_coll.GetSize() == 0)
1598 bp->GetDescription(&ss, lldb::eDescriptionLevelBrief);
1600 target->RemoveBreakpointByID (bp->GetID());
1612 if (num_cleared > 0)
1614 Stream &output_stream = result.GetOutputStream();
1615 output_stream.Printf ("%d breakpoints cleared:\n", num_cleared);
1616 output_stream << ss.GetData();
1617 output_stream.EOL();
1618 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1622 result.AppendError ("Breakpoint clear: No breakpoint cleared.");
1623 result.SetStatus (eReturnStatusFailed);
1626 return result.Succeeded();
1630 CommandOptions m_options;
1633 #pragma mark Clear::CommandOptions
1636 CommandObjectBreakpointClear::CommandOptions::g_option_table[] =
1638 { LLDB_OPT_SET_1, false, "file", 'f', OptionParser::eRequiredArgument, NULL, NULL, CommandCompletions::eSourceFileCompletion, eArgTypeFilename,
1639 "Specify the breakpoint by source location in this particular file."},
1641 { LLDB_OPT_SET_1, true, "line", 'l', OptionParser::eRequiredArgument, NULL, NULL, 0, eArgTypeLineNum,
1642 "Specify the breakpoint by source location at this particular line."},
1644 { 0, false, NULL, 0, 0, NULL, NULL, 0, eArgTypeNone, NULL }
1647 //-------------------------------------------------------------------------
1648 // CommandObjectBreakpointDelete
1649 //-------------------------------------------------------------------------
1652 class CommandObjectBreakpointDelete : public CommandObjectParsed
1655 CommandObjectBreakpointDelete (CommandInterpreter &interpreter) :
1656 CommandObjectParsed (interpreter,
1657 "breakpoint delete",
1658 "Delete the specified breakpoint(s). If no breakpoints are specified, delete them all.",
1661 CommandArgumentEntry arg;
1662 CommandObject::AddIDsArgumentData(arg, eArgTypeBreakpointID, eArgTypeBreakpointIDRange);
1663 // Add the entry for the first argument for this command to the object's arguments vector.
1664 m_arguments.push_back (arg);
1668 ~CommandObjectBreakpointDelete () {}
1672 DoExecute (Args& command, CommandReturnObject &result)
1674 Target *target = m_interpreter.GetDebugger().GetSelectedTarget().get();
1677 result.AppendError ("Invalid target. No existing target or breakpoints.");
1678 result.SetStatus (eReturnStatusFailed);
1682 Mutex::Locker locker;
1683 target->GetBreakpointList().GetListMutex(locker);
1685 const BreakpointList &breakpoints = target->GetBreakpointList();
1687 size_t num_breakpoints = breakpoints.GetSize();
1689 if (num_breakpoints == 0)
1691 result.AppendError ("No breakpoints exist to be deleted.");
1692 result.SetStatus (eReturnStatusFailed);
1696 if (command.GetArgumentCount() == 0)
1698 if (!m_interpreter.Confirm ("About to delete all breakpoints, do you want to do that?", true))
1700 result.AppendMessage("Operation cancelled...");
1704 target->RemoveAllBreakpoints ();
1705 result.AppendMessageWithFormat ("All breakpoints removed. (%" PRIu64 " breakpoint%s)\n", (uint64_t)num_breakpoints, num_breakpoints > 1 ? "s" : "");
1707 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1711 // Particular breakpoint selected; disable that breakpoint.
1712 BreakpointIDList valid_bp_ids;
1713 CommandObjectMultiwordBreakpoint::VerifyBreakpointIDs (command, target, result, &valid_bp_ids);
1715 if (result.Succeeded())
1717 int delete_count = 0;
1718 int disable_count = 0;
1719 const size_t count = valid_bp_ids.GetSize();
1720 for (size_t i = 0; i < count; ++i)
1722 BreakpointID cur_bp_id = valid_bp_ids.GetBreakpointIDAtIndex (i);
1724 if (cur_bp_id.GetBreakpointID() != LLDB_INVALID_BREAK_ID)
1726 if (cur_bp_id.GetLocationID() != LLDB_INVALID_BREAK_ID)
1728 Breakpoint *breakpoint = target->GetBreakpointByID (cur_bp_id.GetBreakpointID()).get();
1729 BreakpointLocation *location = breakpoint->FindLocationByID (cur_bp_id.GetLocationID()).get();
1730 // It makes no sense to try to delete individual locations, so we disable them instead.
1733 location->SetEnabled (false);
1739 target->RemoveBreakpointByID (cur_bp_id.GetBreakpointID());
1744 result.AppendMessageWithFormat ("%d breakpoints deleted; %d breakpoint locations disabled.\n",
1745 delete_count, disable_count);
1746 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1749 return result.Succeeded();
1753 //-------------------------------------------------------------------------
1754 // CommandObjectMultiwordBreakpoint
1755 //-------------------------------------------------------------------------
1756 #pragma mark MultiwordBreakpoint
1758 CommandObjectMultiwordBreakpoint::CommandObjectMultiwordBreakpoint (CommandInterpreter &interpreter) :
1759 CommandObjectMultiword (interpreter,
1761 "A set of commands for operating on breakpoints. Also see _regexp-break.",
1762 "breakpoint <command> [<command-options>]")
1764 CommandObjectSP list_command_object (new CommandObjectBreakpointList (interpreter));
1765 CommandObjectSP enable_command_object (new CommandObjectBreakpointEnable (interpreter));
1766 CommandObjectSP disable_command_object (new CommandObjectBreakpointDisable (interpreter));
1767 CommandObjectSP clear_command_object (new CommandObjectBreakpointClear (interpreter));
1768 CommandObjectSP delete_command_object (new CommandObjectBreakpointDelete (interpreter));
1769 CommandObjectSP set_command_object (new CommandObjectBreakpointSet (interpreter));
1770 CommandObjectSP command_command_object (new CommandObjectBreakpointCommand (interpreter));
1771 CommandObjectSP modify_command_object (new CommandObjectBreakpointModify(interpreter));
1773 list_command_object->SetCommandName ("breakpoint list");
1774 enable_command_object->SetCommandName("breakpoint enable");
1775 disable_command_object->SetCommandName("breakpoint disable");
1776 clear_command_object->SetCommandName("breakpoint clear");
1777 delete_command_object->SetCommandName("breakpoint delete");
1778 set_command_object->SetCommandName("breakpoint set");
1779 command_command_object->SetCommandName ("breakpoint command");
1780 modify_command_object->SetCommandName ("breakpoint modify");
1782 LoadSubCommand ("list", list_command_object);
1783 LoadSubCommand ("enable", enable_command_object);
1784 LoadSubCommand ("disable", disable_command_object);
1785 LoadSubCommand ("clear", clear_command_object);
1786 LoadSubCommand ("delete", delete_command_object);
1787 LoadSubCommand ("set", set_command_object);
1788 LoadSubCommand ("command", command_command_object);
1789 LoadSubCommand ("modify", modify_command_object);
1792 CommandObjectMultiwordBreakpoint::~CommandObjectMultiwordBreakpoint ()
1797 CommandObjectMultiwordBreakpoint::VerifyBreakpointIDs (Args &args, Target *target, CommandReturnObject &result,
1798 BreakpointIDList *valid_ids)
1800 // args can be strings representing 1). integers (for breakpoint ids)
1801 // 2). the full breakpoint & location canonical representation
1802 // 3). the word "to" or a hyphen, representing a range (in which case there
1803 // had *better* be an entry both before & after of one of the first two types.
1804 // If args is empty, we will use the last created breakpoint (if there is one.)
1808 if (args.GetArgumentCount() == 0)
1810 if (target->GetLastCreatedBreakpoint())
1812 valid_ids->AddBreakpointID (BreakpointID(target->GetLastCreatedBreakpoint()->GetID(), LLDB_INVALID_BREAK_ID));
1813 result.SetStatus (eReturnStatusSuccessFinishNoResult);
1817 result.AppendError("No breakpoint specified and no last created breakpoint.");
1818 result.SetStatus (eReturnStatusFailed);
1823 // Create a new Args variable to use; copy any non-breakpoint-id-ranges stuff directly from the old ARGS to
1824 // the new TEMP_ARGS. Do not copy breakpoint id range strings over; instead generate a list of strings for
1825 // all the breakpoint ids in the range, and shove all of those breakpoint id strings into TEMP_ARGS.
1827 BreakpointIDList::FindAndReplaceIDRanges (args, target, result, temp_args);
1829 // NOW, convert the list of breakpoint id strings in TEMP_ARGS into an actual BreakpointIDList:
1831 valid_ids->InsertStringArray (temp_args.GetConstArgumentVector(), temp_args.GetArgumentCount(), result);
1833 // At this point, all of the breakpoint ids that the user passed in have been converted to breakpoint IDs
1834 // and put into valid_ids.
1836 if (result.Succeeded())
1838 // Now that we've converted everything from args into a list of breakpoint ids, go through our tentative list
1839 // of breakpoint id's and verify that they correspond to valid/currently set breakpoints.
1841 const size_t count = valid_ids->GetSize();
1842 for (size_t i = 0; i < count; ++i)
1844 BreakpointID cur_bp_id = valid_ids->GetBreakpointIDAtIndex (i);
1845 Breakpoint *breakpoint = target->GetBreakpointByID (cur_bp_id.GetBreakpointID()).get();
1846 if (breakpoint != NULL)
1848 const size_t num_locations = breakpoint->GetNumLocations();
1849 if (static_cast<size_t>(cur_bp_id.GetLocationID()) > num_locations)
1851 StreamString id_str;
1852 BreakpointID::GetCanonicalReference (&id_str,
1853 cur_bp_id.GetBreakpointID(),
1854 cur_bp_id.GetLocationID());
1855 i = valid_ids->GetSize() + 1;
1856 result.AppendErrorWithFormat ("'%s' is not a currently valid breakpoint/location id.\n",
1858 result.SetStatus (eReturnStatusFailed);
1863 i = valid_ids->GetSize() + 1;
1864 result.AppendErrorWithFormat ("'%d' is not a currently valid breakpoint id.\n", cur_bp_id.GetBreakpointID());
1865 result.SetStatus (eReturnStatusFailed);