| 1 | /* Declaration for error-reporting function |
| 2 | Copyright (C) 1995-1997, 2003, 2006, 2008-2016 Free Software Foundation, |
| 3 | Inc. |
| 4 | This file is part of the GNU C Library. |
| 5 | |
| 6 | This program is free software: you can redistribute it and/or modify |
| 7 | it under the terms of the GNU General Public License as published by |
| 8 | the Free Software Foundation; either version 3 of the License, or |
| 9 | (at your option) any later version. |
| 10 | |
| 11 | This program is distributed in the hope that it will be useful, |
| 12 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 13 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 14 | GNU General Public License for more details. |
| 15 | |
| 16 | You should have received a copy of the GNU General Public License |
| 17 | along with this program. If not, see <http://www.gnu.org/licenses/>. */ |
| 18 | |
| 19 | #ifndef _ERROR_H |
| 20 | #define _ERROR_H 1 |
| 21 | |
| 22 | /* The __attribute__ feature is available in gcc versions 2.5 and later. |
| 23 | The __-protected variants of the attributes 'format' and 'printf' are |
| 24 | accepted by gcc versions 2.6.4 (effectively 2.7) and later. |
| 25 | We enable _GL_ATTRIBUTE_FORMAT only if these are supported too, because |
| 26 | gnulib and libintl do '#define printf __printf__' when they override |
| 27 | the 'printf' function. */ |
| 28 | #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 7) |
| 29 | # define _GL_ATTRIBUTE_FORMAT(spec) __attribute__ ((__format__ spec)) |
| 30 | #else |
| 31 | # define _GL_ATTRIBUTE_FORMAT(spec) /* empty */ |
| 32 | #endif |
| 33 | |
| 34 | /* On mingw, the flavor of printf depends on whether the extensions module |
| 35 | * is in use; the check for <stdio.h> determines the witness macro. */ |
| 36 | #ifndef _GL_ATTRIBUTE_SPEC_PRINTF |
| 37 | # if GNULIB_PRINTF_ATTRIBUTE_FLAVOR_GNU |
| 38 | # define _GL_ATTRIBUTE_SPEC_PRINTF __gnu_printf__ |
| 39 | # else |
| 40 | # define _GL_ATTRIBUTE_SPEC_PRINTF __printf__ |
| 41 | # endif |
| 42 | #endif |
| 43 | |
| 44 | #ifdef __cplusplus |
| 45 | extern "C" { |
| 46 | #endif |
| 47 | |
| 48 | /* Print a message with 'fprintf (stderr, FORMAT, ...)'; |
| 49 | if ERRNUM is nonzero, follow it with ": " and strerror (ERRNUM). |
| 50 | If STATUS is nonzero, terminate the program with 'exit (STATUS)'. */ |
| 51 | |
| 52 | extern void error (int __status, int __errnum, const char *__format, ...) |
| 53 | _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF, 3, 4)); |
| 54 | |
| 55 | extern void error_at_line (int __status, int __errnum, const char *__fname, |
| 56 | unsigned int __lineno, const char *__format, ...) |
| 57 | _GL_ATTRIBUTE_FORMAT ((_GL_ATTRIBUTE_SPEC_PRINTF, 5, 6)); |
| 58 | |
| 59 | /* If NULL, error will flush stdout, then print on stderr the program |
| 60 | name, a colon and a space. Otherwise, error will call this |
| 61 | function without parameters instead. */ |
| 62 | extern void (*error_print_progname) (void); |
| 63 | |
| 64 | /* This variable is incremented each time 'error' is called. */ |
| 65 | extern unsigned int error_message_count; |
| 66 | |
| 67 | /* Sometimes we want to have at most one error per line. This |
| 68 | variable controls whether this mode is selected or not. */ |
| 69 | extern int error_one_per_line; |
| 70 | |
| 71 | #ifdef __cplusplus |
| 72 | } |
| 73 | #endif |
| 74 | |
| 75 | #endif /* error.h */ |