Coverage Report

Created: 2023-05-18 19:24

/src/systemd/src/basic/parse-util.h
Line
Count
Source (jump to first uncovered line)
1
/* SPDX-License-Identifier: LGPL-2.1-or-later */
2
#pragma once
3
4
#include <inttypes.h>
5
#include <limits.h>
6
#include <stddef.h>
7
#include <stdint.h>
8
#include <sys/types.h>
9
10
#include "macro.h"
11
12
typedef unsigned long loadavg_t;
13
14
int parse_boolean(const char *v) _pure_;
15
int parse_pid(const char *s, pid_t* ret_pid);
16
int parse_mode(const char *s, mode_t *ret);
17
int parse_ifindex(const char *s);
18
int parse_mtu(int family, const char *s, uint32_t *ret);
19
20
int parse_size(const char *t, uint64_t base, uint64_t *size);
21
int parse_range(const char *t, unsigned *lower, unsigned *upper);
22
int parse_errno(const char *t);
23
24
#define SAFE_ATO_REFUSE_PLUS_MINUS (1U << 30)
25
#define SAFE_ATO_REFUSE_LEADING_ZERO (1U << 29)
26
#define SAFE_ATO_REFUSE_LEADING_WHITESPACE (1U << 28)
27
#define SAFE_ATO_ALL_FLAGS (SAFE_ATO_REFUSE_PLUS_MINUS|SAFE_ATO_REFUSE_LEADING_ZERO|SAFE_ATO_REFUSE_LEADING_WHITESPACE)
28
#define SAFE_ATO_MASK_FLAGS(base) ((base) & ~SAFE_ATO_ALL_FLAGS)
29
30
int safe_atou_full(const char *s, unsigned base, unsigned *ret_u);
31
32
0
static inline int safe_atou(const char *s, unsigned *ret_u) {
33
0
        return safe_atou_full(s, 0, ret_u);
34
0
}
35
36
int safe_atoi(const char *s, int *ret_i);
37
int safe_atolli(const char *s, long long int *ret_i);
38
39
int safe_atou8_full(const char *s, unsigned base, uint8_t *ret);
40
41
0
static inline int safe_atou8(const char *s, uint8_t *ret) {
42
0
        return safe_atou8_full(s, 0, ret);
43
0
}
44
45
int safe_atou16_full(const char *s, unsigned base, uint16_t *ret);
46
47
0
static inline int safe_atou16(const char *s, uint16_t *ret) {
48
0
        return safe_atou16_full(s, 0, ret);
49
0
}
50
51
0
static inline int safe_atoux16(const char *s, uint16_t *ret) {
52
0
        return safe_atou16_full(s, 16, ret);
53
0
}
54
55
int safe_atoi16(const char *s, int16_t *ret);
56
57
22.6k
static inline int safe_atou32_full(const char *s, unsigned base, uint32_t *ret_u) {
58
22.6k
        assert_cc(sizeof(uint32_t) == sizeof(unsigned));
59
22.6k
        return safe_atou_full(s, base, (unsigned*) ret_u);
60
22.6k
}
61
62
22.6k
static inline int safe_atou32(const char *s, uint32_t *ret_u) {
63
22.6k
        return safe_atou32_full(s, 0, (unsigned*) ret_u);
64
22.6k
}
65
66
0
static inline int safe_atoi32(const char *s, int32_t *ret_i) {
67
0
        assert_cc(sizeof(int32_t) == sizeof(int));
68
0
        return safe_atoi(s, (int*) ret_i);
69
0
}
70
71
int safe_atollu_full(const char *s, unsigned base, unsigned long long *ret_llu);
72
73
0
static inline int safe_atollu(const char *s, unsigned long long *ret_llu) {
74
0
        return safe_atollu_full(s, 0, ret_llu);
75
0
}
76
77
0
static inline int safe_atou64(const char *s, uint64_t *ret_u) {
78
0
        assert_cc(sizeof(uint64_t) == sizeof(unsigned long long));
79
0
        return safe_atollu(s, (unsigned long long*) ret_u);
80
0
}
81
82
0
static inline int safe_atoi64(const char *s, int64_t *ret_i) {
83
0
        assert_cc(sizeof(int64_t) == sizeof(long long int));
84
0
        return safe_atolli(s, (long long int*) ret_i);
85
0
}
86
87
0
static inline int safe_atoux64(const char *s, uint64_t *ret) {
88
0
        assert_cc(sizeof(int64_t) == sizeof(unsigned long long));
89
0
        return safe_atollu_full(s, 16, (unsigned long long*) ret);
90
0
}
91
92
#if LONG_MAX == INT_MAX
93
static inline int safe_atolu_full(const char *s, unsigned base, unsigned long *ret_u) {
94
        assert_cc(sizeof(unsigned long) == sizeof(unsigned));
95
        return safe_atou_full(s, base, (unsigned*) ret_u);
96
}
97
static inline int safe_atoli(const char *s, long int *ret_u) {
98
        assert_cc(sizeof(long int) == sizeof(int));
99
        return safe_atoi(s, (int*) ret_u);
100
}
101
#else
102
0
static inline int safe_atolu_full(const char *s, unsigned base, unsigned long *ret_u) {
103
0
        assert_cc(sizeof(unsigned long) == sizeof(unsigned long long));
104
0
        return safe_atollu_full(s, base, (unsigned long long*) ret_u);
105
0
}
106
0
static inline int safe_atoli(const char *s, long int *ret_u) {
107
0
        assert_cc(sizeof(long int) == sizeof(long long int));
108
0
        return safe_atolli(s, (long long int*) ret_u);
109
0
}
110
#endif
111
112
0
static inline int safe_atolu(const char *s, unsigned long *ret_u) {
113
0
        return safe_atolu_full(s, 0, ret_u);
114
0
}
115
116
#if SIZE_MAX == UINT_MAX
117
static inline int safe_atozu(const char *s, size_t *ret_u) {
118
        assert_cc(sizeof(size_t) == sizeof(unsigned));
119
        return safe_atou(s, (unsigned *) ret_u);
120
}
121
#else
122
0
static inline int safe_atozu(const char *s, size_t *ret_u) {
123
0
        assert_cc(sizeof(size_t) == sizeof(unsigned long));
124
0
        return safe_atolu(s, ret_u);
125
0
}
126
#endif
127
128
int safe_atod(const char *s, double *ret_d);
129
130
int parse_fractional_part_u(const char **s, size_t digits, unsigned *res);
131
132
int parse_nice(const char *p, int *ret);
133
134
int parse_ip_port(const char *s, uint16_t *ret);
135
int parse_ip_port_range(const char *s, uint16_t *low, uint16_t *high);
136
137
int parse_ip_prefix_length(const char *s, int *ret);
138
139
int parse_oom_score_adjust(const char *s, int *ret);
140
141
/* Implement floating point using fixed integers, to improve performance when
142
 * calculating load averages. These macros can be used to extract the integer
143
 * and decimal parts of a value. */
144
#define LOADAVG_PRECISION_BITS  11
145
#define LOADAVG_FIXED_POINT_1_0 (1 << LOADAVG_PRECISION_BITS)
146
#define LOADAVG_INT_SIDE(x)     ((x) >> LOADAVG_PRECISION_BITS)
147
#define LOADAVG_DECIMAL_SIDE(x) LOADAVG_INT_SIDE(((x) & (LOADAVG_FIXED_POINT_1_0 - 1)) * 100)
148
149
/* Given a Linux load average (e.g. decimal number 34.89 where 34 is passed as i and 89 is passed as f), convert it
150
 * to a loadavg_t. */
151
int store_loadavg_fixed_point(unsigned long i, unsigned long f, loadavg_t *ret);
152
int parse_loadavg_fixed_point(const char *s, loadavg_t *ret);