gecko-dev/js/js2/debugger.h
2000-05-12 01:20:34 +00:00

166 lines
4.8 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*-
*
* The contents of this file are subject to the Netscape Public
* License Version 1.1 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.mozilla.org/NPL/
*
* Software distributed under the License is distributed on an "AS
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express oqr
* implied. See the License for the specific language governing
* rights and limitations under the License.
*
* The Original Code is the JavaScript 2 Prototype.
*
* The Initial Developer of the Original Code is Netscape
* Communications Corporation. Portions created by Netscape are
* Copyright (C) 1998 Netscape Communications Corporation. All
* Rights Reserved.
*
* Contributor(s):
*
* Alternatively, the contents of this file may be used under the
* terms of the GNU Public License (the "GPL"), in which case the
* provisions of the GPL are applicable instead of those above.
* If you wish to allow use of your version of this file only
* under the terms of the GPL and not to allow others to use your
* version of this file under the NPL, indicate your decision by
* deleting the provisions above and replace them with the notice
* and other provisions required by the GPL. If you do not delete
* the provisions above, a recipient may use your version of this
* file under either the NPL or the GPL.
*/
/* this is all vapor, don't take it to serious yet */
#ifndef debugger_h
#define debugger_h
#include "utilities.h"
#include "interpreter.h"
#include <stdio.h>
namespace JavaScript {
namespace Debugger {
using namespace Interpreter;
class Breakpoint {
public:
/* representation of a breakpoint */
void set();
void clear();
bool getState();
InstructionIterator getPC();
};
class ICodeDebugger {
public:
/**
* install an icdebugger on a context
*/
static bool attachToContext (Context *aContext);
/**
* detach an icdebugger from a context
*/
static bool detachFromContext (Context *aContext);
enum DebuggerAction {
/* step to next instruction */
STEP,
/* step until current block returns or execution completes */
STEP_OUT,
/* execute next instruction, treat CALLs as a single instruction */
NEXT,
/* resume normal execution */
CONT,
/* restart the program from the top */
RUN,
/* clear current execution, prepare to step from top */
KILL
};
/**
* tell the debugger what to do when the debuggerCallback returns
*/
void setNextAction (DebuggerAction aAction);
/**
* evaluate an expression within the current execution state
*/
JSValue evaluate (ICodeModule *aICode);
/**
* create a break at a desired pc
*/
Breakpoint *createBreakpoint (InstructionIterator aPC);
/**
* destroy a breakpoint
*/
void destroyBreakpoint (Breakpoint *aBreak);
/**
* get the current pc
*/
InstructionIterator getPC() const;
/**
* set next statement to a desired pc, return the last pc
*/
InstructionIterator setNextStatement(InstructionIterator aPC);
}; /* class ICodeDebugger */
class Shell : public Context::Listener {
public:
Shell (World &aWorld, FILE *aIn, Formatter &aOut, Formatter &aErr) :
mWorld(aWorld), mIn(aIn), mOut(aOut), mErr(aErr),
mStopMask(Context::EV_ALL), mTraceFlag(true)
{
mDebugger = new ICodeDebugger();
}
~Shell ()
{
delete mDebugger;
}
void listen(Context *context, Context::Event event);
/**
* install on a context
*/
bool attachToContext (Context *aContext)
{
aContext->addListener (this);
return true;
}
/**
* detach an icdebugger from a context
*/
bool detachFromContext (Context *aContext)
{
aContext->removeListener (this);
return true;
}
private:
bool doCommand (Context *context, const String &aSource);
void doSetVariable (Lexer &lex);
void doPrint (Context *cx, Lexer &lex);
World &mWorld;
FILE *mIn;
Formatter &mOut, &mErr;
ICodeDebugger *mDebugger;
uint32 mStopMask;
bool mTraceFlag;
};
} /* namespace Debugger */
} /* namespace JavaScript */
#endif /* debugger_h */