blob: 27e77341c717ac9b5847d11608fd5176b4bf8118 [file] [log] [blame]
Harald Welte3ae27582010-03-26 21:24:24 +08001#ifndef _OSMOCORE_LOGGING_H
2#define _OSMOCORE_LOGGING_H
3
4#include <stdio.h>
5#include <stdint.h>
6#include <osmocore/linuxlist.h>
7
8#define LOG_MAX_CATEGORY 32
9#define LOG_MAX_CTX 8
10#define LOG_MAX_FILTERS 8
11
12#define DEBUG
13
14#ifdef DEBUG
15#define DEBUGP(ss, fmt, args...) logp(ss, __FILE__, __LINE__, 0, fmt, ## args)
16#define DEBUGPC(ss, fmt, args...) logp(ss, __FILE__, __LINE__, 1, fmt, ## args)
17#else
18#define DEBUGP(xss, fmt, args...)
19#define DEBUGPC(ss, fmt, args...)
20#endif
21
Harald Welte3ae27582010-03-26 21:24:24 +080022
Harald Welte3ae27582010-03-26 21:24:24 +080023void logp(unsigned int subsys, char *file, int line, int cont, const char *format, ...) __attribute__ ((format (printf, 5, 6)));
24
25/* new logging interface */
26#define LOGP(ss, level, fmt, args...) \
27 logp2(ss, level, __FILE__, __LINE__, 0, fmt, ##args)
28#define LOGPC(ss, level, fmt, args...) \
29 logp2(ss, level, __FILE__, __LINE__, 1, fmt, ##args)
30
31/* different levels */
32#define LOGL_DEBUG 1 /* debugging information */
33#define LOGL_INFO 3
34#define LOGL_NOTICE 5 /* abnormal/unexpected condition */
35#define LOGL_ERROR 7 /* error condition, requires user action */
36#define LOGL_FATAL 8 /* fatal, program aborted */
37
38#define LOG_FILTER_ALL 0x0001
39
40struct log_category {
41 uint8_t loglevel;
42 uint8_t enabled;
43};
44
45struct log_info_cat {
46 const char *name;
47 const char *color;
48 const char *description;
49 uint8_t loglevel;
50 uint8_t enabled;
51};
52
53/* log context information, passed to filter */
54struct log_context {
55 void *ctx[LOG_MAX_CTX+1];
56};
57
58struct log_target;
59
60typedef int log_filter(const struct log_context *ctx,
61 struct log_target *target);
62
63struct log_info {
64 /* filter callback function */
65 log_filter *filter_fn;
66
67 /* per-category information */
68 const struct log_info_cat *cat;
69 unsigned int num_cat;
70};
71
72struct log_target {
73 struct llist_head entry;
74
75 int filter_map;
76 void *filter_data[LOG_MAX_FILTERS+1];
77
78 struct log_category categories[LOG_MAX_CATEGORY+1];
79 uint8_t loglevel;
80 int use_color:1;
81 int print_timestamp:1;
82
83 union {
84 struct {
85 FILE *out;
Harald Welte72d0c532010-08-25 19:24:00 +020086 const char *fname;
Harald Welte0083cd32010-08-25 14:55:44 +020087 } tgt_file;
Harald Welte3ae27582010-03-26 21:24:24 +080088
89 struct {
90 int priority;
91 } tgt_syslog;
92
93 struct {
94 void *vty;
95 } tgt_vty;
96 };
97
98 void (*output) (struct log_target *target, const char *string);
99};
100
101/* use the above macros */
102void logp2(unsigned int subsys, unsigned int level, char *file,
103 int line, int cont, const char *format, ...)
104 __attribute__ ((format (printf, 6, 7)));
105void log_init(const struct log_info *cat);
106
107/* context management */
108void log_reset_context(void);
109int log_set_context(uint8_t ctx, void *value);
110
111/* filter on the targets */
112void log_set_all_filter(struct log_target *target, int);
113
114void log_set_use_color(struct log_target *target, int);
115void log_set_print_timestamp(struct log_target *target, int);
116void log_set_log_level(struct log_target *target, int log_level);
117void log_parse_category_mask(struct log_target *target, const char* mask);
118int log_parse_level(const char *lvl);
Harald Welte9ac22252010-05-11 11:19:40 +0200119const char *log_level_str(unsigned int lvl);
Harald Welte3ae27582010-03-26 21:24:24 +0800120int log_parse_category(const char *category);
121void log_set_category_filter(struct log_target *target, int category,
122 int enable, int level);
123
124/* management of the targets */
125struct log_target *log_target_create(void);
Harald Welte72d0c532010-08-25 19:24:00 +0200126void log_target_destroy(struct log_target *target);
Harald Welte3ae27582010-03-26 21:24:24 +0800127struct log_target *log_target_create_stderr(void);
Harald Welte72d0c532010-08-25 19:24:00 +0200128struct log_target *log_target_create_file(const char *fname);
129int log_target_file_reopen(struct log_target *tgt);
130
Harald Welte3ae27582010-03-26 21:24:24 +0800131void log_add_target(struct log_target *target);
132void log_del_target(struct log_target *target);
133
Harald Welte7638af92010-05-11 16:39:22 +0200134/* Gernerate command argument strings for VTY use */
135const char *log_vty_category_string(struct log_info *info);
136const char *log_vty_level_string(struct log_info *info);
137
Harald Welte3ae27582010-03-26 21:24:24 +0800138#endif /* _OSMOCORE_LOGGING_H */