b842f2ecf0
When introduced, breakpoint names were just tags that you could apply to breakpoints that would allow you to refer to a breakpoint when you couldn't capture the ID, or to refer to a collection of breakpoints. This change makes the names independent holders of breakpoint options that you can then apply to breakpoints when you add the name to the breakpoint. It adds the "breakpoint name configure" command to set up or reconfigure breakpoint names. There is also full support for then in the SB API, including a new SBBreakpointName class. The connection between the name and the breakpoints sharing the name remains live, so if you reconfigure the name, all the breakpoint options all change as well. This allows a quick way to share complex breakpoint behavior among a bunch of breakpoints, and a convenient way to iterate on the set. You can also create a name from a breakpoint, allowing a quick way to copy options from one breakpoint to another. I also added the ability to make hidden and delete/disable protected names. When applied to a breakpoint, you will only be able to list, delete or disable that breakpoint if you refer to it explicitly by ID. This feature will allow GUI's that need to use breakpoints for their own purposes to keep their breakpoints from getting accidentally disabled or deleted. <rdar://problem/22094452> llvm-svn: 313292
128 lines
3.7 KiB
C++
128 lines
3.7 KiB
C++
//===-- BreakpointID.cpp ----------------------------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
// C Includes
|
|
#include <stdio.h>
|
|
|
|
// C++ Includes
|
|
// Other libraries and framework includes
|
|
// Project includes
|
|
#include "lldb/Breakpoint/Breakpoint.h"
|
|
#include "lldb/Breakpoint/BreakpointID.h"
|
|
#include "lldb/Utility/Status.h"
|
|
#include "lldb/Utility/Stream.h"
|
|
|
|
using namespace lldb;
|
|
using namespace lldb_private;
|
|
|
|
BreakpointID::BreakpointID(break_id_t bp_id, break_id_t loc_id)
|
|
: m_break_id(bp_id), m_location_id(loc_id) {}
|
|
|
|
BreakpointID::~BreakpointID() = default;
|
|
|
|
static llvm::StringRef g_range_specifiers[] = {"-", "to", "To", "TO"};
|
|
|
|
// Tells whether or not STR is valid to use between two strings representing
|
|
// breakpoint IDs, to
|
|
// indicate a range of breakpoint IDs. This is broken out into a separate
|
|
// function so that we can
|
|
// easily change or add to the format for specifying ID ranges at a later date.
|
|
|
|
bool BreakpointID::IsRangeIdentifier(llvm::StringRef str) {
|
|
for (auto spec : g_range_specifiers) {
|
|
if (spec == str)
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
bool BreakpointID::IsValidIDExpression(llvm::StringRef str) {
|
|
return BreakpointID::ParseCanonicalReference(str).hasValue();
|
|
}
|
|
|
|
llvm::ArrayRef<llvm::StringRef> BreakpointID::GetRangeSpecifiers() {
|
|
return llvm::makeArrayRef(g_range_specifiers);
|
|
}
|
|
|
|
void BreakpointID::GetDescription(Stream *s, lldb::DescriptionLevel level) {
|
|
if (level == eDescriptionLevelVerbose)
|
|
s->Printf("%p BreakpointID:", static_cast<void *>(this));
|
|
|
|
if (m_break_id == LLDB_INVALID_BREAK_ID)
|
|
s->PutCString("<invalid>");
|
|
else if (m_location_id == LLDB_INVALID_BREAK_ID)
|
|
s->Printf("%i", m_break_id);
|
|
else
|
|
s->Printf("%i.%i", m_break_id, m_location_id);
|
|
}
|
|
|
|
void BreakpointID::GetCanonicalReference(Stream *s, break_id_t bp_id,
|
|
break_id_t loc_id) {
|
|
if (bp_id == LLDB_INVALID_BREAK_ID)
|
|
s->PutCString("<invalid>");
|
|
else if (loc_id == LLDB_INVALID_BREAK_ID)
|
|
s->Printf("%i", bp_id);
|
|
else
|
|
s->Printf("%i.%i", bp_id, loc_id);
|
|
}
|
|
|
|
llvm::Optional<BreakpointID>
|
|
BreakpointID::ParseCanonicalReference(llvm::StringRef input) {
|
|
break_id_t bp_id;
|
|
break_id_t loc_id = LLDB_INVALID_BREAK_ID;
|
|
|
|
if (input.empty())
|
|
return llvm::None;
|
|
|
|
// If it doesn't start with an integer, it's not valid.
|
|
if (input.consumeInteger(0, bp_id))
|
|
return llvm::None;
|
|
|
|
// period is optional, but if it exists, it must be followed by a number.
|
|
if (input.consume_front(".")) {
|
|
if (input.consumeInteger(0, loc_id))
|
|
return llvm::None;
|
|
}
|
|
|
|
// And at the end, the entire string must have been consumed.
|
|
if (!input.empty())
|
|
return llvm::None;
|
|
|
|
return BreakpointID(bp_id, loc_id);
|
|
}
|
|
|
|
bool BreakpointID::StringIsBreakpointName(llvm::StringRef str, Status &error) {
|
|
error.Clear();
|
|
if (str.empty())
|
|
{
|
|
error.SetErrorStringWithFormat("Empty breakpoint names are not allowed");
|
|
return false;
|
|
}
|
|
|
|
// First character must be a letter or _
|
|
if (!isalpha(str[0]) && str[0] != '_')
|
|
{
|
|
error.SetErrorStringWithFormat("Breakpoint names must start with a "
|
|
"character or underscore: %s",
|
|
str.str().c_str());
|
|
return false;
|
|
}
|
|
|
|
// Cannot contain ., -, or space.
|
|
if (str.find_first_of(".- ") != llvm::StringRef::npos) {
|
|
error.SetErrorStringWithFormat("Breakpoint names cannot contain "
|
|
"'.' or '-': \"%s\"",
|
|
str.str().c_str());
|
|
return false;
|
|
}
|
|
|
|
return true;
|
|
}
|