ofono API refactoring: Rename netreg Operator property to Name
[platform/upstream/connman.git] / include / log.h
1 /*
2  *
3  *  Connection Manager
4  *
5  *  Copyright (C) 2007-2010  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 struct connman_debug_desc {
45         const char *name;
46         const char *file;
47 #define CONNMAN_DEBUG_FLAG_DEFAULT (0)
48 #define CONNMAN_DEBUG_FLAG_PRINT   (1 << 0)
49 #define CONNMAN_DEBUG_FLAG_ALIAS   (1 << 1)
50         unsigned int flags;
51 } __attribute__((aligned(8)));
52
53 #define CONNMAN_DEBUG_DEFINE(name) \
54         static struct connman_debug_desc __debug_alias_ ## name \
55         __attribute__((used, section("__debug"), aligned(8))) = { \
56                 #name, __FILE__, CONNMAN_DEBUG_FLAG_ALIAS \
57         };
58
59 /**
60  * DBG:
61  * @fmt: format string
62  * @arg...: list of arguments
63  *
64  * Simple macro around connman_debug() which also include the function
65  * name it is called in.
66  */
67 #define DBG(fmt, arg...) do { \
68         static struct connman_debug_desc __connman_debug_desc \
69         __attribute__((used, section("__debug"), aligned(8))) = { \
70                 .file = __FILE__, .flags = CONNMAN_DEBUG_FLAG_DEFAULT, \
71         }; \
72         if (__connman_debug_desc.flags & CONNMAN_DEBUG_FLAG_PRINT) \
73                 connman_debug("%s:%s() " fmt, \
74                                         __FILE__, __FUNCTION__ , ## arg); \
75 } while (0)
76
77 #ifdef __cplusplus
78 }
79 #endif
80
81 #endif /* __CONNMAN_LOG_H */