include/tdm_log.h

   1 /**************************************************************************
   2  *
   3  * libtdm
   4  *
   5  * Copyright 2015 Samsung Electronics co., Ltd. All Rights Reserved.
   6  *
   7  * Contact: Eunchul Kim <chulspro.kim@samsung.com>,
   8  *          JinYoung Jeon <jy0.jeon@samsung.com>,
   9  *          Taeheon Kim <th908.kim@samsung.com>,
  10  *          YoungJun Cho <yj44.cho@samsung.com>,
  11  *          SooChan Lim <sc1.lim@samsung.com>,
  12  *          Boram Park <sc1.lim@samsung.com>
  13  *
  14  * Permission is hereby granted, free of charge, to any person obtaining a
  15  * copy of this software and associated documentation files (the
  16  * "Software"), to deal in the Software without restriction, including
  17  * without limitation the rights to use, copy, modify, merge, publish,
  18  * distribute, sub license, and/or sell copies of the Software, and to
  19  * permit persons to whom the Software is furnished to do so, subject to
  20  * the following conditions:
  21  *
  22  * The above copyright notice and this permission notice (including the
  23  * next paragraph) shall be included in all copies or substantial portions
  24  * of the Software.
  25  *
  26  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  27  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  28  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
  29  * IN NO EVENT SHALL PRECISION INSIGHT AND/OR ITS SUPPLIERS BE LIABLE FOR
  30  * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
  31  * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
  32  * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  33  *
  34 **************************************************************************/
  35
  36 #ifndef _TDM_LOG_H_
  37 #define _TDM_LOG_H_
  38
  39 #include <unistd.h>
  40 #include <sys/syscall.h>
  41 #include <time.h>
  42
  43 #ifdef __cplusplus
  44 extern "C" {
  45 #endif
  46
  47 /**
  48  * @file tdm_log.h
  49  * @brief The header file to print logs in frontend and backend modules
  50  * @details
  51  * The TDM debug log can be enable by setting "TDM_DEBUG" enviroment. And also,
  52  * the TDM dlog can be enable by setting "TDM_DLOG" enviroment.
  53  * @par Example
  54  * @code
  55  *  $ export TDM_DEBUG=1
  56  * @endcode
  57  */
  58
  59 enum {
  60         TDM_LOG_LEVEL_NONE,
  61         TDM_LOG_LEVEL_ERR,
  62         TDM_LOG_LEVEL_WRN,
  63         TDM_LOG_LEVEL_INFO,
  64         TDM_LOG_LEVEL_DBG,
  65 };
  66
  67 void tdm_log_enable_color(unsigned int enable);
  68 void tdm_log_enable_dlog(unsigned int enable);
  69 void tdm_log_set_debug_level(int level);
  70 void tdm_log_set_assert_level(int level);
  71 void tdm_log_set_path(const char *path);
  72 void tdm_log_print(int level, const char *fmt, ...);
  73 void tdm_log_reset(void);
  74
  75 extern unsigned int tdm_log_debug_level;
  76
  77 #define TDM_DBG(fmt, args...) \
  78         do { \
  79                 if (tdm_log_debug_level >= TDM_LOG_LEVEL_DBG) { \
  80                         struct timespec ts; \
  81                         clock_gettime(CLOCK_MONOTONIC, &ts); \
  82                         tdm_log_print(TDM_LOG_LEVEL_DBG, "[%5d.%06d][%d][%s %d]"fmt, \
  83                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
  84                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
  85                 } \
  86         } while (0)
  87 #define TDM_INFO(fmt, args...) \
  88         do { \
  89                 if (tdm_log_debug_level >= TDM_LOG_LEVEL_INFO) { \
  90                         struct timespec ts; \
  91                         clock_gettime(CLOCK_MONOTONIC, &ts); \
  92                         tdm_log_print(TDM_LOG_LEVEL_INFO, "[%5d.%06d][%d][%s %d]"fmt, \
  93                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
  94                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
  95                 } \
  96         } while (0)
  97 #define TDM_WRN(fmt, args...) \
  98         do { \
  99                 if (tdm_log_debug_level >= TDM_LOG_LEVEL_WRN) { \
 100                         struct timespec ts; \
 101                         clock_gettime(CLOCK_MONOTONIC, &ts); \
 102                         tdm_log_print(TDM_LOG_LEVEL_WRN, "[%5d.%06d][%d][%s %d]"fmt, \
 103                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
 104                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
 105                 } \
 106         } while (0)
 107 #define TDM_ERR(fmt, args...) \
 108         do { \
 109                 if (tdm_log_debug_level >= TDM_LOG_LEVEL_ERR) { \
 110                         struct timespec ts; \
 111                         clock_gettime(CLOCK_MONOTONIC, &ts); \
 112                         tdm_log_print(TDM_LOG_LEVEL_ERR, "[%5d.%06d][%d][%s %d]"fmt, \
 113                                                   (int)ts.tv_sec, (int)ts.tv_nsec / 1000, \
 114                                                   (int)syscall(SYS_gettid), __FUNCTION__, __LINE__, ##args);  \
 115                 } \
 116         } while (0)
 117
 118 #define TDM_NEVER_GET_HERE() TDM_WRN("** NEVER GET HERE **")
 119 #define TDM_DEPRECATED(str) \
 120         do { \
 121                 if (str) \
 122                         TDM_WRN("** DEPRECATED: %s **", str); \
 123                 else \
 124                         TDM_WRN("** DEPRECATED **"); \
 125         } while(0)
 126
 127 #ifdef __cplusplus
 128 }
 129 #endif
 130
 131 #endif /* _TDM_LOG_H_ */