remote_gdb.hh revision 3550
1/* 2 * Copyright (c) 2002-2005 The Regents of The University of Michigan 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions are 7 * met: redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer; 9 * redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution; 12 * neither the name of the copyright holders nor the names of its 13 * contributors may be used to endorse or promote products derived from 14 * this software without specific prior written permission. 15 * 16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 18 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 19 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 20 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 21 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 22 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 26 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 * 28 * Authors: Nathan Binkert 29 */ 30 31#ifndef __REMOTE_GDB_HH__ 32#define __REMOTE_GDB_HH__ 33 34#include <map> 35 36#include "arch/types.hh" 37#include "cpu/pc_event.hh" 38#include "base/pollevent.hh" 39#include "base/socket.hh" 40 41class System; 42class ThreadContext; 43class PhysicalMemory; 44 45class GDBListener; 46 47enum GDBCommands 48{ 49 GDBSignal = '?', // last signal 50 GDBSetBaud = 'b', // set baud (depracated) 51 GDBSetBreak = 'B', // set breakpoint (depracated) 52 GDBCont = 'c', // resume 53 GDBAsyncCont = 'C', // continue with signal 54 GDBDebug = 'd', // toggle debug flags (deprecated) 55 GDBDetach = 'D', // detach remote gdb 56 GDBRegR = 'g', // read general registers 57 GDBRegW = 'G', // write general registers 58 GDBSetThread = 'H', // set thread 59 GDBCycleStep = 'i', // step a single cycle 60 GDBSigCycleStep = 'I', // signal then cycle step 61 GDBKill = 'k', // kill program 62 GDBMemR = 'm', // read memory 63 GDBMemW = 'M', // write memory 64 GDBReadReg = 'p', // read register 65 GDBSetReg = 'P', // write register 66 GDBQueryVar = 'q', // query variable 67 GDBSetVar = 'Q', // set variable 68 GDBReset = 'r', // reset system. (Deprecated) 69 GDBStep = 's', // step 70 GDBAsyncStep = 'S', // signal and step 71 GDBThreadAlive = 'T', // find out if the thread is alive 72 GDBTargetExit = 'W', // target exited 73 GDBBinaryDload = 'X', // write memory 74 GDBClrHwBkpt = 'z', // remove breakpoint or watchpoint 75 GDBSetHwBkpt = 'Z' // insert breakpoint or watchpoint 76}; 77 78const char GDBStart = '$'; 79const char GDBEnd = '#'; 80const char GDBGoodP = '+'; 81const char GDBBadP = '-'; 82 83const int GDBPacketBufLen = 1024; 84 85class BaseRemoteGDB 86{ 87 private: 88 friend void debugger(); 89 friend class GDBListener; 90 91 //Helper functions 92 protected: 93 int digit2i(char); 94 char i2digit(int); 95 Addr hex2i(const char **); 96 //Address formats, break types, and gdb commands may change 97 //between architectures, so they're defined as virtual 98 //functions. 99 virtual void mem2hex(void *, const void *, int); 100 virtual const char * hex2mem(void *, const char *, int); 101 virtual const char * break_type(char c); 102 virtual const char * gdb_command(char cmd); 103 104 protected: 105 class Event : public PollEvent 106 { 107 protected: 108 BaseRemoteGDB *gdb; 109 110 public: 111 Event(BaseRemoteGDB *g, int fd, int e); 112 void process(int revent); 113 }; 114 115 friend class Event; 116 Event *event; 117 GDBListener *listener; 118 int number; 119 120 protected: 121 //The socket commands come in through 122 int fd; 123 124 protected: 125#ifdef notyet 126 label_t recover; 127#endif 128 bool active; 129 bool attached; 130 131 System *system; 132 PhysicalMemory *pmem; 133 ThreadContext *context; 134 135 protected: 136 class GdbRegCache 137 { 138 public: 139 GdbRegCache(size_t newSize) : regs(new uint64_t[newSize]), size(newSize) 140 {} 141 ~GdbRegCache() 142 { 143 delete [] regs; 144 } 145 146 uint64_t * regs; 147 size_t size; 148 }; 149 150 GdbRegCache gdbregs; 151 152 protected: 153 uint8_t getbyte(); 154 void putbyte(uint8_t b); 155 156 int recv(char *data, int len); 157 void send(const char *data); 158 159 protected: 160 // Machine memory 161 virtual bool read(Addr addr, size_t size, char *data); 162 virtual bool write(Addr addr, size_t size, const char *data); 163 164 template <class T> T read(Addr addr); 165 template <class T> void write(Addr addr, T data); 166 167 public: 168 BaseRemoteGDB(System *system, ThreadContext *context, size_t cacheSize); 169 virtual ~BaseRemoteGDB(); 170 171 void replaceThreadContext(ThreadContext *tc) { context = tc; } 172 173 void attach(int fd); 174 void detach(); 175 bool isattached(); 176 177 virtual bool acc(Addr addr, size_t len) = 0; 178 bool trap(int type); 179 180 protected: 181 virtual void getregs() = 0; 182 virtual void setregs() = 0; 183 184 virtual void clearSingleStep() = 0; 185 virtual void setSingleStep() = 0; 186 187 PCEventQueue *getPcEventQueue(); 188 189 protected: 190 class HardBreakpoint : public PCEvent 191 { 192 private: 193 BaseRemoteGDB *gdb; 194 195 public: 196 int refcount; 197 198 public: 199 HardBreakpoint(BaseRemoteGDB *_gdb, Addr addr); 200 std::string name() { return gdb->name() + ".hwbkpt"; } 201 202 virtual void process(ThreadContext *tc); 203 }; 204 friend class HardBreakpoint; 205 206 typedef std::map<Addr, HardBreakpoint *> break_map_t; 207 typedef break_map_t::iterator break_iter_t; 208 break_map_t hardBreakMap; 209 210 bool insertSoftBreak(Addr addr, size_t len); 211 bool removeSoftBreak(Addr addr, size_t len); 212 bool insertHardBreak(Addr addr, size_t len); 213 bool removeHardBreak(Addr addr, size_t len); 214 215 protected: 216 void clearTempBreakpoint(Addr &bkpt); 217 void setTempBreakpoint(Addr bkpt); 218 219 public: 220 std::string name(); 221}; 222 223template <class T> 224inline T 225BaseRemoteGDB::read(Addr addr) 226{ 227 T temp; 228 read(addr, sizeof(T), (char *)&temp); 229 return temp; 230} 231 232template <class T> 233inline void 234BaseRemoteGDB::write(Addr addr, T data) 235{ write(addr, sizeof(T), (const char *)&data); } 236 237class GDBListener 238{ 239 protected: 240 class Event : public PollEvent 241 { 242 protected: 243 GDBListener *listener; 244 245 public: 246 Event(GDBListener *l, int fd, int e); 247 void process(int revent); 248 }; 249 250 friend class Event; 251 Event *event; 252 253 protected: 254 ListenSocket listener; 255 BaseRemoteGDB *gdb; 256 int port; 257 258 public: 259 GDBListener(BaseRemoteGDB *g, int p); 260 ~GDBListener(); 261 262 void accept(); 263 void listen(); 264 std::string name(); 265}; 266 267#endif /* __REMOTE_GDB_H__ */ 268