]>
git.proxmox.com Git - mirror_ubuntu-eoan-kernel.git/blob - lib/kstrtox.c
2 * Convert integer string representation to an integer.
3 * If an integer doesn't fit into specified type, -E is returned.
5 * Integer starts with optional sign.
6 * kstrtou*() functions do not accept sign "-".
8 * Radix 0 means autodetection: leading "0x" implies radix 16,
9 * leading "0" implies radix 8, otherwise radix is 10.
10 * Autodetection hints work after optional sign, but not before.
12 * If -E is returned, result is not touched.
14 #include <linux/ctype.h>
15 #include <linux/errno.h>
16 #include <linux/kernel.h>
17 #include <linux/math64.h>
18 #include <linux/export.h>
19 #include <linux/types.h>
20 #include <asm/uaccess.h>
23 const char *_parse_integer_fixup_radix(const char *s
, unsigned int *base
)
27 if (_tolower(s
[1]) == 'x' && isxdigit(s
[2]))
34 if (*base
== 16 && s
[0] == '0' && _tolower(s
[1]) == 'x')
40 * Convert non-negative integer string representation in explicitly given radix
42 * Return number of characters consumed maybe or-ed with overflow bit.
43 * If overflow occurs, result integer (incorrect) is still returned.
45 * Don't you dare use this function.
47 unsigned int _parse_integer(const char *s
, unsigned int base
, unsigned long long *p
)
49 unsigned long long res
;
57 if ('0' <= *s
&& *s
<= '9')
59 else if ('a' <= _tolower(*s
) && _tolower(*s
) <= 'f')
60 val
= _tolower(*s
) - 'a' + 10;
67 * Check for overflow only if we are within range of
68 * it in the max base we support (16)
70 if (unlikely(res
& (~0ull << 60))) {
71 if (res
> div_u64(ULLONG_MAX
- val
, base
))
72 rv
|= KSTRTOX_OVERFLOW
;
74 res
= res
* base
+ val
;
82 static int _kstrtoull(const char *s
, unsigned int base
, unsigned long long *res
)
84 unsigned long long _res
;
87 s
= _parse_integer_fixup_radix(s
, &base
);
88 rv
= _parse_integer(s
, base
, &_res
);
89 if (rv
& KSTRTOX_OVERFLOW
)
103 * kstrtoull - convert a string to an unsigned long long
104 * @s: The start of the string. The string must be null-terminated, and may also
105 * include a single newline before its terminating null. The first character
106 * may also be a plus sign, but not a minus sign.
107 * @base: The number base to use. The maximum supported base is 16. If base is
108 * given as 0, then the base of the string is automatically detected with the
109 * conventional semantics - If it begins with 0x the number will be parsed as a
110 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
111 * parsed as an octal number. Otherwise it will be parsed as a decimal.
112 * @res: Where to write the result of the conversion on success.
114 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
115 * Used as a replacement for the obsolete simple_strtoull. Return code must
118 int kstrtoull(const char *s
, unsigned int base
, unsigned long long *res
)
122 return _kstrtoull(s
, base
, res
);
124 EXPORT_SYMBOL(kstrtoull
);
127 * kstrtoll - convert a string to a long long
128 * @s: The start of the string. The string must be null-terminated, and may also
129 * include a single newline before its terminating null. The first character
130 * may also be a plus sign or a minus sign.
131 * @base: The number base to use. The maximum supported base is 16. If base is
132 * given as 0, then the base of the string is automatically detected with the
133 * conventional semantics - If it begins with 0x the number will be parsed as a
134 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
135 * parsed as an octal number. Otherwise it will be parsed as a decimal.
136 * @res: Where to write the result of the conversion on success.
138 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
139 * Used as a replacement for the obsolete simple_strtoull. Return code must
142 int kstrtoll(const char *s
, unsigned int base
, long long *res
)
144 unsigned long long tmp
;
148 rv
= _kstrtoull(s
+ 1, base
, &tmp
);
151 if ((long long)-tmp
> 0)
155 rv
= kstrtoull(s
, base
, &tmp
);
158 if ((long long)tmp
< 0)
164 EXPORT_SYMBOL(kstrtoll
);
166 /* Internal, do not use. */
167 int _kstrtoul(const char *s
, unsigned int base
, unsigned long *res
)
169 unsigned long long tmp
;
172 rv
= kstrtoull(s
, base
, &tmp
);
175 if (tmp
!= (unsigned long long)(unsigned long)tmp
)
180 EXPORT_SYMBOL(_kstrtoul
);
182 /* Internal, do not use. */
183 int _kstrtol(const char *s
, unsigned int base
, long *res
)
188 rv
= kstrtoll(s
, base
, &tmp
);
191 if (tmp
!= (long long)(long)tmp
)
196 EXPORT_SYMBOL(_kstrtol
);
199 * kstrtouint - convert a string to an unsigned int
200 * @s: The start of the string. The string must be null-terminated, and may also
201 * include a single newline before its terminating null. The first character
202 * may also be a plus sign, but not a minus sign.
203 * @base: The number base to use. The maximum supported base is 16. If base is
204 * given as 0, then the base of the string is automatically detected with the
205 * conventional semantics - If it begins with 0x the number will be parsed as a
206 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
207 * parsed as an octal number. Otherwise it will be parsed as a decimal.
208 * @res: Where to write the result of the conversion on success.
210 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
211 * Used as a replacement for the obsolete simple_strtoull. Return code must
214 int kstrtouint(const char *s
, unsigned int base
, unsigned int *res
)
216 unsigned long long tmp
;
219 rv
= kstrtoull(s
, base
, &tmp
);
222 if (tmp
!= (unsigned long long)(unsigned int)tmp
)
227 EXPORT_SYMBOL(kstrtouint
);
230 * kstrtoint - convert a string to an int
231 * @s: The start of the string. The string must be null-terminated, and may also
232 * include a single newline before its terminating null. The first character
233 * may also be a plus sign or a minus sign.
234 * @base: The number base to use. The maximum supported base is 16. If base is
235 * given as 0, then the base of the string is automatically detected with the
236 * conventional semantics - If it begins with 0x the number will be parsed as a
237 * hexadecimal (case insensitive), if it otherwise begins with 0, it will be
238 * parsed as an octal number. Otherwise it will be parsed as a decimal.
239 * @res: Where to write the result of the conversion on success.
241 * Returns 0 on success, -ERANGE on overflow and -EINVAL on parsing error.
242 * Used as a replacement for the obsolete simple_strtoull. Return code must
245 int kstrtoint(const char *s
, unsigned int base
, int *res
)
250 rv
= kstrtoll(s
, base
, &tmp
);
253 if (tmp
!= (long long)(int)tmp
)
258 EXPORT_SYMBOL(kstrtoint
);
260 int kstrtou16(const char *s
, unsigned int base
, u16
*res
)
262 unsigned long long tmp
;
265 rv
= kstrtoull(s
, base
, &tmp
);
268 if (tmp
!= (unsigned long long)(u16
)tmp
)
273 EXPORT_SYMBOL(kstrtou16
);
275 int kstrtos16(const char *s
, unsigned int base
, s16
*res
)
280 rv
= kstrtoll(s
, base
, &tmp
);
283 if (tmp
!= (long long)(s16
)tmp
)
288 EXPORT_SYMBOL(kstrtos16
);
290 int kstrtou8(const char *s
, unsigned int base
, u8
*res
)
292 unsigned long long tmp
;
295 rv
= kstrtoull(s
, base
, &tmp
);
298 if (tmp
!= (unsigned long long)(u8
)tmp
)
303 EXPORT_SYMBOL(kstrtou8
);
305 int kstrtos8(const char *s
, unsigned int base
, s8
*res
)
310 rv
= kstrtoll(s
, base
, &tmp
);
313 if (tmp
!= (long long)(s8
)tmp
)
318 EXPORT_SYMBOL(kstrtos8
);
321 * kstrtobool - convert common user inputs into boolean values
325 * This routine returns 0 iff the first character is one of 'Yy1Nn0', or
326 * [oO][NnFf] for "on" and "off". Otherwise it will return -EINVAL. Value
327 * pointed to by res is updated upon finding a match.
329 int kstrtobool(const char *s
, bool *res
)
365 EXPORT_SYMBOL(kstrtobool
);
368 * Since "base" would be a nonsense argument, this open-codes the
369 * _from_user helper instead of using the helper macro below.
371 int kstrtobool_from_user(const char __user
*s
, size_t count
, bool *res
)
373 /* Longest string needed to differentiate, newline, terminator */
376 count
= min(count
, sizeof(buf
) - 1);
377 if (copy_from_user(buf
, s
, count
))
380 return kstrtobool(buf
, res
);
382 EXPORT_SYMBOL(kstrtobool_from_user
);
384 #define kstrto_from_user(f, g, type) \
385 int f(const char __user *s, size_t count, unsigned int base, type *res) \
387 /* sign, base 2 representation, newline, terminator */ \
388 char buf[1 + sizeof(type) * 8 + 1 + 1]; \
390 count = min(count, sizeof(buf) - 1); \
391 if (copy_from_user(buf, s, count)) \
394 return g(buf, base, res); \
398 kstrto_from_user(kstrtoull_from_user
, kstrtoull
, unsigned long long);
399 kstrto_from_user(kstrtoll_from_user
, kstrtoll
, long long);
400 kstrto_from_user(kstrtoul_from_user
, kstrtoul
, unsigned long);
401 kstrto_from_user(kstrtol_from_user
, kstrtol
, long);
402 kstrto_from_user(kstrtouint_from_user
, kstrtouint
, unsigned int);
403 kstrto_from_user(kstrtoint_from_user
, kstrtoint
, int);
404 kstrto_from_user(kstrtou16_from_user
, kstrtou16
, u16
);
405 kstrto_from_user(kstrtos16_from_user
, kstrtos16
, s16
);
406 kstrto_from_user(kstrtou8_from_user
, kstrtou8
, u8
);
407 kstrto_from_user(kstrtos8_from_user
, kstrtos8
, s8
);