LLDB mainline
LinuxSignals.cpp
Go to the documentation of this file.
1//===-- LinuxSignals.cpp --------------------------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#include "LinuxSignals.h"
10
11// mips-linux debugging is not supported and mips uses different numbers for
12// some signals (e.g. SIGBUS) on linux, so we skip the static checks below. The
13// definitions here can be used for debugging non-mips targets on a mips-hosted
14// lldb.
15#if defined(__linux__) && !defined(__mips__)
16#include <csignal>
17
18#ifndef SEGV_BNDERR
19#define SEGV_BNDERR 3
20#endif
21#ifndef SEGV_PKUERR
22#define SEGV_PKUERR 4
23#endif
24#ifndef SEGV_MTEAERR
25#define SEGV_MTEAERR 8
26#endif
27#ifndef SEGV_MTESERR
28#define SEGV_MTESERR 9
29#endif
30#ifndef SEGV_CPERR
31#define SEGV_CPERR 10
32#endif
33#ifndef SI_QUEUE
34#define SI_QUEUE -1
35#endif
36#ifndef SI_TIMER
37#define SI_TIMER -2
38#endif
39#ifndef SI_MESGQ
40#define SI_MESGQ -3
41#endif
42#ifndef SI_ASYNCIO
43#define SI_ASYNCIO -4
44#endif
45#ifndef SI_SIGIO
46#define SI_SIGIO -5
47#endif
48#ifndef SI_TKILL
49#define SI_TKILL -6
50#endif
51#ifndef SI_DETHREAD
52#define SI_DETHREAD -7
53#endif
54#ifndef SI_ASYNCNL
55#define SI_ASYNCNL -60
56#endif
57
58#define ADD_SIGCODE(signal_name, signal_value, code_name, code_value, ...) \
59 static_assert(signal_name == signal_value, \
60 "Value mismatch for signal number " #signal_name); \
61 static_assert(code_name == code_value, \
62 "Value mismatch for signal code " #code_name); \
63 AddSignalCode(signal_value, code_value, __VA_ARGS__)
64#else
65#define ADD_SIGCODE(signal_name, signal_value, code_name, code_value, ...) \
66 AddSignalCode(signal_value, code_value, __VA_ARGS__)
67#endif /* if defined(__linux__) && !defined(__mips__) */
68// See siginfo.h in the Linux Kernel, these codes can be sent for any signal.
69#define ADD_LINUX_SIGNAL(signo, name, ...) \
70 AddSignal(signo, name, __VA_ARGS__); \
71 ADD_SIGCODE(signo, signo, SI_USER, 0, "sent by kill, sigsend or raise", \
72 SignalCodePrintOption::Sender); \
73 ADD_SIGCODE(signo, signo, SI_KERNEL, 0x80, "sent by kernel (SI_KERNEL)", \
74 SignalCodePrintOption::Sender); \
75 ADD_SIGCODE(signo, signo, SI_QUEUE, -1, "sent by sigqueue", \
76 SignalCodePrintOption::Sender); \
77 ADD_SIGCODE(signo, signo, SI_TIMER, -2, "sent by timer expiration", \
78 SignalCodePrintOption::Sender); \
79 ADD_SIGCODE(signo, signo, SI_MESGQ, -3, \
80 "sent by real time mesq state change", \
81 SignalCodePrintOption::Sender); \
82 ADD_SIGCODE(signo, signo, SI_ASYNCIO, -4, "sent by AIO completion", \
83 SignalCodePrintOption::Sender); \
84 ADD_SIGCODE(signo, signo, SI_SIGIO, -5, "sent by queued SIGIO", \
85 SignalCodePrintOption::Sender); \
86 ADD_SIGCODE(signo, signo, SI_TKILL, -6, "sent by tkill system call", \
87 SignalCodePrintOption::Sender); \
88 ADD_SIGCODE(signo, signo, SI_DETHREAD, -7, \
89 "sent by execve() killing subsidiary threads", \
90 SignalCodePrintOption::Sender); \
91 ADD_SIGCODE(signo, signo, SI_ASYNCNL, -60, \
92 "sent by glibc async name lookup completion", \
93 SignalCodePrintOption::Sender);
94
95using namespace lldb_private;
96
97LinuxSignals::LinuxSignals() : UnixSignals() { Reset(); }
98
99void LinuxSignals::Reset() {
100 m_signals.clear();
101 // clang-format off
102 // SIGNO NAME SUPPRESS STOP NOTIFY DESCRIPTION
103 // ====== ============== ======== ====== ====== ===================================================
104 ADD_LINUX_SIGNAL(1, "SIGHUP", false, true, true, "hangup");
105 ADD_LINUX_SIGNAL(2, "SIGINT", true, true, true, "interrupt");
106 ADD_LINUX_SIGNAL(3, "SIGQUIT", false, true, true, "quit");
107
108 ADD_LINUX_SIGNAL(4, "SIGILL", false, true, true, "illegal instruction");
109 ADD_SIGCODE(SIGILL, 4, ILL_ILLOPC, 1, "illegal opcode");
110 ADD_SIGCODE(SIGILL, 4, ILL_ILLOPN, 2, "illegal operand");
111 ADD_SIGCODE(SIGILL, 4, ILL_ILLADR, 3, "illegal addressing mode");
112 ADD_SIGCODE(SIGILL, 4, ILL_ILLTRP, 4, "illegal trap");
113 ADD_SIGCODE(SIGILL, 4, ILL_PRVOPC, 5, "privileged opcode");
114 ADD_SIGCODE(SIGILL, 4, ILL_PRVREG, 6, "privileged register");
115 ADD_SIGCODE(SIGILL, 4, ILL_COPROC, 7, "coprocessor error");
116 ADD_SIGCODE(SIGILL, 4, ILL_BADSTK, 8, "internal stack error");
117
118 ADD_LINUX_SIGNAL(5, "SIGTRAP", true, true, true, "trace trap (not reset when caught)");
119 ADD_LINUX_SIGNAL(6, "SIGABRT", false, true, true, "abort()/IOT trap", "SIGIOT");
120
121 ADD_LINUX_SIGNAL(7, "SIGBUS", false, true, true, "bus error");
122 ADD_SIGCODE(SIGBUS, 7, BUS_ADRALN, 1, "illegal alignment");
123 ADD_SIGCODE(SIGBUS, 7, BUS_ADRERR, 2, "illegal address");
124 ADD_SIGCODE(SIGBUS, 7, BUS_OBJERR, 3, "hardware error");
125
126 ADD_LINUX_SIGNAL(8, "SIGFPE", false, true, true, "floating point exception");
127 ADD_SIGCODE(SIGFPE, 8, FPE_INTDIV, 1, "integer divide by zero");
128 ADD_SIGCODE(SIGFPE, 8, FPE_INTOVF, 2, "integer overflow");
129 ADD_SIGCODE(SIGFPE, 8, FPE_FLTDIV, 3, "floating point divide by zero");
130 ADD_SIGCODE(SIGFPE, 8, FPE_FLTOVF, 4, "floating point overflow");
131 ADD_SIGCODE(SIGFPE, 8, FPE_FLTUND, 5, "floating point underflow");
132 ADD_SIGCODE(SIGFPE, 8, FPE_FLTRES, 6, "floating point inexact result");
133 ADD_SIGCODE(SIGFPE, 8, FPE_FLTINV, 7, "floating point invalid operation");
134 ADD_SIGCODE(SIGFPE, 8, FPE_FLTSUB, 8, "subscript out of range");
135
136 ADD_LINUX_SIGNAL(9, "SIGKILL", false, true, true, "kill");
137 ADD_LINUX_SIGNAL(10, "SIGUSR1", false, true, true, "user defined signal 1");
138
139 ADD_LINUX_SIGNAL(11, "SIGSEGV", false, true, true, "segmentation violation");
140 ADD_SIGCODE(SIGSEGV, 11, SEGV_MAPERR, 1, "address not mapped to object", SignalCodePrintOption::Address);
141 ADD_SIGCODE(SIGSEGV, 11, SEGV_ACCERR, 2, "invalid permissions for mapped object", SignalCodePrintOption::Address);
142 ADD_SIGCODE(SIGSEGV, 11, SEGV_BNDERR, 3, "failed address bounds checks", SignalCodePrintOption::Bounds);
143 ADD_SIGCODE(SIGSEGV, 11, SEGV_PKUERR, 4, "failed protection key checks", SignalCodePrintOption::Address);
144 ADD_SIGCODE(SIGSEGV, 11, SEGV_MTEAERR, 8, "async tag check fault");
145 ADD_SIGCODE(SIGSEGV, 11, SEGV_MTESERR, 9, "sync tag check fault", SignalCodePrintOption::Address);
146 ADD_SIGCODE(SIGSEGV, 11, SEGV_CPERR, 10, "control protection fault");
147 // Some platforms will occasionally send nonstandard spurious SI_KERNEL
148 // codes. One way to get this is via unaligned SIMD loads. Treat it as invalid address.
149 ADD_SIGCODE(SIGSEGV, 11, SI_KERNEL, 0x80, "invalid address", SignalCodePrintOption::Address);
150
151 ADD_LINUX_SIGNAL(12, "SIGUSR2", false, true, true, "user defined signal 2");
152 ADD_LINUX_SIGNAL(13, "SIGPIPE", false, true, true, "write to pipe with reading end closed");
153 ADD_LINUX_SIGNAL(14, "SIGALRM", false, false, false, "alarm");
154 ADD_LINUX_SIGNAL(15, "SIGTERM", false, true, true, "termination requested");
155 ADD_LINUX_SIGNAL(16, "SIGSTKFLT", false, true, true, "stack fault");
156 ADD_LINUX_SIGNAL(17, "SIGCHLD", false, false, true, "child status has changed", "SIGCLD");
157 ADD_LINUX_SIGNAL(18, "SIGCONT", false, false, true, "process continue");
158 ADD_LINUX_SIGNAL(19, "SIGSTOP", true, true, true, "process stop");
159 ADD_LINUX_SIGNAL(20, "SIGTSTP", false, true, true, "tty stop");
160 ADD_LINUX_SIGNAL(21, "SIGTTIN", false, true, true, "background tty read");
161 ADD_LINUX_SIGNAL(22, "SIGTTOU", false, true, true, "background tty write");
162 ADD_LINUX_SIGNAL(23, "SIGURG", false, true, true, "urgent data on socket");
163 ADD_LINUX_SIGNAL(24, "SIGXCPU", false, true, true, "CPU resource exceeded");
164 ADD_LINUX_SIGNAL(25, "SIGXFSZ", false, true, true, "file size limit exceeded");
165 ADD_LINUX_SIGNAL(26, "SIGVTALRM", false, true, true, "virtual time alarm");
166 ADD_LINUX_SIGNAL(27, "SIGPROF", false, false, false, "profiling time alarm");
167 ADD_LINUX_SIGNAL(28, "SIGWINCH", false, false, false, "window size changes");
168 ADD_LINUX_SIGNAL(29, "SIGIO", false, true, true, "input/output ready/Pollable event", "SIGPOLL");
169 ADD_LINUX_SIGNAL(30, "SIGPWR", false, true, true, "power failure");
170 ADD_LINUX_SIGNAL(31, "SIGSYS", false, true, true, "invalid system call");
171 ADD_LINUX_SIGNAL(32, "SIG32", false, false, false, "threading library internal signal 1");
172 ADD_LINUX_SIGNAL(33, "SIG33", false, false, false, "threading library internal signal 2");
173 ADD_LINUX_SIGNAL(34, "SIGRTMIN", false, false, false, "real time signal 0");
174 ADD_LINUX_SIGNAL(35, "SIGRTMIN+1", false, false, false, "real time signal 1");
175 ADD_LINUX_SIGNAL(36, "SIGRTMIN+2", false, false, false, "real time signal 2");
176 ADD_LINUX_SIGNAL(37, "SIGRTMIN+3", false, false, false, "real time signal 3");
177 ADD_LINUX_SIGNAL(38, "SIGRTMIN+4", false, false, false, "real time signal 4");
178 ADD_LINUX_SIGNAL(39, "SIGRTMIN+5", false, false, false, "real time signal 5");
179 ADD_LINUX_SIGNAL(40, "SIGRTMIN+6", false, false, false, "real time signal 6");
180 ADD_LINUX_SIGNAL(41, "SIGRTMIN+7", false, false, false, "real time signal 7");
181 ADD_LINUX_SIGNAL(42, "SIGRTMIN+8", false, false, false, "real time signal 8");
182 ADD_LINUX_SIGNAL(43, "SIGRTMIN+9", false, false, false, "real time signal 9");
183 ADD_LINUX_SIGNAL(44, "SIGRTMIN+10", false, false, false, "real time signal 10");
184 ADD_LINUX_SIGNAL(45, "SIGRTMIN+11", false, false, false, "real time signal 11");
185 ADD_LINUX_SIGNAL(46, "SIGRTMIN+12", false, false, false, "real time signal 12");
186 ADD_LINUX_SIGNAL(47, "SIGRTMIN+13", false, false, false, "real time signal 13");
187 ADD_LINUX_SIGNAL(48, "SIGRTMIN+14", false, false, false, "real time signal 14");
188 ADD_LINUX_SIGNAL(49, "SIGRTMIN+15", false, false, false, "real time signal 15");
189 ADD_LINUX_SIGNAL(50, "SIGRTMAX-14", false, false, false, "real time signal 16"); // switching to SIGRTMAX-xxx to match "kill -l" output
190 ADD_LINUX_SIGNAL(51, "SIGRTMAX-13", false, false, false, "real time signal 17");
191 ADD_LINUX_SIGNAL(52, "SIGRTMAX-12", false, false, false, "real time signal 18");
192 ADD_LINUX_SIGNAL(53, "SIGRTMAX-11", false, false, false, "real time signal 19");
193 ADD_LINUX_SIGNAL(54, "SIGRTMAX-10", false, false, false, "real time signal 20");
194 ADD_LINUX_SIGNAL(55, "SIGRTMAX-9", false, false, false, "real time signal 21");
195 ADD_LINUX_SIGNAL(56, "SIGRTMAX-8", false, false, false, "real time signal 22");
196 ADD_LINUX_SIGNAL(57, "SIGRTMAX-7", false, false, false, "real time signal 23");
197 ADD_LINUX_SIGNAL(58, "SIGRTMAX-6", false, false, false, "real time signal 24");
198 ADD_LINUX_SIGNAL(59, "SIGRTMAX-5", false, false, false, "real time signal 25");
199 ADD_LINUX_SIGNAL(60, "SIGRTMAX-4", false, false, false, "real time signal 26");
200 ADD_LINUX_SIGNAL(61, "SIGRTMAX-3", false, false, false, "real time signal 27");
201 ADD_LINUX_SIGNAL(62, "SIGRTMAX-2", false, false, false, "real time signal 28");
202 ADD_LINUX_SIGNAL(63, "SIGRTMAX-1", false, false, false, "real time signal 29");
203 ADD_LINUX_SIGNAL(64, "SIGRTMAX", false, false, false, "real time signal 30");
204 // clang-format on
205}
ADD_SIGCODE
#define ADD_SIGCODE(signal_name, signal_value, code_name, code_value,...)
Definition FreeBSDSignals.cpp:25
ADD_LINUX_SIGNAL
#define ADD_LINUX_SIGNAL(signo, name,...)
Definition LinuxSignals.cpp:69
SEGV_MTESERR
#define SEGV_MTESERR
SIGILL
#define SIGILL
Definition PlatformLinux.cpp:41
SIGFPE
#define SIGFPE
Definition PlatformLinux.cpp:47
SIGSEGV
#define SIGSEGV
Definition PlatformLinux.cpp:50
SIGBUS
#define SIGBUS
Definition PlatformLinux.cpp:44
lldb_private::LinuxSignals::Reset
void Reset() override
Definition LinuxSignals.cpp:99
lldb_private::LinuxSignals::LinuxSignals
LinuxSignals()
Definition LinuxSignals.cpp:97
lldb_private::UnixSignals::Bounds
@ Bounds
Definition UnixSignals.h:112
lldb_private::UnixSignals::Address
@ Address
Definition UnixSignals.h:112
lldb_private::UnixSignals::UnixSignals
UnixSignals()
Definition UnixSignals.cpp:53
lldb_private::UnixSignals::m_signals
collection m_signals
Definition UnixSignals.h:179
lldb_private
A class that represents a running process on the host machine.
Definition SBAddressRange.h:14
Generated on for LLDB by doxygen 1.14.0