2010-06-16 11:08:54 +02:00
|
|
|
/**************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** This file is part of Qt Creator
|
|
|
|
|
**
|
|
|
|
|
** Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
|
|
|
|
|
**
|
|
|
|
|
** Contact: Nokia Corporation (qt-info@nokia.com)
|
|
|
|
|
**
|
|
|
|
|
** Commercial Usage
|
|
|
|
|
**
|
|
|
|
|
** Licensees holding valid Qt Commercial licenses may use this file in
|
|
|
|
|
** accordance with the Qt Commercial License Agreement provided with the
|
|
|
|
|
** Software or, alternatively, in accordance with the terms contained in
|
|
|
|
|
** a written agreement between you and Nokia.
|
|
|
|
|
**
|
|
|
|
|
** GNU Lesser General Public License Usage
|
|
|
|
|
**
|
|
|
|
|
** Alternatively, this file may be used under the terms of the GNU Lesser
|
|
|
|
|
** General Public License version 2.1 as published by the Free Software
|
|
|
|
|
** Foundation and appearing in the file LICENSE.LGPL included in the
|
|
|
|
|
** packaging of this file. Please review the following information to
|
|
|
|
|
** ensure the GNU Lesser General Public License version 2.1 requirements
|
|
|
|
|
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
|
|
|
|
|
**
|
|
|
|
|
** If you are unsure which license is appropriate for your use, please
|
|
|
|
|
** contact the sales department at http://qt.nokia.com/contact.
|
|
|
|
|
**
|
|
|
|
|
**************************************************************************/
|
|
|
|
|
|
|
|
|
|
#ifndef DEBUGGER_DEBUGGERENGINE_H
|
|
|
|
|
#define DEBUGGER_DEBUGGERENGINE_H
|
|
|
|
|
|
|
|
|
|
#include "debugger_global.h"
|
|
|
|
|
#include "debuggerconstants.h"
|
|
|
|
|
#include "moduleshandler.h" // For 'Symbols'
|
|
|
|
|
|
|
|
|
|
#include <coreplugin/ssh/sshconnection.h>
|
|
|
|
|
|
|
|
|
|
#include <QtCore/QObject>
|
|
|
|
|
#include <QtCore/QSharedPointer>
|
|
|
|
|
#include <QtCore/QStringList>
|
|
|
|
|
|
|
|
|
|
QT_BEGIN_NAMESPACE
|
|
|
|
|
class QDebug;
|
|
|
|
|
class QPoint;
|
2010-07-21 14:24:29 +02:00
|
|
|
class QMessageBox;
|
2010-06-16 11:08:54 +02:00
|
|
|
QT_END_NAMESPACE
|
|
|
|
|
|
|
|
|
|
namespace TextEditor {
|
|
|
|
|
class ITextEditor;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
namespace Core {
|
|
|
|
|
class IOptionsPage;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
namespace Debugger {
|
|
|
|
|
|
|
|
|
|
class DebuggerRunControl;
|
|
|
|
|
class DebuggerPlugin;
|
|
|
|
|
|
|
|
|
|
class DEBUGGER_EXPORT DebuggerStartParameters
|
|
|
|
|
{
|
|
|
|
|
public:
|
|
|
|
|
DebuggerStartParameters();
|
|
|
|
|
void clear();
|
|
|
|
|
|
|
|
|
|
QString executable;
|
|
|
|
|
QString displayName;
|
|
|
|
|
QString coreFile;
|
|
|
|
|
QStringList processArgs;
|
|
|
|
|
QStringList environment;
|
|
|
|
|
QString workingDirectory;
|
|
|
|
|
qint64 attachPID;
|
|
|
|
|
bool useTerminal;
|
|
|
|
|
bool breakAtMain;
|
|
|
|
|
QString crashParameter; // for AttachCrashedExternal
|
2010-07-30 12:14:54 +02:00
|
|
|
|
2010-08-13 14:18:10 +02:00
|
|
|
// for qml debugging
|
|
|
|
|
QString qmlServerAddress;
|
|
|
|
|
quint16 qmlServerPort;
|
|
|
|
|
|
2010-06-16 11:08:54 +02:00
|
|
|
// for remote debugging
|
|
|
|
|
QString remoteChannel;
|
|
|
|
|
QString remoteArchitecture;
|
|
|
|
|
QString symbolFileName;
|
|
|
|
|
QString serverStartScript;
|
|
|
|
|
QString sysRoot;
|
2010-07-30 12:14:54 +02:00
|
|
|
QByteArray remoteDumperLib;
|
|
|
|
|
QByteArray remoteSourcesDir;
|
2010-08-09 15:27:21 +02:00
|
|
|
QString remoteMountPoint;
|
|
|
|
|
QString localMountDir;
|
2010-07-30 12:14:54 +02:00
|
|
|
Core::SshConnectionParameters connParams;
|
|
|
|
|
|
2010-06-16 11:08:54 +02:00
|
|
|
QString debuggerCommand;
|
|
|
|
|
int toolChainType;
|
|
|
|
|
QString qtInstallPath;
|
|
|
|
|
|
|
|
|
|
QString dumperLibrary;
|
|
|
|
|
QStringList dumperLibraryLocations;
|
|
|
|
|
DebuggerStartMode startMode;
|
2010-08-20 12:58:37 +02:00
|
|
|
|
|
|
|
|
// for SymbianOS debugging
|
|
|
|
|
quint32 executableUid;
|
2010-06-16 11:08:54 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
|
|
DEBUGGER_EXPORT QDebug operator<<(QDebug str, const DebuggerStartParameters &);
|
|
|
|
|
DEBUGGER_EXPORT QDebug operator<<(QDebug str, DebuggerState state);
|
|
|
|
|
|
|
|
|
|
namespace Internal {
|
|
|
|
|
|
|
|
|
|
class DisassemblerViewAgent;
|
|
|
|
|
class MemoryViewAgent;
|
|
|
|
|
class Symbol;
|
|
|
|
|
class WatchData;
|
|
|
|
|
class BreakHandler;
|
|
|
|
|
class ModulesHandler;
|
|
|
|
|
class RegisterHandler;
|
|
|
|
|
class StackHandler;
|
|
|
|
|
class StackFrame;
|
|
|
|
|
class SourceFilesHandler;
|
|
|
|
|
class ThreadsHandler;
|
|
|
|
|
class WatchHandler;
|
|
|
|
|
|
|
|
|
|
class DebuggerEnginePrivate;
|
|
|
|
|
|
2010-06-25 14:08:53 +02:00
|
|
|
// FIXME: DEBUGGER_EXPORT?
|
|
|
|
|
class DEBUGGER_EXPORT DebuggerEngine : public QObject
|
2010-06-16 11:08:54 +02:00
|
|
|
{
|
|
|
|
|
Q_OBJECT
|
|
|
|
|
|
|
|
|
|
public:
|
|
|
|
|
DebuggerEngine(const DebuggerStartParameters &sp);
|
|
|
|
|
virtual ~DebuggerEngine();
|
|
|
|
|
|
2010-06-22 12:28:05 +02:00
|
|
|
virtual void setToolTipExpression(const QPoint & /* mousePos */,
|
|
|
|
|
TextEditor::ITextEditor * /* editor */, int /* cursorPos */) { }
|
2010-06-16 11:08:54 +02:00
|
|
|
void initializeFromTemplate(DebuggerEngine *other);
|
2010-07-08 18:10:50 +02:00
|
|
|
|
|
|
|
|
virtual void updateWatchData(const WatchData & /* data */) { }
|
2010-06-16 11:08:54 +02:00
|
|
|
void startDebugger(DebuggerRunControl *runControl);
|
2010-07-08 18:10:50 +02:00
|
|
|
virtual bool isSessionEngine() const { return false; }
|
|
|
|
|
|
|
|
|
|
virtual void watchPoint(const QPoint &) {}
|
|
|
|
|
virtual void fetchMemory(MemoryViewAgent *, QObject *,
|
|
|
|
|
quint64 addr, quint64 length);
|
|
|
|
|
virtual void fetchDisassembler(DisassemblerViewAgent *) {}
|
|
|
|
|
virtual void activateFrame(int index) { Q_UNUSED(index); }
|
|
|
|
|
|
|
|
|
|
virtual void reloadModules() {}
|
2010-07-22 16:53:01 +02:00
|
|
|
virtual void examineModules() {}
|
2010-07-08 18:10:50 +02:00
|
|
|
virtual void loadSymbols(const QString &moduleName)
|
|
|
|
|
{ Q_UNUSED(moduleName); }
|
|
|
|
|
virtual void loadAllSymbols() {}
|
|
|
|
|
virtual void requestModuleSymbols(const QString &moduleName)
|
|
|
|
|
{ Q_UNUSED(moduleName); }
|
|
|
|
|
|
|
|
|
|
virtual void reloadRegisters() {}
|
|
|
|
|
virtual void reloadSourceFiles() {}
|
|
|
|
|
virtual void reloadFullStack() {}
|
|
|
|
|
|
|
|
|
|
virtual void setRegisterValue(int regnr, const QString &value);
|
|
|
|
|
virtual void addOptionPages(QList<Core::IOptionsPage*> *) const {}
|
|
|
|
|
virtual unsigned debuggerCapabilities() const { return 0; }
|
|
|
|
|
|
|
|
|
|
virtual bool isSynchroneous() const { return false; }
|
|
|
|
|
virtual QString qtNamespace() const { return QString(); }
|
|
|
|
|
|
2010-07-21 09:42:33 +02:00
|
|
|
virtual void createSnapshot() {}
|
2010-07-13 15:57:34 +02:00
|
|
|
virtual void updateAll() {}
|
2010-07-08 18:10:50 +02:00
|
|
|
|
|
|
|
|
virtual void attemptBreakpointSynchronization() {}
|
|
|
|
|
virtual void selectThread(int index) { Q_UNUSED(index); }
|
|
|
|
|
|
|
|
|
|
virtual void assignValueInDebugger(const QString &expr, const QString &value)
|
|
|
|
|
{ Q_UNUSED(expr); Q_UNUSED(value); }
|
|
|
|
|
|
2010-07-21 14:24:29 +02:00
|
|
|
// Convenience
|
|
|
|
|
static QMessageBox *showMessageBox
|
|
|
|
|
(int icon, const QString &title, const QString &text, int buttons = 0);
|
|
|
|
|
|
2010-07-08 18:10:50 +02:00
|
|
|
protected:
|
2010-06-16 11:08:54 +02:00
|
|
|
virtual void detachDebugger() {}
|
|
|
|
|
virtual void executeStep() {}
|
|
|
|
|
virtual void executeStepOut() {}
|
|
|
|
|
virtual void executeNext() {}
|
|
|
|
|
virtual void executeStepI() {}
|
|
|
|
|
virtual void executeNextI() {}
|
|
|
|
|
virtual void executeReturn() {}
|
|
|
|
|
|
|
|
|
|
virtual void continueInferior() {}
|
|
|
|
|
virtual void interruptInferior() {}
|
|
|
|
|
|
2010-07-20 12:14:59 +02:00
|
|
|
virtual void requestInterruptInferior();
|
|
|
|
|
|
2010-06-16 11:08:54 +02:00
|
|
|
virtual void executeRunToLine(const QString &fileName, int lineNumber)
|
|
|
|
|
{ Q_UNUSED(fileName); Q_UNUSED(lineNumber); }
|
|
|
|
|
virtual void executeRunToFunction(const QString &functionName)
|
|
|
|
|
{ Q_UNUSED(functionName); }
|
|
|
|
|
virtual void executeJumpToLine(const QString &fileName, int lineNumber)
|
|
|
|
|
{ Q_UNUSED(fileName); Q_UNUSED(lineNumber); }
|
|
|
|
|
virtual void executeDebuggerCommand(const QString &command)
|
|
|
|
|
{ Q_UNUSED(command); }
|
|
|
|
|
|
|
|
|
|
virtual void frameUp();
|
|
|
|
|
virtual void frameDown();
|
|
|
|
|
|
|
|
|
|
public:
|
2010-07-21 14:24:29 +02:00
|
|
|
static DebuggerPlugin *plugin();
|
2010-06-16 11:08:54 +02:00
|
|
|
const DebuggerStartParameters &startParameters() const;
|
|
|
|
|
DebuggerStartParameters &startParameters();
|
|
|
|
|
|
|
|
|
|
ModulesHandler *modulesHandler() const;
|
|
|
|
|
BreakHandler *breakHandler() const;
|
|
|
|
|
RegisterHandler *registerHandler() const;
|
|
|
|
|
StackHandler *stackHandler() const;
|
|
|
|
|
ThreadsHandler *threadsHandler() const;
|
|
|
|
|
WatchHandler *watchHandler() const;
|
|
|
|
|
SourceFilesHandler *sourceFilesHandler() const;
|
|
|
|
|
|
|
|
|
|
QAbstractItemModel *commandModel() const;
|
|
|
|
|
QAbstractItemModel *modulesModel() const;
|
|
|
|
|
QAbstractItemModel *breakModel() const;
|
|
|
|
|
QAbstractItemModel *registerModel() const;
|
|
|
|
|
QAbstractItemModel *stackModel() const;
|
|
|
|
|
QAbstractItemModel *threadsModel() const;
|
|
|
|
|
QAbstractItemModel *localsModel() const;
|
|
|
|
|
QAbstractItemModel *watchersModel() const;
|
|
|
|
|
QAbstractItemModel *returnModel() const;
|
2010-07-13 15:57:34 +02:00
|
|
|
//QAbstractItemModel *snapshotModel() const;
|
2010-06-16 11:08:54 +02:00
|
|
|
QAbstractItemModel *sourceFilesModel() const;
|
|
|
|
|
|
2010-07-21 11:02:51 +02:00
|
|
|
void progressPing();
|
2010-06-22 15:14:44 +02:00
|
|
|
void handleFinished();
|
2010-07-20 18:31:35 +02:00
|
|
|
void handleStartFailed();
|
2010-06-16 11:08:54 +02:00
|
|
|
bool debuggerActionsEnabled() const;
|
|
|
|
|
static bool debuggerActionsEnabled(DebuggerState state);
|
|
|
|
|
void showModuleSymbols(const QString &moduleName, const Symbols &symbols);
|
|
|
|
|
|
|
|
|
|
void breakByFunction(const QString &functionName);
|
|
|
|
|
void breakByFunctionMain();
|
|
|
|
|
|
|
|
|
|
void executeStepX();
|
|
|
|
|
void executeStepOutX();
|
|
|
|
|
void executeStepNextX();
|
|
|
|
|
void executeReturnX();
|
|
|
|
|
|
|
|
|
|
DebuggerState state() const;
|
2010-07-09 17:07:59 +02:00
|
|
|
DebuggerState lastGoodState() const;
|
|
|
|
|
DebuggerState targetState() const;
|
|
|
|
|
bool isDying() const { return targetState() == DebuggerFinished; }
|
2010-06-16 11:08:54 +02:00
|
|
|
|
|
|
|
|
// Dumper stuff (common to cdb and gdb).
|
|
|
|
|
bool qtDumperLibraryEnabled() const;
|
|
|
|
|
QString qtDumperLibraryName() const;
|
|
|
|
|
QStringList qtDumperLibraryLocations() const;
|
2010-07-21 12:04:20 +02:00
|
|
|
void showQtDumperLibraryWarning(const QString &details);
|
2010-06-16 11:08:54 +02:00
|
|
|
|
|
|
|
|
static const char *stateName(int s);
|
|
|
|
|
|
|
|
|
|
void notifyInferiorPid(qint64 pid);
|
|
|
|
|
qint64 inferiorPid() const;
|
|
|
|
|
bool isReverseDebugging() const;
|
2010-07-13 17:16:31 +02:00
|
|
|
bool isActive() const; // True if this is the currently active engine;
|
|
|
|
|
void setActive(bool on); // FIXME: private?
|
2010-06-22 15:37:27 +02:00
|
|
|
void handleCommand(int role, const QVariant &value);
|
2010-06-16 11:08:54 +02:00
|
|
|
|
2010-07-09 08:48:33 +02:00
|
|
|
// Convenience
|
2010-07-14 16:01:53 +02:00
|
|
|
Q_SLOT void showMessage(const QString &msg, int channel = LogDebug, int timeout = -1) const;
|
|
|
|
|
Q_SLOT void showStatusMessage(const QString &msg, int timeout = -1) const;
|
2010-07-09 08:48:33 +02:00
|
|
|
|
2010-06-16 11:08:54 +02:00
|
|
|
void resetLocation();
|
|
|
|
|
void openFile(const QString &fileName, int lineNumber = -1);
|
|
|
|
|
void gotoLocation(const QString &fileName, int lineNumber, bool setMarker);
|
|
|
|
|
void gotoLocation(const StackFrame &frame, bool setMarker);
|
2010-07-09 17:07:59 +02:00
|
|
|
virtual void quitDebugger(); // called by DebuggerRunControl
|
2010-06-16 11:08:54 +02:00
|
|
|
|
|
|
|
|
protected:
|
2010-08-11 09:46:39 +02:00
|
|
|
// The base notify*() function implementation should be sufficient
|
|
|
|
|
// in most cases, but engines are free to override them to do some
|
|
|
|
|
// engine specific cleanup like stopping timers etc.
|
|
|
|
|
virtual void notifyEngineSetupOk();
|
|
|
|
|
virtual void notifyEngineSetupFailed();
|
|
|
|
|
virtual void notifyEngineRunFailed();
|
2010-06-16 11:08:54 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyInferiorSetupOk();
|
|
|
|
|
virtual void notifyInferiorSetupFailed();
|
2010-07-08 18:10:50 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyEngineRunAndInferiorRunOk();
|
|
|
|
|
virtual void notifyEngineRunAndInferiorStopOk();
|
|
|
|
|
virtual void notifyInferiorUnrunnable(); // Called by CoreAdapter.
|
2010-07-13 08:41:27 +02:00
|
|
|
|
|
|
|
|
// Use notifyInferiorRunRequested() plus notifyInferiorRunOk() instead.
|
2010-08-11 09:46:39 +02:00
|
|
|
//virtual void notifyInferiorSpontaneousRun();
|
2010-07-09 17:07:59 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyInferiorRunRequested();
|
|
|
|
|
virtual void notifyInferiorRunOk();
|
|
|
|
|
virtual void notifyInferiorRunFailed();
|
2010-07-09 17:07:59 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyInferiorStopOk();
|
|
|
|
|
virtual void notifyInferiorSpontaneousStop();
|
|
|
|
|
virtual void notifyInferiorStopFailed();
|
|
|
|
|
virtual void notifyInferiorExited();
|
2010-07-09 17:07:59 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyInferiorShutdownOk();
|
|
|
|
|
virtual void notifyInferiorShutdownFailed();
|
2010-07-09 17:07:59 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyEngineSpontaneousShutdown();
|
|
|
|
|
virtual void notifyEngineShutdownOk();
|
|
|
|
|
virtual void notifyEngineShutdownFailed();
|
2010-07-09 08:48:33 +02:00
|
|
|
|
2010-08-11 09:46:39 +02:00
|
|
|
virtual void notifyInferiorIll();
|
|
|
|
|
virtual void notifyEngineIll();
|
2010-07-09 08:48:33 +02:00
|
|
|
|
2010-07-09 17:07:59 +02:00
|
|
|
virtual void setupEngine() = 0;
|
|
|
|
|
virtual void setupInferior() = 0;
|
|
|
|
|
virtual void runEngine() = 0;
|
|
|
|
|
virtual void shutdownInferior() = 0;
|
|
|
|
|
virtual void shutdownEngine() = 0;
|
2010-07-08 18:10:50 +02:00
|
|
|
|
2010-07-13 08:41:27 +02:00
|
|
|
private:
|
2010-07-08 15:06:09 +02:00
|
|
|
void setState(DebuggerState state, bool forced = false);
|
|
|
|
|
|
2010-06-22 17:18:29 +02:00
|
|
|
private:
|
|
|
|
|
void executeRunToLine();
|
|
|
|
|
void executeRunToFunction();
|
|
|
|
|
void executeJumpToLine();
|
2010-06-22 18:30:18 +02:00
|
|
|
void addToWatchWindow();
|
2010-06-22 17:18:29 +02:00
|
|
|
|
2010-07-08 18:10:50 +02:00
|
|
|
friend class DebuggerEnginePrivate;
|
2010-06-16 11:08:54 +02:00
|
|
|
DebuggerEnginePrivate *d;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
} // namespace Internal
|
|
|
|
|
} // namespace Debugger
|
|
|
|
|
|
|
|
|
|
#endif // DEBUGGER_DEBUGGERENGINE_H
|