2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2000,2001 Peter Wemm <peter@FreeBSD.org>
7 * Redistribution and use in source and binary forms, with or without
8 * modification, are permitted provided that the following conditions
10 * 1. Redistributions of source code must retain the above copyright
11 * notice, this list of conditions and the following disclaimer.
12 * 2. Redistributions in binary form must reproduce the above copyright
13 * notice, this list of conditions and the following disclaimer in the
14 * documentation and/or other materials provided with the distribution.
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
17 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
20 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
32 #include <sys/param.h>
34 #include <sys/kernel.h>
35 #include <sys/malloc.h>
36 #include <sys/mutex.h>
37 #include <sys/sysctl.h>
38 #include <sys/systm.h>
41 #define FBACK_MDENV 0 /* MD env (e.g. loader.conf) */
42 #define FBACK_STENV 1 /* Static env */
43 #define FBACK_STATIC 2 /* static_hints */
46 * We'll use hintenv_merged to indicate that the dynamic environment has been
47 * properly prepared for hint usage. This implies that the dynamic environment
48 * has already been setup (dynamic_kenv) and that we have added any supplied
49 * static_hints to the dynamic environment.
51 static int hintenv_merged;
54 * Access functions for device resources.
58 static_hints_to_env(void *data __unused)
65 while (cp && *cp != '\0') {
73 line = malloc(i + 1, M_TEMP, M_WAITOK);
75 line[eqidx] = line[i] = '\0';
77 * Before adding a hint to the dynamic environment, check if
78 * another value for said hint has already been added. This is
79 * needed because static environment overrides static hints and
80 * dynamic environment overrides all.
82 if (testenv(line) == 0)
83 kern_setenv(line, line + eqidx + 1);
90 /* Any time after dynamic env is setup */
91 SYSINIT(hintenv, SI_SUB_KMEM + 1, SI_ORDER_SECOND, static_hints_to_env, NULL);
94 * Checks the environment to see if we even have any hints. If it has no hints,
95 * then res_find can take the hint that there's no point in searching it and
96 * either move on to the next environment or fail early.
99 _res_checkenv(char *envp)
105 if (strncmp(cp, "hint.", 5) == 0)
117 * Evil wildcarding resource string lookup.
118 * This walks the supplied env string table and returns a match.
119 * The start point can be remembered for incremental searches.
122 res_find(char **hintp_cookie, int *line, int *startln,
123 const char *name, int *unit, const char *resname, const char *value,
124 const char **ret_name, int *ret_namelen, int *ret_unit,
125 const char **ret_resname, int *ret_resnamelen, const char **ret_value)
127 int dyn_used = 0, fbacklvl = FBACK_MDENV, hit, i = 0, n = 0;
137 * We are expecting that the caller will pass us a hintp_cookie that
138 * they are tracking. Upon entry, if *hintp_cookie is *not* set, this
139 * indicates to us that we should be figuring out based on the current
140 * environment where to search. This keeps us sane throughout the
141 * entirety of a single search.
143 if (*hintp_cookie == NULL) {
145 if (hintenv_merged) {
147 * static_hints, if it was previously used, has
148 * already been folded in to the environment
151 mtx_lock(&kenv_lock);
153 for (i = 0; cp != NULL; cp = kenvp[++i]) {
154 if (!strncmp(cp, "hint.", 5)) {
159 mtx_unlock(&kenv_lock);
163 * We'll have a chance to keep coming back here until
164 * we've actually exhausted all of our possibilities.
165 * We might have chosen the MD/Static env because it
166 * had some kind of hints, but perhaps it didn't have
167 * the hint we are looking for. We don't provide any
168 * fallback when searching the dynamic environment.
171 if (dyn_used || fbacklvl >= FBACK_STATIC)
174 if (fbacklvl <= FBACK_MDENV &&
175 _res_checkenv(md_envp)) {
181 if (fbacklvl <= FBACK_STENV &&
182 _res_checkenv(kern_envp)) {
188 /* We'll fallback to static_hints if needed/can */
189 if (fbacklvl <= FBACK_STATIC &&
190 _res_checkenv(static_hints))
191 hintp = static_hints;
198 *hintp_cookie = hintp;
200 hintp = *hintp_cookie;
201 if (hintenv_merged && hintp == kenvp[0])
205 * If we aren't using the dynamic environment, we need
206 * to run through the proper fallback procedure again.
207 * This is so that we do continuations right if we're
208 * working with *line and *startln.
214 mtx_lock(&kenv_lock);
222 if (strncmp(cp, "hint.", 5) != 0)
225 n = sscanf(cp, "hint.%32[^.].%d.%32[^=]=%127s",
226 r_name, &r_unit, r_resname, r_value);
227 /* We'll circumvent all of the checks if we already know */
230 printf("CONFIG: invalid hint '%s'\n", cp);
235 if (hit && startln && *startln >= 0 && *line < *startln)
237 if (hit && name && strcmp(name, r_name) != 0)
239 if (hit && unit && *unit != r_unit)
241 if (hit && resname && strcmp(resname, r_resname) != 0)
243 if (hit && value && strcmp(value, r_value) != 0)
263 mtx_unlock(&kenv_lock);
268 /* This is a bit of a hack, but at least is reentrant */
269 /* Note that it returns some !unterminated! strings. */
270 s = strchr(s, '.') + 1; /* start of device */
273 s = strchr(s, '.') + 1; /* start of unit */
274 if (ret_namelen && ret_name)
275 *ret_namelen = s - *ret_name - 1; /* device length */
278 s = strchr(s, '.') + 1; /* start of resname */
281 s = strchr(s, '=') + 1; /* start of value */
282 if (ret_resnamelen && ret_resname)
283 *ret_resnamelen = s - *ret_resname - 1; /* value len */
286 if (startln) /* line number for anchor */
287 *startln = *line + 1;
292 * Search all the data sources for matches to our query. We look for
293 * dynamic hints first as overrides for static or fallback hints.
296 resource_find(int *line, int *startln,
297 const char *name, int *unit, const char *resname, const char *value,
298 const char **ret_name, int *ret_namelen, int *ret_unit,
299 const char **ret_resname, int *ret_resnamelen, const char **ret_value)
308 /* Search for exact unit matches first */
309 i = res_find(&hintp, line, startln, name, unit, resname, value,
310 ret_name, ret_namelen, ret_unit, ret_resname, ret_resnamelen,
316 /* If we are still here, search for wildcard matches */
318 i = res_find(&hintp, line, startln, name, &un, resname, value,
319 ret_name, ret_namelen, ret_unit, ret_resname, ret_resnamelen,
327 resource_int_value(const char *name, int unit, const char *resname, int *result)
336 error = resource_find(&line, NULL, name, &unit, resname, NULL,
337 NULL, NULL, NULL, NULL, NULL, &str);
342 val = strtoul(str, &op, 0);
350 resource_long_value(const char *name, int unit, const char *resname,
360 error = resource_find(&line, NULL, name, &unit, resname, NULL,
361 NULL, NULL, NULL, NULL, NULL, &str);
366 val = strtoul(str, &op, 0);
374 resource_string_value(const char *name, int unit, const char *resname,
382 error = resource_find(&line, NULL, name, &unit, resname, NULL,
383 NULL, NULL, NULL, NULL, NULL, &str);
391 * This is a bit nasty, but allows us to not modify the env strings.
394 resource_string_copy(const char *s, int len)
396 static char stringbuf[256];
397 static int offset = 0;
404 if ((offset + len + 1) > 255)
406 bcopy(s, &stringbuf[offset], len);
407 stringbuf[offset + len] = '\0';
408 ret = &stringbuf[offset];
414 * err = resource_find_match(&anchor, &name, &unit, resname, value)
415 * Iteratively fetch a list of devices wired "at" something
416 * res and value are restrictions. eg: "at", "scbus0".
417 * For practical purposes, res = required, value = optional.
418 * *name and *unit are set.
419 * set *anchor to zero before starting.
422 resource_find_match(int *anchor, const char **name, int *unit,
423 const char *resname, const char *value)
425 const char *found_name;
432 ret = resource_find(anchor, &newln, NULL, NULL, resname, value,
433 &found_name, &found_namelen, &found_unit, NULL, NULL, NULL);
435 *name = resource_string_copy(found_name, found_namelen);
444 * err = resource_find_dev(&anchor, name, &unit, res, value);
445 * Iterate through a list of devices, returning their unit numbers.
446 * res and value are optional restrictions. eg: "at", "scbus0".
447 * *unit is set to the value.
448 * set *anchor to zero before starting.
451 resource_find_dev(int *anchor, const char *name, int *unit,
452 const char *resname, const char *value)
459 ret = resource_find(anchor, &newln, name, NULL, resname, value,
460 NULL, NULL, &found_unit, NULL, NULL, NULL);
469 * Check to see if a device is disabled via a disabled hint.
472 resource_disabled(const char *name, int unit)
476 error = resource_int_value(name, unit, "disabled", &value);
483 * Clear a value associated with a device by removing it from
484 * the kernel environment. This only removes a hint for an
488 resource_unset_value(const char *name, int unit, const char *resname)
491 const char *retname, *retvalue;
496 error = resource_find(&line, NULL, name, &unit, resname, NULL,
497 &retname, NULL, NULL, NULL, NULL, &retvalue);
501 retname -= strlen("hint.");
502 len = retvalue - retname - 1;
503 if (len > sizeof(varname) - 1)
504 return (ENAMETOOLONG);
505 memcpy(varname, retname, len);
507 return (kern_unsetenv(varname));