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