xref: /freebsd/contrib/llvm-project/lldb/source/Plugins/Process/Utility/LinuxSignals.cpp (revision 700637cbb5e582861067a11aaca4d053546871d2)
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 
92 using namespace lldb_private;
93 
LinuxSignals()94 LinuxSignals::LinuxSignals() : UnixSignals() { Reset(); }
95 
Reset()96 void 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 }
202