]>
Commit | Line | Data |
---|---|---|
c906108c | 1 | /* Definitions for complaint handling during symbol reading in GDB. |
b9caf505 | 2 | |
213516ef | 3 | Copyright (C) 1990-2023 Free Software Foundation, Inc. |
c906108c | 4 | |
c5aa993b | 5 | This file is part of GDB. |
c906108c | 6 | |
c5aa993b JM |
7 | This program is free software; you can redistribute it and/or modify |
8 | it under the terms of the GNU General Public License as published by | |
a9762ec7 | 9 | the Free Software Foundation; either version 3 of the License, or |
c5aa993b | 10 | (at your option) any later version. |
c906108c | 11 | |
c5aa993b JM |
12 | This program is distributed in the hope that it will be useful, |
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
15 | GNU General Public License for more details. | |
c906108c | 16 | |
c5aa993b | 17 | You should have received a copy of the GNU General Public License |
a9762ec7 | 18 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
c906108c SS |
19 | |
20 | ||
21 | #if !defined (COMPLAINTS_H) | |
22 | #define COMPLAINTS_H | |
23 | ||
da632297 TT |
24 | #include <unordered_set> |
25 | ||
62d7ae92 | 26 | /* Helper for complaint. */ |
b98664d3 TT |
27 | extern void complaint_internal (const char *fmt, ...) |
28 | ATTRIBUTE_PRINTF (1, 2); | |
62d7ae92 | 29 | |
a00caa12 TT |
30 | /* This controls whether complaints are emitted. */ |
31 | ||
32 | extern int stop_whining; | |
33 | ||
ca10a126 TV |
34 | /* Return true if complaints are enabled. This can be used to guard code |
35 | that is used only to decide whether to issue a complaint. */ | |
36 | ||
37 | static inline bool | |
38 | have_complaint () | |
39 | { | |
40 | return stop_whining > 0; | |
41 | } | |
42 | ||
62d7ae92 PA |
43 | /* Register a complaint. This is a macro around complaint_internal to |
44 | avoid computing complaint's arguments when complaints are disabled. | |
45 | Running FMT via gettext [i.e., _(FMT)] can be quite expensive, for | |
46 | example. */ | |
b98664d3 | 47 | #define complaint(FMT, ...) \ |
62d7ae92 PA |
48 | do \ |
49 | { \ | |
ca10a126 | 50 | if (have_complaint ()) \ |
b98664d3 | 51 | complaint_internal (FMT, ##__VA_ARGS__); \ |
62d7ae92 PA |
52 | } \ |
53 | while (0) | |
54 | ||
b9caf505 | 55 | /* Clear out / initialize all complaint counters that have ever been |
5ca8c39f TT |
56 | incremented. */ |
57 | ||
58 | extern void clear_complaints (); | |
b9caf505 | 59 | |
da632297 TT |
60 | /* A class that can handle calls to complaint from multiple threads. |
61 | When this is instantiated, it hooks into the complaint mechanism, | |
62 | so the 'complaint' macro can continue to be used. When it is | |
63 | destroyed, it issues all the complaints that have been stored. It | |
64 | should only be instantiated in the main thread. */ | |
65 | ||
66 | class complaint_interceptor | |
67 | { | |
68 | public: | |
69 | ||
70 | complaint_interceptor (); | |
71 | ~complaint_interceptor (); | |
72 | ||
73 | DISABLE_COPY_AND_ASSIGN (complaint_interceptor); | |
74 | ||
75 | private: | |
76 | ||
77 | /* The issued complaints. */ | |
78 | std::unordered_set<std::string> m_complaints; | |
79 | ||
80 | /* The saved value of deprecated_warning_hook. */ | |
81 | void (*m_saved_warning_hook) (const char *, va_list) | |
08755c5a | 82 | ATTRIBUTE_FPTR_PRINTF (1,0); |
da632297 TT |
83 | |
84 | /* A helper function that is used by the 'complaint' implementation | |
85 | to issue a complaint. */ | |
08755c5a SM |
86 | static void issue_complaint (const char *, va_list) |
87 | ATTRIBUTE_PRINTF (1, 0); | |
da632297 TT |
88 | |
89 | /* This object. Used by the static callback function. */ | |
90 | static complaint_interceptor *g_complaint_interceptor; | |
91 | }; | |
c906108c | 92 | |
c5aa993b | 93 | #endif /* !defined (COMPLAINTS_H) */ |