Debian Codegraph @

src/basic/parse-util.h

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