/** * \file include/error.h * \brief Application interface library for the ALSA driver * \author Jaroslav Kysela <[email protected]> * \author Abramo Bagnara <[email protected]> * \author Takashi Iwai <[email protected]> * \date 1998-2001 * * Application interface library for the ALSA driver */ /* * This library is free software; you can redistribute it and/or modify * it under the terms of the GNU Lesser General Public License as * published by the Free Software Foundation; either version 2.1 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 Lesser General Public License for more details. * * You should have received a copy of the GNU Lesser General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA * */ #ifndef __ALSA_ERROR_H #define __ALSA_ERROR_H #ifdef __cplusplus extern "C" { #endif /** * \defgroup Error Error handling * Error handling macros and functions. * \{ */ #define SND_ERROR_BEGIN … #define SND_ERROR_INCOMPATIBLE_VERSION … #define SND_ERROR_ALISP_NIL … const char *snd_strerror(int errnum); /** * \brief Error handler callback. * \param file Source file name. * \param line Line number. * \param function Function name. * \param err Value of \c errno, or 0 if not relevant. * \param fmt \c printf(3) format. * \param ... \c printf(3) arguments. * * A function of this type is called by the ALSA library when an error occurs. * This function usually shows the message on the screen, and/or logs it. */ snd_lib_error_handler_t /* __attribute__ ((format (printf, 5, 6))) */; extern snd_lib_error_handler_t snd_lib_error; extern int snd_lib_error_set_handler(snd_lib_error_handler_t handler); #if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 95) #define SNDERR(...) … #define SYSERR(...) … #else #define SNDERR … #define SYSERR … #endif /** \} */ #ifdef __cplusplus } #endif /** Local error handler function type */ snd_local_error_handler_t; snd_local_error_handler_t snd_lib_error_set_local(snd_local_error_handler_t func); #endif /* __ALSA_ERROR_H */