]> git.ipfire.org Git - thirdparty/systemd.git/blob - src/basic/parse-util.h
util: introduce parse_ifindex_or_ifname()
[thirdparty/systemd.git] / src / basic / parse-util.h
1 /* SPDX-License-Identifier: LGPL-2.1+ */
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 #define MODE_INVALID ((mode_t) -1)
13
14 int parse_boolean(const char *v) _pure_;
15 int parse_dev(const char *s, dev_t *ret);
16 int parse_pid(const char *s, pid_t* ret_pid);
17 int parse_mode(const char *s, mode_t *ret);
18 int parse_ifindex(const char *s, int *ret);
19 int parse_ifindex_or_ifname(const char *s, int *ret);
20 int parse_mtu(int family, const char *s, uint32_t *ret);
21
22 int parse_size(const char *t, uint64_t base, uint64_t *size);
23 int parse_range(const char *t, unsigned *lower, unsigned *upper);
24 int parse_errno(const char *t);
25 int parse_syscall_and_errno(const char *in, char **name, int *error);
26
27 #define FORMAT_BYTES_MAX 8
28 char *format_bytes(char *buf, size_t l, uint64_t t);
29
30 int safe_atou_full(const char *s, unsigned base, unsigned *ret_u);
31
32 static inline int safe_atou(const char *s, unsigned *ret_u) {
33 return safe_atou_full(s, 0, ret_u);
34 }
35
36 int safe_atoi(const char *s, int *ret_i);
37 int safe_atollu(const char *s, unsigned long long *ret_u);
38 int safe_atolli(const char *s, long long int *ret_i);
39
40 int safe_atou8(const char *s, uint8_t *ret);
41
42 int safe_atou16_full(const char *s, unsigned base, uint16_t *ret);
43
44 static inline int safe_atou16(const char *s, uint16_t *ret) {
45 return safe_atou16_full(s, 0, ret);
46 }
47
48 static inline int safe_atoux16(const char *s, uint16_t *ret) {
49 return safe_atou16_full(s, 16, ret);
50 }
51
52 int safe_atoi16(const char *s, int16_t *ret);
53
54 static inline int safe_atou32(const char *s, uint32_t *ret_u) {
55 assert_cc(sizeof(uint32_t) == sizeof(unsigned));
56 return safe_atou(s, (unsigned*) ret_u);
57 }
58
59 static inline int safe_atoi32(const char *s, int32_t *ret_i) {
60 assert_cc(sizeof(int32_t) == sizeof(int));
61 return safe_atoi(s, (int*) ret_i);
62 }
63
64 static inline int safe_atou64(const char *s, uint64_t *ret_u) {
65 assert_cc(sizeof(uint64_t) == sizeof(unsigned long long));
66 return safe_atollu(s, (unsigned long long*) ret_u);
67 }
68
69 static inline int safe_atoi64(const char *s, int64_t *ret_i) {
70 assert_cc(sizeof(int64_t) == sizeof(long long int));
71 return safe_atolli(s, (long long int*) ret_i);
72 }
73
74 #if LONG_MAX == INT_MAX
75 static inline int safe_atolu(const char *s, unsigned long *ret_u) {
76 assert_cc(sizeof(unsigned long) == sizeof(unsigned));
77 return safe_atou(s, (unsigned*) ret_u);
78 }
79 static inline int safe_atoli(const char *s, long int *ret_u) {
80 assert_cc(sizeof(long int) == sizeof(int));
81 return safe_atoi(s, (int*) ret_u);
82 }
83 #else
84 static inline int safe_atolu(const char *s, unsigned long *ret_u) {
85 assert_cc(sizeof(unsigned long) == sizeof(unsigned long long));
86 return safe_atollu(s, (unsigned long long*) ret_u);
87 }
88 static inline int safe_atoli(const char *s, long int *ret_u) {
89 assert_cc(sizeof(long int) == sizeof(long long int));
90 return safe_atolli(s, (long long int*) ret_u);
91 }
92 #endif
93
94 #if SIZE_MAX == UINT_MAX
95 static inline int safe_atozu(const char *s, size_t *ret_u) {
96 assert_cc(sizeof(size_t) == sizeof(unsigned));
97 return safe_atou(s, (unsigned *) ret_u);
98 }
99 #else
100 static inline int safe_atozu(const char *s, size_t *ret_u) {
101 assert_cc(sizeof(size_t) == sizeof(long unsigned));
102 return safe_atolu(s, ret_u);
103 }
104 #endif
105
106 int safe_atod(const char *s, double *ret_d);
107
108 int parse_fractional_part_u(const char **s, size_t digits, unsigned *res);
109
110 int parse_percent_unbounded(const char *p);
111 int parse_percent(const char *p);
112
113 int parse_permille_unbounded(const char *p);
114 int parse_permille(const char *p);
115
116 int parse_nice(const char *p, int *ret);
117
118 int parse_ip_port(const char *s, uint16_t *ret);
119 int parse_ip_port_range(const char *s, uint16_t *low, uint16_t *high);
120
121 int parse_oom_score_adjust(const char *s, int *ret);