| /* Definitions for complaint handling during symbol reading in GDB. |
| |
| Copyright 1990, 1991, 1992, 1995, 1998, 2000, 2002 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 2 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, write to the Free Software |
| Foundation, Inc., 59 Temple Place - Suite 330, |
| Boston, MA 02111-1307, USA. */ |
| |
| |
| #if !defined (COMPLAINTS_H) |
| #define COMPLAINTS_H |
| |
| /* Opaque object used to track the number of complaints of a |
| particular category. */ |
| struct complaints; |
| |
| /* Predefined categories. */ |
| extern struct complaints *symfile_complaints; |
| |
| /* Register a complaint. */ |
| extern void complaint (struct complaints **complaints, const char *fmt, |
| ...) ATTR_FORMAT (printf, 2, 3); |
| extern void internal_complaint (struct complaints **complaints, |
| const char *file, int line, const char *fmt, |
| ...) ATTR_FORMAT (printf, 4, 5); |
| |
| /* 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. */ |
| |
| extern void clear_complaints (struct complaints **complaints, |
| int less_verbose, int noisy); |
| |
| |
| /* Deprecated interfaces to keep the old code working (until it is all |
| converted to the above). Existing code such as: |
| |
| struct deprecated_complaint msg = { "msg 0x%08x[sic]", 0, 0 }; |
| deprecated_complain (&msg, addr); |
| |
| should be replaced by either the new call (for the singular case): |
| |
| complaint (&symtab_complaints, "msg 0x%s", paddr (addr)); |
| |
| or with a wrapper function (for the many-of case): |
| |
| msg_complaint (CORE_ADDR addr) |
| { complaint (&symtab_complaints, "msg 0x%s", paddr (addr)); } |
| ... |
| msg_complaint (addr); |
| |
| Yes, the typo is intentional. The motivation behind this interface |
| change is to eliminate all possibility of this problem re-occurring |
| (it has occurred in the past and no one is sure that it isn't |
| present now). |
| |
| Support for complaining about things in the symbol file that aren't |
| catastrophic. |
| |
| Each such thing gets a counter. The first time we have the problem, |
| during a symbol read, we report it. At the end of symbol reading, |
| if verbose, we report how many of each problem we had. */ |
| |
| struct deprecated_complaint |
| { |
| const char *message; |
| unsigned counter_ignored; |
| struct deprecated_complaint *next_ignored; |
| }; |
| |
| extern void complain (struct deprecated_complaint *, ...); |
| |
| #endif /* !defined (COMPLAINTS_H) */ |