/* Definitions for complaint handling during symbol reading in GDB.
- Copyright (C) 1990-2013 Free Software Foundation, Inc.
+ Copyright (C) 1990-2022 Free Software Foundation, Inc.
This file is part of GDB.
#if !defined (COMPLAINTS_H)
#define COMPLAINTS_H
-/* Opaque object used to track the number of complaints of a
- particular category. */
-struct complaints;
+#include <unordered_set>
-/* Predefined categories. */
-extern struct complaints *symfile_complaints;
+/* Helper for complaint. */
+extern void complaint_internal (const char *fmt, ...)
+ ATTRIBUTE_PRINTF (1, 2);
-/* Register a complaint. */
-extern void complaint (struct complaints **complaints,
- const char *fmt,
- ...) ATTRIBUTE_PRINTF (2, 3);
-extern void internal_complaint (struct complaints **complaints,
- const char *file, int line,
- const char *fmt,
- ...) ATTRIBUTE_PRINTF (4, 5);
+/* This controls whether complaints are emitted. */
+
+extern int stop_whining;
+
+/* Return true if complaints are enabled. This can be used to guard code
+ that is used only to decide whether to issue a complaint. */
+
+static inline bool
+have_complaint ()
+{
+ return stop_whining > 0;
+}
+
+/* Register a complaint. This is a macro around complaint_internal to
+ avoid computing complaint's arguments when complaints are disabled.
+ Running FMT via gettext [i.e., _(FMT)] can be quite expensive, for
+ example. */
+#define complaint(FMT, ...) \
+ do \
+ { \
+ if (have_complaint ()) \
+ complaint_internal (FMT, ##__VA_ARGS__); \
+ } \
+ while (0)
/* Clear out / initialize all complaint counters that have ever been
- incremented. If LESS_VERBOSE is 1, be less verbose about
- successive complaints, since the messages are appearing all
- together during a command that is reporting a contiguous block of
- complaints (rather than being interleaved with other messages). If
- noisy is 1, we are in a noisy command, and our caller will print
- enough context for the user to figure it out. */
+ incremented. */
+
+extern void clear_complaints ();
+
+/* A class that can handle calls to complaint from multiple threads.
+ When this is instantiated, it hooks into the complaint mechanism,
+ so the 'complaint' macro can continue to be used. When it is
+ destroyed, it issues all the complaints that have been stored. It
+ should only be instantiated in the main thread. */
+
+class complaint_interceptor
+{
+public:
+
+ complaint_interceptor ();
+ ~complaint_interceptor ();
+
+ DISABLE_COPY_AND_ASSIGN (complaint_interceptor);
+
+private:
+
+ /* The issued complaints. */
+ std::unordered_set<std::string> m_complaints;
+
+ /* The saved value of deprecated_warning_hook. */
+ void (*m_saved_warning_hook) (const char *, va_list)
+ ATTRIBUTE_FPTR_PRINTF (1,0);
-extern void clear_complaints (struct complaints **complaints,
- int less_verbose, int noisy);
+ /* A helper function that is used by the 'complaint' implementation
+ to issue a complaint. */
+ static void issue_complaint (const char *, va_list)
+ ATTRIBUTE_PRINTF (1, 0);
+ /* This object. Used by the static callback function. */
+ static complaint_interceptor *g_complaint_interceptor;
+};
#endif /* !defined (COMPLAINTS_H) */