/* * Copyright (C) 2020-2022 Roy Qu (royqh1979@gmail.com) * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef DEBUGGER_H #define DEBUGGER_H #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "gdbmiresultparser.h" enum class DebugCommandSource { Console, HeartBeat, Other }; enum class DebuggerType { GDB, LLDB_MI }; struct DebugCommand{ QString command; QString params; DebugCommandSource source; }; using PDebugCommand = std::shared_ptr; struct WatchVar; using PWatchVar = std::shared_ptr; struct WatchVar { QString name; QString expression; bool hasMore; QString value; QString type; int numChild; QList children; std::weak_ptr parent; //use raw point to prevent circular-reference qint64 timestamp; }; enum class BreakpointType { Breakpoint, Watchpoint, ReadWatchpoint, WriteWatchpoint }; struct Breakpoint { int number; // breakpoint number QString type; // type of the breakpoint QString catch_type; int line; QString filename; QString condition; bool enabled; BreakpointType breakpointType; qint64 timestamp; }; using PBreakpoint = std::shared_ptr; struct DebugConfig { QList breakpoints; QList watchVars; qint64 timestamp; }; using PDebugConfig=std::shared_ptr; struct Trace { QString funcname; QString filename; QString address; int line; int level; }; using PTrace = std::shared_ptr; class RegisterModel: public QAbstractTableModel { Q_OBJECT public: explicit RegisterModel(QObject* parent = nullptr); int rowCount(const QModelIndex &parent) const override; int columnCount(const QModelIndex &parent) const override; QVariant data(const QModelIndex &index, int role) const override; QVariant headerData(int section, Qt::Orientation orientation, int role) const override; void updateNames(const QStringList& regNames); void updateValues(const QHash registerValues); void clear(); private: QHash mRegisterDescriptions; QStringList mRegisterNames; QHash mRegisterNameIndex; QHash mRegisterValues; }; class Debugger; class BreakpointModel: public QAbstractTableModel { Q_OBJECT // QAbstractItemModel interface public: explicit BreakpointModel(QObject *parent = nullptr); int rowCount(const QModelIndex &parent) const override; int columnCount(const QModelIndex &parent) const override; QVariant data(const QModelIndex &index, int role) const override; QVariant headerData(int section, Qt::Orientation orientation, int role) const override; void addBreakpoint(PBreakpoint p, bool forProject); void clear(bool forProject); void removeBreakpoint(int index, bool forProject); void removeBreakpointsInFile(const QString& fileName, bool forProject); void renameBreakpointFilenames(const QString& oldFileName,const QString& newFileName, bool forProject); PBreakpoint setBreakPointCondition(int index, const QString& condition, bool forProject); const QList& breakpoints(bool forProject) const { return forProject?mProjectBreakpoints:mBreakpoints; } PBreakpoint breakpoint(int index, bool forProject) const; public slots: void updateBreakpointNumber(const QString& filename, int line, int number); void invalidateAllBreakpointNumbers(); // call this when gdb is stopped void onFileDeleteLines(const QString& filename, int startLine, int count, bool forProject); void onFileInsertLines(const QString& filename, int startLine, int count, bool forProject); private: bool isForProject() const; void setIsForProject(bool newIsForProject); QList loadJson(const QJsonArray& jsonArray, qint64 criteriaTime); QJsonArray toJson(const QString& projectFolder); void setBreakpoints(const QList& list, bool forProject); private: QList mBreakpoints; QList mProjectBreakpoints; bool mIsForProject; friend class Debugger; }; class BacktraceModel : public QAbstractTableModel { Q_OBJECT // QAbstractItemModel interface public: explicit BacktraceModel(QObject *parent = nullptr); int rowCount(const QModelIndex &parent) const override; int columnCount(const QModelIndex &parent) const override; QVariant data(const QModelIndex &index, int role) const override; QVariant headerData(int section, Qt::Orientation orientation, int role) const override; void addTrace(PTrace p); void clear(); void removeTrace(int index); const QList& backtraces() const; PTrace backtrace(int index) const; private: QList mList; }; class WatchModel: public QAbstractItemModel { Q_OBJECT public: explicit WatchModel(QObject *parent = nullptr); QVariant data(const QModelIndex &index, int role) const override; QModelIndex index(int row, int column, const QModelIndex &parent = QModelIndex()) const override; QModelIndex parent(const QModelIndex &index) const override; QVariant headerData(int section, Qt::Orientation orientation, int role) const override; void fetchMore(const QModelIndex &parent) override; bool canFetchMore(const QModelIndex &parent) const override; int rowCount(const QModelIndex &parent = QModelIndex()) const override; int columnCount(const QModelIndex &parent = QModelIndex()) const override; bool hasChildren(const QModelIndex &parent) const override; QModelIndex index(PWatchVar var) const; QModelIndex index(WatchVar* pVar) const; void removeWatchVar(const QString& expression); void removeWatchVar(const QModelIndex& index); void clear(); void clear(bool forProject); PWatchVar findWatchVar(const QModelIndex& index); PWatchVar findWatchVar(const QString& expr); void resetAllVarInfos(); void clearAllVarInfos(); void beginUpdate(); void endUpdate(); void notifyUpdated(PWatchVar var); signals: void setWatchVarValue(const QString& name, const QString& value); public slots: void updateVarInfo(const QString& expression, const QString& name, int numChild, const QString& value, const QString& type, bool hasMore); void prepareVarChildren(const QString& parentName, int numChild, bool hasMore); void addVarChild(const QString& parentName, const QString& name, const QString& exp, int numChild, const QString& value, const QString& type, bool hasMore); void updateVarValue(const QString& name, const QString& val, const QString& inScope, bool typeChanged, const QString& newType, int newNumChildren, bool hasMore); void updateAllHasMoreVars(); signals: void fetchChildren(const QString& name); private: bool isForProject() const; void setIsForProject(bool newIsForProject); const QList &watchVars(bool forProject) const; QJsonArray toJson(bool forProject); QList loadJson(const QJsonArray &jsonArray, qint64 criteriaTimestamp); const QList &watchVars() const; void addWatchVar(PWatchVar watchVar, bool forProject); void setWatchVars(const QList list, bool forProject); private: QList mWatchVars; QList mProjectWatchVars; QHash mVarIndex; //var index is only valid for the current debugging session int mUpdateCount; bool mIsForProject; // QAbstractItemModel interface public: bool setData(const QModelIndex &index, const QVariant &value, int role) override; Qt::ItemFlags flags(const QModelIndex &index) const override; friend class Debugger; }; struct MemoryLine { uintptr_t startAddress; QList datas; QSet changedDatas; }; using PMemoryLine = std::shared_ptr; class MemoryModel: public QAbstractTableModel{ Q_OBJECT public: explicit MemoryModel(int dataPerLine,QObject* parent=nullptr); void updateMemory(const QStringList& value); qulonglong startAddress() const; void reset(); // QAbstractItemModel interface signals: void setMemoryData(qlonglong address, unsigned char data); public: int rowCount(const QModelIndex &parent) const override; int columnCount(const QModelIndex &parent) const override; QVariant data(const QModelIndex &index, int role) const override; QVariant headerData(int section, Qt::Orientation orientation, int role) const override; bool setData(const QModelIndex &index, const QVariant &value, int role) override; Qt::ItemFlags flags(const QModelIndex &index) const override; private: int mDataPerLine; QList mLines; qulonglong mStartAddress; }; class DebugReader; class DebugTarget; class Editor; using PDebugReader = std::shared_ptr; class Debugger : public QObject { Q_OBJECT public: explicit Debugger(QObject *parent = nullptr); ~Debugger(); // Play/pause bool start(int compilerSetIndex, const QString& inferior, const QStringList& binDirs, const QString& sourceFile=QString()); void sendCommand(const QString& command, const QString& params, DebugCommandSource source = DebugCommandSource::Other); bool commandRunning(); bool inferiorRunning(); void interrupt(); bool isForProject() const; void setIsForProject(bool newIsForProject); void clearForProject(); //breakpoints void addBreakpoint(int line, const Editor* editor); void addBreakpoint(int line, const QString& filename, bool forProject); void deleteBreakpoints(const QString& filename, bool forProject); void deleteBreakpoints(const Editor* editor); void deleteBreakpoints(bool forProject); void deleteInvalidProjectBreakpoints(const QSet unitFiles); void removeBreakpoint(int line, const Editor* editor); void removeBreakpoint(int line, const QString& filename, bool forProject); void removeBreakpoint(int index, bool forProject); PBreakpoint breakpointAt(int line, const QString &filename, int *index, bool forProject); PBreakpoint breakpointAt(int line, const Editor *editor, int *index); void setBreakPointCondition(int index, const QString& condition, bool forProject); void sendAllBreakpointsToDebugger(); void saveForNonproject(const QString &filename); void saveForProject(const QString &filename, const QString &projectFolder); void loadForNonproject(const QString &filename); void loadForProject(const QString& filename, const QString& projectFolder); void addWatchpoint(const QString& expression); //watch vars void addWatchVar(const QString& expression); void modifyWatchVarExpression(const QString& oldExpr, const QString& newExpr); void removeWatchVars(bool deleteparent); void removeWatchVar(const QModelIndex& index); void sendAllWatchVarsToDebugger(); PWatchVar findWatchVar(const QString& expression); PWatchVar watchVarAt(const QModelIndex& index); void refreshVars(); // void notifyWatchVarUpdated(PWatchVar var); std::shared_ptr backtraceModel(); std::shared_ptr breakpointModel(); bool executing() const; int leftPageIndexBackup() const; void setLeftPageIndexBackup(int leftPageIndexBackup); std::shared_ptr watchModel() const; std::shared_ptr registerModel() const; std::shared_ptr memoryModel() const; bool forceUTF8() const; void setForceUTF8(bool newForceUTF8); DebuggerType debuggerType() const; void setDebuggerType(DebuggerType newDebuggerType); signals: void evalValueReady(const QString& s); void memoryExamineReady(const QStringList& s); void localsReady(const QStringList& s); public slots: void stop(); void refreshAll(); private: void sendWatchCommand(PWatchVar var); void sendRemoveWatchCommand(PWatchVar var); void sendBreakpointCommand(PBreakpoint breakpoint); void sendClearBreakpointCommand(int index, bool forProject); void sendClearBreakpointCommand(PBreakpoint breakpoint); void save(const QString& filename, const QString& projectFolder); PDebugConfig load(const QString& filename, bool forProject); void addWatchVar(const PWatchVar &watchVar, bool forProject); private slots: void syncFinishedParsing(); void setMemoryData(qulonglong address, unsigned char data); void setWatchVarValue(const QString& name, const QString& value); void updateMemory(const QStringList& value); void updateEval(const QString& value); void updateDisassembly(const QString& file, const QString& func,const QStringList& value); void onChangeDebugConsoleLastline(const QString& text); void cleanUpReader(); void updateRegisterNames(const QStringList& registerNames); void updateRegisterValues(const QHash& values); void refreshWatchVars(); void fetchVarChildren(const QString& varName); private: bool mExecuting; bool mCommandChanged; std::shared_ptr mBreakpointModel; std::shared_ptr mBacktraceModel; std::shared_ptr mWatchModel; std::shared_ptr mRegisterModel; std::shared_ptr mMemoryModel; DebugReader *mReader; DebugTarget *mTarget; bool mForceUTF8; DebuggerType mDebuggerType; int mLeftPageIndexBackup; qint64 mLastLoadtime; qint64 mProjectLastLoadtime; QString mCurrentSourceFile; }; class DebugTarget: public QThread { Q_OBJECT public: explicit DebugTarget(const QString& inferior, const QString& GDBServer, int port, const QString& arguments, QObject *parent = nullptr); void setInputFile(const QString& inputFile); void stopDebug(); void waitStart(); const QStringList &binDirs() const; void addBinDirs(const QStringList &binDirs); void addBinDir(const QString &binDir); signals: void processError(QProcess::ProcessError error); private: QString mInferior; QString mArguments; QString mGDBServer; int mPort; bool mStop; std::shared_ptr mProcess; QSemaphore mStartSemaphore; bool mErrorOccured; QString mInputFile; QStringList mBinDirs; // QThread interface protected: void run() override; }; class DebugReader : public QThread { Q_OBJECT public: explicit DebugReader(Debugger* debugger, QObject *parent = nullptr); void postCommand(const QString &Command, const QString &Params, DebugCommandSource Source); void registerInferiorStoppedCommand(const QString &Command, const QString &Params); QString debuggerPath() const; void setDebuggerPath(const QString &debuggerPath); void stopDebug(); bool commandRunning(); void waitStart(); bool inferiorPaused() const; bool processExited() const; bool signalReceived() const; const QStringList &consoleOutput() const; int breakPointLine() const; const QString &breakPointFile() const; const PDebugCommand ¤tCmd() const; bool updateCPUInfo() const; bool updateLocals() const; const QStringList &localsValue() const; bool evalReady() const; const QString &evalValue() const; bool updateMemory() const; const QStringList &memoryValue() const; bool receivedSFWarning() const; const QStringList &fullOutput() const; bool inferiorRunning() const; const QString &signalName() const; const QString &signalMeaning() const; const QStringList &binDirs() const; void addBinDirs(const QStringList &binDirs); void addBinDir(const QString &binDir); signals: void parseStarted(); void invalidateAllVars(); void parseFinished(); void writeToDebugFailed(); void processError(QProcess::ProcessError error); void changeDebugConsoleLastLine(const QString& text); void cmdStarted(); void cmdFinished(); void errorNoSymbolTable(); void breakpointInfoGetted(const QString& filename, int line, int number); void inferiorContinued(); void watchpointHitted(const QString& var, const QString& oldVal, const QString& newVal); void inferiorStopped(const QString& filename, int line, bool setFocus); void localsUpdated(const QStringList& localsValue); void evalUpdated(const QString& value); void memoryUpdated(const QStringList& memoryValues); void disassemblyUpdate(const QString& filename, const QString& funcName, const QStringList& result); void registerNamesUpdated(const QStringList& registerNames); void registerValuesUpdated(const QHash& values); void varCreated(const QString& expression, const QString& name, int numChild, const QString& value, const QString& type, bool hasMore); void prepareVarChildren(const QString& parentName,int numChild, bool hasMore); void addVarChild(const QString& parentName, const QString& name, const QString& exp, int numChild, const QString& value, const QString& type, bool hasMore); void varValueUpdated(const QString& name, const QString& val, const QString& inScope, bool typeChanged, const QString& newType, int newNumChildren, bool hasMore); void varsValueUpdated(); private: void clearCmdQueue(); void runNextCmd(); QStringList tokenize(const QString& s); bool outputTerminated(const QByteArray& text); void handleBreakpoint(const GDBMIResultParser::ParseObject& breakpoint); void handleFrame(const GDBMIResultParser::ParseValue &frame); void handleStack(const QList & stack); void handleLocalVariables(const QList & variables); void handleEvaluation(const QString& value); void handleMemory(const QList & rows); void handleRegisterNames(const QList & names); void handleRegisterValue(const QList & values); void handleCreateVar(const GDBMIResultParser::ParseObject& multiVars); void handleListVarChildren(const GDBMIResultParser::ParseObject& multiVars); void handleUpdateVarValue(const QList &changes); void processConsoleOutput(const QByteArray& line); void processResult(const QByteArray& result); void processExecAsyncRecord(const QByteArray& line); void processError(const QByteArray& errorLine); void processResultRecord(const QByteArray& line); void processDebugOutput(const QByteArray& debugOutput); void runInferiorStoppedHook(); QByteArray removeToken(const QByteArray& line); private slots: void asyncUpdate(); private: Debugger *mDebugger; QString mDebuggerPath; #if QT_VERSION >= QT_VERSION_CHECK(5, 15, 0) QRecursiveMutex mCmdQueueMutex; #else QMutex mCmdQueueMutex; #endif QSemaphore mStartSemaphore; QQueue mCmdQueue; bool mErrorOccured; bool mAsyncUpdated; //fOnInvalidateAllVars: TInvalidateAllVarsEvent; bool mCmdRunning; PDebugCommand mCurrentCmd; std::shared_ptr mProcess; QStringList mBinDirs; //fWatchView: TTreeView; QString mSignalName; QString mSignalMeaning; // QList mInferiorStoppedHookCommands; bool mInferiorRunning; bool mProcessExited; bool mSignalReceived; bool mUpdateCPUInfo; bool mReceivedSFWarning; int mCurrentLine; qulonglong mCurrentAddress; QString mCurrentFunc; QString mCurrentFile; QStringList mConsoleOutput; QStringList mFullOutput; bool mStop; // QThread interface protected: void run() override; }; #endif // DEBUGGER_H