sim: mips: merge mips64vr4300 with existing multi-run build
[binutils-gdb.git] / gdb / complaints.h
index 5d280942dc41b2a3db545f7d4c8725365ebc56a4..02c8c2c558be6a9de966deb41529074a28322ae3 100644 (file)
@@ -1,6 +1,6 @@
 /* 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) */