gem5  v20.1.0.0
debug.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2003-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 
29 #include "sim/debug.hh"
30 
31 #include <string>
32 #include <vector>
33 
34 #include "base/debug.hh"
35 #include "cpu/pc_event.hh"
36 #include "sim/eventq.hh"
37 #include "sim/global_event.hh"
38 #include "sim/kernel_workload.hh"
39 #include "sim/sim_events.hh"
40 #include "sim/sim_exit.hh"
41 #include "sim/system.hh"
42 
43 using namespace std;
44 
45 //
46 // Debug event: place a breakpoint on the process function and
47 // schedule the event to break at a particular cycle
48 //
50 {
51  DebugBreakEvent(Tick when);
52  void process(); // process event
53  virtual const char *description() const;
54 };
55 
56 //
57 // constructor: schedule at specified time
58 //
60  : GlobalEvent(when, Debug_Break_Pri, AutoDelete)
61 {
62 }
63 
64 //
65 // handle debug event: set debugger breakpoint on this function
66 //
67 void
69 {
71 }
72 
73 
74 const char *
76 {
77  return "debug breakpoint";
78 }
79 
80 //
81 // handy function to schedule DebugBreakEvent on main event queue
82 // (callable from debugger)
83 //
84 void
86 {
87  new DebugBreakEvent(when);
88  warn("need to stop all queues");
89 }
90 
91 void
93 {
94  schedBreak(curTick() + delta);
95 }
96 
100 void
102 {
103  if (!when)
104  when = curTick() + 1;
105  exitSimLoop("checkpoint", 0, when, 0);
106 }
107 
108 void
110 {
111  for (uint32_t i = 0; i < numMainEventQueues; ++i) {
112  mainEventQueue[i]->dump();
113  }
114 }
115 
117 
118 int
120 {
121  return remote_gdb_base_port;
122 }
123 
124 // Set remote GDB base port. 0 means disable remote GDB.
125 // Callable from python.
126 void
128 {
129  remote_gdb_base_port = port;
130 }
131 
warn
#define warn(...)
Definition: logging.hh:239
system.hh
Debug::breakpoint
void breakpoint()
Definition: debug.cc:62
sim_events.hh
ArmISA::i
Bitfield< 7 > i
Definition: miscregs_types.hh:63
Tick
uint64_t Tick
Tick count type.
Definition: types.hh:63
DebugBreakEvent::process
void process()
Definition: debug.cc:68
schedBreak
void schedBreak(Tick when)
Cause the simulator to execute a breakpoint.
Definition: debug.cc:85
sim_exit.hh
DebugBreakEvent::DebugBreakEvent
DebugBreakEvent(Tick when)
Definition: debug.cc:59
mainEventQueue
vector< EventQueue * > mainEventQueue
Array for main event queues.
Definition: eventq.cc:56
debug.hh
schedRelBreak
void schedRelBreak(Tick delta)
Cause the simulator to execute a breakpoint relative to the current tick.
Definition: debug.cc:92
debug.hh
exitSimLoop
void exitSimLoop(const std::string &message, int exit_code, Tick when, Tick repeat, bool serialize)
Schedule an event to exit the simulation loop (returning to Python) at the end of the current cycle (...
Definition: sim_events.cc:88
remote_gdb_base_port
int remote_gdb_base_port
Definition: debug.cc:116
setRemoteGDBPort
void setRemoteGDBPort(int port)
Definition: debug.cc:127
takeCheckpoint
void takeCheckpoint(Tick when)
Function to cause the simulator to take a checkpoint from the debugger.
Definition: debug.cc:101
pc_event.hh
std
Overload hash function for BasicBlockRange type.
Definition: vec_reg.hh:587
eventqDump
void eventqDump()
Dump all the events currently on the event queue.
Definition: debug.cc:109
kernel_workload.hh
numMainEventQueues
uint32_t numMainEventQueues
Current number of allocated main event queues.
Definition: eventq.cc:55
global_event.hh
getRemoteGDBPort
int getRemoteGDBPort()
Definition: debug.cc:119
GlobalEvent
The main global event class.
Definition: global_event.hh:173
DebugBreakEvent::description
virtual const char * description() const
Definition: debug.cc:75
DebugBreakEvent
Definition: debug.cc:49
curTick
Tick curTick()
The current simulated tick.
Definition: core.hh:45
eventq.hh

Generated on Wed Sep 30 2020 14:02:07 for gem5 by doxygen 1.8.17