gem5  v20.1.0.0
init_signals.cc
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2012, 2015 ARM Limited
3  * All rights reserved
4  *
5  * The license below extends only to copyright in the software and shall
6  * not be construed as granting a license to any other intellectual
7  * property including but not limited to intellectual property relating
8  * to a hardware implementation of the functionality of the software
9  * licensed hereunder. You may use the software subject to the license
10  * terms below provided that you ensure that this notice is replicated
11  * unmodified and in its entirety in all distributions of the software,
12  * modified or unmodified, in source code or in binary form.
13  *
14  * Copyright (c) 2000-2005 The Regents of The University of Michigan
15  * Copyright (c) 2008 The Hewlett-Packard Development Company
16  * All rights reserved.
17  *
18  * Redistribution and use in source and binary forms, with or without
19  * modification, are permitted provided that the following conditions are
20  * met: redistributions of source code must retain the above copyright
21  * notice, this list of conditions and the following disclaimer;
22  * redistributions in binary form must reproduce the above copyright
23  * notice, this list of conditions and the following disclaimer in the
24  * documentation and/or other materials provided with the distribution;
25  * neither the name of the copyright holders nor the names of its
26  * contributors may be used to endorse or promote products derived from
27  * this software without specific prior written permission.
28  *
29  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
30  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
31  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
32  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
33  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
34  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
35  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
36  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
37  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
39  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40  */
41 
42 #include "sim/init_signals.hh"
43 
44 #include <sys/types.h>
45 #include <unistd.h>
46 
47 #include <csignal>
48 #include <iostream>
49 #include <string>
50 
51 #if defined(__FreeBSD__)
52 #include <sys/param.h>
53 
54 #endif
55 
56 #include "base/atomicio.hh"
57 #include "base/cprintf.hh"
58 #include "base/logging.hh"
59 #include "sim/async.hh"
60 #include "sim/backtrace.hh"
61 #include "sim/core.hh"
62 #include "sim/eventq.hh"
63 
64 using namespace std;
65 
66 // Use an separate stack for fatal signal handlers
67 static uint8_t fatalSigStack[2 * SIGSTKSZ];
68 
69 static bool
71 {
72  stack_t stack;
73 #if defined(__FreeBSD__) && (__FreeBSD_version < 1100097)
74  stack.ss_sp = (char *)fatalSigStack;
75 #else
76  stack.ss_sp = fatalSigStack;
77 #endif
78  stack.ss_size = sizeof(fatalSigStack);
79  stack.ss_flags = 0;
80 
81  return sigaltstack(&stack, NULL) == 0;
82 }
83 
84 static void
85 installSignalHandler(int signal, void (*handler)(int sigtype),
86  int flags = SA_RESTART)
87 {
88  struct sigaction sa;
89 
90  memset(&sa, 0, sizeof(sa));
91  sigemptyset(&sa.sa_mask);
92  sa.sa_handler = handler;
93  sa.sa_flags = flags;
94 
95  if (sigaction(signal, &sa, NULL) == -1)
96  panic("Failed to setup handler for signal %i\n", signal);
97 }
98 
99 static void
101 {
102  // The signal handler should have been reset and unmasked (it was
103  // registered with SA_RESETHAND | SA_NODEFER), just raise the
104  // signal again to invoke the default handler.
105  pthread_kill(pthread_self(), signo);
106 
107  // Something is really wrong if the process is alive at this
108  // point, manually try to exit it.
109  STATIC_ERR("Failed to execute default signal handler!\n");
110  _exit(127);
111 }
112 
114 void
115 dumpStatsHandler(int sigtype)
116 {
117  async_event = true;
118  async_statdump = true;
119  /* Wake up some event queue to handle event */
120  getEventQueue(0)->wakeup();
121 }
122 
123 void
125 {
126  async_event = true;
127  async_statdump = true;
128  async_statreset = true;
129  /* Wake up some event queue to handle event */
130  getEventQueue(0)->wakeup();
131 }
132 
134 void
135 exitNowHandler(int sigtype)
136 {
137  async_event = true;
138  async_exit = true;
139  /* Wake up some event queue to handle event */
140  getEventQueue(0)->wakeup();
141 }
142 
144 void
145 abortHandler(int sigtype)
146 {
147  const EventQueue *const eq(curEventQueue());
148  if (eq) {
149  ccprintf(cerr, "Program aborted at tick %llu\n", eq->getCurTick());
150  } else {
151  STATIC_ERR("Program aborted\n\n");
152  }
153 
154  print_backtrace();
155  raiseFatalSignal(sigtype);
156 }
157 
159 static void
160 segvHandler(int sigtype)
161 {
162  STATIC_ERR("gem5 has encountered a segmentation fault!\n\n");
163 
164  print_backtrace();
165  raiseFatalSignal(SIGSEGV);
166 }
167 
168 // Handle SIGIO
169 static void
170 ioHandler(int sigtype)
171 {
172  async_event = true;
173  async_io = true;
174  /* Wake up some event queue to handle event */
175  getEventQueue(0)->wakeup();
176 }
177 
178 /*
179  * M5 can do several special things when various signals are sent.
180  * None are mandatory.
181  */
182 void
184 {
185  // Floating point exceptions may happen on misspeculated paths, so
186  // ignore them
187  signal(SIGFPE, SIG_IGN);
188 
189  // Dump intermediate stats
191 
192  // Dump intermediate stats and reset them
194 
195  // Exit cleanly on Interrupt (Ctrl-C)
197 
198  // Print the current cycle number and a backtrace on abort. Make
199  // sure the signal is unmasked and the handler reset when a signal
200  // is delivered to be able to invoke the default handler.
201  installSignalHandler(SIGABRT, abortHandler, SA_RESETHAND | SA_NODEFER);
202 
203  // Setup a SIGSEGV handler with a private stack
204  if (setupAltStack()) {
206  SA_RESETHAND | SA_NODEFER | SA_ONSTACK);
207  } else {
208  warn("Failed to setup stack for SIGSEGV handler, "
209  "using default signal handler.\n");
210  }
211 
212  // Install a SIGIO handler to handle asynchronous file IO. See the
213  // PollQueue class.
215 }
216 
async_event
volatile bool async_event
Some asynchronous event has happened.
Definition: async.cc:29
warn
#define warn(...)
Definition: logging.hh:239
async_io
volatile bool async_io
Async I/O request (SIGIO).
Definition: async.cc:33
getEventQueue
EventQueue * getEventQueue(uint32_t index)
Function for returning eventq queue for the provided index.
Definition: eventq.cc:61
abortHandler
void abortHandler(int sigtype)
Abort signal handler.
Definition: init_signals.cc:145
atomicio.hh
async_statdump
volatile bool async_statdump
Async request to dump stats.
Definition: async.cc:30
dumpStatsHandler
void dumpStatsHandler(int sigtype)
Stats signal handler.
Definition: init_signals.cc:115
async_exit
volatile bool async_exit
Async request to exit simulator.
Definition: async.cc:32
exitNowHandler
void exitNowHandler(int sigtype)
Exit signal handler.
Definition: init_signals.cc:135
installSignalHandler
static void installSignalHandler(int signal, void(*handler)(int sigtype), int flags=SA_RESTART)
Definition: init_signals.cc:85
EventQueue::wakeup
virtual void wakeup(Tick when=(Tick) -1)
Function to signal that the event loop should be woken up because an event has been scheduled by an a...
Definition: eventq.hh:923
X86ISA::stack
Bitfield< 17, 16 > stack
Definition: misc.hh:587
segvHandler
static void segvHandler(int sigtype)
Segmentation fault signal handler.
Definition: init_signals.cc:160
setupAltStack
static bool setupAltStack()
Definition: init_signals.cc:70
async_statreset
volatile bool async_statreset
Async request to reset stats.
Definition: async.cc:31
STATIC_ERR
#define STATIC_ERR(m)
Statically allocate a string and write it to STDERR.
Definition: atomicio.hh:64
ArmISA::sa
Bitfield< 3 > sa
Definition: miscregs_types.hh:386
initSignals
void initSignals()
Definition: init_signals.cc:183
curEventQueue
EventQueue * curEventQueue()
Definition: eventq.hh:83
cprintf.hh
core.hh
async.hh
ioHandler
static void ioHandler(int sigtype)
Definition: init_signals.cc:170
PowerISA::eq
Bitfield< 29 > eq
Definition: miscregs.hh:48
std
Overload hash function for BasicBlockRange type.
Definition: vec_reg.hh:587
raiseFatalSignal
static void raiseFatalSignal(int signo)
Definition: init_signals.cc:100
fatalSigStack
static uint8_t fatalSigStack[2 *SIGSTKSZ]
Definition: init_signals.cc:67
ccprintf
void ccprintf(cp::Print &print)
Definition: cprintf.hh:127
logging.hh
init_signals.hh
EventQueue
Queue of events sorted in time order.
Definition: eventq.hh:617
dumprstStatsHandler
void dumprstStatsHandler(int sigtype)
Definition: init_signals.cc:124
backtrace.hh
print_backtrace
void print_backtrace()
Print a gem5 post-mortem report.
Definition: backtrace_glibc.cc:51
panic
#define panic(...)
This implements a cprintf based panic() function.
Definition: logging.hh:171
eventq.hh

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