Coverage Report

Created: 2026-09-27 06:19

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/open5gs/lib/core/ogs-log.c
Line
Count
Source
1
/*
2
 * Copyright (C) 2019 by Sukchan Lee <acetcom@gmail.com>
3
 *
4
 * This file is part of Open5GS.
5
 *
6
 * This program is free software: you can redistribute it and/or modify
7
 * it under the terms of the GNU Affero General Public License as published by
8
 * the Free Software Foundation, either version 3 of the License, or
9
 * (at your option) any later version.
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, see <https://www.gnu.org/licenses/>.
18
 */
19
20
#include "core-config-private.h"
21
22
#if HAVE_CTYPE_H
23
#include <ctype.h>
24
#endif
25
26
#if HAVE_STDARG_H
27
#include <stdarg.h>
28
#endif
29
30
#include "ogs-core.h"
31
32
1.01M
#define TA_NOR              "\033[0m"       /* all off */
33
34
#define TA_FGC_BLACK        "\033[30m"      /* Black */
35
#define TA_FGC_RED          "\033[31m"      /* Red */
36
254k
#define TA_FGC_BOLD_RED     "\033[1;31m"    /* Bold Red */
37
254k
#define TA_FGC_GREEN        "\033[32m"      /* Green */
38
254k
#define TA_FGC_BOLD_GREEN   "\033[1;32m"    /* Bold Green */
39
254k
#define TA_FGC_YELLOW       "\033[33m"      /* Yellow */
40
254k
#define TA_FGC_BOLD_YELLOW  "\033[1;33m"    /* Bold Yellow */
41
#define TA_FGC_BOLD_BLUE    "\033[1;34m"    /* Bold Blue */
42
#define TA_FGC_BOLD_MAGENTA "\033[1;35m"    /* Bold Magenta */
43
254k
#define TA_FGC_BOLD_CYAN    "\033[1;36m"    /* Bold Cyan */
44
254k
#define TA_FGC_WHITE        "\033[37m"      /* White  */
45
254k
#define TA_FGC_BOLD_WHITE   "\033[1;37m"    /* Bold White  */
46
#define TA_FGC_DEFAULT      "\033[39m"      /* default */
47
48
typedef enum {
49
    OGS_LOG_STDERR_TYPE,
50
    OGS_LOG_FILE_TYPE,
51
} ogs_log_type_e;
52
53
typedef struct ogs_log_s {
54
    ogs_lnode_t node;
55
56
    ogs_log_type_e type;
57
58
    union {
59
        struct {
60
            FILE *out;
61
            const char *name;
62
        } file;
63
    };
64
65
    struct {
66
    ED7(uint8_t color:1;,
67
        uint8_t timestamp:1;,
68
        uint8_t domain:1;,
69
        uint8_t level:1;,
70
        uint8_t fileline:1;,
71
        uint8_t function:1;,
72
        uint8_t linefeed:1;)
73
    } print;
74
75
    void (*writer)(ogs_log_t *log, ogs_log_level_e level, const char *string);
76
77
} ogs_log_t;
78
79
typedef struct ogs_log_domain_s {
80
    ogs_lnode_t node;
81
82
    int id;
83
    ogs_log_level_e level;
84
    const char *name;
85
} ogs_log_domain_t;
86
87
const char *level_strings[] = {
88
    NULL,
89
    "FATAL", "ERROR", "WARNING", "INFO", "DEBUG", "TRACE",
90
};
91
92
static OGS_POOL(log_pool, ogs_log_t);
93
static OGS_LIST(log_list);
94
95
static OGS_POOL(domain_pool, ogs_log_domain_t);
96
static OGS_LIST(domain_list);
97
98
static ogs_log_t *add_log(ogs_log_type_e type);
99
static int file_cycle(ogs_log_t *log);
100
101
static char *log_timestamp(char *buf, char *last,
102
        int use_color);
103
static char *log_domain(char *buf, char *last,
104
        const char *name, int use_color);
105
static char *log_content(char *buf, char *last,
106
        const char *format, va_list ap);
107
static char *log_level(char *buf, char *last,
108
        ogs_log_level_e level, int use_color);
109
static char *log_linefeed(char *buf, char *last);
110
111
static void file_writer(
112
        ogs_log_t *log, ogs_log_level_e level, const char *string);
113
114
void ogs_log_init(void)
115
9
{
116
9
    ogs_pool_init(&log_pool, ogs_core()->log.pool);
117
9
    ogs_pool_init(&domain_pool, ogs_core()->log.domain_pool);
118
119
9
    ogs_log_add_domain("core", ogs_core()->log.level);
120
9
    ogs_log_add_stderr();
121
9
}
122
123
void ogs_log_final(void)
124
0
{
125
0
    ogs_log_t *log, *saved_log;
126
0
    ogs_log_domain_t *domain, *saved_domain;
127
128
0
    ogs_list_for_each_safe(&log_list, saved_log, log)
129
0
        ogs_log_remove(log);
130
0
    ogs_pool_final(&log_pool);
131
132
0
    ogs_list_for_each_safe(&domain_list, saved_domain, domain)
133
0
        ogs_log_remove_domain(domain);
134
0
    ogs_pool_final(&domain_pool);
135
0
}
136
137
void ogs_log_cycle(void)
138
0
{
139
0
    ogs_log_t *log = NULL;
140
141
0
    ogs_list_for_each(&log_list, log) {
142
0
        switch(log->type) {
143
0
        case OGS_LOG_FILE_TYPE:
144
0
            file_cycle(log);
145
0
        default:
146
0
            break;
147
0
        }
148
0
    }
149
0
}
150
151
ogs_log_t *ogs_log_add_stderr(void)
152
9
{
153
9
    ogs_log_t *log = NULL;
154
    
155
9
    log = add_log(OGS_LOG_STDERR_TYPE);
156
9
    ogs_assert(log);
157
158
9
    log->file.out = stderr;
159
9
    log->writer = file_writer;
160
161
9
#if !defined(_WIN32)
162
9
    log->print.color = 1;
163
9
#endif
164
165
9
    return log;
166
9
}
167
168
ogs_log_t *ogs_log_add_file(const char *name)
169
0
{
170
0
    FILE *out = NULL;
171
0
    ogs_log_t *log = NULL;
172
173
0
    out = fopen(name, "a");
174
0
    if (!out) 
175
0
        return NULL;
176
    
177
0
    log = add_log(OGS_LOG_FILE_TYPE);
178
0
    ogs_assert(log);
179
180
0
    log->file.name = name;
181
0
    log->file.out = out;
182
183
0
    log->writer = file_writer;
184
185
0
    return log;
186
0
}
187
188
void ogs_log_remove(ogs_log_t *log)
189
0
{
190
0
    ogs_assert(log);
191
192
0
    ogs_list_remove(&log_list, log);
193
194
0
    if (log->type == OGS_LOG_FILE_TYPE) {
195
0
        ogs_assert(log->file.out);
196
0
        fclose(log->file.out);
197
0
        log->file.out = NULL;
198
0
    }
199
200
0
    ogs_pool_free(&log_pool, log);
201
0
}
202
203
ogs_log_domain_t *ogs_log_add_domain(const char *name, ogs_log_level_e level)
204
62
{
205
62
    ogs_log_domain_t *domain = NULL;
206
207
62
    ogs_assert(name);
208
209
62
    ogs_pool_alloc(&domain_pool, &domain);
210
62
    ogs_assert(domain);
211
212
62
    domain->name = name;
213
62
    domain->id = ogs_pool_index(&domain_pool, domain);
214
62
    domain->level = level;
215
216
62
    ogs_list_add(&domain_list, domain);
217
218
62
    return domain;
219
62
}
220
221
ogs_log_domain_t *ogs_log_find_domain(const char *name)
222
56
{
223
56
    ogs_log_domain_t *domain = NULL;
224
225
56
    ogs_assert(name);
226
227
56
    ogs_list_for_each(&domain_list, domain)
228
196
        if (!ogs_strcasecmp(domain->name, name))
229
3
            return domain;
230
231
53
    return NULL;
232
56
}
233
234
void ogs_log_remove_domain(ogs_log_domain_t *domain)
235
0
{
236
0
    ogs_assert(domain);
237
238
0
    ogs_list_remove(&domain_list, domain);
239
0
    ogs_pool_free(&domain_pool, domain);
240
0
}
241
242
void ogs_log_set_domain_level(int id, ogs_log_level_e level)
243
2
{
244
2
    ogs_log_domain_t *domain = NULL;
245
246
2
    ogs_assert(id > 0 && id <= ogs_core()->log.domain_pool);
247
248
2
    domain = ogs_pool_find(&domain_pool, id);
249
2
    ogs_assert(domain);
250
251
2
    domain->level = level;
252
2
}
253
254
ogs_log_level_e ogs_log_get_domain_level(int id)
255
135
{
256
135
    ogs_log_domain_t *domain = NULL;
257
258
135
    ogs_assert(id > 0 && id <= ogs_core()->log.domain_pool);
259
260
135
    domain = ogs_pool_find(&domain_pool, id);
261
135
    ogs_assert(domain);
262
263
135
    return domain->level;
264
135
}
265
266
const char *ogs_log_get_domain_name(int id)
267
0
{
268
0
    ogs_log_domain_t *domain = NULL;
269
270
0
    ogs_assert(id > 0 && id <= ogs_core()->log.domain_pool);
271
272
0
    domain = ogs_pool_find(&domain_pool, id);
273
0
    ogs_assert(domain);
274
275
0
    return domain->name;
276
0
}
277
278
int ogs_log_get_domain_id(const char *name)
279
0
{
280
0
    ogs_log_domain_t *domain = NULL;
281
282
0
    ogs_assert(name);
283
    
284
0
    domain = ogs_log_find_domain(name);
285
0
    ogs_assert(domain);
286
287
0
    return domain->id;
288
0
}
289
290
void ogs_log_install_domain(int *domain_id,
291
        const char *name, ogs_log_level_e level)
292
55
{
293
55
    ogs_log_domain_t *domain = NULL;
294
295
55
    ogs_assert(domain_id);
296
55
    ogs_assert(name);
297
298
55
    domain = ogs_log_find_domain(name);
299
55
    if (domain) {
300
2
        ogs_warn("`%s` log-domain duplicated", name);
301
2
        if (level != domain->level) {
302
2
            ogs_warn("[%s]->[%s] log-level changed",
303
2
                    level_strings[domain->level], level_strings[level]);
304
2
            ogs_log_set_domain_level(domain->id, level);
305
2
        }
306
53
    } else {
307
53
        domain = ogs_log_add_domain(name, level);
308
53
        ogs_assert(domain);
309
53
    }
310
311
55
    *domain_id = domain->id;
312
55
}
313
314
void ogs_log_set_mask_level(const char *_mask, ogs_log_level_e level)
315
1
{
316
1
    ogs_log_domain_t *domain = NULL;
317
318
1
    if (_mask) {
319
1
        const char *delim = " \t\n,:";
320
1
        char *mask = NULL;
321
1
        char *saveptr;
322
1
        char *name;
323
324
1
        mask = ogs_strdup(_mask);
325
1
        ogs_assert(mask);
326
327
1
        for (name = ogs_strtok_r(mask, delim, &saveptr);
328
2
            name != NULL;
329
1
            name = ogs_strtok_r(NULL, delim, &saveptr)) {
330
331
1
            domain = ogs_log_find_domain(name);
332
1
            if (domain)
333
1
                domain->level = level;
334
1
        }
335
336
1
        ogs_free(mask);
337
1
    } else {
338
0
        ogs_list_for_each(&domain_list, domain)
339
0
            domain->level = level;
340
0
    }
341
1
}
342
343
void ogs_log_set_timestamp(ogs_log_ts_e ts_default, ogs_log_ts_e ts_file)
344
0
{
345
0
    ogs_log_t *log;
346
347
0
    if (ts_default == OGS_LOG_TS_UNSET)
348
0
        ts_default = OGS_LOG_TS_ENABLED;
349
350
0
    if (ts_file == OGS_LOG_TS_UNSET)
351
0
        ts_file = ts_default;
352
353
0
    ogs_list_for_each(&log_list, log) {
354
0
        switch (log->type) {
355
0
            case OGS_LOG_FILE_TYPE:
356
0
                log->print.timestamp = (ts_file == OGS_LOG_TS_ENABLED);
357
0
                break;
358
0
            default:
359
0
                log->print.timestamp = (ts_default == OGS_LOG_TS_ENABLED);
360
0
                break;
361
0
        }
362
0
    }
363
0
}
364
365
static ogs_log_level_e ogs_log_level_from_string(const char *string)
366
0
{
367
0
    ogs_log_level_e level = OGS_ERROR;
368
369
0
    if (!strcasecmp(string, "none")) level = OGS_LOG_NONE;
370
0
    else if (!strcasecmp(string, "fatal")) level = OGS_LOG_FATAL;
371
0
    else if (!strcasecmp(string, "error")) level = OGS_LOG_ERROR;
372
0
    else if (!strcasecmp(string, "warn")) level = OGS_LOG_WARN;
373
0
    else if (!strcasecmp(string, "info")) level = OGS_LOG_INFO;
374
0
    else if (!strcasecmp(string, "debug")) level = OGS_LOG_DEBUG;
375
0
    else if (!strcasecmp(string, "trace")) level = OGS_LOG_TRACE;
376
377
0
    return level;
378
0
}
379
380
int ogs_log_config_domain(const char *domain, const char *level)
381
0
{
382
0
    if (domain || level) {
383
0
        int l = ogs_core()->log.level;
384
385
0
        if (level) {
386
0
            l = ogs_log_level_from_string(level);
387
0
            if (l == OGS_ERROR) {
388
0
                ogs_error("Invalid LOG-LEVEL "
389
0
                        "[none:fatal|error|warn|info|debug|trace]: %s\n",
390
0
                        level);
391
0
                return OGS_ERROR;
392
0
            }
393
0
        }
394
395
0
        ogs_log_set_mask_level(domain, l);
396
0
    }
397
398
0
    return OGS_OK;
399
0
}
400
401
void ogs_log_vprintf(ogs_log_level_e level, int id,
402
    ogs_err_t err, const char *file, int line, const char *func,
403
    int content_only, const char *format, va_list ap)
404
933k
{
405
933k
    ogs_log_t *log = NULL;
406
933k
    ogs_log_domain_t *domain = NULL;
407
408
933k
    char logstr[OGS_HUGE_LEN];
409
933k
    char *p, *last;
410
411
933k
    int wrote_stderr = 0;
412
413
933k
    ogs_list_for_each(&log_list, log) {
414
933k
        domain = ogs_pool_find(&domain_pool, id);
415
933k
        if (!domain) {
416
0
            fprintf(stderr, "No LogDomain[id:%d] in %s:%d", id, file, line);
417
0
            ogs_assert_if_reached();
418
0
        }
419
933k
        if (domain->level < level)
420
677k
            return;
421
422
255k
        p = logstr;
423
255k
        last = logstr + OGS_HUGE_LEN;
424
425
255k
        if (!content_only) {
426
254k
            if (log->print.timestamp)
427
254k
                p = log_timestamp(p, last, log->print.color);
428
254k
            if (log->print.domain)
429
254k
                p = log_domain(p, last, domain->name, log->print.color);
430
254k
            if (log->print.level)
431
254k
                p = log_level(p, last, level, log->print.color);
432
254k
        }
433
434
255k
        p = log_content(p, last, format, ap);
435
436
255k
        if (err) {
437
0
            char errbuf[OGS_HUGE_LEN];
438
0
            p = ogs_slprintf(p, last, " (%d:%s)",
439
0
                    (int)err, ogs_strerror(err, errbuf, OGS_HUGE_LEN));
440
0
        }
441
442
255k
        if (!content_only) {
443
254k
            if (log->print.fileline)
444
254k
                p = ogs_slprintf(p, last, " (%s:%d)", file, line);
445
254k
            if (log->print.function)
446
0
                p = ogs_slprintf(p, last, " %s()", func);
447
254k
            if (log->print.linefeed) 
448
254k
                p = log_linefeed(p, last);
449
254k
        }
450
451
255k
        log->writer(log, level, logstr);
452
        
453
255k
        if (log->type == OGS_LOG_STDERR_TYPE)
454
255k
            wrote_stderr = 1;
455
255k
    }
456
457
255k
    if (!wrote_stderr)
458
0
    {
459
0
        int use_color = 0;
460
0
#if !defined(_WIN32)
461
0
        use_color = 1;
462
0
#endif
463
464
0
        p = logstr;
465
0
        last = logstr + OGS_HUGE_LEN;
466
467
0
        if (!content_only) {
468
0
            p = log_timestamp(p, last, use_color);
469
0
            p = log_level(p, last, level, use_color);
470
0
        }
471
0
        p = log_content(p, last, format, ap);
472
0
        if (!content_only) {
473
0
            p = ogs_slprintf(p, last, " (%s:%d)", file, line);
474
0
            p = ogs_slprintf(p, last, " %s()", func);
475
0
            p = log_linefeed(p, last);
476
0
        }
477
478
0
        fprintf(stderr, "%s", logstr);
479
0
        fflush(stderr);
480
0
    }
481
255k
}
482
483
void ogs_log_printf(ogs_log_level_e level, int id,
484
    ogs_err_t err, const char *file, int line, const char *func,
485
    int content_only, const char *format, ...)
486
933k
{
487
933k
    va_list args;
488
489
933k
    va_start(args, format);
490
933k
    ogs_log_vprintf(level, id,
491
933k
            err, file, line, func, content_only, format, args);
492
933k
    va_end(args);
493
933k
}
494
495
void ogs_log_hexdump_func(ogs_log_level_e level, int id,
496
        const unsigned char *data, size_t len)
497
201k
{
498
201k
    size_t n, m;
499
201k
    char dumpstr[OGS_HUGE_LEN];
500
201k
    char *p, *last;
501
502
    /*
503
     * Nothing is written to dumpstr when len is zero, so printing it
504
     * would output an uninitialized stack buffer.
505
     */
506
201k
    if (!len)
507
26.7k
        return;
508
509
174k
    last = dumpstr + OGS_HUGE_LEN;
510
174k
    p = dumpstr;
511
512
361k
    for (n = 0; n < len; n += 16) {
513
186k
        p = ogs_slprintf(p, last, "%04x: ", (int)n);
514
        
515
3.17M
        for (m = n; m < n + 16; m++) {
516
2.98M
            if (m > n && (m % 4) == 0)
517
559k
                p = ogs_slprintf(p, last, " ");
518
2.98M
            if (m < len)
519
404k
                p = ogs_slprintf(p, last, "%02x", data[m]);
520
2.57M
            else
521
2.57M
                p = ogs_slprintf(p, last, "  ");
522
2.98M
        }
523
524
186k
        p = ogs_slprintf(p, last, "   ");
525
526
591k
        for (m = n; m < len && m < n + 16; m++)
527
404k
            p = ogs_slprintf(p, last, "%c", isprint(data[m]) ? data[m] : '.');
528
529
186k
        p = ogs_slprintf(p, last, "\n");
530
186k
    }
531
532
174k
    ogs_log_print(level, "%s", dumpstr);
533
174k
}
534
535
static ogs_log_t *add_log(ogs_log_type_e type)
536
9
{
537
9
    ogs_log_t *log = NULL;
538
539
9
    ogs_pool_alloc(&log_pool, &log);
540
9
    ogs_assert(log);
541
9
    memset(log, 0, sizeof *log);
542
543
9
    log->type = type;
544
545
9
    log->print.timestamp = 1;
546
9
    log->print.domain = 1;
547
9
    log->print.level = 1;
548
9
    log->print.fileline = 1;
549
9
    log->print.linefeed = 1;
550
551
9
    ogs_list_add(&log_list, log);
552
553
9
    return log;
554
9
}
555
556
static int file_cycle(ogs_log_t *log)
557
0
{
558
0
    ogs_assert(log);
559
0
    ogs_assert(log->file.out);
560
0
    ogs_assert(log->file.name);
561
562
0
    fclose(log->file.out);
563
0
    log->file.out = fopen(log->file.name, "a");
564
0
    ogs_assert(log->file.out);
565
566
0
    return 0;
567
0
}
568
569
static char *log_timestamp(char *buf, char *last,
570
        int use_color)
571
254k
{
572
254k
    struct timeval tv;
573
254k
    struct tm tm;
574
254k
    char nowstr[32];
575
576
254k
    ogs_gettimeofday(&tv);
577
254k
    ogs_localtime(tv.tv_sec, &tm);
578
254k
    strftime(nowstr, sizeof nowstr, "%m/%d %H:%M:%S", &tm);
579
580
254k
    buf = ogs_slprintf(buf, last, "%s%s.%03d%s: ",
581
254k
            use_color ? TA_FGC_GREEN : "",
582
254k
            nowstr, (int)(tv.tv_usec/1000),
583
254k
            use_color ? TA_NOR : "");
584
585
254k
    return buf;
586
254k
}
587
588
static char *log_domain(char *buf, char *last,
589
        const char *name, int use_color)
590
254k
{
591
254k
    buf = ogs_slprintf(buf, last, "[%s%s%s] ",
592
254k
            use_color ? TA_FGC_YELLOW : "",
593
254k
            name,
594
254k
            use_color ? TA_NOR : "");
595
596
254k
    return buf;
597
254k
}
598
599
static char *log_level(char *buf, char *last,
600
        ogs_log_level_e level, int use_color)
601
254k
{
602
254k
    const char *colors[] = {
603
254k
        TA_NOR,
604
254k
        TA_FGC_BOLD_RED, TA_FGC_BOLD_YELLOW, TA_FGC_BOLD_CYAN,
605
254k
        TA_FGC_BOLD_GREEN, TA_FGC_BOLD_WHITE, TA_FGC_WHITE,
606
254k
    };
607
608
254k
    buf = ogs_slprintf(buf, last, "%s%s%s: ",
609
254k
            use_color ? colors[level] : "",
610
254k
            level_strings[level],
611
254k
            use_color ? TA_NOR : "");
612
613
254k
    return buf;
614
254k
}
615
616
static char *log_content(char *buf, char *last,
617
        const char *format, va_list ap)
618
255k
{
619
255k
    va_list bp;
620
621
255k
    va_copy(bp, ap);
622
255k
#pragma GCC diagnostic push
623
255k
#pragma GCC diagnostic ignored "-Wformat-nonliteral"
624
255k
    buf = ogs_vslprintf(buf, last, format, bp);
625
255k
#pragma GCC diagnostic pop
626
255k
    va_end(bp);
627
628
255k
    return buf;
629
255k
}
630
631
static char *log_linefeed(char *buf, char *last)
632
254k
{
633
#if defined(_WIN32)
634
    if (buf > last - 3)
635
        buf = last - 3;
636
637
    buf = ogs_slprintf(buf, last, "\r\n");
638
#else
639
254k
    if (buf > last - 2)
640
11
        buf = last - 2;
641
642
254k
    buf = ogs_slprintf(buf, last, "\n");
643
254k
#endif
644
645
254k
    return buf;
646
254k
}
647
648
static void file_writer(
649
        ogs_log_t *log, ogs_log_level_e level, const char *string)
650
255k
{
651
255k
    fprintf(log->file.out, "%s", string);
652
255k
    fflush(log->file.out);
653
255k
}
654