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

source code of lldb/source/Plugins/Process/Utility/LinuxSignals.cpp