Coverage Report

Created: 2026-09-28 07:04

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/sudo/lib/util/strtonum.c
Line
Count
Source
1
/*
2
 * SPDX-License-Identifier: ISC
3
 *
4
 * Copyright (c) 2013-2015, 2019-2020 Todd C. Miller <Todd.Miller@sudo.ws>
5
 *
6
 * Permission to use, copy, modify, and distribute this software for any
7
 * purpose with or without fee is hereby granted, provided that the above
8
 * copyright notice and this permission notice appear in all copies.
9
 *
10
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17
 */
18
19
#include <config.h>
20
21
#include <ctype.h>
22
#include <errno.h>
23
24
#include <sudo_compat.h>
25
#include <sudo_gettext.h>
26
#include <sudo_util.h>
27
28
enum strtonum_err {
29
    STN_INITIAL,
30
    STN_VALID,
31
    STN_INVALID,
32
    STN_TOOSMALL,
33
    STN_TOOBIG
34
};
35
36
/*
37
 * Convert a string to a number in the range [minval, maxval]
38
 * Unlike strtonum(), this returns the first non-digit in endp (if not NULL).
39
 */
40
long long
41
sudo_strtonumx(const char *str, long long minval, long long maxval, char **endp,
42
    const char **errstrp)
43
21.2k
{
44
21.2k
    enum strtonum_err errval = STN_INITIAL;
45
21.2k
    long long lastval, result = 0;
46
21.2k
    const char *cp = str;
47
21.2k
    int remainder;
48
21.2k
    char ch, sign;
49
50
21.2k
    if (minval > maxval) {
51
0
  errval = STN_INVALID;
52
0
  goto done;
53
0
    }
54
55
    /* Trim leading space and check sign, if any. */
56
21.9k
    do {
57
21.9k
  ch = *cp++;
58
21.9k
    } while (isspace((unsigned char)ch));
59
21.2k
    switch (ch) {
60
2.03k
    case '-':
61
2.03k
  sign = '-';
62
2.03k
  ch = *cp++;
63
2.03k
  break;
64
721
    case '+':
65
721
  ch = *cp++;
66
721
  FALLTHROUGH;
67
19.2k
    default:
68
19.2k
  sign = '+';
69
19.2k
  break;
70
21.2k
    }
71
72
    /*
73
     * To prevent overflow we determine the highest (or lowest in
74
     * the case of negative numbers) value result can have *before*
75
     * if its multiplied (divided) by 10 as well as the remainder.
76
     * If result matches this value and the next digit is larger than
77
     * the remainder, we know the result is out of range.
78
     * The remainder is always positive since it is compared against
79
     * an unsigned digit.
80
     */
81
21.2k
    if (sign == '-') {
82
2.03k
  lastval = minval / 10;
83
2.03k
  remainder = -(int)(minval % 10);
84
2.03k
  if (remainder < 0) {
85
496
      lastval += 1;
86
496
      remainder += 10;
87
496
  }
88
14.0k
  for (;; ch = *cp++) {
89
14.0k
      if (!isdigit((unsigned char)ch))
90
1.42k
    break;
91
12.6k
      ch -= '0';
92
12.6k
      if (result < lastval || (result == lastval && ch > remainder)) {
93
    /* Skip remaining digits. */
94
3.13M
    do {
95
3.13M
        ch = *cp++;
96
3.13M
    } while (isdigit((unsigned char)ch));
97
603
    errval = STN_TOOSMALL;
98
603
    break;
99
12.0k
      } else {
100
12.0k
    result *= 10;
101
12.0k
    result -= ch;
102
12.0k
    errval = STN_VALID;
103
12.0k
      }
104
12.6k
  }
105
2.03k
  if (result > maxval)
106
0
      errval = STN_TOOBIG;
107
19.2k
    } else {
108
19.2k
  lastval = maxval / 10;
109
19.2k
  remainder = (int)(maxval % 10);
110
73.7k
  for (;; ch = *cp++) {
111
73.7k
      if (!isdigit((unsigned char)ch))
112
18.0k
    break;
113
55.6k
      ch -= '0';
114
55.6k
      if (result > lastval || (result == lastval && ch > remainder)) {
115
    /* Skip remaining digits. */
116
1.07M
    do {
117
1.07M
        ch = *cp++;
118
1.07M
    } while (isdigit((unsigned char)ch));
119
1.18k
    errval = STN_TOOBIG;
120
1.18k
    break;
121
54.4k
      } else {
122
54.4k
    result *= 10;
123
54.4k
    result += ch;
124
54.4k
    errval = STN_VALID;
125
54.4k
      }
126
55.6k
  }
127
19.2k
  if (result < minval)
128
401
      errval = STN_TOOSMALL;
129
19.2k
    }
130
131
21.2k
done:
132
21.2k
    switch (errval) {
133
1.31k
    case STN_INITIAL:
134
19.0k
    case STN_VALID:
135
19.0k
  if (errstrp != NULL)
136
19.0k
      *errstrp = NULL;
137
19.0k
  break;
138
0
    case STN_INVALID:
139
0
  result = 0;
140
0
  errno = EINVAL;
141
0
  if (errstrp != NULL)
142
0
      *errstrp = N_("invalid value");
143
0
  break;
144
1.00k
    case STN_TOOSMALL:
145
1.00k
  result = 0;
146
1.00k
  errno = ERANGE;
147
1.00k
  if (errstrp != NULL)
148
1.00k
      *errstrp = N_("value too small");
149
1.00k
  break;
150
1.18k
    case STN_TOOBIG:
151
1.18k
  result = 0;
152
1.18k
  errno = ERANGE;
153
1.18k
  if (errstrp != NULL)
154
1.18k
      *errstrp = N_("value too large");
155
1.18k
  break;
156
21.2k
    }
157
21.2k
    if (endp != NULL) {
158
21.2k
  if (errval == STN_INITIAL || errval == STN_INVALID)
159
1.31k
      *endp = (char *)str;
160
19.9k
  else
161
19.9k
      *endp = (char *)(cp - 1);
162
21.2k
    }
163
21.2k
    return result;
164
21.2k
}
165
166
/*
167
 * Convert a string to a number in the range [minval, maxval]
168
 */
169
long long
170
sudo_strtonum(const char *str, long long minval, long long maxval,
171
    const char **errstrp)
172
21.2k
{
173
21.2k
    const char *errstr;
174
21.2k
    char *ep;
175
21.2k
    long long ret;
176
177
21.2k
    ret = sudo_strtonumx(str, minval, maxval, &ep, &errstr);
178
    /* Check for empty string and terminating NUL. */
179
21.2k
    if (str == ep || *ep != '\0') {
180
1.63k
  errno = EINVAL;
181
1.63k
  errstr = N_("invalid value");
182
1.63k
  ret = 0;
183
1.63k
    }
184
21.2k
    if (errstrp != NULL)
185
19.2k
  *errstrp = errstr;
186
21.2k
    return ret;
187
21.2k
}