blob: 5b780a34556f7feb06c5b4686bf0dc4e1be366b8 [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
Harald Welte76e72ab2011-02-17 15:52:39 +010098 void (*output) (struct log_target *target, unsigned int level,
99 const char *string);
Harald Welte3ae27582010-03-26 21:24:24 +0800100};
101
102/* use the above macros */
103void logp2(unsigned int subsys, unsigned int level, char *file,
104 int line, int cont, const char *format, ...)
105 __attribute__ ((format (printf, 6, 7)));
106void log_init(const struct log_info *cat);
107
108/* context management */
109void log_reset_context(void);
110int log_set_context(uint8_t ctx, void *value);
111
112/* filter on the targets */
113void log_set_all_filter(struct log_target *target, int);
114
115void log_set_use_color(struct log_target *target, int);
116void log_set_print_timestamp(struct log_target *target, int);
117void log_set_log_level(struct log_target *target, int log_level);
118void log_parse_category_mask(struct log_target *target, const char* mask);
119int log_parse_level(const char *lvl);
Harald Welte9ac22252010-05-11 11:19:40 +0200120const char *log_level_str(unsigned int lvl);
Harald Welte3ae27582010-03-26 21:24:24 +0800121int log_parse_category(const char *category);
122void log_set_category_filter(struct log_target *target, int category,
123 int enable, int level);
124
125/* management of the targets */
126struct log_target *log_target_create(void);
Harald Welte72d0c532010-08-25 19:24:00 +0200127void log_target_destroy(struct log_target *target);
Harald Welte3ae27582010-03-26 21:24:24 +0800128struct log_target *log_target_create_stderr(void);
Harald Welte72d0c532010-08-25 19:24:00 +0200129struct log_target *log_target_create_file(const char *fname);
130int log_target_file_reopen(struct log_target *tgt);
131
Harald Welte3ae27582010-03-26 21:24:24 +0800132void log_add_target(struct log_target *target);
133void log_del_target(struct log_target *target);
134
Harald Welte7638af92010-05-11 16:39:22 +0200135/* Gernerate command argument strings for VTY use */
136const char *log_vty_category_string(struct log_info *info);
137const char *log_vty_level_string(struct log_info *info);
138
Harald Welte3ae27582010-03-26 21:24:24 +0800139#endif /* _OSMOCORE_LOGGING_H */