logging.h

Go to the documentation of this file.

/*
  The oRTP library is an RTP (Realtime Transport Protocol - rfc3550) stack.
  Copyright (C) 2001  Simon MORLAT simon.morlat@linphone.org

  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 library 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 ORTP_LOGGING_H
#define ORTP_LOGGING_H

#include <ortp/port.h>

#ifdef __cplusplus
extern "C"
{
#endif

typedef enum {
        ORTP_DEBUG=1,
        ORTP_MESSAGE=1<<1,
        ORTP_WARNING=1<<2,
        ORTP_ERROR=1<<3,
        ORTP_FATAL=1<<4,
        ORTP_TRACE=1<<5,
        ORTP_LOGLEV_END=1<<6
} OrtpLogLevel;


typedef void (*OrtpLogFunc)(OrtpLogLevel lev, const char *fmt, va_list args);

ORTP_PUBLIC void ortp_set_log_file(FILE *file);
ORTP_PUBLIC void ortp_set_log_handler(OrtpLogFunc func);
ORTP_PUBLIC OrtpLogFunc ortp_get_log_handler();

ORTP_VAR_PUBLIC OrtpLogFunc ortp_logv_out;

#define ortp_log_level_enabled(level)   (ortp_get_log_level_mask() & (level))

ORTP_PUBLIC void ortp_logv(int level, const char *fmt, va_list args);

ORTP_PUBLIC void ortp_logv_flush(void);

ORTP_PUBLIC void ortp_set_log_level_mask(int levelmask);
ORTP_PUBLIC int ortp_get_log_level_mask(void);

ORTP_PUBLIC void ortp_set_log_thread_id(unsigned long thread_id);

#ifdef __GNUC__
#define CHECK_FORMAT_ARGS(m,n) __attribute__((format(printf,m,n)))
#else
#define CHECK_FORMAT_ARGS(m,n)
#endif
#ifdef __clang__
/*in case of compile with -g static inline can produce this type of warning*/
#pragma GCC diagnostic ignored "-Wunused-function"
#endif
#ifdef ORTP_DEBUG_MODE
static ORTP_INLINE void CHECK_FORMAT_ARGS(1,2) ortp_debug(const char *fmt,...)
{
  va_list args;
  va_start (args, fmt);
  ortp_logv(ORTP_DEBUG, fmt, args);
  va_end (args);
}
#else

#define ortp_debug(...)

#endif

#ifdef ORTP_NOMESSAGE_MODE

#define ortp_log(...)
#define ortp_message(...)
#define ortp_warning(...)

#else

static ORTP_INLINE void CHECK_FORMAT_ARGS(2,3) ortp_log(OrtpLogLevel lev, const char *fmt,...) {
        va_list args;
        va_start (args, fmt);
        ortp_logv(lev, fmt, args);
        va_end (args);
}

static ORTP_INLINE void CHECK_FORMAT_ARGS(1,2) ortp_message(const char *fmt,...)
{
        va_list args;
        va_start (args, fmt);
        ortp_logv(ORTP_MESSAGE, fmt, args);
        va_end (args);
}

static ORTP_INLINE void CHECK_FORMAT_ARGS(1,2) ortp_warning(const char *fmt,...)
{
        va_list args;
        va_start (args, fmt);
        ortp_logv(ORTP_WARNING, fmt, args);
        va_end (args);
}

#endif

static ORTP_INLINE void CHECK_FORMAT_ARGS(1,2) ortp_error(const char *fmt,...)
{
        va_list args;
        va_start (args, fmt);
        ortp_logv(ORTP_ERROR, fmt, args);
        va_end (args);
}

static ORTP_INLINE void CHECK_FORMAT_ARGS(1,2) ortp_fatal(const char *fmt,...)
{
        va_list args;
        va_start (args, fmt);
        ortp_logv(ORTP_FATAL, fmt, args);
        va_end (args);
}


#ifdef __QNX__
void ortp_qnx_log_handler(const char *domain, OrtpLogLevel lev, const char *fmt, va_list args);
#endif


#ifdef __cplusplus
}
#endif

#endif