verbosity: Prepare hooking of log messages
[src/app-framework-binder.git] / 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, NOTICE
31          2         : ERROR, WARNING, NOTICE, INFO
32     greater than 2 : ERROR, WARNING, NOTICE, INFO, DEBUG
33
34 */
35 extern int verbosity;
36
37 enum verbosity_levels
38 {
39         Verbosity_Level_Error = 0,
40         Verbosity_Level_Warning = 1,
41         Verbosity_Level_Notice = 1,
42         Verbosity_Level_Info = 2,
43         Verbosity_Level_Debug = 3
44 };
45
46 extern void verbose_set_name(const char *name, int authority);
47
48 /*
49  Log level is defined by syslog standard:
50        KERN_EMERG             0        System is unusable
51        KERN_ALERT             1        Action must be taken immediately
52        KERN_CRIT              2        Critical conditions
53        KERN_ERR               3        Error conditions
54        KERN_WARNING           4        Warning conditions
55        KERN_NOTICE            5        Normal but significant condition
56        KERN_INFO              6        Informational
57        KERN_DEBUG             7        Debug-level messages
58 */
59
60 enum log_levels
61 {
62         Log_Level_Emergency = 0,
63         Log_Level_Alert = 1,
64         Log_Level_Critical = 2,
65         Log_Level_Error = 3,
66         Log_Level_Warning = 4,
67         Log_Level_Notice = 5,
68         Log_Level_Info = 6,
69         Log_Level_Debug = 7
70 };
71
72 extern void verbose(int loglevel, const char *file, int line, const char *function, const char *fmt, ...) __attribute__((format(printf, 5, 6)));
73 extern void vverbose(int loglevel, const char *file, int line, const char *function, const char *fmt, va_list args);
74
75 # define _VERBOSE_(vlvl,llvl,...)  do{ if (verbosity >= vlvl) verbose(llvl, __FILE__, __LINE__, __func__, __VA_ARGS__); } while(0)
76 # define ERROR(...)                _VERBOSE_(Verbosity_Level_Error, Log_Level_Error, __VA_ARGS__)
77 # define WARNING(...)              _VERBOSE_(Verbosity_Level_Warning, Log_Level_Warning, __VA_ARGS__)
78 # define NOTICE(...)               _VERBOSE_(Verbosity_Level_Notice, Log_Level_Notice, __VA_ARGS__)
79 # define INFO(...)                 _VERBOSE_(Verbosity_Level_Info, Log_Level_Info, __VA_ARGS__)
80 # define DEBUG(...)                _VERBOSE_(Verbosity_Level_Debug, Log_Level_Debug, __VA_ARGS__)
81 # define LOGUSER(app)              verbose_set_name(app,0)
82 # define LOGAUTH(app)              verbose_set_name(app,1)
83
84 extern void (*verbose_observer)(int loglevel, const char *file, int line, const char *function, const char *fmt, va_list args);