1 // SPDX-License-Identifier: GPL-2.0-only
4 * Helper functions generally used for parsing kernel command line
7 * Code and copyrights come from init/main.c and arch/i386/kernel/setup.c.
9 * GNU Indent formatting options for this file: -kr -i8 -npsl -pcs
12 #include <linux/export.h>
13 #include <linux/kernel.h>
14 #include <linux/string.h>
15 #include <linux/ctype.h>
18 * If a hyphen was found in get_option, this will handle the
19 * range of numbers, M-N. This will expand the range and insert
20 * the values[M, M+1, ..., N] into the ints array in get_options.
23 static int get_range(char **str, int *pint, int n)
25 int x, inc_counter, upper_range;
28 upper_range = simple_strtol((*str), NULL, 0);
29 inc_counter = upper_range - *pint;
30 for (x = *pint; n && x < upper_range; x++, n--)
36 * get_option - Parse integer from an option string
38 * @pint: (optional output) integer value parsed from @str
40 * Read an int from an option string; if available accept a subsequent
43 * When @pint is NULL the function can be used as a validator of
44 * the current option in the string.
47 * 0 - no int in string
48 * 1 - int found, no subsequent comma
49 * 2 - int found including a subsequent comma
50 * 3 - hyphen found to denote a range
52 * Leading hyphen without integer is no integer case, but we consume it
53 * for the sake of simplification.
56 int get_option(char **str, int *pint)
64 value = -simple_strtoull(++cur, str, 0);
66 value = simple_strtoull(cur, str, 0);
80 EXPORT_SYMBOL(get_option);
83 * get_options - Parse a string into a list of integers
84 * @str: String to be parsed
85 * @nints: size of integer array
86 * @ints: integer array
88 * This function parses a string containing a comma-separated
89 * list of integers, a hyphen-separated range of _positive_ integers,
90 * or a combination of both. The parse halts when the array is
91 * full, or when no more numbers can be retrieved from the
94 * Return value is the character in the string which caused
95 * the parse to end (typically a null terminator, if @str is
96 * completely parseable).
99 char *get_options(const char *str, int nints, int *ints)
104 res = get_option((char **)&str, ints + i);
109 range_nums = get_range((char **)&str, ints + i, nints - i);
113 * Decrement the result by one to leave out the
114 * last number in the range. The next iteration
115 * will handle the upper number in the range
117 i += (range_nums - 1);
126 EXPORT_SYMBOL(get_options);
129 * memparse - parse a string with mem suffixes into a number
130 * @ptr: Where parse begins
131 * @retptr: (output) Optional pointer to next char after parse completes
133 * Parses a string into a number. The number stored at @ptr is
134 * potentially suffixed with K, M, G, T, P, E.
137 unsigned long long memparse(const char *ptr, char **retptr)
139 char *endptr; /* local pointer to end of parsed string */
141 unsigned long long ret = simple_strtoull(ptr, &endptr, 0);
178 EXPORT_SYMBOL(memparse);
181 * parse_option_str - Parse a string and check an option is set or not
182 * @str: String to be parsed
183 * @option: option name
185 * This function parses a string containing a comma-separated list of
186 * strings like a=b,c.
188 * Return true if there's such option in the string, or return false.
190 bool parse_option_str(const char *str, const char *option)
193 if (!strncmp(str, option, strlen(option))) {
194 str += strlen(option);
195 if (!*str || *str == ',')
199 while (*str && *str != ',')
210 * Parse a string to get a param value pair.
211 * You can use " around spaces, but can't escape ".
212 * Hyphens and underscores equivalent in parameter names.
214 char *next_arg(char *args, char **param, char **val)
216 unsigned int i, equals = 0;
217 int in_quote = 0, quoted = 0;
226 for (i = 0; args[i]; i++) {
227 if (isspace(args[i]) && !in_quote)
234 in_quote = !in_quote;
242 *val = args + equals + 1;
244 /* Don't include quotes in value. */
247 if (args[i-1] == '"')
251 if (quoted && args[i-1] == '"')
260 /* Chew up trailing spaces. */
261 return skip_spaces(next);