]> mj.ucw.cz Git - libucw.git/blob - ucw/log-stream.c
ucw. docs: document single-line doc. comments
[libucw.git] / ucw / log-stream.c
1 /*
2  *      UCW Library -- Logging: Management of Log Streams
3  *
4  *      (c) 2008 Tomas Gavenciak <gavento@ucw.cz>
5  *      (c) 2009 Martin Mares <mj@ucw.cz>
6  *
7  *      This software may be freely distributed and used according to the terms
8  *      of the GNU Lesser General Public License.
9  */
10
11 #include "ucw/lib.h"
12 #include "ucw/log.h"
13 #include "ucw/log-internal.h"
14 #include "ucw/simple-lists.h"
15
16 #include <string.h>
17
18 /* Initial number of streams to allocate (must be >=2) */
19 #define LS_INIT_STREAMS 8
20
21 /* Flag indicating initialization of the module */
22 static int log_initialized = 0;
23
24 /* The head of the list of freed log_streams indexes in log_streams.ptr (~0U if none free).
25  * Freed positions in log_streams.ptr are connected into a linked list in the following way:
26  * log_streams.ptr[log_streams_free].levels is the index of next freed position (or ~0U) */
27 static uns log_streams_free = ~0U;
28
29 /* Initialize the logstream module.
30  * It is not neccessary to call this explicitely as it is called by
31  * the first log_new_stream()  (for backward compatibility and ease of use). */
32 static void
33 log_init_module(void)
34 {
35   if (log_initialized)
36     return;
37
38   /* Create the growing array */
39   lsbuf_init(&log_streams);
40   lsbuf_set_size(&log_streams, LS_INIT_STREAMS);
41
42   bzero(log_streams.ptr, sizeof(struct log_stream*) * (log_streams.len));
43   log_streams_free = ~0U;
44
45   log_initialized = 1;
46
47   /* init the default stream (0) as forwarder to fd2 */
48   struct log_stream *ls = log_new_stream(sizeof(*ls));
49   ASSERT(ls == log_streams.ptr[0]);
50   ASSERT(ls->regnum == 0);
51   ls->name = "default";
52   log_add_substream(ls, &log_stream_default);
53 }
54
55 void
56 log_close_all(void)
57 {
58   if (!log_initialized)
59     return;
60
61   // Close all open streams
62   for (int i=0; i < log_streams_after; i++)
63     if (log_streams.ptr[i]->regnum >= 0)
64       log_close_stream(log_streams.ptr[i]);
65
66   // Free all cached structures
67   for (int i=0; i < log_streams_after; i++)
68     xfree(log_streams.ptr[i]);
69
70   /* Back to the default state */
71   lsbuf_done(&log_streams);
72   log_streams_after = 0;
73   log_streams_free = ~0U;
74   log_initialized = 0;
75 }
76
77 void
78 log_add_substream(struct log_stream *where, struct log_stream *what)
79 {
80   ASSERT(where);
81   ASSERT(what);
82
83   simp_node *n = xmalloc(sizeof(simp_node));
84   n->p = log_ref_stream(what);
85   clist_add_tail(&where->substreams, &n->n);
86 }
87
88 int
89 log_rm_substream(struct log_stream *where, struct log_stream *what)
90 {
91   void *tmp;
92   int cnt = 0;
93   ASSERT(where);
94
95   CLIST_FOR_EACH_DELSAFE(simp_node *, i, where->substreams, tmp)
96     if (i->p == what || !what)
97       {
98         clist_remove(&i->n);
99         log_close_stream(i->p);
100         xfree(i);
101         cnt++;
102       }
103   return cnt;
104 }
105
106 struct log_stream *
107 log_new_stream(size_t size)
108 {
109   struct log_stream *l;
110   int index;
111
112   /* Initialize the data structures if needed */
113   log_init_module();
114
115   /* Get a free stream, possibly recycling a closed one */
116   if (log_streams_free == ~0U)
117     {
118       lsbuf_grow(&log_streams, log_streams_after+1);
119       index = log_streams_after++;
120       l = log_streams.ptr[index] = xmalloc(size);
121     }
122   else
123     {
124       index = log_streams_free;
125       l = xrealloc(log_streams.ptr[index], size);
126       log_streams.ptr[index] = l;
127       log_streams_free = l->levels;
128     }
129
130   /* Initialize the stream */
131   bzero(l, sizeof(*l));
132   l->levels = ~0U;
133   l->regnum = LS_SET_STRNUM(index);
134   clist_init(&l->substreams);
135   return log_ref_stream(l);
136 }
137
138 int
139 log_close_stream(struct log_stream *ls)
140 {
141   ASSERT(ls);
142   ASSERT(ls->use_count);
143   if (--ls->use_count)
144     return 0;
145
146   /* Unlink all subtreams */
147   log_rm_substream(ls, NULL);
148
149   /* Close the stream and add it to the free-list */
150   if (ls->close)
151     ls->close(ls);
152   ls->levels = log_streams_free;
153   log_streams_free = LS_GET_STRNUM(ls->regnum);
154   ls->regnum = -1;
155   return 1;
156 }
157
158 void
159 log_set_format(struct log_stream *ls, uns mask, uns data)
160 {
161   ls->msgfmt = (ls->msgfmt & mask) | data;
162   CLIST_FOR_EACH(simp_node *, i, ls->substreams)
163     log_set_format(i->p, mask, data);
164 }