/* * Drizzle Client & Protocol Library * * Copyright (C) 2008 Eric Day (eday@oddments.org) * All rights reserved. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are * met: * * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the following disclaimer * in the documentation and/or other materials provided with the * distribution. * * * The names of its contributors may not be used to endorse or * promote products derived from this software without specific prior * written permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * */ #pragma once /** * @file * @brief Local Drizzle Declarations */ #ifdef __cplusplus extern "C" { #endif /** * @addtogroup drizzle_local Local Drizzle Declarations * @ingroup drizzle * @{ */ /** * Set the error string. * * @param[in] drizzle Drizzle structure previously initialized with * drizzle_create() or drizzle_clone(). * @param[in] function Name of function the error happened in. * @param[in] format Format and variable argument list of message. */ DRIZZLE_LOCAL void drizzle_set_error(drizzle_st *drizzle, const char *function, const char *format, ...); /** * Log a message. * * @param[in] drizzle Drizzle structure previously initialized with * drizzle_create() or drizzle_clone(). * @param[in] verbose Logging level of the message. * @param[in] format Format and variable argument list of message. * @param[in] args Variable argument list that has been initialized. */ DRIZZLE_LOCAL void drizzle_log(drizzle_st *drizzle, drizzle_verbose_t verbose, const char *format, va_list args); /** * Log a fatal message, see drizzle_log() for argument details. */ static inline void drizzle_log_fatal(drizzle_st *drizzle, const char *format, ...) { va_list args; if (drizzle->verbose >= DRIZZLE_VERBOSE_FATAL) { va_start(args, format); drizzle_log(drizzle, DRIZZLE_VERBOSE_FATAL, format, args); va_end(args); } } /** * Log an error message, see drizzle_log() for argument details. */ static inline void drizzle_log_error(drizzle_st *drizzle, const char *format, ...) { va_list args; if (drizzle->verbose >= DRIZZLE_VERBOSE_ERROR) { va_start(args, format); drizzle_log(drizzle, DRIZZLE_VERBOSE_ERROR, format, args); va_end(args); } } /** * Log an info message, see drizzle_log() for argument details. */ static inline void drizzle_log_info(drizzle_st *drizzle, const char *format, ...) { va_list args; if (drizzle->verbose >= DRIZZLE_VERBOSE_INFO) { va_start(args, format); drizzle_log(drizzle, DRIZZLE_VERBOSE_INFO, format, args); va_end(args); } } /** * Log a debug message, see drizzle_log() for argument details. */ static inline void drizzle_log_debug(drizzle_st *drizzle, const char *format, ...) { va_list args; if (drizzle->verbose >= DRIZZLE_VERBOSE_DEBUG) { va_start(args, format); drizzle_log(drizzle, DRIZZLE_VERBOSE_DEBUG, format, args); va_end(args); } } /** * Log a crazy message, see drizzle_log() for argument details. */ static inline void drizzle_log_crazy(drizzle_st *drizzle, const char *format, ...) { va_list args; if (drizzle->verbose >= DRIZZLE_VERBOSE_CRAZY) { va_start(args, format); drizzle_log(drizzle, DRIZZLE_VERBOSE_CRAZY, format, args); va_end(args); } } /** @} */ #ifdef __cplusplus } #endif