Coverage Report

Created: 2026-08-17 06:12

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
953k
#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
238k
#define TA_FGC_BOLD_RED     "\033[1;31m"    /* Bold Red */
37
238k
#define TA_FGC_GREEN        "\033[32m"      /* Green */
38
238k
#define TA_FGC_BOLD_GREEN   "\033[1;32m"    /* Bold Green */
39
238k
#define TA_FGC_YELLOW       "\033[33m"      /* Yellow */
40
238k
#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
238k
#define TA_FGC_BOLD_CYAN    "\033[1;36m"    /* Bold Cyan */
44
238k
#define TA_FGC_WHITE        "\033[37m"      /* White  */
45
238k
#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
8
{
116
8
    ogs_pool_init(&log_pool, ogs_core()->log.pool);
117
8
    ogs_pool_init(&domain_pool, ogs_core()->log.domain_pool);
118
119
8
    ogs_log_add_domain("core", ogs_core()->log.level);
120
8
    ogs_log_add_stderr();
121
8
}
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
8
{
153
8
    ogs_log_t *log = NULL;
154
    
155
8
    log = add_log(OGS_LOG_STDERR_TYPE);
156
8
    ogs_assert(log);
157
158
8
    log->file.out = stderr;
159
8
    log->writer = file_writer;
160
161
8
#if !defined(_WIN32)
162
8
    log->print.color = 1;
163
8
#endif
164
165
8
    return log;
166
8
}
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
56
{
205
56
    ogs_log_domain_t *domain = NULL;
206
207
56
    ogs_assert(name);
208
209
56
    ogs_pool_alloc(&domain_pool, &domain);
210
56
    ogs_assert(domain);
211
212
56
    domain->name = name;
213
56
    domain->id = ogs_pool_index(&domain_pool, domain);
214
56
    domain->level = level;
215
216
56
    ogs_list_add(&domain_list, domain);
217
218
56
    return domain;
219
56
}
220
221
ogs_log_domain_t *ogs_log_find_domain(const char *name)
222
50
{
223
50
    ogs_log_domain_t *domain = NULL;
224
225
50
    ogs_assert(name);
226
227
50
    ogs_list_for_each(&domain_list, domain)
228
180
        if (!ogs_strcasecmp(domain->name, name))
229
2
            return domain;
230
231
48
    return NULL;
232
50
}
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
146
{
256
146
    ogs_log_domain_t *domain = NULL;
257
258
146
    ogs_assert(id > 0 && id <= ogs_core()->log.domain_pool);
259
260
146
    domain = ogs_pool_find(&domain_pool, id);
261
146
    ogs_assert(domain);
262
263
146
    return domain->level;
264
146
}
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
50
{
293
50
    ogs_log_domain_t *domain = NULL;
294
295
50
    ogs_assert(domain_id);
296
50
    ogs_assert(name);
297
298
50
    domain = ogs_log_find_domain(name);
299
50
    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
48
    } else {
307
48
        domain = ogs_log_add_domain(name, level);
308
48
        ogs_assert(domain);
309
48
    }
310
311
50
    *domain_id = domain->id;
312
50
}
313
314
void ogs_log_set_mask_level(const char *_mask, ogs_log_level_e level)
315
0
{
316
0
    ogs_log_domain_t *domain = NULL;
317
318
0
    if (_mask) {
319
0
        const char *delim = " \t\n,:";
320
0
        char *mask = NULL;
321
0
        char *saveptr;
322
0
        char *name;
323
324
0
        mask = ogs_strdup(_mask);
325
0
        ogs_assert(mask);
326
327
0
        for (name = ogs_strtok_r(mask, delim, &saveptr);
328
0
            name != NULL;
329
0
            name = ogs_strtok_r(NULL, delim, &saveptr)) {
330
331
0
            domain = ogs_log_find_domain(name);
332
0
            if (domain)
333
0
                domain->level = level;
334
0
        }
335
336
0
        ogs_free(mask);
337
0
    } else {
338
0
        ogs_list_for_each(&domain_list, domain)
339
0
            domain->level = level;
340
0
    }
341
0
}
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
948k
{
405
948k
    ogs_log_t *log = NULL;
406
948k
    ogs_log_domain_t *domain = NULL;
407
408
948k
    char logstr[OGS_HUGE_LEN];
409
948k
    char *p, *last;
410
411
948k
    int wrote_stderr = 0;
412
413
948k
    ogs_list_for_each(&log_list, log) {
414
948k
        domain = ogs_pool_find(&domain_pool, id);
415
948k
        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
948k
        if (domain->level < level)
420
709k
            return;
421
422
238k
        p = logstr;
423
238k
        last = logstr + OGS_HUGE_LEN;
424
425
238k
        if (!content_only) {
426
238k
            if (log->print.timestamp)
427
238k
                p = log_timestamp(p, last, log->print.color);
428
238k
            if (log->print.domain)
429
238k
                p = log_domain(p, last, domain->name, log->print.color);
430
238k
            if (log->print.level)
431
238k
                p = log_level(p, last, level, log->print.color);
432
238k
        }
433
434
238k
        p = log_content(p, last, format, ap);
435
436
238k
        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
238k
        if (!content_only) {
443
238k
            if (log->print.fileline)
444
238k
                p = ogs_slprintf(p, last, " (%s:%d)", file, line);
445
238k
            if (log->print.function)
446
0
                p = ogs_slprintf(p, last, " %s()", func);
447
238k
            if (log->print.linefeed) 
448
238k
                p = log_linefeed(p, last);
449
238k
        }
450
451
238k
        log->writer(log, level, logstr);
452
        
453
238k
        if (log->type == OGS_LOG_STDERR_TYPE)
454
238k
            wrote_stderr = 1;
455
238k
    }
456
457
238k
    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
238k
}
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
948k
{
487
948k
    va_list args;
488
489
948k
    va_start(args, format);
490
948k
    ogs_log_vprintf(level, id,
491
948k
            err, file, line, func, content_only, format, args);
492
948k
    va_end(args);
493
948k
}
494
495
void ogs_log_hexdump_func(ogs_log_level_e level, int id,
496
        const unsigned char *data, size_t len)
497
209k
{
498
209k
    size_t n, m;
499
209k
    char dumpstr[OGS_HUGE_LEN];
500
209k
    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
209k
    if (!len)
507
25.8k
        return;
508
509
183k
    last = dumpstr + OGS_HUGE_LEN;
510
183k
    p = dumpstr;
511
512
378k
    for (n = 0; n < len; n += 16) {
513
194k
        p = ogs_slprintf(p, last, "%04x: ", (int)n);
514
        
515
3.30M
        for (m = n; m < n + 16; m++) {
516
3.11M
            if (m > n && (m % 4) == 0)
517
583k
                p = ogs_slprintf(p, last, " ");
518
3.11M
            if (m < len)
519
397k
                p = ogs_slprintf(p, last, "%02x", data[m]);
520
2.71M
            else
521
2.71M
                p = ogs_slprintf(p, last, "  ");
522
3.11M
        }
523
524
194k
        p = ogs_slprintf(p, last, "   ");
525
526
591k
        for (m = n; m < len && m < n + 16; m++)
527
397k
            p = ogs_slprintf(p, last, "%c", isprint(data[m]) ? data[m] : '.');
528
529
194k
        p = ogs_slprintf(p, last, "\n");
530
194k
    }
531
532
183k
    ogs_log_print(level, "%s", dumpstr);
533
183k
}
534
535
static ogs_log_t *add_log(ogs_log_type_e type)
536
8
{
537
8
    ogs_log_t *log = NULL;
538
539
8
    ogs_pool_alloc(&log_pool, &log);
540
8
    ogs_assert(log);
541
8
    memset(log, 0, sizeof *log);
542
543
8
    log->type = type;
544
545
8
    log->print.timestamp = 1;
546
8
    log->print.domain = 1;
547
8
    log->print.level = 1;
548
8
    log->print.fileline = 1;
549
8
    log->print.linefeed = 1;
550
551
8
    ogs_list_add(&log_list, log);
552
553
8
    return log;
554
8
}
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
238k
{
572
238k
    struct timeval tv;
573
238k
    struct tm tm;
574
238k
    char nowstr[32];
575
576
238k
    ogs_gettimeofday(&tv);
577
238k
    ogs_localtime(tv.tv_sec, &tm);
578
238k
    strftime(nowstr, sizeof nowstr, "%m/%d %H:%M:%S", &tm);
579
580
238k
    buf = ogs_slprintf(buf, last, "%s%s.%03d%s: ",
581
238k
            use_color ? TA_FGC_GREEN : "",
582
238k
            nowstr, (int)(tv.tv_usec/1000),
583
238k
            use_color ? TA_NOR : "");
584
585
238k
    return buf;
586
238k
}
587
588
static char *log_domain(char *buf, char *last,
589
        const char *name, int use_color)
590
238k
{
591
238k
    buf = ogs_slprintf(buf, last, "[%s%s%s] ",
592
238k
            use_color ? TA_FGC_YELLOW : "",
593
238k
            name,
594
238k
            use_color ? TA_NOR : "");
595
596
238k
    return buf;
597
238k
}
598
599
static char *log_level(char *buf, char *last,
600
        ogs_log_level_e level, int use_color)
601
238k
{
602
238k
    const char *colors[] = {
603
238k
        TA_NOR,
604
238k
        TA_FGC_BOLD_RED, TA_FGC_BOLD_YELLOW, TA_FGC_BOLD_CYAN,
605
238k
        TA_FGC_BOLD_GREEN, TA_FGC_BOLD_WHITE, TA_FGC_WHITE,
606
238k
    };
607
608
238k
    buf = ogs_slprintf(buf, last, "%s%s%s: ",
609
238k
            use_color ? colors[level] : "",
610
238k
            level_strings[level],
611
238k
            use_color ? TA_NOR : "");
612
613
238k
    return buf;
614
238k
}
615
616
static char *log_content(char *buf, char *last,
617
        const char *format, va_list ap)
618
238k
{
619
238k
    va_list bp;
620
621
238k
    va_copy(bp, ap);
622
238k
#pragma GCC diagnostic push
623
238k
#pragma GCC diagnostic ignored "-Wformat-nonliteral"
624
238k
    buf = ogs_vslprintf(buf, last, format, bp);
625
238k
#pragma GCC diagnostic pop
626
238k
    va_end(bp);
627
628
238k
    return buf;
629
238k
}
630
631
static char *log_linefeed(char *buf, char *last)
632
238k
{
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
238k
    if (buf > last - 2)
640
9
        buf = last - 2;
641
642
238k
    buf = ogs_slprintf(buf, last, "\n");
643
238k
#endif
644
645
238k
    return buf;
646
238k
}
647
648
static void file_writer(
649
        ogs_log_t *log, ogs_log_level_e level, const char *string)
650
238k
{
651
238k
    fprintf(log->file.out, "%s", string);
652
238k
    fflush(log->file.out);
653
238k
}
654