Loading...
Searching...
No Matches
error.h
Go to the documentation of this file.
/*
* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*
*/
#if !defined(__ASOUNDLIB_H) && !defined(ALSA_LIBRARY_BUILD)
/* don't use ALSA_LIBRARY_BUILD define in sources outside alsa-lib */
#warning "use #include <alsa/asoundlib.h>, <alsa/error.h> should not be used directly"
#include <alsa/asoundlib.h>
#endif
#ifndef __ALSA_ERROR_H
#define __ALSA_ERROR_H
#ifdef __cplusplus
extern "C" {
#endif
#define SND_ERROR_BEGIN 500000
#define SND_ERROR_INCOMPATIBLE_VERSION (SND_ERROR_BEGIN+0)
const char *snd_strerror(int errnum);
#define SND_LOG_ERROR 1
#define SND_LOG_WARN 2
#define SND_LOG_INFO 3
#define SND_LOG_DEBUG 4
#define SND_LOG_TRACE 5
#define SND_LOG_LAST SND_LOG_TRACE
#define SND_ILOG_CORE 1
#define SND_ILOG_CONFIG 2
#define SND_ILOG_CONTROL 3
#define SND_ILOG_HWDEP 4
#define SND_ILOG_TIMER 5
#define SND_ILOG_RAWMIDI 6
#define SND_ILOG_PCM 7
#define SND_ILOG_MIXER 8
#define SND_ILOG_SEQUENCER 9
#define SND_ILOG_UCM 10
#define SND_ILOG_TOPOLOGY 11
#define SND_ILOG_ASERVER 12
#define SND_ILOG_LAST SND_ILOG_ASERVER
typedef void (*snd_lib_log_handler_t)(int prio, int interface, const char *file, int line, const char *function, int errcode, const char *fmt, va_list arg);
extern snd_lib_log_handler_t snd_lib_vlog;
int snd_lib_log_filter(int prio, int interface, const char *configstr);
void snd_lib_log(int prio, int interface, const char *file, int line, const char *function, int errcode, const char *fmt, ...) /* __attribute__ ((format (printf, 7, 8))) */;
void snd_lib_check(int interface, const char *file, int line, const char *function, int errcode, const char *fmt, ...);
snd_lib_log_handler_t snd_lib_log_set_handler(snd_lib_log_handler_t handler);
snd_lib_log_handler_t snd_lib_log_set_local(snd_lib_log_handler_t handler);
const char *snd_lib_log_priority(int prio);
const char *snd_lib_log_interface(int interface);
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 95)
#define snd_error(interface, ...) snd_lib_log(SND_LOG_ERROR, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define snd_errornum(interface, ...) snd_lib_log(SND_LOG_ERROR, SND_ILOG_##interface, __FILE__, __LINE__, __func__, errno, __VA_ARGS__)
#define snd_warn(interface, ...) snd_lib_log(SND_LOG_WARN, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define snd_info(interface, ...) snd_lib_log(SND_LOG_INFO, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define snd_debug(interface, ...) snd_lib_log(SND_LOG_DEBUG, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define snd_trace(interface, ...) snd_lib_log(SND_LOG_TRACE, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define snd_check(interface, ...) snd_lib_check(SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define snd_checknum(interface, ...) snd_lib_check(SND_ILOG_##interface, __FILE__, __LINE__, __func__, errno, __VA_ARGS__)
#else
#define snd_error(interface, args...) snd_lib_log(SND_LOG_ERROR, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, ##args)
#define snd_errornum(interface, args...) snd_lib_log(SND_LOG_ERROR, SND_ILOG_##interface, __FILE__, __LINE__, __func__, errno, ##args)
#define snd_warn(interface, args...) snd_lib_log(SND_LOG_WARN, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, ##args)
#define snd_info(interface, args...) snd_lib_log(SND_LOG_INFO, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, ##args)
#define snd_debug(interface, args...) snd_lib_log(SND_LOG_DEBUG, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, ##args)
#define snd_trace(interface, args...) snd_lib_log(SND_LOG_TRACE, SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, ##args)
#define snd_check(interface, args...) snd_lib_check(SND_ILOG_##interface, __FILE__, __LINE__, __func__, 0, ##args)
#define snd_checknum(interface, args...) snd_lib_check(SND_ILOG_##interface, __FILE__, __LINE__, __func__, errno, ##args)
#endif
typedef void (*snd_lib_error_handler_t)(const char *file, int line, const char *function, int errcode, const char *fmt, ...) /* __attribute__ ((format (printf, 5, 6))) */;
extern snd_lib_error_handler_t snd_lib_error;
int snd_lib_error_set_handler(snd_lib_error_handler_t handler);
#if __GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ > 95)
#define SNDERR(...) snd_lib_log(SND_LOG_ERROR, 0, __FILE__, __LINE__, __func__, 0, __VA_ARGS__)
#define SYSERR(...) snd_lib_log(SND_LOG_ERROR, 0, __FILE__, __LINE__, __func__, errno, __VA_ARGS__)
#else
#define SNDERR(args...) snd_lib_log(SND_LOG_ERROR, 0, __FILE__, __LINE__, __func__, 0, ##args)
#define SYSERR(args...) snd_lib_log(SND_LOG_ERROR, 0, __FILE__, __LINE__, __func__, errno, ##args)
#endif
typedef void (*snd_local_error_handler_t)(const char *file, int line,
const char *func, int errcode,
const char *fmt, va_list arg);
snd_local_error_handler_t snd_lib_error_set_local(snd_local_error_handler_t func);
#ifdef __cplusplus
}
#endif
#endif /* __ALSA_ERROR_H */
snd_lib_log_filter
int snd_lib_log_filter(int prio, int interface, const char *configstr)
Check if a log message should be shown based on LIBASOUND_DEBUG.
Definition error.c:275
snd_lib_check
void snd_lib_check(int interface, const char *file, int line, const char *function, int errcode, const char *fmt,...)
The check point function.
Definition error.c:368
snd_lib_vlog
snd_lib_log_handler_t snd_lib_vlog
Definition error.c:392
snd_strerror
const char * snd_strerror(int errnum)
Returns the message for an error code.
Definition error.c:51
snd_lib_log_set_local
snd_lib_log_handler_t snd_lib_log_set_local(snd_lib_log_handler_t handler)
Install local log handler.
Definition error.c:79
snd_lib_error_set_handler
int snd_lib_error_set_handler(snd_lib_error_handler_t handler)
Sets the error handler.
Definition error.c:465
snd_lib_log_interface
const char * snd_lib_log_interface(int interface)
Function to convert interface code to text.
Definition error.c:134
snd_lib_log_handler_t
void(* snd_lib_log_handler_t)(int prio, int interface, const char *file, int line, const char *function, int errcode, const char *fmt, va_list arg)
Log handler callback.
Definition error.h:87
snd_lib_log_set_handler
snd_lib_log_handler_t snd_lib_log_set_handler(snd_lib_log_handler_t handler)
Sets the log handler.
Definition error.c:402
snd_lib_error_set_local
snd_local_error_handler_t snd_lib_error_set_local(snd_local_error_handler_t func)
Install local error handler.
Definition error.c:416
snd_lib_log
void snd_lib_log(int prio, int interface, const char *file, int line, const char *function, int errcode, const char *fmt,...)
Root log handler function.
Definition error.c:348
snd_local_error_handler_t
void(* snd_local_error_handler_t)(const char *file, int line, const char *func, int errcode, const char *fmt, va_list arg)
Definition error.h:143
snd_lib_error_handler_t
void(* snd_lib_error_handler_t)(const char *file, int line, const char *function, int errcode, const char *fmt,...)
Error handler callback.
Definition error.h:130
snd_lib_error
snd_lib_error_handler_t snd_lib_error
Definition error.c:452
snd_lib_log_priority
const char * snd_lib_log_priority(int prio)
Function to convert log priority level to text.
Definition error.c:122