1d506c26d9
This commit is the result of the following actions:
- Running gdb/copyright.py to update all of the copyright headers to
include 2024,
- Manually updating a few files the copyright.py script told me to
update, these files had copyright headers embedded within the
file,
- Regenerating gdbsupport/Makefile.in to refresh it's copyright
date,
- Using grep to find other files that still mentioned 2023. If
these files were updated last year from 2022 to 2023 then I've
updated them this year to 2024.
I'm sure I've probably missed some dates. Feel free to fix them up as
you spot them.
115 lines
3.5 KiB
C++
115 lines
3.5 KiB
C++
/* Definitions for complaint handling during symbol reading in GDB.
|
|
|
|
Copyright (C) 1990-2024 Free Software Foundation, Inc.
|
|
|
|
This file is part of GDB.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
|
|
|
#if !defined (COMPLAINTS_H)
|
|
#define COMPLAINTS_H
|
|
|
|
#include <unordered_set>
|
|
|
|
/* Helper for complaint. */
|
|
extern void complaint_internal (const char *fmt, ...)
|
|
ATTRIBUTE_PRINTF (1, 2);
|
|
|
|
/* 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. */
|
|
|
|
extern void clear_complaints ();
|
|
|
|
/* Type of collected complaints. */
|
|
|
|
typedef std::unordered_set<std::string> complaint_collection;
|
|
|
|
/* 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. It collects all
|
|
the complaints (and warnings) emitted while it is installed, and
|
|
these can be retrieved before the object is destroyed. This is
|
|
intended for use from worker threads (though it will also work on
|
|
the main thread). Messages can be re-emitted on the main thread
|
|
using re_emit_complaints, see below. */
|
|
|
|
class complaint_interceptor
|
|
{
|
|
public:
|
|
|
|
complaint_interceptor ();
|
|
~complaint_interceptor () = default;
|
|
|
|
DISABLE_COPY_AND_ASSIGN (complaint_interceptor);
|
|
|
|
complaint_collection &&release ()
|
|
{
|
|
return std::move (m_complaints);
|
|
}
|
|
|
|
private:
|
|
|
|
/* The issued complaints. */
|
|
complaint_collection m_complaints;
|
|
|
|
typedef void (*saved_warning_hook_ftype) (const char *, va_list);
|
|
|
|
/* The saved value of deprecated_warning_hook. */
|
|
scoped_restore_tmpl<saved_warning_hook_ftype> m_saved_warning_hook;
|
|
|
|
/* The saved value of g_complaint_interceptor. */
|
|
scoped_restore_tmpl<complaint_interceptor *> m_saved_complaint_interceptor;
|
|
|
|
/* 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 thread_local complaint_interceptor *g_complaint_interceptor;
|
|
};
|
|
|
|
/* Re-emit complaints that were collected by complaint_interceptor.
|
|
This can only be called on the main thread. */
|
|
|
|
extern void re_emit_complaints (const complaint_collection &);
|
|
|
|
#endif /* !defined (COMPLAINTS_H) */
|