2 * Copyright (c) 1998 Michael Smith <msmith@freebsd.org>
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
17 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
31 * file/module function dispatcher, support, etc.
36 #include <sys/param.h>
37 #include <sys/linker.h>
38 #include <sys/module.h>
39 #include <sys/queue.h>
40 #include <sys/stdint.h>
42 #include "bootstrap.h"
44 #define MDIR_REMOVED 0x0001
45 #define MDIR_NOHINTS 0x0002
48 char *d_path; /* path of modules directory */
49 u_char *d_hints; /* content of linker.hints file */
50 int d_hintsz; /* size of hints data */
52 STAILQ_ENTRY(moduledir) d_link;
55 static int file_load(char *, vm_offset_t, struct preloaded_file **);
56 static int file_load_dependencies(struct preloaded_file *);
57 static char * file_search(const char *, char **);
58 static struct kernel_module *file_findmodule(struct preloaded_file *, char *,
60 static int file_havepath(const char *);
61 static char *mod_searchmodule(char *, struct mod_depend *);
62 static void file_insert_tail(struct preloaded_file *);
63 static void file_remove(struct preloaded_file *);
64 struct file_metadata *metadata_next(struct file_metadata *, int);
65 static void moduledir_readhints(struct moduledir *);
66 static void moduledir_rebuild(void);
68 /* load address should be tweaked by first module loaded (kernel) */
69 static vm_offset_t loadaddr = 0;
71 #if defined(LOADER_FDT_SUPPORT)
72 static const char *default_searchpath =
73 "/boot/kernel;/boot/modules;/boot/dtb";
75 static const char *default_searchpath = "/boot/kernel;/boot/modules";
78 static STAILQ_HEAD(, moduledir) moduledir_list =
79 STAILQ_HEAD_INITIALIZER(moduledir_list);
81 struct preloaded_file *preloaded_files = NULL;
83 static char *kld_ext_list[] = {
92 * load an object, either a disk file or code module.
94 * To load a file, the syntax is:
96 * load -t <type> <path>
98 * code modules are loaded as:
100 * load <path> <options>
103 COMMAND_SET(load, "load", "load a kernel or module", command_load);
106 command_load(int argc, char *argv[])
108 struct preloaded_file *fp;
112 int dflag, dofile, dokld, ch, error;
114 dflag = dokld = dofile = 0;
119 command_errmsg = "no filename specified";
122 prefix = skip = NULL;
123 while ((ch = getopt(argc, argv, "dkp:s:t:")) != -1) {
143 /* getopt has already reported an error */
147 argv += (optind - 1);
148 argc -= (optind - 1);
151 * Request to load a raw file?
154 if ((argc != 2) || (typestr == NULL) || (*typestr == 0)) {
155 command_errmsg = "invalid load type";
159 #ifdef LOADER_VERIEXEC
160 if (strncmp(typestr, "manifest", 8) == 0) {
163 return (load_manifest(argv[1], prefix, skip, NULL));
165 #ifdef LOADER_VERIEXEC_PASS_MANIFEST
166 if (strncmp(typestr, "pass_manifest", 13) == 0) {
169 return (pass_manifest(argv[1], prefix));
174 fp = file_findfile(argv[1], typestr);
176 snprintf(command_errbuf, sizeof(command_errbuf),
177 "warning: file '%s' already loaded", argv[1]);
181 if (file_loadraw(argv[1], typestr, 1) != NULL)
184 /* Failing to load mfs_root is never going to end well! */
185 if (strcmp("mfs_root", typestr) == 0)
191 * Do we have explicit KLD load ?
193 if (dokld || file_havepath(argv[1])) {
194 error = mod_loadkld(argv[1], argc - 2, argv + 2);
195 if (error == EEXIST) {
196 snprintf(command_errbuf, sizeof(command_errbuf),
197 "warning: KLD '%s' already loaded", argv[1]);
201 return (error == 0 ? CMD_OK : CMD_CRIT);
204 * Looks like a request for a module.
206 error = mod_load(argv[1], NULL, argc - 2, argv + 2);
207 if (error == EEXIST) {
208 snprintf(command_errbuf, sizeof(command_errbuf),
209 "warning: module '%s' already loaded", argv[1]);
213 return (error == 0 ? CMD_OK : CMD_CRIT);
216 #ifdef LOADER_GELI_SUPPORT
217 COMMAND_SET(load_geli, "load_geli", "load a geli key", command_load_geli);
220 command_load_geli(int argc, char *argv[])
227 command_errmsg = "usage is [-n key#] <prov> <file>";
234 while ((ch = getopt(argc, argv, "n:")) != -1) {
237 num = strtol(optarg, &cp, 0);
239 snprintf(command_errbuf, sizeof(command_errbuf),
240 "bad key index '%s'", optarg);
246 /* getopt has already reported an error */
250 argv += (optind - 1);
251 argc -= (optind - 1);
252 sprintf(typestr, "%s:geli_keyfile%d", argv[1], num);
253 return (file_loadraw(argv[2], typestr, 1) ? CMD_OK : CMD_ERROR);
260 struct preloaded_file *fp;
262 while (preloaded_files != NULL) {
263 fp = preloaded_files;
264 preloaded_files = preloaded_files->f_next;
268 unsetenv("kernelname");
271 COMMAND_SET(unload, "unload", "unload all modules", command_unload);
274 command_unload(int argc, char *argv[])
280 COMMAND_SET(lsmod, "lsmod", "list loaded modules", command_lsmod);
283 command_lsmod(int argc, char *argv[])
285 struct preloaded_file *fp;
286 struct kernel_module *mp;
287 struct file_metadata *md;
289 int ch, verbose, ret = 0;
294 while ((ch = getopt(argc, argv, "v")) != -1) {
301 /* getopt has already reported an error */
307 for (fp = preloaded_files; fp; fp = fp->f_next) {
308 snprintf(lbuf, sizeof(lbuf), " %p: ", (void *) fp->f_addr);
310 pager_output(fp->f_name);
311 snprintf(lbuf, sizeof(lbuf), " (%s, 0x%lx)\n", fp->f_type,
313 if (pager_output(lbuf))
315 if (fp->f_args != NULL) {
316 pager_output(" args: ");
317 pager_output(fp->f_args);
318 if (pager_output("\n"))
322 pager_output(" modules: ");
323 for (mp = fp->f_modules; mp; mp = mp->m_next) {
324 snprintf(lbuf, sizeof(lbuf), "%s.%d ", mp->m_name,
328 if (pager_output("\n"))
332 /* XXX could add some formatting smarts here to display some better */
333 for (md = fp->f_metadata; md != NULL; md = md->md_next) {
334 snprintf(lbuf, sizeof(lbuf), " 0x%04x, 0x%lx\n",
335 md->md_type, (long) md->md_size);
336 if (pager_output(lbuf))
348 * File level interface, functions file_*
351 file_load(char *filename, vm_offset_t dest, struct preloaded_file **result)
353 static int last_file_format = 0;
354 struct preloaded_file *fp;
358 if (archsw.arch_loadaddr != NULL)
359 dest = archsw.arch_loadaddr(LOAD_RAW, filename, dest);
362 for (i = last_file_format, fp = NULL;
363 file_formats[i] && fp == NULL; i++) {
364 error = (file_formats[i]->l_load)(filename, dest, &fp);
366 fp->f_loader = last_file_format = i; /* remember the loader */
369 } else if (last_file_format == i && i != 0) {
370 /* Restart from the beginning */
372 last_file_format = 0;
377 continue; /* Unknown to this handler? */
379 snprintf(command_errbuf, sizeof(command_errbuf),
380 "can't load file '%s': %s", filename, strerror(error));
388 file_load_dependencies(struct preloaded_file *base_file)
390 struct file_metadata *md;
391 struct preloaded_file *fp;
392 struct mod_depend *verinfo;
393 struct kernel_module *mp;
397 md = file_findmetadata(base_file, MODINFOMD_DEPLIST);
402 verinfo = (struct mod_depend*)md->md_data;
403 dmodname = (char *)(verinfo + 1);
404 if (file_findmodule(NULL, dmodname, verinfo) == NULL) {
405 printf("loading required module '%s'\n", dmodname);
406 error = mod_load(dmodname, verinfo, 0, NULL);
410 * If module loaded via kld name which isn't listed
411 * in the linker.hints file, we should check if it have
414 mp = file_findmodule(NULL, dmodname, verinfo);
416 snprintf(command_errbuf, sizeof(command_errbuf),
417 "module '%s' exists but with wrong version", dmodname);
422 md = metadata_next(md, MODINFOMD_DEPLIST);
426 /* Load failed; discard everything */
427 while (base_file != NULL) {
429 base_file = base_file->f_next;
436 * We've been asked to load (fname) as (type), so just suck it in,
437 * no arguments or anything.
439 struct preloaded_file *
440 file_loadraw(const char *fname, char *type, int insert)
442 struct preloaded_file *fp;
447 /* We can't load first */
448 if ((file_findfile(NULL, NULL)) == NULL) {
449 command_errmsg = "can't load file before kernel";
453 /* locate the file on the load path */
454 name = file_search(fname, NULL);
456 snprintf(command_errbuf, sizeof(command_errbuf),
457 "can't find '%s'", fname);
461 if ((fd = open(name, O_RDONLY)) < 0) {
462 snprintf(command_errbuf, sizeof(command_errbuf),
463 "can't open '%s': %s", name, strerror(errno));
468 #ifdef LOADER_VERIEXEC
469 if (verify_file(fd, name, 0, VE_MUST) < 0) {
470 sprintf(command_errbuf, "can't verify '%s'", name);
477 if (archsw.arch_loadaddr != NULL)
478 loadaddr = archsw.arch_loadaddr(LOAD_RAW, name, loadaddr);
484 /* read in 4k chunks; size is not really important */
485 got = archsw.arch_readin(fd, laddr, 4096);
486 if (got == 0) /* end of file */
488 if (got < 0) { /* error */
489 snprintf(command_errbuf, sizeof(command_errbuf),
490 "error reading '%s': %s", name, strerror(errno));
498 printf("size=%#jx\n", (uintmax_t)(laddr - loadaddr));
500 /* Looks OK so far; create & populate control structure */
502 fp->f_name = strdup(name);
503 fp->f_type = strdup(type);
505 fp->f_metadata = NULL;
507 fp->f_addr = loadaddr;
508 fp->f_size = laddr - loadaddr;
510 /* recognise space consumption */
513 /* Add to the list of loaded files */
515 file_insert_tail(fp);
521 * Load the module (name), pass it (argc),(argv), add container file
522 * to the list of loaded files.
523 * If module is already loaded just assign new argc/argv.
526 mod_load(char *modname, struct mod_depend *verinfo, int argc, char *argv[])
528 struct kernel_module *mp;
532 if (file_havepath(modname)) {
533 printf("Warning: mod_load() called instead of mod_loadkld() for module '%s'\n", modname);
534 return (mod_loadkld(modname, argc, argv));
536 /* see if module is already loaded */
537 mp = file_findmodule(NULL, modname, verinfo);
541 mp->m_args = unargv(argc, argv);
543 snprintf(command_errbuf, sizeof(command_errbuf),
544 "warning: module '%s' already loaded", mp->m_name);
547 /* locate file with the module on the search path */
548 filename = mod_searchmodule(modname, verinfo);
549 if (filename == NULL) {
550 snprintf(command_errbuf, sizeof(command_errbuf),
551 "can't find '%s'", modname);
554 err = mod_loadkld(filename, argc, argv);
559 * Load specified KLD. If path is omitted, then try to locate it via
563 mod_loadkld(const char *kldname, int argc, char *argv[])
565 struct preloaded_file *fp;
568 vm_offset_t loadaddr_saved;
571 * Get fully qualified KLD name
573 filename = file_search(kldname, kld_ext_list);
574 if (filename == NULL) {
575 snprintf(command_errbuf, sizeof(command_errbuf),
576 "can't find '%s'", kldname);
580 * Check if KLD already loaded
582 fp = file_findfile(filename, NULL);
584 snprintf(command_errbuf, sizeof(command_errbuf),
585 "warning: KLD '%s' already loaded", filename);
591 err = file_load(filename, loadaddr, &fp);
594 fp->f_args = unargv(argc, argv);
595 loadaddr_saved = loadaddr;
596 loadaddr = fp->f_addr + fp->f_size;
597 file_insert_tail(fp); /* Add to the list of loaded files */
598 if (file_load_dependencies(fp) != 0) {
601 loadaddr = loadaddr_saved;
607 snprintf(command_errbuf, sizeof(command_errbuf),
608 "don't know how to load module '%s'", filename);
617 * Find a file matching (name) and (type).
618 * NULL may be passed as a wildcard to either.
620 struct preloaded_file *
621 file_findfile(const char *name, const char *type)
623 struct preloaded_file *fp;
625 for (fp = preloaded_files; fp != NULL; fp = fp->f_next) {
626 if (((name == NULL) || !strcmp(name, fp->f_name)) &&
627 ((type == NULL) || !strcmp(type, fp->f_type)))
634 * Find a module matching (name) inside of given file.
635 * NULL may be passed as a wildcard.
637 struct kernel_module *
638 file_findmodule(struct preloaded_file *fp, char *modname,
639 struct mod_depend *verinfo)
641 struct kernel_module *mp, *best;
645 for (fp = preloaded_files; fp; fp = fp->f_next) {
646 mp = file_findmodule(fp, modname, verinfo);
654 for (mp = fp->f_modules; mp; mp = mp->m_next) {
655 if (strcmp(modname, mp->m_name) == 0) {
658 mver = mp->m_version;
659 if (mver == verinfo->md_ver_preferred)
661 if (mver >= verinfo->md_ver_minimum &&
662 mver <= verinfo->md_ver_maximum &&
672 * Make a copy of (size) bytes of data from (p), and associate them as
673 * metadata of (type) to the module (mp).
676 file_addmetadata(struct preloaded_file *fp, int type, size_t size, void *p)
678 struct file_metadata *md;
680 md = malloc(sizeof(struct file_metadata) - sizeof(md->md_data) + size);
684 bcopy(p, md->md_data, size);
685 md->md_next = fp->f_metadata;
691 * Find a metadata object of (type) associated with the file (fp)
693 struct file_metadata *
694 file_findmetadata(struct preloaded_file *fp, int type)
696 struct file_metadata *md;
698 for (md = fp->f_metadata; md != NULL; md = md->md_next)
699 if (md->md_type == type)
705 * Remove all metadata from the file.
708 file_removemetadata(struct preloaded_file *fp)
710 struct file_metadata *md, *next;
712 for (md = fp->f_metadata; md != NULL; md = next)
717 fp->f_metadata = NULL;
720 struct file_metadata *
721 metadata_next(struct file_metadata *md, int type)
726 while((md = md->md_next) != NULL)
727 if (md->md_type == type)
732 static char *emptyextlist[] = { "", NULL };
735 * Check if the given file is in place and return full path to it.
738 file_lookup(const char *path, const char *name, int namelen, char **extlist)
741 char *result, *cp, **cpp;
742 int pathlen, extlen, len;
744 pathlen = strlen(path);
747 extlist = emptyextlist;
748 for (cpp = extlist; *cpp; cpp++) {
753 result = malloc(pathlen + namelen + extlen + 2);
756 bcopy(path, result, pathlen);
757 if (pathlen > 0 && result[pathlen - 1] != '/')
758 result[pathlen++] = '/';
759 cp = result + pathlen;
760 bcopy(name, cp, namelen);
762 for (cpp = extlist; *cpp; cpp++) {
764 if (stat(result, &st) == 0 && S_ISREG(st.st_mode))
772 * Check if file name have any qualifiers
775 file_havepath(const char *name)
779 archsw.arch_getdev(NULL, name, &cp);
780 return (cp != name || strchr(name, '/') != NULL);
784 * Attempt to find the file (name) on the module searchpath.
785 * If (name) is qualified in any way, we simply check it and
786 * return it or NULL. If it is not qualified, then we attempt
787 * to construct a path using entries in the environment variable
790 * The path we return a pointer to need never be freed, as we manage
794 file_search(const char *name, char **extlist)
796 struct moduledir *mdp;
801 /* Don't look for nothing */
806 return(strdup(name));
808 if (file_havepath(name)) {
809 /* Qualified, so just see if it exists */
810 if (stat(name, &sb) == 0)
811 return(strdup(name));
816 namelen = strlen(name);
817 STAILQ_FOREACH(mdp, &moduledir_list, d_link) {
818 result = file_lookup(mdp->d_path, name, namelen, extlist);
825 #define INT_ALIGN(base, ptr) ptr = \
826 (base) + roundup2((ptr) - (base), sizeof(int))
829 mod_search_hints(struct moduledir *mdp, const char *modname,
830 struct mod_depend *verinfo)
832 u_char *cp, *recptr, *bufend, *best;
834 int *intp, bestver, blen, clen, found, ival, modnamelen, reclen;
836 moduledir_readhints(mdp);
837 modnamelen = strlen(modname);
841 if (mdp->d_hints == NULL)
843 recptr = mdp->d_hints;
844 bufend = recptr + mdp->d_hintsz;
847 while (recptr < bufend && !found) {
855 if (clen != modnamelen || bcmp(cp, modname, clen) != 0)
858 INT_ALIGN(mdp->d_hints, cp);
862 if (verinfo == NULL || ival == verinfo->md_ver_preferred) {
866 if (ival >= verinfo->md_ver_minimum &&
867 ival <= verinfo->md_ver_maximum &&
877 recptr += reclen + sizeof(int);
880 * Finally check if KLD is in the place
883 result = file_lookup(mdp->d_path, (const char *)cp, clen, NULL);
885 result = file_lookup(mdp->d_path, (const char *)best, blen, NULL);
888 * If nothing found or hints is absent - fallback to the old way
889 * by using "kldname[.ko]" as module name.
891 if (!found && !bestver && result == NULL)
892 result = file_lookup(mdp->d_path, modname, modnamelen, kld_ext_list);
897 * Attempt to locate the file containing the module (name)
900 mod_searchmodule(char *name, struct mod_depend *verinfo)
902 struct moduledir *mdp;
907 * Now we ready to lookup module in the given directories
910 STAILQ_FOREACH(mdp, &moduledir_list, d_link) {
911 result = mod_search_hints(mdp, name, verinfo);
920 file_addmodule(struct preloaded_file *fp, char *modname, int version,
921 struct kernel_module **newmp)
923 struct kernel_module *mp;
924 struct mod_depend mdepend;
926 bzero(&mdepend, sizeof(mdepend));
927 mdepend.md_ver_preferred = version;
928 mp = file_findmodule(fp, modname, &mdepend);
931 mp = calloc(1, sizeof(struct kernel_module));
934 mp->m_name = strdup(modname);
935 if (mp->m_name == NULL) {
939 mp->m_version = version;
941 mp->m_next = fp->f_modules;
952 file_discard(struct preloaded_file *fp)
954 struct file_metadata *md, *md1;
955 struct kernel_module *mp, *mp1;
978 * Allocate a new file; must be used instead of malloc()
979 * to ensure safe initialisation.
981 struct preloaded_file *
985 return (calloc(1, sizeof(struct preloaded_file)));
989 * Add a module to the chain
992 file_insert_tail(struct preloaded_file *fp)
994 struct preloaded_file *cm;
996 /* Append to list of loaded file */
998 if (preloaded_files == NULL) {
999 preloaded_files = fp;
1001 for (cm = preloaded_files; cm->f_next != NULL; cm = cm->f_next)
1008 * Remove module from the chain
1011 file_remove(struct preloaded_file *fp)
1013 struct preloaded_file *cm;
1015 if (preloaded_files == NULL)
1018 if (preloaded_files == fp) {
1019 preloaded_files = fp->f_next;
1022 for (cm = preloaded_files; cm->f_next != NULL; cm = cm->f_next) {
1023 if (cm->f_next == fp) {
1024 cm->f_next = fp->f_next;
1031 moduledir_fullpath(struct moduledir *mdp, const char *fname)
1035 cp = malloc(strlen(mdp->d_path) + strlen(fname) + 2);
1038 strcpy(cp, mdp->d_path);
1045 * Read linker.hints file into memory performing some sanity checks.
1048 moduledir_readhints(struct moduledir *mdp)
1052 int fd, size, version;
1054 if (mdp->d_hints != NULL || (mdp->d_flags & MDIR_NOHINTS))
1056 path = moduledir_fullpath(mdp, "linker.hints");
1057 if (stat(path, &st) != 0 ||
1058 st.st_size < (ssize_t)(sizeof(version) + sizeof(int)) ||
1059 st.st_size > LINKER_HINTS_MAX || (fd = open(path, O_RDONLY)) < 0) {
1061 mdp->d_flags |= MDIR_NOHINTS;
1065 size = read(fd, &version, sizeof(version));
1066 if (size != sizeof(version) || version != LINKER_HINTS_VERSION)
1068 size = st.st_size - size;
1069 mdp->d_hints = malloc(size);
1070 if (mdp->d_hints == NULL)
1072 if (read(fd, mdp->d_hints, size) != size)
1074 mdp->d_hintsz = size;
1080 mdp->d_hints = NULL;
1081 mdp->d_flags |= MDIR_NOHINTS;
1086 * Extract directories from the ';' separated list, remove duplicates.
1089 moduledir_rebuild(void)
1091 struct moduledir *mdp, *mtmp;
1092 const char *path, *cp, *ep;
1095 path = getenv("module_path");
1097 path = default_searchpath;
1099 * Rebuild list of module directories if it changed
1101 STAILQ_FOREACH(mdp, &moduledir_list, d_link)
1102 mdp->d_flags |= MDIR_REMOVED;
1104 for (ep = path; *ep != 0; ep++) {
1106 for (; *ep != 0 && *ep != ';'; ep++)
1109 * Ignore trailing slashes
1111 for (cplen = ep - cp; cplen > 1 && cp[cplen - 1] == '/'; cplen--)
1113 STAILQ_FOREACH(mdp, &moduledir_list, d_link) {
1114 if (strlen(mdp->d_path) != cplen || bcmp(cp, mdp->d_path, cplen) != 0)
1116 mdp->d_flags &= ~MDIR_REMOVED;
1120 mdp = malloc(sizeof(*mdp) + cplen + 1);
1123 mdp->d_path = (char*)(mdp + 1);
1124 bcopy(cp, mdp->d_path, cplen);
1125 mdp->d_path[cplen] = 0;
1126 mdp->d_hints = NULL;
1128 STAILQ_INSERT_TAIL(&moduledir_list, mdp, d_link);
1134 * Delete unused directories if any
1136 mdp = STAILQ_FIRST(&moduledir_list);
1138 if ((mdp->d_flags & MDIR_REMOVED) == 0) {
1139 mdp = STAILQ_NEXT(mdp, d_link);
1143 mdp = STAILQ_NEXT(mdp, d_link);
1144 STAILQ_REMOVE(&moduledir_list, mtmp, moduledir, d_link);