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