Files
clang-p2996/lldb/source/Target/ThreadPlanBase.cpp
Greg Clayton f4b47e1579 Abtracted the old "lldb_private::Thread::StopInfo" into an abtract class.
This will allow debugger plug-ins to make any instance of "lldb_private::StopInfo"
that can completely describe any stop reason. It also provides a framework for
doing intelligent things with the stop info at important times in the lifetime
of the inferior. 

Examples include the signal stop info in StopInfoUnixSignal. It will check with
the process to see that the current action is for the signal. These actions
include wether to stop for the signal, wether the notify that the signal was
hit, and wether to pass the signal along to the inferior process. The 
StopInfoUnixSignal class overrides the "ShouldStop()" method of StopInfo and
this allows the stop info to determine if it should stop at the signal or 
continue the process. 


StopInfo subclasses must override the following functions:

    virtual lldb::StopReason
    GetStopReason () const = 0;

    virtual const char *
    GetDescription () = 0;


StopInfo subclasses can override the following functions:


    // If the subclass returns "false", the inferior will resume. The default
    // version of this function returns "true" which means the default stop
    // info will stop the process. The breakpoint subclass will check if
    // the breakpoint wants us to stop by calling any installed callback on
    // the breakpoint, and also checking if the breakpoint is for the current
    // thread. Signals will check if they should stop based off of the 
    // UnixSignal settings in the process.
    virtual bool
    ShouldStop (Event *event_ptr);

    // Sublasses can state if they want to notify the debugger when "ShouldStop"
    // returns false. This would be handy for breakpoints where you want to
    // log information and continue and is also used by the signal stop info
    // to notify that a signal was received (after it checks with the process
    // signal settings).
    virtual bool
    ShouldNotify (Event *event_ptr)
    {
        return false;
    }

    // Allow subclasses to do something intelligent right before we resume.
    // The signal class will figure out if the signal should be propagated
    // to the inferior process and pass that along to the debugger plug-ins.
    virtual void
    WillResume (lldb::StateType resume_state)
    {
        // By default, don't do anything
    }


The support the Mach exceptions was moved into the lldb/source/Plugins/Process/Utility
folder and now doesn't polute the lldb_private::Thread class with platform
specific code.

llvm-svn: 110184
2010-08-04 01:40:35 +00:00

175 lines
4.6 KiB
C++

//===-- ThreadPlanBase.cpp --------------------------------------*- C++ -*-===//
//
// The LLVM Compiler Infrastructure
//
// This file is distributed under the University of Illinois Open Source
// License. See LICENSE.TXT for details.
//
//===----------------------------------------------------------------------===//
#include "lldb/Target/ThreadPlanBase.h"
// C Includes
// C++ Includes
// Other libraries and framework includes
// Project includes
//
#include "lldb/Breakpoint/StoppointCallbackContext.h"
#include "lldb/Breakpoint/BreakpointSite.h"
#include "lldb/Breakpoint/BreakpointLocation.h"
#include "lldb/Breakpoint/Breakpoint.h"
#include "lldb/Core/Stream.h"
#include "lldb/Target/Process.h"
#include "lldb/Target/RegisterContext.h"
#include "lldb/Target/StopInfo.h"
using namespace lldb;
using namespace lldb_private;
//----------------------------------------------------------------------
// ThreadPlanBase: This one always stops, and never has anything particular
// to do.
// FIXME: The "signal handling" policies should probably go here.
//----------------------------------------------------------------------
ThreadPlanBase::ThreadPlanBase (Thread &thread) :
ThreadPlan(ThreadPlan::eKindBase, "base plan", thread, eVoteYes, eVoteNoOpinion)
{
}
ThreadPlanBase::~ThreadPlanBase ()
{
}
void
ThreadPlanBase::GetDescription (Stream *s, lldb::DescriptionLevel level)
{
s->Printf ("Base thread plan.");
}
bool
ThreadPlanBase::ValidatePlan (Stream *error)
{
return true;
}
bool
ThreadPlanBase::PlanExplainsStop ()
{
return true;
}
bool
ThreadPlanBase::ShouldStop (Event *event_ptr)
{
m_stop_vote = eVoteYes;
m_run_vote = eVoteYes;
StopInfo *stop_info = m_thread.GetStopInfo();
if (stop_info)
{
StopReason reason = stop_info->GetStopReason();
switch (reason)
{
case eStopReasonInvalid:
case eStopReasonNone:
m_run_vote = eVoteNo;
m_stop_vote = eVoteNo;
return false;
case eStopReasonBreakpoint:
if (stop_info->ShouldStop(event_ptr))
{
// If we are going to stop for a breakpoint, then unship the other plans
// at this point. Don't force the discard, however, so Master plans can stay
// in place if they want to.
m_thread.DiscardThreadPlans(false);
return true;
}
// If we aren't going to stop at this breakpoint, and it is internal,
// don't report this stop or the subsequent running event.
// Otherwise we will post the stopped & running, but the stopped event will get marked
// with "restarted" so the UI will know to wait and expect the consequent "running".
if (stop_info->ShouldNotify (event_ptr))
{
m_stop_vote = eVoteYes;
m_run_vote = eVoteYes;
}
else
{
m_stop_vote = eVoteNo;
m_run_vote = eVoteNo;
}
return false;
// TODO: the break below was missing, was this intentional??? If so
// please mention it
break;
case eStopReasonException:
// If we crashed, discard thread plans and stop. Don't force the discard, however,
// since on rerun the target may clean up this exception and continue normally from there.
m_thread.DiscardThreadPlans(false);
return true;
case eStopReasonSignal:
if (stop_info->ShouldStop(event_ptr))
{
m_thread.DiscardThreadPlans(false);
return true;
}
else
{
// We're not going to stop, but while we are here, let's figure out
// whether to report this.
if (stop_info->ShouldNotify(event_ptr))
m_stop_vote = eVoteYes;
else
m_stop_vote = eVoteNo;
}
return false;
default:
return true;
}
}
else
{
m_run_vote = eVoteNo;
m_stop_vote = eVoteNo;
}
// If there's no explicit reason to stop, then we will continue.
return false;
}
bool
ThreadPlanBase::StopOthers ()
{
return false;
}
StateType
ThreadPlanBase::RunState ()
{
return eStateRunning;
}
bool
ThreadPlanBase::WillStop ()
{
return true;
}
// The base plan is never done.
bool
ThreadPlanBase::MischiefManaged ()
{
// The base plan is never done.
return false;
}