xref: /netbsd-src/sys/kern/kern_ksyms.c (revision a7e090f70e491979434963c9a27df4020fe0a18b)
1 /*	$NetBSD: kern_ksyms.c,v 1.58 2010/03/14 21:27:49 darran Exp $	*/
2 
3 /*-
4  * Copyright (c) 2008 The NetBSD Foundation, Inc.
5  * All rights reserved.
6  *
7  * This code is derived from software developed for The NetBSD Foundation
8  * by Andrew Doran.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23  * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29  * POSSIBILITY OF SUCH DAMAGE.
30  */
31 
32 /*
33  * Copyright (c) 2001, 2003 Anders Magnusson (ragge@ludd.luth.se).
34  * All rights reserved.
35  *
36  * Redistribution and use in source and binary forms, with or without
37  * modification, are permitted provided that the following conditions
38  * are met:
39  * 1. Redistributions of source code must retain the above copyright
40  *    notice, this list of conditions and the following disclaimer.
41  * 2. Redistributions in binary form must reproduce the above copyright
42  *    notice, this list of conditions and the following disclaimer in the
43  *    documentation and/or other materials provided with the distribution.
44  * 3. The name of the author may not be used to endorse or promote products
45  *    derived from this software without specific prior written permission
46  *
47  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
48  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
49  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
50  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
51  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
52  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
53  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
54  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
55  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
56  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
57  */
58 
59 /*
60  * Code to deal with in-kernel symbol table management + /dev/ksyms.
61  *
62  * For each loaded module the symbol table info is kept track of by a
63  * struct, placed in a circular list. The first entry is the kernel
64  * symbol table.
65  */
66 
67 /*
68  * TODO:
69  *
70  *	Add support for mmap, poll.
71  */
72 
73 #include <sys/cdefs.h>
74 __KERNEL_RCSID(0, "$NetBSD: kern_ksyms.c,v 1.58 2010/03/14 21:27:49 darran Exp $");
75 
76 #if defined(_KERNEL) && defined(_KERNEL_OPT)
77 #include "opt_ddb.h"
78 #include "opt_ddbparam.h"	/* for SYMTAB_SPACE */
79 #include "opt_dtrace.h"
80 #endif
81 
82 #define _KSYMS_PRIVATE
83 
84 #include <sys/param.h>
85 #include <sys/queue.h>
86 #include <sys/exec.h>
87 #include <sys/systm.h>
88 #include <sys/conf.h>
89 #include <sys/kmem.h>
90 #include <sys/proc.h>
91 #include <sys/atomic.h>
92 #include <sys/ksyms.h>
93 
94 #include <uvm/uvm_extern.h>
95 
96 #ifdef DDB
97 #include <ddb/db_output.h>
98 #endif
99 
100 #include "ksyms.h"
101 
102 #define KSYMS_MAX_ID	65536
103 #ifdef KDTRACE_HOOKS
104 static uint32_t ksyms_nmap[KSYMS_MAX_ID];	/* sorted symbol table map */
105 #else
106 static uint32_t *ksyms_nmap = NULL;
107 #endif
108 
109 static int ksyms_maxlen;
110 static bool ksyms_isopen;
111 static bool ksyms_initted;
112 static struct ksyms_hdr ksyms_hdr;
113 static kmutex_t ksyms_lock;
114 
115 void ksymsattach(int);
116 static void ksyms_hdr_init(void *);
117 static void ksyms_sizes_calc(void);
118 
119 #ifdef KSYMS_DEBUG
120 #define	FOLLOW_CALLS		1
121 #define	FOLLOW_MORE_CALLS	2
122 #define	FOLLOW_DEVKSYMS		4
123 static int ksyms_debug;
124 #endif
125 
126 #ifdef SYMTAB_SPACE
127 #define		SYMTAB_FILLER	"|This is the symbol table!"
128 
129 char		db_symtab[SYMTAB_SPACE] = SYMTAB_FILLER;
130 int		db_symtabsize = SYMTAB_SPACE;
131 #endif
132 
133 int ksyms_symsz;
134 int ksyms_strsz;
135 int ksyms_ctfsz;
136 TAILQ_HEAD(, ksyms_symtab) ksyms_symtabs =
137     TAILQ_HEAD_INITIALIZER(ksyms_symtabs);
138 static struct ksyms_symtab kernel_symtab;
139 
140 static int
141 ksyms_verify(void *symstart, void *strstart)
142 {
143 #if defined(DIAGNOSTIC) || defined(DEBUG)
144 	if (symstart == NULL)
145 		printf("ksyms: Symbol table not found\n");
146 	if (strstart == NULL)
147 		printf("ksyms: String table not found\n");
148 	if (symstart == NULL || strstart == NULL)
149 		printf("ksyms: Perhaps the kernel is stripped?\n");
150 #endif
151 	if (symstart == NULL || strstart == NULL)
152 		return 0;
153 	return 1;
154 }
155 
156 /*
157  * Finds a certain symbol name in a certain symbol table.
158  */
159 static Elf_Sym *
160 findsym(const char *name, struct ksyms_symtab *table, int type)
161 {
162 	Elf_Sym *sym, *maxsym;
163 	int low, mid, high, nglob;
164 	char *str, *cmp;
165 
166 	sym = table->sd_symstart;
167 	str = table->sd_strstart - table->sd_usroffset;
168 	nglob = table->sd_nglob;
169 	low = 0;
170 	high = nglob;
171 
172 	/*
173 	 * Start with a binary search of all global symbols in this table.
174 	 * Global symbols must have unique names.
175 	 */
176 	while (low < high) {
177 		mid = (low + high) >> 1;
178 		cmp = sym[mid].st_name + str;
179 		if (cmp[0] < name[0] || strcmp(cmp, name) < 0) {
180 			low = mid + 1;
181 		} else {
182 			high = mid;
183 		}
184 	}
185 	KASSERT(low == high);
186 	if (__predict_true(low < nglob &&
187 	    strcmp(sym[low].st_name + str, name) == 0)) {
188 		KASSERT(ELF_ST_BIND(sym[low].st_info) == STB_GLOBAL);
189 		return &sym[low];
190 	}
191 
192 	/*
193 	 * Perform a linear search of local symbols (rare).  Many local
194 	 * symbols with the same name can exist so are not included in
195 	 * the binary search.
196 	 */
197 	if (type != KSYMS_EXTERN) {
198 		maxsym = sym + table->sd_symsize / sizeof(Elf_Sym);
199 		for (sym += nglob; sym < maxsym; sym++) {
200 			if (strcmp(name, sym->st_name + str) == 0) {
201 				return sym;
202 			}
203 		}
204 	}
205 	return NULL;
206 }
207 
208 /*
209  * The "attach" is in reality done in ksyms_init().
210  */
211 void
212 ksymsattach(int arg)
213 {
214 
215 }
216 
217 void
218 ksyms_init(void)
219 {
220 
221 #ifdef SYMTAB_SPACE
222 	if (!ksyms_initted &&
223 	    strncmp(db_symtab, SYMTAB_FILLER, sizeof(SYMTAB_FILLER))) {
224 		ksyms_addsyms_elf(db_symtabsize, db_symtab,
225 		    db_symtab + db_symtabsize);
226 	}
227 #endif
228 
229 	mutex_init(&ksyms_lock, MUTEX_DEFAULT, IPL_NONE);
230 }
231 
232 /*
233  * Add a symbol table.
234  * This is intended for use when the symbol table and its corresponding
235  * string table are easily available.  If they are embedded in an ELF
236  * image, use addsymtab_elf() instead.
237  *
238  * name - Symbol's table name.
239  * symstart, symsize - Address and size of the symbol table.
240  * strstart, strsize - Address and size of the string table.
241  * tab - Symbol table to be updated with this information.
242  * newstart - Address to which the symbol table has to be copied during
243  *            shrinking.  If NULL, it is not moved.
244  */
245 static const char *addsymtab_strstart;
246 
247 static int
248 addsymtab_compar(const void *a, const void *b)
249 {
250 	const Elf_Sym *sa, *sb;
251 
252 	sa = a;
253 	sb = b;
254 
255 	/*
256 	 * Split the symbol table into two, with globals at the start
257 	 * and locals at the end.
258 	 */
259 	if (ELF_ST_BIND(sa->st_info) != ELF_ST_BIND(sb->st_info)) {
260 		if (ELF_ST_BIND(sa->st_info) == STB_GLOBAL) {
261 			return -1;
262 		}
263 		if (ELF_ST_BIND(sb->st_info) == STB_GLOBAL) {
264 			return 1;
265 		}
266 	}
267 
268 	/* Within each band, sort by name. */
269 	return strcmp(sa->st_name + addsymtab_strstart,
270 	    sb->st_name + addsymtab_strstart);
271 }
272 
273 static void
274 addsymtab(const char *name, void *symstart, size_t symsize,
275 	  void *strstart, size_t strsize, struct ksyms_symtab *tab,
276 	  void *newstart, void *ctfstart, size_t ctfsize, uint32_t *nmap)
277 {
278 	Elf_Sym *sym, *nsym, ts;
279 	int i, j, n, nglob;
280 	char *str;
281 	int nsyms = symsize / sizeof(Elf_Sym);
282 
283 	/* sanity check for pre-malloc map table used during startup */
284 	if ((nmap == ksyms_nmap) && (nsyms >= KSYMS_MAX_ID)) {
285 	    printf("kern_ksyms: ERROR %d > %d, increase KSYMS_MAX_ID\n",
286 		    nsyms, KSYMS_MAX_ID);
287 
288 	    /* truncate for now */
289 	    nsyms = KSYMS_MAX_ID-1;
290 	}
291 
292 	tab->sd_symstart = symstart;
293 	tab->sd_symsize = symsize;
294 	tab->sd_strstart = strstart;
295 	tab->sd_strsize = strsize;
296 	tab->sd_name = name;
297 	tab->sd_minsym = UINTPTR_MAX;
298 	tab->sd_maxsym = 0;
299 	tab->sd_usroffset = 0;
300 	tab->sd_gone = false;
301 #ifdef KDTRACE_HOOKS
302 	tab->sd_ctfstart = ctfstart;
303 	tab->sd_ctfsize = ctfsize;
304 	tab->sd_nmap = nmap;
305 	tab->sd_nmapsize = nsyms;
306 #endif
307 #ifdef KSYMS_DEBUG
308 	printf("newstart %p sym %p ksyms_symsz %d str %p strsz %d send %p\n",
309 	    newstart, symstart, symsize, strstart, strsize,
310 	    tab->sd_strstart + tab->sd_strsize);
311 #endif
312 
313 	if (nmap) {
314 		memset(nmap, 0, nsyms * sizeof(uint32_t));
315 	}
316 
317 	/* Pack symbol table by removing all file name references. */
318 	sym = tab->sd_symstart;
319 	nsym = (Elf_Sym *)newstart;
320 	str = tab->sd_strstart;
321 	nglob = 0;
322 	for (i = n = 0; i < nsyms; i++) {
323 
324 	    	/* This breaks CTF mapping, so don't do it when
325 		 * DTrace is enabled
326 		 */
327 #ifndef KDTRACE_HOOKS
328 		/*
329 		 * Remove useless symbols.
330 		 * Should actually remove all typeless symbols.
331 		 */
332 		if (sym[i].st_name == 0)
333 			continue; /* Skip nameless entries */
334 		if (sym[i].st_shndx == SHN_UNDEF)
335 			continue; /* Skip external references */
336 		if (ELF_ST_TYPE(sym[i].st_info) == STT_FILE)
337 			continue; /* Skip filenames */
338 		if (ELF_ST_TYPE(sym[i].st_info) == STT_NOTYPE &&
339 		    sym[i].st_value == 0 &&
340 		    strcmp(str + sym[i].st_name, "*ABS*") == 0)
341 			continue; /* XXX */
342 		if (ELF_ST_TYPE(sym[i].st_info) == STT_NOTYPE &&
343 		    strcmp(str + sym[i].st_name, "gcc2_compiled.") == 0)
344 			continue; /* XXX */
345 #endif
346 
347 		/* Save symbol. Set it as an absolute offset */
348 		nsym[n] = sym[i];
349 
350 #ifdef KDTRACE_HOOKS
351 		if (nmap != NULL) {
352 			/* Save the size, replace it with the symbol id so
353 			 * the mapping can be done after the cleanup and sort.
354 			 */
355 			nmap[i] = nsym[n].st_size;
356 			nsym[n].st_size = i+1;	/* zero is reserved */
357 		}
358 #endif
359 
360 		nsym[n].st_shndx = SHBSS;
361 		j = strlen(nsym[n].st_name + str) + 1;
362 		if (j > ksyms_maxlen)
363 			ksyms_maxlen = j;
364 		nglob += (ELF_ST_BIND(nsym[n].st_info) == STB_GLOBAL);
365 
366 		/* Compute min and max symbols. */
367 		if (nsym[n].st_value < tab->sd_minsym) {
368 		    	tab->sd_minsym = nsym[n].st_value;
369 		}
370 		if (nsym[n].st_value > tab->sd_maxsym) {
371 		    	tab->sd_maxsym = nsym[n].st_value;
372 		}
373 		n++;
374 	}
375 
376 	/* Fill the rest of the record, and sort the symbols. */
377 	tab->sd_symstart = nsym;
378 	tab->sd_symsize = n * sizeof(Elf_Sym);
379 	tab->sd_nglob = nglob;
380 	addsymtab_strstart = str;
381 	if (kheapsort(nsym, n, sizeof(Elf_Sym), addsymtab_compar, &ts) != 0)
382 		panic("addsymtab");
383 
384 #ifdef KDTRACE_HOOKS
385 	/*
386 	 * Build the mapping from original symbol id to new symbol table.
387 	 * Deleted symbols will have a zero map, indices will be one based
388 	 * instead of zero based.
389 	 * Resulting map is sd_nmap[original_index] = new_index + 1
390 	 */
391 	if (nmap != NULL) {
392 		int new;
393 		for (new=0; new<n; new++) {
394 			uint32_t orig = nsym[new].st_size - 1;
395 			uint32_t size = nmap[orig];
396 
397 			nmap[orig] = new + 1;
398 
399 			/* restore the size */
400 			nsym[new].st_size = size;
401 		}
402 	}
403 #endif
404 
405 	/* ksymsread() is unlocked, so membar. */
406 	membar_producer();
407 	TAILQ_INSERT_TAIL(&ksyms_symtabs, tab, sd_queue);
408 	ksyms_sizes_calc();
409 	ksyms_initted = true;
410 }
411 
412 /*
413  * Setup the kernel symbol table stuff.
414  */
415 void
416 ksyms_addsyms_elf(int symsize, void *start, void *end)
417 {
418 	int i, j;
419 	Elf_Shdr *shdr;
420 	char *symstart = NULL, *strstart = NULL;
421 	size_t strsize = 0;
422 	Elf_Ehdr *ehdr;
423 	char *ctfstart = NULL;
424 	size_t ctfsize = 0;
425 
426 	if (symsize <= 0) {
427 		printf("[ Kernel symbol table missing! ]\n");
428 		return;
429 	}
430 
431 	/* Sanity check */
432 	if (ALIGNED_POINTER(start, long) == 0) {
433 		printf("[ Kernel symbol table has bad start address %p ]\n",
434 		    start);
435 		return;
436 	}
437 
438 	ehdr = (Elf_Ehdr *)start;
439 
440 	/* check if this is a valid ELF header */
441 	/* No reason to verify arch type, the kernel is actually running! */
442 	if (memcmp(ehdr->e_ident, ELFMAG, SELFMAG) ||
443 	    ehdr->e_ident[EI_CLASS] != ELFCLASS ||
444 	    ehdr->e_version > 1) {
445 		printf("[ Kernel symbol table invalid! ]\n");
446 		return; /* nothing to do */
447 	}
448 
449 	/* Loaded header will be scratched in addsymtab */
450 	ksyms_hdr_init(start);
451 
452 	/* Find the symbol table and the corresponding string table. */
453 	shdr = (Elf_Shdr *)((uint8_t *)start + ehdr->e_shoff);
454 	for (i = 1; i < ehdr->e_shnum; i++) {
455 		if (shdr[i].sh_type != SHT_SYMTAB)
456 			continue;
457 		if (shdr[i].sh_offset == 0)
458 			continue;
459 		symstart = (uint8_t *)start + shdr[i].sh_offset;
460 		symsize = shdr[i].sh_size;
461 		j = shdr[i].sh_link;
462 		if (shdr[j].sh_offset == 0)
463 			continue; /* Can this happen? */
464 		strstart = (uint8_t *)start + shdr[j].sh_offset;
465 		strsize = shdr[j].sh_size;
466 		break;
467 	}
468 
469 #ifdef KDTRACE_HOOKS
470 	/* Find the CTF section */
471 	shdr = (Elf_Shdr *)((uint8_t *)start + ehdr->e_shoff);
472 	if (ehdr->e_shstrndx != 0) {
473 		char *shstr = (uint8_t*)start +
474 				shdr[ehdr->e_shstrndx].sh_offset;
475 		for (i = 1; i < ehdr->e_shnum; i++) {
476 			if (shdr[i].sh_type != SHT_PROGBITS)
477 				continue;
478 			if (strncmp(".SUNW_ctf", &shstr[shdr[i].sh_name] ,10) != 0)
479 				continue;
480 			ctfstart = (uint8_t *)start + shdr[i].sh_offset;
481 			ctfsize = shdr[i].sh_size;
482 			ksyms_ctfsz = ctfsize;
483 #ifdef DEBUG
484 			aprint_normal("Found CTF at %p, size 0x%zx\n",
485 			    ctfstart, ctfsize);
486 #endif
487 			break;
488 		}
489 	}
490 #endif
491 
492 	if (!ksyms_verify(symstart, strstart))
493 		return;
494 
495 	addsymtab("netbsd", symstart, symsize, strstart, strsize,
496 	    &kernel_symtab, start, ctfstart, ctfsize, ksyms_nmap);
497 
498 #ifdef DEBUG
499 	aprint_normal("Loaded initial symtab at %p, strtab at %p, # entries %ld\n",
500 	    kernel_symtab.sd_symstart, kernel_symtab.sd_strstart,
501 	    (long)kernel_symtab.sd_symsize/sizeof(Elf_Sym));
502 #endif
503 }
504 
505 /*
506  * Setup the kernel symbol table stuff.
507  * Use this when the address of the symbol and string tables are known;
508  * otherwise use ksyms_init with an ELF image.
509  * We need to pass a minimal ELF header which will later be completed by
510  * ksyms_hdr_init and handed off to userland through /dev/ksyms.  We use
511  * a void *rather than a pointer to avoid exposing the Elf_Ehdr type.
512  */
513 void
514 ksyms_addsyms_explicit(void *ehdr, void *symstart, size_t symsize,
515 		    void *strstart, size_t strsize)
516 {
517 
518 	if (!ksyms_verify(symstart, strstart))
519 		return;
520 
521 	ksyms_hdr_init(ehdr);
522 	addsymtab("netbsd", symstart, symsize, strstart, strsize,
523 	    &kernel_symtab, symstart, NULL, 0, ksyms_nmap);
524 }
525 
526 /*
527  * Get the value associated with a symbol.
528  * "mod" is the module name, or null if any module.
529  * "sym" is the symbol name.
530  * "val" is a pointer to the corresponding value, if call succeeded.
531  * Returns 0 if success or ENOENT if no such entry.
532  *
533  * Call with ksyms_lock, unless known that the symbol table can't change.
534  */
535 int
536 ksyms_getval_unlocked(const char *mod, const char *sym, unsigned long *val,
537 		      int type)
538 {
539 	struct ksyms_symtab *st;
540 	Elf_Sym *es;
541 
542 #ifdef KSYMS_DEBUG
543 	if (ksyms_debug & FOLLOW_CALLS)
544 		printf("ksyms_getval_unlocked: mod %s sym %s valp %p\n",
545 		    mod, sym, val);
546 #endif
547 
548 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
549 		if (__predict_false(st->sd_gone))
550 			continue;
551 		if (mod != NULL && strcmp(st->sd_name, mod))
552 			continue;
553 		if ((es = findsym(sym, st, type)) != NULL) {
554 			*val = es->st_value;
555 			return 0;
556 		}
557 	}
558 	return ENOENT;
559 }
560 
561 int
562 ksyms_getval(const char *mod, const char *sym, unsigned long *val, int type)
563 {
564 	int rc;
565 
566 	if (!ksyms_initted)
567 		return ENOENT;
568 
569 	mutex_enter(&ksyms_lock);
570 	rc = ksyms_getval_unlocked(mod, sym, val, type);
571 	mutex_exit(&ksyms_lock);
572 	return rc;
573 }
574 
575 struct ksyms_symtab *
576 ksyms_get_mod(const char *mod)
577 {
578 	struct ksyms_symtab *st;
579 
580 	mutex_enter(&ksyms_lock);
581 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
582 		if (__predict_false(st->sd_gone))
583 			continue;
584 		if (mod != NULL && strcmp(st->sd_name, mod))
585 			continue;
586 		break;
587 	}
588 	mutex_exit(&ksyms_lock);
589 
590 	return st;
591 }
592 
593 
594 /*
595  * ksyms_mod_foreach()
596  *
597  * Iterate over the symbol table of the specified module, calling the callback
598  * handler for each symbol. Stop iterating if the handler return is non-zero.
599  *
600  */
601 
602 int
603 ksyms_mod_foreach(const char *mod, ksyms_callback_t callback, void *opaque)
604 {
605 	struct ksyms_symtab *st;
606 	Elf_Sym *sym, *maxsym;
607 	char *str;
608 	int symindx;
609 
610 	if (!ksyms_initted)
611 		return ENOENT;
612 
613 	mutex_enter(&ksyms_lock);
614 
615 	/* find the module */
616 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
617 		if (__predict_false(st->sd_gone))
618 			continue;
619 		if (mod != NULL && strcmp(st->sd_name, mod))
620 			continue;
621 
622 		sym = st->sd_symstart;
623 		str = st->sd_strstart - st->sd_usroffset;
624 
625 		/* now iterate through the symbols */
626 		maxsym = sym + st->sd_symsize / sizeof(Elf_Sym);
627 		for (symindx=0; sym < maxsym; sym++,symindx++) {
628 			if (callback(str + sym->st_name, symindx,
629 				    (void *)sym->st_value,
630 				    sym->st_size,
631 				    sym->st_info,
632 				    opaque) != 0) {
633 				break;
634 			}
635 		}
636 	}
637 	mutex_exit(&ksyms_lock);
638 
639 	return 0;
640 }
641 
642 /*
643  * Get "mod" and "symbol" associated with an address.
644  * Returns 0 if success or ENOENT if no such entry.
645  *
646  * Call with ksyms_lock, unless known that the symbol table can't change.
647  */
648 int
649 ksyms_getname(const char **mod, const char **sym, vaddr_t v, int f)
650 {
651 	struct ksyms_symtab *st;
652 	Elf_Sym *les, *es = NULL;
653 	vaddr_t laddr = 0;
654 	const char *lmod = NULL;
655 	char *stable = NULL;
656 	int type, i, sz;
657 
658 	if (!ksyms_initted)
659 		return ENOENT;
660 
661 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
662 		if (st->sd_gone)
663 			continue;
664 		if (v < st->sd_minsym || v > st->sd_maxsym)
665 			continue;
666 		sz = st->sd_symsize/sizeof(Elf_Sym);
667 		for (i = 0; i < sz; i++) {
668 			les = st->sd_symstart + i;
669 			type = ELF_ST_TYPE(les->st_info);
670 
671 			if ((f & KSYMS_PROC) && (type != STT_FUNC))
672 				continue;
673 
674 			if (type == STT_NOTYPE)
675 				continue;
676 
677 			if (((f & KSYMS_ANY) == 0) &&
678 			    (type != STT_FUNC) && (type != STT_OBJECT))
679 				continue;
680 
681 			if ((les->st_value <= v) && (les->st_value > laddr)) {
682 				laddr = les->st_value;
683 				es = les;
684 				lmod = st->sd_name;
685 				stable = st->sd_strstart - st->sd_usroffset;
686 			}
687 		}
688 	}
689 	if (es == NULL)
690 		return ENOENT;
691 	if ((f & KSYMS_EXACT) && (v != es->st_value))
692 		return ENOENT;
693 	if (mod)
694 		*mod = lmod;
695 	if (sym)
696 		*sym = stable + es->st_name;
697 	return 0;
698 }
699 
700 /*
701  * Add a symbol table from a loadable module.
702  */
703 void
704 ksyms_modload(const char *name, void *symstart, vsize_t symsize,
705 	      char *strstart, vsize_t strsize)
706 {
707 	struct ksyms_symtab *st;
708 
709 	st = kmem_zalloc(sizeof(*st), KM_SLEEP);
710 	mutex_enter(&ksyms_lock);
711 	addsymtab(name, symstart, symsize, strstart, strsize, st, symstart,
712 		NULL, 0, NULL);
713 	mutex_exit(&ksyms_lock);
714 }
715 
716 /*
717  * Remove a symbol table from a loadable module.
718  */
719 void
720 ksyms_modunload(const char *name)
721 {
722 	struct ksyms_symtab *st;
723 
724 	mutex_enter(&ksyms_lock);
725 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
726 		if (st->sd_gone)
727 			continue;
728 		if (strcmp(name, st->sd_name) != 0)
729 			continue;
730 		st->sd_gone = true;
731 		if (!ksyms_isopen) {
732 			TAILQ_REMOVE(&ksyms_symtabs, st, sd_queue);
733 			ksyms_sizes_calc();
734 			kmem_free(st, sizeof(*st));
735 		}
736 		break;
737 	}
738 	mutex_exit(&ksyms_lock);
739 	KASSERT(st != NULL);
740 }
741 
742 #ifdef DDB
743 /*
744  * Keep sifting stuff here, to avoid export of ksyms internals.
745  *
746  * Systems is expected to be quiescent, so no locking done.
747  */
748 int
749 ksyms_sift(char *mod, char *sym, int mode)
750 {
751 	struct ksyms_symtab *st;
752 	char *sb;
753 	int i, sz;
754 
755 	if (!ksyms_initted)
756 		return ENOENT;
757 
758 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
759 		if (st->sd_gone)
760 			continue;
761 		if (mod && strcmp(mod, st->sd_name))
762 			continue;
763 		sb = st->sd_strstart - st->sd_usroffset;
764 
765 		sz = st->sd_symsize/sizeof(Elf_Sym);
766 		for (i = 0; i < sz; i++) {
767 			Elf_Sym *les = st->sd_symstart + i;
768 			char c;
769 
770 			if (strstr(sb + les->st_name, sym) == NULL)
771 				continue;
772 
773 			if (mode == 'F') {
774 				switch (ELF_ST_TYPE(les->st_info)) {
775 				case STT_OBJECT:
776 					c = '+';
777 					break;
778 				case STT_FUNC:
779 					c = '*';
780 					break;
781 				case STT_SECTION:
782 					c = '&';
783 					break;
784 				case STT_FILE:
785 					c = '/';
786 					break;
787 				default:
788 					c = ' ';
789 					break;
790 				}
791 				db_printf("%s%c ", sb + les->st_name, c);
792 			} else
793 				db_printf("%s ", sb + les->st_name);
794 		}
795 	}
796 	return ENOENT;
797 }
798 #endif /* DDB */
799 
800 /*
801  * In case we exposing the symbol table to the userland using the pseudo-
802  * device /dev/ksyms, it is easier to provide all the tables as one.
803  * However, it means we have to change all the st_name fields for the
804  * symbols so they match the ELF image that the userland will read
805  * through the device.
806  *
807  * The actual (correct) value of st_name is preserved through a global
808  * offset stored in the symbol table structure.
809  *
810  * Call with ksyms_lock held.
811  */
812 static void
813 ksyms_sizes_calc(void)
814 {
815         struct ksyms_symtab *st;
816 	int i, delta;
817 
818         ksyms_symsz = ksyms_strsz = 0;
819         TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
820 		delta = ksyms_strsz - st->sd_usroffset;
821 		if (delta != 0) {
822 			for (i = 0; i < st->sd_symsize/sizeof(Elf_Sym); i++)
823 				st->sd_symstart[i].st_name += delta;
824 			st->sd_usroffset = ksyms_strsz;
825 		}
826                 ksyms_symsz += st->sd_symsize;
827                 ksyms_strsz += st->sd_strsize;
828         }
829 }
830 
831 static void
832 ksyms_hdr_init(void *hdraddr)
833 {
834 
835 	/* Copy the loaded elf exec header */
836 	memcpy(&ksyms_hdr.kh_ehdr, hdraddr, sizeof(Elf_Ehdr));
837 
838 	/* Set correct program/section header sizes, offsets and numbers */
839 	ksyms_hdr.kh_ehdr.e_phoff = offsetof(struct ksyms_hdr, kh_phdr[0]);
840 	ksyms_hdr.kh_ehdr.e_phentsize = sizeof(Elf_Phdr);
841 	ksyms_hdr.kh_ehdr.e_phnum = NPRGHDR;
842 	ksyms_hdr.kh_ehdr.e_shoff = offsetof(struct ksyms_hdr, kh_shdr[0]);
843 	ksyms_hdr.kh_ehdr.e_shentsize = sizeof(Elf_Shdr);
844 	ksyms_hdr.kh_ehdr.e_shnum = NSECHDR;
845 	ksyms_hdr.kh_ehdr.e_shstrndx = SHSTRTAB;
846 
847 	/* Text/data - fake */
848 	ksyms_hdr.kh_phdr[0].p_type = PT_LOAD;
849 	ksyms_hdr.kh_phdr[0].p_memsz = (unsigned long)-1L;
850 	ksyms_hdr.kh_phdr[0].p_flags = PF_R | PF_X | PF_W;
851 
852 	/* First section is null */
853 
854 	/* Second section header; ".symtab" */
855 	ksyms_hdr.kh_shdr[SYMTAB].sh_name = 1; /* Section 3 offset */
856 	ksyms_hdr.kh_shdr[SYMTAB].sh_type = SHT_SYMTAB;
857 	ksyms_hdr.kh_shdr[SYMTAB].sh_offset = sizeof(struct ksyms_hdr);
858 /*	ksyms_hdr.kh_shdr[SYMTAB].sh_size = filled in at open */
859 	ksyms_hdr.kh_shdr[SYMTAB].sh_link = 2; /* Corresponding strtab */
860 	ksyms_hdr.kh_shdr[SYMTAB].sh_addralign = sizeof(long);
861 	ksyms_hdr.kh_shdr[SYMTAB].sh_entsize = sizeof(Elf_Sym);
862 
863 	/* Third section header; ".strtab" */
864 	ksyms_hdr.kh_shdr[STRTAB].sh_name = 9; /* Section 3 offset */
865 	ksyms_hdr.kh_shdr[STRTAB].sh_type = SHT_STRTAB;
866 /*	ksyms_hdr.kh_shdr[STRTAB].sh_offset = filled in at open */
867 /*	ksyms_hdr.kh_shdr[STRTAB].sh_size = filled in at open */
868 	ksyms_hdr.kh_shdr[STRTAB].sh_addralign = sizeof(char);
869 
870 	/* Fourth section, ".shstrtab" */
871 	ksyms_hdr.kh_shdr[SHSTRTAB].sh_name = 17; /* This section name offset */
872 	ksyms_hdr.kh_shdr[SHSTRTAB].sh_type = SHT_STRTAB;
873 	ksyms_hdr.kh_shdr[SHSTRTAB].sh_offset =
874 	    offsetof(struct ksyms_hdr, kh_strtab);
875 	ksyms_hdr.kh_shdr[SHSTRTAB].sh_size = SHSTRSIZ;
876 	ksyms_hdr.kh_shdr[SHSTRTAB].sh_addralign = sizeof(char);
877 
878 	/* Fifth section, ".bss". All symbols reside here. */
879 	ksyms_hdr.kh_shdr[SHBSS].sh_name = 27; /* This section name offset */
880 	ksyms_hdr.kh_shdr[SHBSS].sh_type = SHT_NOBITS;
881 	ksyms_hdr.kh_shdr[SHBSS].sh_offset = 0;
882 	ksyms_hdr.kh_shdr[SHBSS].sh_size = (unsigned long)-1L;
883 	ksyms_hdr.kh_shdr[SHBSS].sh_addralign = PAGE_SIZE;
884 	ksyms_hdr.kh_shdr[SHBSS].sh_flags = SHF_ALLOC | SHF_EXECINSTR;
885 
886 #ifdef KDTRACE_HOOKS
887 	/* Sixth section header; ".SUNW_ctf" */
888 	ksyms_hdr.kh_shdr[SHCTF].sh_name = 32; /* Section 6 offset */
889 	ksyms_hdr.kh_shdr[SHCTF].sh_type = SHT_PROGBITS;
890 /*	ksyms_hdr.kh_shdr[SHCTF].sh_offset = filled in at open */
891 /*	ksyms_hdr.kh_shdr[SHCTF].sh_size = filled in at open */
892 	ksyms_hdr.kh_shdr[SHCTF].sh_link = SYMTAB; /* Corresponding symtab */
893 	ksyms_hdr.kh_shdr[SHCTF].sh_addralign = sizeof(char);
894 #endif
895 
896 	/* Set section names */
897 	strlcpy(&ksyms_hdr.kh_strtab[1], ".symtab",
898 	    sizeof(ksyms_hdr.kh_strtab) - 1);
899 	strlcpy(&ksyms_hdr.kh_strtab[9], ".strtab",
900 	    sizeof(ksyms_hdr.kh_strtab) - 9);
901 	strlcpy(&ksyms_hdr.kh_strtab[17], ".shstrtab",
902 	    sizeof(ksyms_hdr.kh_strtab) - 17);
903 	strlcpy(&ksyms_hdr.kh_strtab[27], ".bss",
904 	    sizeof(ksyms_hdr.kh_strtab) - 27);
905 #ifdef KDTRACE_HOOKS
906 	strlcpy(&ksyms_hdr.kh_strtab[32], ".SUNW_ctf",
907 	    sizeof(ksyms_hdr.kh_strtab) - 32);
908 #endif
909 }
910 
911 static int
912 ksymsopen(dev_t dev, int oflags, int devtype, struct lwp *l)
913 {
914 
915 	if (minor(dev) != 0 || !ksyms_initted)
916 		return ENXIO;
917 
918 	/*
919 	 * Create a "snapshot" of the kernel symbol table.  Setting
920 	 * ksyms_isopen will prevent symbol tables from being freed.
921 	 */
922 	mutex_enter(&ksyms_lock);
923 	ksyms_hdr.kh_shdr[SYMTAB].sh_size = ksyms_symsz;
924 	ksyms_hdr.kh_shdr[SYMTAB].sh_info = ksyms_symsz / sizeof(Elf_Sym);
925 	ksyms_hdr.kh_shdr[STRTAB].sh_offset = ksyms_symsz +
926 	    ksyms_hdr.kh_shdr[SYMTAB].sh_offset;
927 	ksyms_hdr.kh_shdr[STRTAB].sh_size = ksyms_strsz;
928 #ifdef KDTRACE_HOOKS
929 	ksyms_hdr.kh_shdr[SHCTF].sh_offset = ksyms_strsz +
930 	    ksyms_hdr.kh_shdr[STRTAB].sh_offset;
931 	ksyms_hdr.kh_shdr[SHCTF].sh_size = ksyms_ctfsz;
932 #endif
933 	ksyms_isopen = true;
934 	mutex_exit(&ksyms_lock);
935 
936 	return 0;
937 }
938 
939 static int
940 ksymsclose(dev_t dev, int oflags, int devtype, struct lwp *l)
941 {
942 	struct ksyms_symtab *st, *next;
943 	bool resize;
944 
945 	/* Discard refernces to symbol tables. */
946 	mutex_enter(&ksyms_lock);
947 	ksyms_isopen = false;
948 	resize = false;
949 	for (st = TAILQ_FIRST(&ksyms_symtabs); st != NULL; st = next) {
950 		next = TAILQ_NEXT(st, sd_queue);
951 		if (st->sd_gone) {
952 			TAILQ_REMOVE(&ksyms_symtabs, st, sd_queue);
953 			kmem_free(st, sizeof(*st));
954 			resize = true;
955 		}
956 	}
957 	if (resize)
958 		ksyms_sizes_calc();
959 	mutex_exit(&ksyms_lock);
960 
961 	return 0;
962 }
963 
964 static int
965 ksymsread(dev_t dev, struct uio *uio, int ioflag)
966 {
967 	struct ksyms_symtab *st;
968 	size_t filepos, inpos, off;
969 	int error;
970 #ifdef KDTRACE_HOOKS
971 	struct ksyms_symtab *cst;
972 #endif
973 
974 	/*
975 	 * First: Copy out the ELF header.   XXX Lose if ksymsopen()
976 	 * occurs during read of the header.
977 	 */
978 	off = uio->uio_offset;
979 	if (off < sizeof(struct ksyms_hdr)) {
980 		error = uiomove((char *)&ksyms_hdr + off,
981 		    sizeof(struct ksyms_hdr) - off, uio);
982 		if (error != 0)
983 			return error;
984 	}
985 
986 	/*
987 	 * Copy out the symbol table.
988 	 */
989 	filepos = sizeof(struct ksyms_hdr);
990 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
991 		if (uio->uio_resid == 0)
992 			return 0;
993 		if (uio->uio_offset <= st->sd_symsize + filepos) {
994 			inpos = uio->uio_offset - filepos;
995 			error = uiomove((char *)st->sd_symstart + inpos,
996 			   st->sd_symsize - inpos, uio);
997 			if (error != 0)
998 				return error;
999 		}
1000 		filepos += st->sd_symsize;
1001 	}
1002 
1003 	/*
1004 	 * Copy out the string table
1005 	 */
1006 	KASSERT(filepos == sizeof(struct ksyms_hdr) +
1007 	    ksyms_hdr.kh_shdr[SYMTAB].sh_size);
1008 	TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
1009 		if (uio->uio_resid == 0)
1010 			return 0;
1011 		if (uio->uio_offset <= st->sd_strsize + filepos) {
1012 			inpos = uio->uio_offset - filepos;
1013 			error = uiomove((char *)st->sd_strstart + inpos,
1014 			   st->sd_strsize - inpos, uio);
1015 			if (error != 0)
1016 				return error;
1017 		}
1018 		filepos += st->sd_strsize;
1019 	}
1020 
1021 #ifdef KDTRACE_HOOKS
1022 	/*
1023 	 * Copy out the CTF table.
1024 	 */
1025 	cst = TAILQ_FIRST(&ksyms_symtabs);
1026 	if (cst->sd_ctfstart != NULL) {
1027 		if (uio->uio_resid == 0)
1028 			return 0;
1029 		if (uio->uio_offset <= cst->sd_ctfsize + filepos) {
1030 			inpos = uio->uio_offset - filepos;
1031 			error = uiomove((char *)cst->sd_ctfstart + inpos,
1032 			   cst->sd_ctfsize - inpos, uio);
1033 			if (error != 0)
1034 				return error;
1035 		}
1036 		filepos += cst->sd_ctfsize;
1037 	}
1038 #endif
1039 
1040 	return 0;
1041 }
1042 
1043 static int
1044 ksymswrite(dev_t dev, struct uio *uio, int ioflag)
1045 {
1046 
1047 	return EROFS;
1048 }
1049 
1050 static int
1051 ksymsioctl(dev_t dev, u_long cmd, void *data, int fflag, struct lwp *l)
1052 {
1053 	struct ksyms_gsymbol *kg = (struct ksyms_gsymbol *)data;
1054 	struct ksyms_symtab *st;
1055 	Elf_Sym *sym = NULL, copy;
1056 	unsigned long val;
1057 	int error = 0;
1058 	char *str = NULL;
1059 	int len;
1060 
1061 	/* Read ksyms_maxlen only once while not holding the lock. */
1062 	len = ksyms_maxlen;
1063 
1064 	if (cmd == KIOCGVALUE || cmd == KIOCGSYMBOL) {
1065 		str = kmem_alloc(len, KM_SLEEP);
1066 		if ((error = copyinstr(kg->kg_name, str, len, NULL)) != 0) {
1067 			kmem_free(str, len);
1068 			return error;
1069 		}
1070 	}
1071 
1072 	switch (cmd) {
1073 	case KIOCGVALUE:
1074 		/*
1075 		 * Use the in-kernel symbol lookup code for fast
1076 		 * retreival of a value.
1077 		 */
1078 		error = ksyms_getval(NULL, str, &val, KSYMS_EXTERN);
1079 		if (error == 0)
1080 			error = copyout(&val, kg->kg_value, sizeof(long));
1081 		kmem_free(str, len);
1082 		break;
1083 
1084 	case KIOCGSYMBOL:
1085 		/*
1086 		 * Use the in-kernel symbol lookup code for fast
1087 		 * retreival of a symbol.
1088 		 */
1089 		mutex_enter(&ksyms_lock);
1090 		TAILQ_FOREACH(st, &ksyms_symtabs, sd_queue) {
1091 			if (st->sd_gone)
1092 				continue;
1093 			if ((sym = findsym(str, st, KSYMS_ANY)) == NULL)
1094 				continue;
1095 #ifdef notdef
1096 			/* Skip if bad binding */
1097 			if (ELF_ST_BIND(sym->st_info) != STB_GLOBAL) {
1098 				sym = NULL;
1099 				continue;
1100 			}
1101 #endif
1102 			break;
1103 		}
1104 		if (sym != NULL) {
1105 			memcpy(&copy, sym, sizeof(copy));
1106 			mutex_exit(&ksyms_lock);
1107 			error = copyout(&copy, kg->kg_sym, sizeof(Elf_Sym));
1108 		} else {
1109 			mutex_exit(&ksyms_lock);
1110 			error = ENOENT;
1111 		}
1112 		kmem_free(str, len);
1113 		break;
1114 
1115 	case KIOCGSIZE:
1116 		/*
1117 		 * Get total size of symbol table.
1118 		 */
1119 		mutex_enter(&ksyms_lock);
1120 		*(int *)data = ksyms_strsz + ksyms_symsz +
1121 		    sizeof(struct ksyms_hdr);
1122 		mutex_exit(&ksyms_lock);
1123 		break;
1124 
1125 	default:
1126 		error = ENOTTY;
1127 		break;
1128 	}
1129 
1130 	return error;
1131 }
1132 
1133 const struct cdevsw ksyms_cdevsw = {
1134 	ksymsopen, ksymsclose, ksymsread, ksymswrite, ksymsioctl,
1135 	nullstop, notty, nopoll, nommap, nullkqfilter, D_OTHER | D_MPSAFE
1136 };
1137