src/basic/parse-util.h

   1 /* SPDX-License-Identifier: LGPL-2.1+ */
   2 #pragma once
   3
   4 /***
   5   This file is part of systemd.
   6
   7   Copyright 2010 Lennart Poettering
   8 ***/
   9
  10 #include <inttypes.h>
  11 #include <limits.h>
  12 #include <stddef.h>
  13 #include <stdint.h>
  14 #include <sys/types.h>
  15
  16 #include "macro.h"
  17
  18 #define MODE_INVALID ((mode_t) -1)
  19
  20 int parse_boolean(const char *v) _pure_;
  21 int parse_dev(const char *s, dev_t *ret);
  22 int parse_pid(const char *s, pid_t* ret_pid);
  23 int parse_mode(const char *s, mode_t *ret);
  24 int parse_ifindex(const char *s, int *ret);
  25 int parse_mtu(int family, const char *s, uint32_t *ret);
  26
  27 int parse_size(const char *t, uint64_t base, uint64_t *size);
  28 #if 0 /// UNNEEDED by elogind
  29 int parse_range(const char *t, unsigned *lower, unsigned *upper);
  30 #endif // 0
  31 int parse_errno(const char *t);
  32 int parse_syscall_and_errno(const char *in, char **name, int *error);
  33
  34 #define FORMAT_BYTES_MAX 8
  35 char *format_bytes(char *buf, size_t l, uint64_t t);
  36
  37 int safe_atou_full(const char *s, unsigned base, unsigned *ret_u);
  38
  39 static inline int safe_atou(const char *s, unsigned *ret_u) {
  40         return safe_atou_full(s, 0, ret_u);
  41 }
  42
  43 int safe_atoi(const char *s, int *ret_i);
  44 int safe_atollu(const char *s, unsigned long long *ret_u);
  45 int safe_atolli(const char *s, long long int *ret_i);
  46
  47 int safe_atou8(const char *s, uint8_t *ret);
  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(const char *s, uint32_t *ret_u) {
  62         assert_cc(sizeof(uint32_t) == sizeof(unsigned));
  63         return safe_atou(s, (unsigned*) ret_u);
  64 }
  65
  66 static inline int safe_atoi32(const char *s, int32_t *ret_i) {
  67         assert_cc(sizeof(int32_t) == sizeof(int));
  68         return safe_atoi(s, (int*) ret_i);
  69 }
  70
  71 static inline int safe_atou64(const char *s, uint64_t *ret_u) {
  72         assert_cc(sizeof(uint64_t) == sizeof(unsigned long long));
  73         return safe_atollu(s, (unsigned long long*) ret_u);
  74 }
  75
  76 static inline int safe_atoi64(const char *s, int64_t *ret_i) {
  77         assert_cc(sizeof(int64_t) == sizeof(long long int));
  78         return safe_atolli(s, (long long int*) ret_i);
  79 }
  80
  81 #if LONG_MAX == INT_MAX
  82 static inline int safe_atolu(const char *s, unsigned long *ret_u) {
  83         assert_cc(sizeof(unsigned long) == sizeof(unsigned));
  84         return safe_atou(s, (unsigned*) ret_u);
  85 }
  86 static inline int safe_atoli(const char *s, long int *ret_u) {
  87         assert_cc(sizeof(long int) == sizeof(int));
  88         return safe_atoi(s, (int*) ret_u);
  89 }
  90 #else
  91 static inline int safe_atolu(const char *s, unsigned long *ret_u) {
  92         assert_cc(sizeof(unsigned long) == sizeof(unsigned long long));
  93         return safe_atollu(s, (unsigned long long*) ret_u);
  94 }
  95 static inline int safe_atoli(const char *s, long int *ret_u) {
  96         assert_cc(sizeof(long int) == sizeof(long long int));
  97         return safe_atolli(s, (long long int*) ret_u);
  98 }
  99 #endif
 100
 101 #if SIZE_MAX == UINT_MAX
 102 static inline int safe_atozu(const char *s, size_t *ret_u) {
 103         assert_cc(sizeof(size_t) == sizeof(unsigned));
 104         return safe_atou(s, (unsigned *) ret_u);
 105 }
 106 #else
 107 static inline int safe_atozu(const char *s, size_t *ret_u) {
 108         assert_cc(sizeof(size_t) == sizeof(long unsigned));
 109         return safe_atolu(s, ret_u);
 110 }
 111 #endif
 112
 113 int safe_atod(const char *s, double *ret_d);
 114
 115 int parse_fractional_part_u(const char **s, size_t digits, unsigned *res);
 116
 117 int parse_percent_unbounded(const char *p);
 118 int parse_percent(const char *p);
 119
 120 int parse_permille_unbounded(const char *p);
 121 int parse_permille(const char *p);
 122
 123 #if 0 /// UNNEEDED by elogind
 124 int parse_nice(const char *p, int *ret);
 125
 126 int parse_ip_port(const char *s, uint16_t *ret);
 127 #endif // 0
 128
 129 int parse_oom_score_adjust(const char *s, int *ret);