include/log.h

   1 /*
   2  *
   3  *  Connection Manager
   4  *
   5  *  Copyright (C) 2007-2013  Intel Corporation. All rights reserved.
   6  *
   7  *  This program is free software; you can redistribute it and/or modify
   8  *  it under the terms of the GNU General Public License version 2 as
   9  *  published by the Free Software Foundation.
  10  *
  11  *  This program is distributed in the hope that it will be useful,
  12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  *  GNU General Public License for more details.
  15  *
  16  *  You should have received a copy of the GNU General Public License
  17  *  along with this program; if not, write to the Free Software
  18  *  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
  19  *
  20  */
  21
  22 #ifndef __CONNMAN_LOG_H
  23 #define __CONNMAN_LOG_H
  24
  25 #ifdef __cplusplus
  26 extern "C" {
  27 #endif
  28
  29 /**
  30  * SECTION:log
  31  * @title: Logging premitives
  32  * @short_description: Functions for logging error and debug information
  33  */
  34
  35 void connman_info(const char *format, ...)
  36                                 __attribute__((format(printf, 1, 2)));
  37 void connman_warn(const char *format, ...)
  38                                 __attribute__((format(printf, 1, 2)));
  39 void connman_error(const char *format, ...)
  40                                 __attribute__((format(printf, 1, 2)));
  41 void connman_debug(const char *format, ...)
  42                                 __attribute__((format(printf, 1, 2)));
  43
  44 #define connman_warn_once(fmt, arg...) do {             \
  45         static bool printed;                            \
  46         if (!printed) {                                 \
  47                 connman_warn(fmt, ## arg);              \
  48                 printed = true;                         \
  49         }                                               \
  50 } while (0)
  51
  52 struct connman_debug_desc {
  53         const char *name;
  54         const char *file;
  55 #define CONNMAN_DEBUG_FLAG_DEFAULT (0)
  56 #define CONNMAN_DEBUG_FLAG_PRINT   (1 << 0)
  57 #define CONNMAN_DEBUG_FLAG_ALIAS   (1 << 1)
  58         unsigned int flags;
  59 } __attribute__((aligned(8)));
  60
  61 #define CONNMAN_DEBUG_DEFINE(name) \
  62         static struct connman_debug_desc __debug_alias_ ## name \
  63         __attribute__((used, section("__debug"), aligned(8))) = { \
  64                 #name, __FILE__, CONNMAN_DEBUG_FLAG_ALIAS \
  65         };
  66
  67 /**
  68  * DBG:
  69  * @fmt: format string
  70  * @arg...: list of arguments
  71  *
  72  * Simple macro around connman_debug() which also include the function
  73  * name it is called in.
  74  */
  75 #define DBG(fmt, arg...) do { \
  76         static struct connman_debug_desc __connman_debug_desc \
  77         __attribute__((used, section("__debug"), aligned(8))) = { \
  78                 .file = __FILE__, .flags = CONNMAN_DEBUG_FLAG_DEFAULT, \
  79         }; \
  80         if (__connman_debug_desc.flags & CONNMAN_DEBUG_FLAG_PRINT) \
  81                 connman_debug("%s:%s() " fmt, \
  82                                         __FILE__, __FUNCTION__ , ## arg); \
  83 } while (0)
  84
  85 #ifdef __cplusplus
  86 }
  87 #endif
  88
  89 #endif /* __CONNMAN_LOG_H */