blob: 661a1e807bd1ac89616ee1eff4ac395c05d617d8 [file] [log] [blame]
Greg Kroah-Hartmanb2441312017-11-01 15:07:57 +01001// SPDX-License-Identifier: GPL-2.0
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -07002/*
3 * Convert integer string representation to an integer.
4 * If an integer doesn't fit into specified type, -E is returned.
5 *
6 * Integer starts with optional sign.
7 * kstrtou*() functions do not accept sign "-".
8 *
9 * Radix 0 means autodetection: leading "0x" implies radix 16,
10 * leading "0" implies radix 8, otherwise radix is 10.
11 * Autodetection hints work after optional sign, but not before.
12 *
13 * If -E is returned, result is not touched.
14 */
15#include <linux/ctype.h>
16#include <linux/errno.h>
17#include <linux/kernel.h>
18#include <linux/math64.h>
Paul Gortmaker8bc3bcc2011-11-16 21:29:17 -050019#include <linux/export.h>
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070020#include <linux/types.h>
Linus Torvalds7c0f6ba2016-12-24 11:46:01 -080021#include <linux/uaccess.h>
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070022#include "kstrtox.h"
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070023
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070024const char *_parse_integer_fixup_radix(const char *s, unsigned int *base)
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070025{
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070026 if (*base == 0) {
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070027 if (s[0] == '0') {
28 if (_tolower(s[1]) == 'x' && isxdigit(s[2]))
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070029 *base = 16;
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070030 else
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070031 *base = 8;
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070032 } else
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070033 *base = 10;
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070034 }
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070035 if (*base == 16 && s[0] == '0' && _tolower(s[1]) == 'x')
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070036 s += 2;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070037 return s;
38}
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070039
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070040/*
41 * Convert non-negative integer string representation in explicitly given radix
42 * to an integer.
43 * Return number of characters consumed maybe or-ed with overflow bit.
44 * If overflow occurs, result integer (incorrect) is still returned.
45 *
46 * Don't you dare use this function.
47 */
David Howells690d1372012-02-09 15:48:20 +000048unsigned int _parse_integer(const char *s, unsigned int base, unsigned long long *p)
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070049{
David Howells690d1372012-02-09 15:48:20 +000050 unsigned long long res;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070051 unsigned int rv;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070052
David Howells690d1372012-02-09 15:48:20 +000053 res = 0;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070054 rv = 0;
Alexey Dobriyan512750e2017-07-10 15:51:38 -070055 while (1) {
Alexey Dobriyanbe5f3c72017-07-10 15:51:41 -070056 unsigned int c = *s;
57 unsigned int lc = c | 0x20; /* don't tolower() this line */
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070058 unsigned int val;
59
Alexey Dobriyanbe5f3c72017-07-10 15:51:41 -070060 if ('0' <= c && c <= '9')
61 val = c - '0';
62 else if ('a' <= lc && lc <= 'f')
63 val = lc - 'a' + 10;
Alexey Dobriyan78be9592011-04-14 15:22:02 -070064 else
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070065 break;
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070066
67 if (val >= base)
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070068 break;
David Howells690d1372012-02-09 15:48:20 +000069 /*
70 * Check for overflow only if we are within range of
71 * it in the max base we support (16)
72 */
73 if (unlikely(res & (~0ull << 60))) {
74 if (res > div_u64(ULLONG_MAX - val, base))
Alexey Dobriyan8cfd56d2016-10-11 13:51:32 -070075 rv |= KSTRTOX_OVERFLOW;
David Howells690d1372012-02-09 15:48:20 +000076 }
77 res = res * base + val;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070078 rv++;
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070079 s++;
80 }
David Howells690d1372012-02-09 15:48:20 +000081 *p = res;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070082 return rv;
83}
84
85static int _kstrtoull(const char *s, unsigned int base, unsigned long long *res)
86{
87 unsigned long long _res;
88 unsigned int rv;
89
90 s = _parse_integer_fixup_radix(s, &base);
91 rv = _parse_integer(s, base, &_res);
92 if (rv & KSTRTOX_OVERFLOW)
93 return -ERANGE;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070094 if (rv == 0)
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -070095 return -EINVAL;
Alexey Dobriyan1dff46d2011-10-31 17:12:28 -070096 s += rv;
97 if (*s == '\n')
98 s++;
99 if (*s)
100 return -EINVAL;
101 *res = _res;
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -0700102 return 0;
103}
104
Eldad Zack4c925d62012-12-17 16:03:04 -0800105/**
106 * kstrtoull - convert a string to an unsigned long long
107 * @s: The start of the string. The string must be null-terminated, and may also
108 * include a single newline before its terminating null. The first character
109 * may also be a plus sign, but not a minus sign.
110 * @base: The number base to use. The maximum supported base is 16. If base is
111 * given as 0, then the base of the string is automatically detected with the
112 * conventional semantics - If it begins with 0x the number will be parsed as a
113 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
114 * parsed as an octal number. Otherwise it will be parsed as a decimal.
115 * @res: Where to write the result of the conversion on success.
116 *
117 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
118 * Used as a replacement for the obsolete simple_strtoull. Return code must
119 * be checked.
120 */
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -0700121int kstrtoull(const char *s, unsigned int base, unsigned long long *res)
122{
123 if (s[0] == '+')
124 s++;
125 return _kstrtoull(s, base, res);
126}
127EXPORT_SYMBOL(kstrtoull);
128
Eldad Zack4c925d62012-12-17 16:03:04 -0800129/**
130 * kstrtoll - convert a string to a long long
131 * @s: The start of the string. The string must be null-terminated, and may also
132 * include a single newline before its terminating null. The first character
133 * may also be a plus sign or a minus sign.
134 * @base: The number base to use. The maximum supported base is 16. If base is
135 * given as 0, then the base of the string is automatically detected with the
136 * conventional semantics - If it begins with 0x the number will be parsed as a
137 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
138 * parsed as an octal number. Otherwise it will be parsed as a decimal.
139 * @res: Where to write the result of the conversion on success.
140 *
141 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
142 * Used as a replacement for the obsolete simple_strtoull. Return code must
143 * be checked.
144 */
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -0700145int kstrtoll(const char *s, unsigned int base, long long *res)
146{
147 unsigned long long tmp;
148 int rv;
149
150 if (s[0] == '-') {
151 rv = _kstrtoull(s + 1, base, &tmp);
152 if (rv < 0)
153 return rv;
Alexey Dobriyan2d2e4712015-09-09 15:36:17 -0700154 if ((long long)-tmp > 0)
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -0700155 return -ERANGE;
156 *res = -tmp;
157 } else {
158 rv = kstrtoull(s, base, &tmp);
159 if (rv < 0)
160 return rv;
161 if ((long long)tmp < 0)
162 return -ERANGE;
163 *res = tmp;
164 }
165 return 0;
166}
167EXPORT_SYMBOL(kstrtoll);
168
169/* Internal, do not use. */
170int _kstrtoul(const char *s, unsigned int base, unsigned long *res)
171{
172 unsigned long long tmp;
173 int rv;
174
175 rv = kstrtoull(s, base, &tmp);
176 if (rv < 0)
177 return rv;
178 if (tmp != (unsigned long long)(unsigned long)tmp)
179 return -ERANGE;
180 *res = tmp;
181 return 0;
182}
183EXPORT_SYMBOL(_kstrtoul);
184
185/* Internal, do not use. */
186int _kstrtol(const char *s, unsigned int base, long *res)
187{
188 long long tmp;
189 int rv;
190
191 rv = kstrtoll(s, base, &tmp);
192 if (rv < 0)
193 return rv;
194 if (tmp != (long long)(long)tmp)
195 return -ERANGE;
196 *res = tmp;
197 return 0;
198}
199EXPORT_SYMBOL(_kstrtol);
200
Eldad Zack4c925d62012-12-17 16:03:04 -0800201/**
202 * kstrtouint - convert a string to an unsigned int
203 * @s: The start of the string. The string must be null-terminated, and may also
204 * include a single newline before its terminating null. The first character
205 * may also be a plus sign, but not a minus sign.
206 * @base: The number base to use. The maximum supported base is 16. If base is
207 * given as 0, then the base of the string is automatically detected with the
208 * conventional semantics - If it begins with 0x the number will be parsed as a
209 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
210 * parsed as an octal number. Otherwise it will be parsed as a decimal.
211 * @res: Where to write the result of the conversion on success.
212 *
213 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
214 * Used as a replacement for the obsolete simple_strtoull. Return code must
215 * be checked.
216 */
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -0700217int kstrtouint(const char *s, unsigned int base, unsigned int *res)
218{
219 unsigned long long tmp;
220 int rv;
221
222 rv = kstrtoull(s, base, &tmp);
223 if (rv < 0)
224 return rv;
225 if (tmp != (unsigned long long)(unsigned int)tmp)
226 return -ERANGE;
227 *res = tmp;
228 return 0;
229}
230EXPORT_SYMBOL(kstrtouint);
231
Eldad Zack4c925d62012-12-17 16:03:04 -0800232/**
233 * kstrtoint - convert a string to an int
234 * @s: The start of the string. The string must be null-terminated, and may also
235 * include a single newline before its terminating null. The first character
236 * may also be a plus sign or a minus sign.
237 * @base: The number base to use. The maximum supported base is 16. If base is
238 * given as 0, then the base of the string is automatically detected with the
239 * conventional semantics - If it begins with 0x the number will be parsed as a
240 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
241 * parsed as an octal number. Otherwise it will be parsed as a decimal.
242 * @res: Where to write the result of the conversion on success.
243 *
244 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
245 * Used as a replacement for the obsolete simple_strtoull. Return code must
246 * be checked.
247 */
Alexey Dobriyan33ee3b22011-03-22 16:34:40 -0700248int kstrtoint(const char *s, unsigned int base, int *res)
249{
250 long long tmp;
251 int rv;
252
253 rv = kstrtoll(s, base, &tmp);
254 if (rv < 0)
255 return rv;
256 if (tmp != (long long)(int)tmp)
257 return -ERANGE;
258 *res = tmp;
259 return 0;
260}
261EXPORT_SYMBOL(kstrtoint);
262
263int kstrtou16(const char *s, unsigned int base, u16 *res)
264{
265 unsigned long long tmp;
266 int rv;
267
268 rv = kstrtoull(s, base, &tmp);
269 if (rv < 0)
270 return rv;
271 if (tmp != (unsigned long long)(u16)tmp)
272 return -ERANGE;
273 *res = tmp;
274 return 0;
275}
276EXPORT_SYMBOL(kstrtou16);
277
278int kstrtos16(const char *s, unsigned int base, s16 *res)
279{
280 long long tmp;
281 int rv;
282
283 rv = kstrtoll(s, base, &tmp);
284 if (rv < 0)
285 return rv;
286 if (tmp != (long long)(s16)tmp)
287 return -ERANGE;
288 *res = tmp;
289 return 0;
290}
291EXPORT_SYMBOL(kstrtos16);
292
293int kstrtou8(const char *s, unsigned int base, u8 *res)
294{
295 unsigned long long tmp;
296 int rv;
297
298 rv = kstrtoull(s, base, &tmp);
299 if (rv < 0)
300 return rv;
301 if (tmp != (unsigned long long)(u8)tmp)
302 return -ERANGE;
303 *res = tmp;
304 return 0;
305}
306EXPORT_SYMBOL(kstrtou8);
307
308int kstrtos8(const char *s, unsigned int base, s8 *res)
309{
310 long long tmp;
311 int rv;
312
313 rv = kstrtoll(s, base, &tmp);
314 if (rv < 0)
315 return rv;
316 if (tmp != (long long)(s8)tmp)
317 return -ERANGE;
318 *res = tmp;
319 return 0;
320}
321EXPORT_SYMBOL(kstrtos8);
Alexey Dobriyanc196e322011-05-24 17:13:31 -0700322
Kees Cookef951592016-03-17 14:22:50 -0700323/**
324 * kstrtobool - convert common user inputs into boolean values
325 * @s: input string
326 * @res: result
327 *
Kees Cooka81a5a12016-03-17 14:22:57 -0700328 * This routine returns 0 iff the first character is one of 'Yy1Nn0', or
329 * [oO][NnFf] for "on" and "off". Otherwise it will return -EINVAL. Value
330 * pointed to by res is updated upon finding a match.
Kees Cookef951592016-03-17 14:22:50 -0700331 */
332int kstrtobool(const char *s, bool *res)
333{
334 if (!s)
335 return -EINVAL;
336
337 switch (s[0]) {
338 case 'y':
339 case 'Y':
340 case '1':
341 *res = true;
342 return 0;
343 case 'n':
344 case 'N':
345 case '0':
346 *res = false;
347 return 0;
Kees Cooka81a5a12016-03-17 14:22:57 -0700348 case 'o':
349 case 'O':
350 switch (s[1]) {
351 case 'n':
352 case 'N':
353 *res = true;
354 return 0;
355 case 'f':
356 case 'F':
357 *res = false;
358 return 0;
359 default:
360 break;
361 }
Kees Cookef951592016-03-17 14:22:50 -0700362 default:
363 break;
364 }
365
366 return -EINVAL;
367}
368EXPORT_SYMBOL(kstrtobool);
369
370/*
371 * Since "base" would be a nonsense argument, this open-codes the
372 * _from_user helper instead of using the helper macro below.
373 */
374int kstrtobool_from_user(const char __user *s, size_t count, bool *res)
375{
376 /* Longest string needed to differentiate, newline, terminator */
377 char buf[4];
378
379 count = min(count, sizeof(buf) - 1);
380 if (copy_from_user(buf, s, count))
381 return -EFAULT;
382 buf[count] = '\0';
383 return kstrtobool(buf, res);
384}
385EXPORT_SYMBOL(kstrtobool_from_user);
386
Alexey Dobriyanc196e322011-05-24 17:13:31 -0700387#define kstrto_from_user(f, g, type) \
388int f(const char __user *s, size_t count, unsigned int base, type *res) \
389{ \
390 /* sign, base 2 representation, newline, terminator */ \
391 char buf[1 + sizeof(type) * 8 + 1 + 1]; \
392 \
393 count = min(count, sizeof(buf) - 1); \
394 if (copy_from_user(buf, s, count)) \
395 return -EFAULT; \
396 buf[count] = '\0'; \
397 return g(buf, base, res); \
398} \
399EXPORT_SYMBOL(f)
400
401kstrto_from_user(kstrtoull_from_user, kstrtoull, unsigned long long);
402kstrto_from_user(kstrtoll_from_user, kstrtoll, long long);
403kstrto_from_user(kstrtoul_from_user, kstrtoul, unsigned long);
404kstrto_from_user(kstrtol_from_user, kstrtol, long);
405kstrto_from_user(kstrtouint_from_user, kstrtouint, unsigned int);
406kstrto_from_user(kstrtoint_from_user, kstrtoint, int);
407kstrto_from_user(kstrtou16_from_user, kstrtou16, u16);
408kstrto_from_user(kstrtos16_from_user, kstrtos16, s16);
409kstrto_from_user(kstrtou8_from_user, kstrtou8, u8);
410kstrto_from_user(kstrtos8_from_user, kstrtos8, s8);