util/messages-krb5.h

   1 /*
   2  * Prototypes for error handling for Kerberos.
   3  *
   4  * The canonical version of this file is maintained in the rra-c-util package,
   5  * which can be found at <https://www.eyrie.org/~eagle/software/rra-c-util/>.
   6  *
   7  * Written by Russ Allbery <eagle@eyrie.org>
   8  * Copyright 2006-2010, 2013
   9  *     The Board of Trustees of the Leland Stanford Junior University
  10  *
  11  * Permission is hereby granted, free of charge, to any person obtaining a
  12  * copy of this software and associated documentation files (the "Software"),
  13  * to deal in the Software without restriction, including without limitation
  14  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  15  * and/or sell copies of the Software, and to permit persons to whom the
  16  * Software is furnished to do so, subject to the following conditions:
  17  *
  18  * The above copyright notice and this permission notice shall be included in
  19  * all copies or substantial portions of the Software.
  20  *
  21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  22  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  24  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  25  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  26  * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  27  * DEALINGS IN THE SOFTWARE.
  28  *
  29  * SPDX-License-Identifier: MIT
  30  */
  31
  32 #ifndef UTIL_MESSAGES_KRB5_H
  33 #define UTIL_MESSAGES_KRB5_H 1
  34
  35 #include <config.h>
  36 #include <portable/krb5.h>
  37 #include <portable/macros.h>
  38
  39 BEGIN_DECLS
  40
  41 /* Default to a hidden visibility for all util functions. */
  42 #pragma GCC visibility push(hidden)
  43
  44 /*
  45  * The Kerberos versions of the reporting functions.  These take a context and
  46  * an error code to get the Kerberos error.
  47  */
  48 void die_krb5(krb5_context, krb5_error_code, const char *, ...)
  49     __attribute__((__nonnull__(3), __noreturn__, __format__(printf, 3, 4)));
  50 void warn_krb5(krb5_context, krb5_error_code, const char *, ...)
  51     __attribute__((__nonnull__(3), __format__(printf, 3, 4)));
  52
  53 /* Undo default visibility change. */
  54 #pragma GCC visibility pop
  55
  56 END_DECLS
  57
  58 #endif /* UTIL_MESSAGES_KRB5_H */