src/verbose.h

   1 /*
   2  Copyright (C) 2016, 2017 "IoT.bzh"
   3
   4  author: José Bollo <jose.bollo@iot.bzh>
   5
   6  Licensed under the Apache License, Version 2.0 (the "License");
   7  you may not use this file except in compliance with the License.
   8  You may obtain a copy of the License at
   9
  10      http://www.apache.org/licenses/LICENSE-2.0
  11
  12  Unless required by applicable law or agreed to in writing, software
  13  distributed under the License is distributed on an "AS IS" BASIS,
  14  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  15  See the License for the specific language governing permissions and
  16  limitations under the License.
  17 */
  18
  19 #pragma once
  20
  21 #include <stdarg.h>
  22
  23 /*
  24   verbosity tune the count of reported messages
  25
  26    verbosity value : reported messages
  27    ----------------+------------------------
  28     lesser than 0  : no message at all
  29          0         : ERROR
  30          1         : ERROR, WARNING
  31          2         : ERROR, WARNING, NOTICE
  32          3         : ERROR, WARNING, NOTICE, INFO
  33     greater than 3 : ERROR, WARNING, NOTICE, INFO, DEBUG
  34
  35 */
  36 extern int verbosity;
  37
  38 enum verbosity_levels
  39 {
  40         Verbosity_Level_Error = 0,
  41         Verbosity_Level_Warning = 1,
  42         Verbosity_Level_Notice = 2,
  43         Verbosity_Level_Info = 3,
  44         Verbosity_Level_Debug = 4
  45 };
  46
  47 extern void verbose_set_name(const char *name, int authority);
  48
  49 /*
  50  Log level is defined by syslog standard:
  51        KERN_EMERG             0        System is unusable
  52        KERN_ALERT             1        Action must be taken immediately
  53        KERN_CRIT              2        Critical conditions
  54        KERN_ERR               3        Error conditions
  55        KERN_WARNING           4        Warning conditions
  56        KERN_NOTICE            5        Normal but significant condition
  57        KERN_INFO              6        Informational
  58        KERN_DEBUG             7        Debug-level messages
  59 */
  60
  61 enum log_levels
  62 {
  63         Log_Level_Emergency = 0,
  64         Log_Level_Alert = 1,
  65         Log_Level_Critical = 2,
  66         Log_Level_Error = 3,
  67         Log_Level_Warning = 4,
  68         Log_Level_Notice = 5,
  69         Log_Level_Info = 6,
  70         Log_Level_Debug = 7
  71 };
  72
  73 extern void verbose(int loglevel, const char *file, int line, const char *function, const char *fmt, ...) __attribute__((format(printf, 5, 6)));
  74 extern void vverbose(int loglevel, const char *file, int line, const char *function, const char *fmt, va_list args);
  75
  76 #if defined(VERBOSE_NO_DATA)
  77 # define __VERBOSE__(lvl,...)      do{if((lvl)<=Log_Level_Error) verbose(lvl, __FILE__, __LINE__, __func__, __VA_ARGS__)\
  78                                         else verbose(lvl, __FILE__, __LINE__, __func__, NULL);}while(0)
  79 #elif defined(VERBOSE_NO_DETAILS)
  80 # define __VERBOSE__(lvl,...)      verbose(lvl, NULL, 0, NULL, __VA_ARGS__)
  81 #else
  82 # define __VERBOSE__(lvl,...)      verbose(lvl, __FILE__, __LINE__, __func__, __VA_ARGS__)
  83 #endif
  84
  85 # define _VERBOSE_(vlvl,llvl,...)  do{ if (verbosity >= vlvl) __VERBOSE__(llvl, __VA_ARGS__); } while(0)
  86
  87 # define ERROR(...)                _VERBOSE_(Verbosity_Level_Error, Log_Level_Error, __VA_ARGS__)
  88 # define WARNING(...)              _VERBOSE_(Verbosity_Level_Warning, Log_Level_Warning, __VA_ARGS__)
  89 # define NOTICE(...)               _VERBOSE_(Verbosity_Level_Notice, Log_Level_Notice, __VA_ARGS__)
  90 # define INFO(...)                 _VERBOSE_(Verbosity_Level_Info, Log_Level_Info, __VA_ARGS__)
  91 # define DEBUG(...)                _VERBOSE_(Verbosity_Level_Debug, Log_Level_Debug, __VA_ARGS__)
  92
  93 # define LOGUSER(app)              verbose_set_name(app,0)
  94 # define LOGAUTH(app)              verbose_set_name(app,1)
  95
  96 extern void (*verbose_observer)(int loglevel, const char *file, int line, const char *function, const char *fmt, va_list args);