misc/err.h

   1 /* 4.4BSD utility functions for error messages.
   2    Copyright (C) 1995-2024 Free Software Foundation, Inc.
   3    This file is part of the GNU C Library.
   4
   5    The GNU C Library is free software; you can redistribute it and/or
   6    modify it under the terms of the GNU Lesser General Public
   7    License as published by the Free Software Foundation; either
   8    version 2.1 of the License, or (at your option) any later version.
   9
  10    The GNU C Library is distributed in the hope that it will be useful,
  11    but WITHOUT ANY WARRANTY; without even the implied warranty of
  12    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13    Lesser General Public License for more details.
  14
  15    You should have received a copy of the GNU Lesser General Public
  16    License along with the GNU C Library; if not, see
  17    <https://www.gnu.org/licenses/>.  */
  18
  19 #ifndef _ERR_H
  20 #define _ERR_H  1
  21
  22 #include <features.h>
  23
  24 #define __need___va_list
  25 #include <stdarg.h>
  26 #ifndef __GNUC_VA_LIST
  27 # define __gnuc_va_list void *
  28 #endif
  29
  30 __BEGIN_DECLS
  31
  32 /* Print "program: ", FORMAT, ": ", the standard error string for errno,
  33    and a newline, on stderr.  */
  34 extern void warn (const char *__format, ...)
  35      __attribute__ ((__format__ (__printf__, 1, 2))) __COLD;
  36 extern void vwarn (const char *__format, __gnuc_va_list)
  37      __attribute__ ((__format__ (__printf__, 1, 0))) __COLD;
  38
  39 /* Likewise, but without ": " and the standard error string.  */
  40 extern void warnx (const char *__format, ...)
  41      __attribute__ ((__format__ (__printf__, 1, 2)));
  42 extern void vwarnx (const char *__format, __gnuc_va_list)
  43      __attribute__ ((__format__ (__printf__, 1, 0)));
  44
  45 /* Likewise, and then exit with STATUS.  */
  46 extern void err (int __status, const char *__format, ...)
  47      __attribute__ ((__noreturn__, __format__ (__printf__, 2, 3))) __COLD;
  48 extern void verr (int __status, const char *__format, __gnuc_va_list)
  49      __attribute__ ((__noreturn__, __format__ (__printf__, 2, 0))) __COLD;
  50 extern void errx (int __status, const char *__format, ...)
  51      __attribute__ ((__noreturn__, __format__ (__printf__, 2, 3))) __COLD;
  52 extern void verrx (int __status, const char *, __gnuc_va_list)
  53      __attribute__ ((__noreturn__, __format__ (__printf__, 2, 0))) __COLD;
  54
  55 #include <bits/floatn.h>
  56 #if defined __LDBL_COMPAT || __LDOUBLE_REDIRECTS_TO_FLOAT128_ABI == 1
  57 # include <bits/err-ldbl.h>
  58 #endif
  59
  60 __END_DECLS
  61
  62 #endif  /* err.h */