2 * Copyright (c) 2002, 2003 Greg Lehey
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 ``as is'' and any express
15 * or implied warranties, including, but not limited to, the implied
16 * warranties of merchantability and fitness for a particular purpose
17 * are disclaimed. In no event shall the author be liable for any
18 * direct, indirect, incidental, special, exemplary, or consequential
19 * damages (including, but not limited to, procurement of substitute
20 * goods or services; loss of use, data, or profits; or business
21 * interruption) however caused and on any theory of liability,
22 * whether in contract, strict liability, or tort (including
23 * negligence or otherwise) arising in any way out of the use of this
24 * software, even if advised of the possibility of such damage.
26 /* $Id: asf.c,v 1.4 2003/05/04 02:55:20 grog Exp grog $ */
28 #include <sys/cdefs.h>
29 __FBSDID("$FreeBSD$");
31 #include <sys/types.h>
32 #include <sys/queue.h>
51 STAILQ_ENTRY(kfile) link;
54 static STAILQ_HEAD(,kfile) kfile_head = STAILQ_HEAD_INITIALIZER(kfile_head);
57 kfile_add(const char *name, caddr_t addr)
61 if ((kfp = malloc(sizeof(*kfp))) == NULL ||
62 (kfp->name = strdup(name)) == NULL)
63 errx(2, "out of memory");
66 STAILQ_INSERT_TAIL(&kfile_head, kfp, link);
70 kfile_find(const char *name)
74 STAILQ_FOREACH(kfp, &kfile_head, link)
75 if (strcmp(kfp->name, name) == 0)
76 return (kfp); /* found */
78 return (NULL); /* not found */
86 STAILQ_FOREACH(kfp, &kfile_head, link)
88 return (0); /* at least one unseen */
90 return (1); /* all seen */
96 return (STAILQ_EMPTY(&kfile_head));
100 * Take a blank separated list of tokens and turn it into a list of
101 * individual nul-delimited strings. Build a list of pointers at
102 * token, which must have enough space for the tokens. Return the
103 * number of tokens, or -1 on error (typically a missing string
107 tokenize(char *cptr, char *token[], int maxtoken)
109 char delim; /* delimiter to search for */
110 int tokennr; /* index of this token */
112 for (tokennr = 0; tokennr < maxtoken;) {
113 while (isspace(*cptr))
114 cptr++; /* skip initial white space */
115 if ((*cptr == '\0') || (*cptr == '\n')
116 || (*cptr == '#')) /* end of line */
117 return tokennr; /* return number of tokens found */
119 token[tokennr] = cptr; /* point to it */
120 tokennr++; /* one more */
121 if (tokennr == maxtoken) /* run off the end? */
123 if ((delim == '\'') || (delim == '"')) { /* delimitered */
127 && (cptr[-1] != '\\')) { /* found the partner */
128 cptr++; /* move on past */
129 if (!isspace(*cptr)) /* no space after closing quote */
131 *cptr++ = '\0'; /* delimit */
132 } else if ((*cptr == '\0')
133 || (*cptr == '\n')) /* end of line */
136 } else { /* not quoted */
137 while ((*cptr != '\0') && (!isspace(*cptr)) && (*cptr != '\n'))
139 if (*cptr != '\0') /* not end of the line, */
140 *cptr++ = '\0'; /* delimit and move to the next */
143 return maxtoken; /* can't get here */
147 doobj(const char *path, caddr_t addr, FILE *out)
149 uintmax_t base = (uintptr_t)addr;
150 uintmax_t textaddr = 0;
151 uintmax_t dataaddr = 0;
152 uintmax_t bssaddr = 0;
155 char *octoken[MAXTOKEN];
156 char ocbuf[LINE_MAX + PATH_MAX];
159 snprintf(ocbuf, sizeof(ocbuf),
160 "/usr/bin/objdump --section-headers %s", path);
161 if ((objcopy = popen(ocbuf, "r")) == NULL)
162 err(2, "can't start %s", ocbuf);
163 while (fgets(ocbuf, sizeof(ocbuf), objcopy)) {
164 octokens = tokenize(ocbuf, octoken, MAXTOKEN);
168 if (strcmp(octoken[1], ".text") == 0)
170 else if (strcmp(octoken[1], ".data") == 0)
172 else if (strcmp(octoken[1], ".bss") == 0)
176 *up = strtoumax(octoken[3], NULL, 16) + base;
178 if (textaddr) { /* we must have a text address */
179 fprintf(out, "add-symbol-file %s 0x%jx", path, textaddr);
181 fprintf(out, " -s .data 0x%jx", dataaddr);
183 fprintf(out, " -s .bss 0x%jx", bssaddr);
189 findmodules(char *path_argv[], const char *sfx[], FILE *out)
198 /* Have to fts once per suffix to find preferred suffixes first */
200 sl = *sfx ? strlen(*sfx) : 0; /* current suffix length */
201 fts = fts_open(path_argv, FTS_PHYSICAL | FTS_NOCHDIR, NULL);
203 err(2, "can't begin traversing module path");
204 while ((ftsent = fts_read(fts)) != NULL) {
205 if (ftsent->fts_info == FTS_DNR ||
206 ftsent->fts_info == FTS_ERR ||
207 ftsent->fts_info == FTS_NS) {
208 errno = ftsent->fts_errno;
209 err(2, "error while traversing path %s", ftsent->fts_path);
211 if (ftsent->fts_info != FTS_F)
212 continue; /* not a plain file */
215 /* non-blank suffix; see if file name has it */
216 i = ftsent->fts_namelen - sl;
217 if (i <= 0 || strcmp(ftsent->fts_name + i, *sfx) != 0)
218 continue; /* no such suffix */
219 if ((p = strdup(ftsent->fts_name)) == NULL)
220 errx(2, "out of memory");
221 p[i] = '\0'; /* remove suffix in the copy */
225 kfp = kfile_find(ftsent->fts_name);
227 if (kfp && !kfp->seen) {
228 doobj(ftsent->fts_path, kfp->addr, out);
230 /* Optimization: stop fts as soon as seen all loaded modules */
231 if (kfile_allseen()) {
237 if (ftsent == NULL && errno != 0)
238 err(2, "couldn't complete traversing module path");
244 usage(const char *myname)
248 "%s [-afKksVx] [-M core] [-N system] [-o outfile] [-X suffix]\n"
249 "%*s [modules-path [outfile]]\n\n"
250 "\t-a\tappend to outfile\n"
251 "\t-f\tfind the module in any subdirectory of modules-path\n"
252 "\t-K\tuse kld(2) to get the list of modules\n"
253 "\t-k\ttake input from kldstat(8)\n"
254 "\t-M\tspecify core name for kvm(3)\n"
255 "\t-N\tspecify system name for kvm(3)\n"
256 "\t-o\tuse outfile instead of \".asf\"\n"
257 "\t-s\tdon't prepend subdir for module path\n"
258 "\t-V\tuse kvm(3) to get the list of modules\n"
259 "\t-X\tappend suffix to list of possible module file name suffixes\n"
260 "\t-x\tclear list of possible module file name suffixes\n",
261 myname, (int)strlen(myname), "");
266 #define MAXSUFFIXES 15
268 /* KLD file names end in this */
269 static int nsuffixes = 2;
270 static const char *suffixes[MAXSUFFIXES + 1] = {
277 main(int argc, char *argv[])
279 char basename[PATH_MAX];
281 char *modules_argv[MAXPATHS + 1];
284 const char *filemode = "w"; /* mode for outfile */
285 const char *modules_path = "modules"; /* path to kernel build directory */
286 const char *outfile = ".asf"; /* and where to write the output */
287 const char *corefile = NULL; /* for kvm(3) */
288 const char *sysfile = NULL; /* for kvm(3) */
292 FILE *out; /* output file */
299 const int sl = strlen(KLDSUFFIX);
301 while ((i = getopt(argc, argv, "afKkM:N:o:sVX:x")) != -1)
304 filemode = "a"; /* append to outfile */
307 dofind = 1; /* find .ko (recursively) */
310 dokld = 1; /* use kld(2) interface */
313 runprog = 1; /* get input from kldstat(8) */
316 corefile = optarg; /* core file for kvm(3) */
319 sysfile = optarg; /* system file (kernel) for kvm(3) */
322 outfile = optarg; /* output file name */
325 nosubdir = 1; /* don't descend into subdirs */
328 dokvm = 1; /* use kvm(3) interface */
331 if (nsuffixes >= MAXSUFFIXES)
332 errx(2, "only %d suffixes can be specified", MAXSUFFIXES);
333 suffixes[nsuffixes++] = optarg;
334 suffixes[nsuffixes] = NULL;
348 modules_path = argv[0];
358 if (strcmp(outfile, "-") == 0)
361 if ((out = fopen(outfile, filemode)) == NULL)
362 err(2, "can't open output file %s", outfile);
364 if (dokvm || corefile || sysfile) {
365 if (dokld || runprog)
366 warnx("using kvm(3) instead");
367 asf_kvm(sysfile, corefile);
370 warnx("using kld(2) instead");
375 /* Avoid long operations like module tree traversal when nothing to do */
377 warnx("no kernel modules loaded");
381 if ((copy = strdup(modules_path)) == NULL)
382 errx(2, "out of memory");
384 ap = modules_argv, p = copy;
385 (*ap = strsep(&p, ";")) != NULL && ap < &modules_argv[MAXPATHS];
389 errx(2, "only %d module path elements can be specified", MAXPATHS);
392 STAILQ_FOREACH(kfp, &kfile_head, link) {
393 for (ap = modules_argv; *ap; ap++) {
395 /* prepare basename of KLD, w/o suffix */
396 strlcpy(basename, kfp->name, sizeof(basename) - 1);
397 i = strlen(basename);
398 if (i > sl && strcmp(basename + i - sl, KLDSUFFIX) == 0)
401 basename[i + 1] = '\0';
403 for (sfx = suffixes;; sfx++) {
404 snprintf(path, sizeof(path),
407 nosubdir ? "" : basename,
410 if (stat(path, &st) == 0) {
411 doobj(path, kfp->addr, out);
418 warnx("module %s not found in search path", kfp->name);
423 findmodules(modules_argv, suffixes, out);