Blame view

kernel/kallsyms.c 17.6 KB
457c89965   Thomas Gleixner   treewide: Add SPD...
1
  // SPDX-License-Identifier: GPL-2.0-only
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
2
3
4
5
6
7
8
9
10
11
12
13
14
15
  /*
   * kallsyms.c: in-kernel printing of symbolic oopses and stack traces.
   *
   * Rewritten and vastly simplified by Rusty Russell for in-kernel
   * module loader:
   *   Copyright 2002 Rusty Russell <rusty@rustcorp.com.au> IBM Corporation
   *
   * ChangeLog:
   *
   * (25/Aug/2004) Paulo Marques <pmarques@grupopie.com>
   *      Changed the compression method from stem compression to "table lookup"
   *      compression (see scripts/kallsyms.c for a more complete description)
   */
  #include <linux/kallsyms.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
16
17
18
  #include <linux/init.h>
  #include <linux/seq_file.h>
  #include <linux/fs.h>
67fc4e0cb   Jason Wessel   kdb: core for kgd...
19
  #include <linux/kdb.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
20
21
  #include <linux/err.h>
  #include <linux/proc_fs.h>
4e57b6817   Tim Schmielau   [PATCH] fix missi...
22
  #include <linux/sched.h>	/* for cond_resched */
07354a009   Adam B. Jerome   [PATCH] /proc/kal...
23
  #include <linux/ctype.h>
5a0e3ad6a   Tejun Heo   include cleanup: ...
24
  #include <linux/slab.h>
74451e66d   Daniel Borkmann   bpf: make jited p...
25
  #include <linux/filter.h>
aba4b5c22   Steven Rostedt (VMware)   ftrace: Save modu...
26
  #include <linux/ftrace.h>
52f5684c8   Gideon Israel Dsouza   kernel: use macro...
27
  #include <linux/compiler.h>
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
28

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
29
30
31
32
  /*
   * These will be re-linked against their real values
   * during the second link stage.
   */
52f5684c8   Gideon Israel Dsouza   kernel: use macro...
33
  extern const unsigned long kallsyms_addresses[] __weak;
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
34
  extern const int kallsyms_offsets[] __weak;
52f5684c8   Gideon Israel Dsouza   kernel: use macro...
35
  extern const u8 kallsyms_names[] __weak;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
36

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
37
38
39
  /*
   * Tell the compiler that the count isn't in the small data section if the arch
   * has one (eg: FRV).
9e6c1e633   David Howells   FRV: fix the exte...
40
   */
80ffbaa5b   Jan Beulich   kallsyms: reduce ...
41
  extern const unsigned int kallsyms_num_syms
2ea038917   Sam Ravnborg   Revert "kbuild: s...
42
  __attribute__((weak, section(".rodata")));
9e6c1e633   David Howells   FRV: fix the exte...
43

2213e9a66   Ard Biesheuvel   kallsyms: add sup...
44
45
  extern const unsigned long kallsyms_relative_base
  __attribute__((weak, section(".rodata")));
52f5684c8   Gideon Israel Dsouza   kernel: use macro...
46
47
  extern const u8 kallsyms_token_table[] __weak;
  extern const u16 kallsyms_token_index[] __weak;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
48

80ffbaa5b   Jan Beulich   kallsyms: reduce ...
49
  extern const unsigned int kallsyms_markers[] __weak;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
50

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
51
52
  /*
   * Expand a compressed symbol data into the resulting uncompressed string,
e3f26752f   Chen Gang   kernel: kallsyms:...
53
   * if uncompressed string is too long (>= maxlen), it will be truncated,
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
54
55
   * given the offset to where the symbol is in the compressed stream.
   */
e3f26752f   Chen Gang   kernel: kallsyms:...
56
57
  static unsigned int kallsyms_expand_symbol(unsigned int off,
  					   char *result, size_t maxlen)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
58
59
  {
  	int len, skipped_first = 0;
aad094701   Jan Beulich   [PATCH] move kall...
60
  	const u8 *tptr, *data;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
61

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
62
  	/* Get the compressed symbol length from the first symbol byte. */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
63
64
65
  	data = &kallsyms_names[off];
  	len = *data;
  	data++;
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
66
67
68
69
  	/*
  	 * Update the offset to return the offset for the next symbol on
  	 * the compressed stream.
  	 */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
70
  	off += len + 1;
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
71
72
73
74
75
76
  	/*
  	 * For every byte on the compressed symbol data, copy the table
  	 * entry for that byte.
  	 */
  	while (len) {
  		tptr = &kallsyms_token_table[kallsyms_token_index[*data]];
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
77
78
79
80
  		data++;
  		len--;
  
  		while (*tptr) {
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
81
  			if (skipped_first) {
e3f26752f   Chen Gang   kernel: kallsyms:...
82
83
  				if (maxlen <= 1)
  					goto tail;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
84
85
  				*result = *tptr;
  				result++;
e3f26752f   Chen Gang   kernel: kallsyms:...
86
  				maxlen--;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
87
88
89
90
91
  			} else
  				skipped_first = 1;
  			tptr++;
  		}
  	}
e3f26752f   Chen Gang   kernel: kallsyms:...
92
93
94
  tail:
  	if (maxlen)
  		*result = '\0';
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
95

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
96
  	/* Return to offset to the next symbol. */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
97
98
  	return off;
  }
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
99
100
101
102
  /*
   * Get symbol type information. This is encoded as a single char at the
   * beginning of the symbol name.
   */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
103
104
  static char kallsyms_get_symbol_type(unsigned int off)
  {
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
105
106
107
108
109
  	/*
  	 * Get just the first code, look it up in the token table,
  	 * and return the first char from this token.
  	 */
  	return kallsyms_token_table[kallsyms_token_index[kallsyms_names[off + 1]]];
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
110
  }
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
111
112
113
114
  /*
   * Find the offset on the compressed stream given and index in the
   * kallsyms array.
   */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
115
116
  static unsigned int get_symbol_offset(unsigned long pos)
  {
aad094701   Jan Beulich   [PATCH] move kall...
117
  	const u8 *name;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
118
  	int i;
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
119
120
121
122
123
  	/*
  	 * Use the closest marker we have. We have markers every 256 positions,
  	 * so that should be close enough.
  	 */
  	name = &kallsyms_names[kallsyms_markers[pos >> 8]];
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
124

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
125
126
127
128
129
130
131
  	/*
  	 * Sequentially scan all the symbols up to the point we're searching
  	 * for. Every symbol is stored in a [<len>][<len> bytes of data] format,
  	 * so we just need to add the len to the current pointer for every
  	 * symbol we wish to skip.
  	 */
  	for (i = 0; i < (pos & 0xFF); i++)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
132
133
134
135
  		name = name + (*name) + 1;
  
  	return name - kallsyms_names;
  }
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
  static unsigned long kallsyms_sym_address(int idx)
  {
  	if (!IS_ENABLED(CONFIG_KALLSYMS_BASE_RELATIVE))
  		return kallsyms_addresses[idx];
  
  	/* values are unsigned offsets if --absolute-percpu is not in effect */
  	if (!IS_ENABLED(CONFIG_KALLSYMS_ABSOLUTE_PERCPU))
  		return kallsyms_relative_base + (u32)kallsyms_offsets[idx];
  
  	/* ...otherwise, positive offsets are absolute values */
  	if (kallsyms_offsets[idx] >= 0)
  		return kallsyms_offsets[idx];
  
  	/* ...and negative offsets are relative to kallsyms_relative_base - 1 */
  	return kallsyms_relative_base - 1 - kallsyms_offsets[idx];
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
152
153
154
  /* Lookup the address for this symbol. Returns 0 if not found. */
  unsigned long kallsyms_lookup_name(const char *name)
  {
9281acea6   Tejun Heo   kallsyms: make KS...
155
  	char namebuf[KSYM_NAME_LEN];
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
156
157
158
159
  	unsigned long i;
  	unsigned int off;
  
  	for (i = 0, off = 0; i < kallsyms_num_syms; i++) {
e3f26752f   Chen Gang   kernel: kallsyms:...
160
  		off = kallsyms_expand_symbol(off, namebuf, ARRAY_SIZE(namebuf));
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
161
162
  
  		if (strcmp(namebuf, name) == 0)
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
163
  			return kallsyms_sym_address(i);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
164
165
166
  	}
  	return module_kallsyms_lookup_name(name);
  }
f60d24d2a   Frederic Weisbecker   hw-breakpoints: F...
167
  EXPORT_SYMBOL_GPL(kallsyms_lookup_name);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
168

75a66614d   Anders Kaseorg   Ksplice: Add func...
169
170
171
172
173
174
175
176
177
178
  int kallsyms_on_each_symbol(int (*fn)(void *, const char *, struct module *,
  				      unsigned long),
  			    void *data)
  {
  	char namebuf[KSYM_NAME_LEN];
  	unsigned long i;
  	unsigned int off;
  	int ret;
  
  	for (i = 0, off = 0; i < kallsyms_num_syms; i++) {
e3f26752f   Chen Gang   kernel: kallsyms:...
179
  		off = kallsyms_expand_symbol(off, namebuf, ARRAY_SIZE(namebuf));
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
180
  		ret = fn(data, namebuf, NULL, kallsyms_sym_address(i));
75a66614d   Anders Kaseorg   Ksplice: Add func...
181
182
183
184
185
186
  		if (ret != 0)
  			return ret;
  	}
  	return module_kallsyms_on_each_symbol(fn, data);
  }
  EXPORT_SYMBOL_GPL(kallsyms_on_each_symbol);
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
187
188
189
190
191
192
  static unsigned long get_symbol_pos(unsigned long addr,
  				    unsigned long *symbolsize,
  				    unsigned long *offset)
  {
  	unsigned long symbol_start = 0, symbol_end = 0;
  	unsigned long i, low, high, mid;
2ea038917   Sam Ravnborg   Revert "kbuild: s...
193
  	/* This kernel should never had been booted. */
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
194
195
196
197
  	if (!IS_ENABLED(CONFIG_KALLSYMS_BASE_RELATIVE))
  		BUG_ON(!kallsyms_addresses);
  	else
  		BUG_ON(!kallsyms_offsets);
2ea038917   Sam Ravnborg   Revert "kbuild: s...
198

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
199
  	/* Do a binary search on the sorted kallsyms_addresses array. */
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
200
201
202
203
  	low = 0;
  	high = kallsyms_num_syms;
  
  	while (high - low > 1) {
2fc9c4e18   Vegard Nossum   kallsyms: fix pot...
204
  		mid = low + (high - low) / 2;
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
205
  		if (kallsyms_sym_address(mid) <= addr)
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
206
207
208
209
210
211
  			low = mid;
  		else
  			high = mid;
  	}
  
  	/*
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
212
213
  	 * Search for the first aliased symbol. Aliased
  	 * symbols are symbols with the same address.
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
214
  	 */
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
215
  	while (low && kallsyms_sym_address(low-1) == kallsyms_sym_address(low))
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
216
  		--low;
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
217
  	symbol_start = kallsyms_sym_address(low);
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
218

ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
219
  	/* Search for next non-aliased symbol. */
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
220
  	for (i = low + 1; i < kallsyms_num_syms; i++) {
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
221
222
  		if (kallsyms_sym_address(i) > symbol_start) {
  			symbol_end = kallsyms_sym_address(i);
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
223
224
225
  			break;
  		}
  	}
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
226
  	/* If we found no next symbol, we use the end of the section. */
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
227
228
229
  	if (!symbol_end) {
  		if (is_kernel_inittext(addr))
  			symbol_end = (unsigned long)_einittext;
63b23e2cb   Masahiro Yamada   kernel/kallsyms.c...
230
  		else if (IS_ENABLED(CONFIG_KALLSYMS_ALL))
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
231
232
233
234
  			symbol_end = (unsigned long)_end;
  		else
  			symbol_end = (unsigned long)_etext;
  	}
ffb451227   Alexey Dobriyan   Simplify kallsyms...
235
236
237
238
  	if (symbolsize)
  		*symbolsize = symbol_end - symbol_start;
  	if (offset)
  		*offset = addr - symbol_start;
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
239
240
241
242
243
244
245
246
247
248
  
  	return low;
  }
  
  /*
   * Lookup an address but don't bother to find any names.
   */
  int kallsyms_lookup_size_offset(unsigned long addr, unsigned long *symbolsize,
  				unsigned long *offset)
  {
6dd06c9fb   Rusty Russell   module: make modu...
249
  	char namebuf[KSYM_NAME_LEN];
74451e66d   Daniel Borkmann   bpf: make jited p...
250

ffc508919   Franck Bui-Huu   [PATCH] Create ka...
251
252
  	if (is_ksym_addr(addr))
  		return !!get_symbol_pos(addr, symbolsize, offset);
74451e66d   Daniel Borkmann   bpf: make jited p...
253
254
  	return !!module_address_lookup(addr, symbolsize, offset, NULL, namebuf) ||
  	       !!__bpf_address_lookup(addr, symbolsize, offset, namebuf);
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
255
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
256
257
  /*
   * Lookup an address
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
258
259
260
261
   * - modname is set to NULL if it's in the kernel.
   * - We guarantee that the returned name is valid until we reschedule even if.
   *   It resides in a module.
   * - We also guarantee that modname will be valid until rescheduled.
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
262
263
264
265
266
267
   */
  const char *kallsyms_lookup(unsigned long addr,
  			    unsigned long *symbolsize,
  			    unsigned long *offset,
  			    char **modname, char *namebuf)
  {
74451e66d   Daniel Borkmann   bpf: make jited p...
268
  	const char *ret;
9281acea6   Tejun Heo   kallsyms: make KS...
269
  	namebuf[KSYM_NAME_LEN - 1] = 0;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
270
  	namebuf[0] = 0;
ffc508919   Franck Bui-Huu   [PATCH] Create ka...
271
272
  	if (is_ksym_addr(addr)) {
  		unsigned long pos;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
273

ffc508919   Franck Bui-Huu   [PATCH] Create ka...
274
  		pos = get_symbol_pos(addr, symbolsize, offset);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
275
  		/* Grab name */
e3f26752f   Chen Gang   kernel: kallsyms:...
276
277
  		kallsyms_expand_symbol(get_symbol_offset(pos),
  				       namebuf, KSYM_NAME_LEN);
7a74fc492   Kyle McMartin   fix possible null...
278
279
  		if (modname)
  			*modname = NULL;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
280
281
  		return namebuf;
  	}
74451e66d   Daniel Borkmann   bpf: make jited p...
282
283
284
285
286
287
  	/* See if it's in a module or a BPF JITed image. */
  	ret = module_address_lookup(addr, symbolsize, offset,
  				    modname, namebuf);
  	if (!ret)
  		ret = bpf_address_lookup(addr, symbolsize,
  					 offset, modname, namebuf);
aba4b5c22   Steven Rostedt (VMware)   ftrace: Save modu...
288
289
290
291
  
  	if (!ret)
  		ret = ftrace_mod_address_lookup(addr, symbolsize,
  						offset, modname, namebuf);
74451e66d   Daniel Borkmann   bpf: make jited p...
292
  	return ret;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
293
  }
9d65cb4a1   Alexey Dobriyan   Fix race between ...
294
295
296
  int lookup_symbol_name(unsigned long addr, char *symname)
  {
  	symname[0] = '\0';
9281acea6   Tejun Heo   kallsyms: make KS...
297
  	symname[KSYM_NAME_LEN - 1] = '\0';
9d65cb4a1   Alexey Dobriyan   Fix race between ...
298
299
300
301
302
303
  
  	if (is_ksym_addr(addr)) {
  		unsigned long pos;
  
  		pos = get_symbol_pos(addr, NULL, NULL);
  		/* Grab name */
e3f26752f   Chen Gang   kernel: kallsyms:...
304
305
  		kallsyms_expand_symbol(get_symbol_offset(pos),
  				       symname, KSYM_NAME_LEN);
9d65cb4a1   Alexey Dobriyan   Fix race between ...
306
307
  		return 0;
  	}
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
308
  	/* See if it's in a module. */
9d65cb4a1   Alexey Dobriyan   Fix race between ...
309
310
  	return lookup_module_symbol_name(addr, symname);
  }
a5c43dae7   Alexey Dobriyan   Fix race between ...
311
312
313
314
  int lookup_symbol_attrs(unsigned long addr, unsigned long *size,
  			unsigned long *offset, char *modname, char *name)
  {
  	name[0] = '\0';
9281acea6   Tejun Heo   kallsyms: make KS...
315
  	name[KSYM_NAME_LEN - 1] = '\0';
a5c43dae7   Alexey Dobriyan   Fix race between ...
316
317
318
319
320
321
  
  	if (is_ksym_addr(addr)) {
  		unsigned long pos;
  
  		pos = get_symbol_pos(addr, size, offset);
  		/* Grab name */
e3f26752f   Chen Gang   kernel: kallsyms:...
322
323
  		kallsyms_expand_symbol(get_symbol_offset(pos),
  				       name, KSYM_NAME_LEN);
a5c43dae7   Alexey Dobriyan   Fix race between ...
324
325
326
  		modname[0] = '\0';
  		return 0;
  	}
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
327
  	/* See if it's in a module. */
a5c43dae7   Alexey Dobriyan   Fix race between ...
328
329
  	return lookup_module_symbol_attrs(addr, size, offset, modname, name);
  }
42e380832   Robert Peterson   Extend print_symb...
330
  /* Look up a kernel symbol and return it in a text buffer. */
0f77a8d37   Namhyung Kim   vsprintf: Introdu...
331
  static int __sprint_symbol(char *buffer, unsigned long address,
4796dd200   Stephen Boyd   vsprintf: fix %ps...
332
  			   int symbol_offset, int add_offset)
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
333
334
335
336
  {
  	char *modname;
  	const char *name;
  	unsigned long offset, size;
966c8c12d   Hugh Dickins   sprint_symbol(): ...
337
  	int len;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
338

0f77a8d37   Namhyung Kim   vsprintf: Introdu...
339
  	address += symbol_offset;
966c8c12d   Hugh Dickins   sprint_symbol(): ...
340
  	name = kallsyms_lookup(address, &size, &offset, &modname, buffer);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
341
  	if (!name)
b86280aa4   Namhyung Kim   kernel/kallsyms.c...
342
  		return sprintf(buffer, "0x%lx", address - symbol_offset);
19769b762   Andrew Morton   sprint_symbol() c...
343

966c8c12d   Hugh Dickins   sprint_symbol(): ...
344
345
346
  	if (name != buffer)
  		strcpy(buffer, name);
  	len = strlen(buffer);
0f77a8d37   Namhyung Kim   vsprintf: Introdu...
347
  	offset -= symbol_offset;
966c8c12d   Hugh Dickins   sprint_symbol(): ...
348

4796dd200   Stephen Boyd   vsprintf: fix %ps...
349
350
  	if (add_offset)
  		len += sprintf(buffer + len, "+%#lx/%#lx", offset, size);
19769b762   Andrew Morton   sprint_symbol() c...
351
  	if (modname)
4796dd200   Stephen Boyd   vsprintf: fix %ps...
352
  		len += sprintf(buffer + len, " [%s]", modname);
966c8c12d   Hugh Dickins   sprint_symbol(): ...
353
354
  
  	return len;
42e380832   Robert Peterson   Extend print_symb...
355
  }
0f77a8d37   Namhyung Kim   vsprintf: Introdu...
356
357
358
359
360
361
362
363
364
365
366
367
368
369
  
  /**
   * sprint_symbol - Look up a kernel symbol and return it in a text buffer
   * @buffer: buffer to be stored
   * @address: address to lookup
   *
   * This function looks up a kernel symbol with @address and stores its name,
   * offset, size and module name to @buffer if possible. If no symbol was found,
   * just saves its @address as is.
   *
   * This function returns the number of bytes stored in @buffer.
   */
  int sprint_symbol(char *buffer, unsigned long address)
  {
4796dd200   Stephen Boyd   vsprintf: fix %ps...
370
  	return __sprint_symbol(buffer, address, 0, 1);
0f77a8d37   Namhyung Kim   vsprintf: Introdu...
371
  }
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
372
  EXPORT_SYMBOL_GPL(sprint_symbol);
42e380832   Robert Peterson   Extend print_symb...
373

0f77a8d37   Namhyung Kim   vsprintf: Introdu...
374
  /**
4796dd200   Stephen Boyd   vsprintf: fix %ps...
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
   * sprint_symbol_no_offset - Look up a kernel symbol and return it in a text buffer
   * @buffer: buffer to be stored
   * @address: address to lookup
   *
   * This function looks up a kernel symbol with @address and stores its name
   * and module name to @buffer if possible. If no symbol was found, just saves
   * its @address as is.
   *
   * This function returns the number of bytes stored in @buffer.
   */
  int sprint_symbol_no_offset(char *buffer, unsigned long address)
  {
  	return __sprint_symbol(buffer, address, 0, 0);
  }
  EXPORT_SYMBOL_GPL(sprint_symbol_no_offset);
  
  /**
0f77a8d37   Namhyung Kim   vsprintf: Introdu...
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
   * sprint_backtrace - Look up a backtrace symbol and return it in a text buffer
   * @buffer: buffer to be stored
   * @address: address to lookup
   *
   * This function is for stack backtrace and does the same thing as
   * sprint_symbol() but with modified/decreased @address. If there is a
   * tail-call to the function marked "noreturn", gcc optimized out code after
   * the call so that the stack-saved return address could point outside of the
   * caller. This function ensures that kallsyms will find the original caller
   * by decreasing @address.
   *
   * This function returns the number of bytes stored in @buffer.
   */
  int sprint_backtrace(char *buffer, unsigned long address)
  {
4796dd200   Stephen Boyd   vsprintf: fix %ps...
407
  	return __sprint_symbol(buffer, address, -1, 1);
0f77a8d37   Namhyung Kim   vsprintf: Introdu...
408
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
409
  /* To avoid using get_symbol_offset for every symbol, we carry prefix along. */
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
410
  struct kallsym_iter {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
411
  	loff_t pos;
d83212d5d   Alexander Shishkin   kallsyms, x86: Ex...
412
  	loff_t pos_arch_end;
74451e66d   Daniel Borkmann   bpf: make jited p...
413
  	loff_t pos_mod_end;
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
414
  	loff_t pos_ftrace_mod_end;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
415
  	unsigned long value;
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
416
  	unsigned int nameoff; /* If iterating in core kernel symbols. */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
417
  	char type;
9281acea6   Tejun Heo   kallsyms: make KS...
418
419
  	char name[KSYM_NAME_LEN];
  	char module_name[MODULE_NAME_LEN];
ea07890a6   Alexey Dobriyan   Fix race between ...
420
  	int exported;
c0f3ea158   Linus Torvalds   stop using '%pK' ...
421
  	int show_value;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
422
  };
d83212d5d   Alexander Shishkin   kallsyms, x86: Ex...
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
  int __weak arch_get_kallsym(unsigned int symnum, unsigned long *value,
  			    char *type, char *name)
  {
  	return -EINVAL;
  }
  
  static int get_ksymbol_arch(struct kallsym_iter *iter)
  {
  	int ret = arch_get_kallsym(iter->pos - kallsyms_num_syms,
  				   &iter->value, &iter->type,
  				   iter->name);
  
  	if (ret < 0) {
  		iter->pos_arch_end = iter->pos;
  		return 0;
  	}
  
  	return 1;
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
442
443
  static int get_ksymbol_mod(struct kallsym_iter *iter)
  {
d83212d5d   Alexander Shishkin   kallsyms, x86: Ex...
444
  	int ret = module_get_kallsym(iter->pos - iter->pos_arch_end,
74451e66d   Daniel Borkmann   bpf: make jited p...
445
446
447
448
449
  				     &iter->value, &iter->type,
  				     iter->name, iter->module_name,
  				     &iter->exported);
  	if (ret < 0) {
  		iter->pos_mod_end = iter->pos;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
450
  		return 0;
74451e66d   Daniel Borkmann   bpf: make jited p...
451
  	}
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
452
453
  	return 1;
  }
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
454
455
456
457
458
459
460
461
462
463
464
465
466
  static int get_ksymbol_ftrace_mod(struct kallsym_iter *iter)
  {
  	int ret = ftrace_mod_get_kallsym(iter->pos - iter->pos_mod_end,
  					 &iter->value, &iter->type,
  					 iter->name, iter->module_name,
  					 &iter->exported);
  	if (ret < 0) {
  		iter->pos_ftrace_mod_end = iter->pos;
  		return 0;
  	}
  
  	return 1;
  }
74451e66d   Daniel Borkmann   bpf: make jited p...
467
468
  static int get_ksymbol_bpf(struct kallsym_iter *iter)
  {
6934058d9   Song Liu   bpf: Add module n...
469
  	strlcpy(iter->module_name, "bpf", MODULE_NAME_LEN);
74451e66d   Daniel Borkmann   bpf: make jited p...
470
  	iter->exported = 0;
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
471
  	return bpf_get_kallsym(iter->pos - iter->pos_ftrace_mod_end,
74451e66d   Daniel Borkmann   bpf: make jited p...
472
473
474
  			       &iter->value, &iter->type,
  			       iter->name) < 0 ? 0 : 1;
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
475
476
477
478
  /* Returns space to next name. */
  static unsigned long get_ksymbol_core(struct kallsym_iter *iter)
  {
  	unsigned off = iter->nameoff;
ea07890a6   Alexey Dobriyan   Fix race between ...
479
  	iter->module_name[0] = '\0';
2213e9a66   Ard Biesheuvel   kallsyms: add sup...
480
  	iter->value = kallsyms_sym_address(iter->pos);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
481
482
  
  	iter->type = kallsyms_get_symbol_type(off);
e3f26752f   Chen Gang   kernel: kallsyms:...
483
  	off = kallsyms_expand_symbol(off, iter->name, ARRAY_SIZE(iter->name));
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
484
485
486
487
488
489
490
491
492
  
  	return off - iter->nameoff;
  }
  
  static void reset_iter(struct kallsym_iter *iter, loff_t new_pos)
  {
  	iter->name[0] = '\0';
  	iter->nameoff = get_symbol_offset(new_pos);
  	iter->pos = new_pos;
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
493
  	if (new_pos == 0) {
d83212d5d   Alexander Shishkin   kallsyms, x86: Ex...
494
  		iter->pos_arch_end = 0;
74451e66d   Daniel Borkmann   bpf: make jited p...
495
  		iter->pos_mod_end = 0;
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
496
497
  		iter->pos_ftrace_mod_end = 0;
  	}
74451e66d   Daniel Borkmann   bpf: make jited p...
498
  }
b96679422   Adrian Hunter   kallsyms: Simplif...
499
500
501
502
503
  /*
   * The end position (last + 1) of each additional kallsyms section is recorded
   * in iter->pos_..._end as each section is added, and so can be used to
   * determine which get_ksymbol_...() function to call next.
   */
74451e66d   Daniel Borkmann   bpf: make jited p...
504
505
506
  static int update_iter_mod(struct kallsym_iter *iter, loff_t pos)
  {
  	iter->pos = pos;
d83212d5d   Alexander Shishkin   kallsyms, x86: Ex...
507
508
509
  	if ((!iter->pos_arch_end || iter->pos_arch_end > pos) &&
  	    get_ksymbol_arch(iter))
  		return 1;
b96679422   Adrian Hunter   kallsyms: Simplif...
510
511
  	if ((!iter->pos_mod_end || iter->pos_mod_end > pos) &&
  	    get_ksymbol_mod(iter))
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
512
  		return 1;
6171a0310   Steven Rostedt (VMware)   ftrace/kallsyms: ...
513

b96679422   Adrian Hunter   kallsyms: Simplif...
514
515
516
  	if ((!iter->pos_ftrace_mod_end || iter->pos_ftrace_mod_end > pos) &&
  	    get_ksymbol_ftrace_mod(iter))
  		return 1;
74451e66d   Daniel Borkmann   bpf: make jited p...
517

b96679422   Adrian Hunter   kallsyms: Simplif...
518
  	return get_ksymbol_bpf(iter);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
519
520
521
522
523
524
  }
  
  /* Returns false if pos at or past end of file. */
  static int update_iter(struct kallsym_iter *iter, loff_t pos)
  {
  	/* Module symbols can be accessed randomly. */
74451e66d   Daniel Borkmann   bpf: make jited p...
525
526
  	if (pos >= kallsyms_num_syms)
  		return update_iter_mod(iter, pos);
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
527

1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
  	/* If we're not on the desired position, reset to new position. */
  	if (pos != iter->pos)
  		reset_iter(iter, pos);
  
  	iter->nameoff += get_ksymbol_core(iter);
  	iter->pos++;
  
  	return 1;
  }
  
  static void *s_next(struct seq_file *m, void *p, loff_t *pos)
  {
  	(*pos)++;
  
  	if (!update_iter(m->private, *pos))
  		return NULL;
  	return p;
  }
  
  static void *s_start(struct seq_file *m, loff_t *pos)
  {
  	if (!update_iter(m->private, *pos))
  		return NULL;
  	return m->private;
  }
  
  static void s_stop(struct seq_file *m, void *p)
  {
  }
  
  static int s_show(struct seq_file *m, void *p)
  {
668533dc0   Linus Torvalds   kallsyms: take ad...
560
  	void *value;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
561
  	struct kallsym_iter *iter = m->private;
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
562
  	/* Some debugging symbols have no name.  Ignore them. */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
563
564
  	if (!iter->name[0])
  		return 0;
668533dc0   Linus Torvalds   kallsyms: take ad...
565
  	value = iter->show_value ? (void *)iter->value : NULL;
c0f3ea158   Linus Torvalds   stop using '%pK' ...
566

ea07890a6   Alexey Dobriyan   Fix race between ...
567
568
  	if (iter->module_name[0]) {
  		char type;
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
569
570
571
572
  		/*
  		 * Label it "global" if it is exported,
  		 * "local" if not exported.
  		 */
ea07890a6   Alexey Dobriyan   Fix race between ...
573
574
  		type = iter->exported ? toupper(iter->type) :
  					tolower(iter->type);
668533dc0   Linus Torvalds   kallsyms: take ad...
575
576
  		seq_printf(m, "%px %c %s\t[%s]
  ", value,
9f36e2c44   Kees Cook   printk: use %pK f...
577
  			   type, iter->name, iter->module_name);
ea07890a6   Alexey Dobriyan   Fix race between ...
578
  	} else
668533dc0   Linus Torvalds   kallsyms: take ad...
579
580
  		seq_printf(m, "%px %c %s
  ", value,
9f36e2c44   Kees Cook   printk: use %pK f...
581
  			   iter->type, iter->name);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
582
583
  	return 0;
  }
15ad7cdcf   Helge Deller   [PATCH] struct se...
584
  static const struct seq_operations kallsyms_op = {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
585
586
587
588
589
  	.start = s_start,
  	.next = s_next,
  	.stop = s_stop,
  	.show = s_show
  };
c0f3ea158   Linus Torvalds   stop using '%pK' ...
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
  static inline int kallsyms_for_perf(void)
  {
  #ifdef CONFIG_PERF_EVENTS
  	extern int sysctl_perf_event_paranoid;
  	if (sysctl_perf_event_paranoid <= 1)
  		return 1;
  #endif
  	return 0;
  }
  
  /*
   * We show kallsyms information even to normal users if we've enabled
   * kernel profiling and are explicitly not paranoid (so kptr_restrict
   * is clear, and sysctl_perf_event_paranoid isn't set).
   *
   * Otherwise, require CAP_SYSLOG (assuming kptr_restrict isn't set to
   * block even that).
   */
516fb7f2e   Linus Torvalds   /proc/module: use...
608
  int kallsyms_show_value(void)
c0f3ea158   Linus Torvalds   stop using '%pK' ...
609
610
611
612
613
614
615
616
617
618
619
620
621
622
  {
  	switch (kptr_restrict) {
  	case 0:
  		if (kallsyms_for_perf())
  			return 1;
  	/* fallthrough */
  	case 1:
  		if (has_capability_noaudit(current, CAP_SYSLOG))
  			return 1;
  	/* fallthrough */
  	default:
  		return 0;
  	}
  }
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
623
624
  static int kallsyms_open(struct inode *inode, struct file *file)
  {
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
625
626
  	/*
  	 * We keep iterator in m->private, since normal case is to
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
627
  	 * s_start from where we left off, so we avoid doing
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
628
629
  	 * using get_symbol_offset for every symbol.
  	 */
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
630
  	struct kallsym_iter *iter;
0049f26ae   Rob Jones   kernel/kallsyms.c...
631
  	iter = __seq_open_private(file, &kallsyms_op, sizeof(*iter));
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
632
633
634
  	if (!iter)
  		return -ENOMEM;
  	reset_iter(iter, 0);
c0f3ea158   Linus Torvalds   stop using '%pK' ...
635
  	iter->show_value = kallsyms_show_value();
0049f26ae   Rob Jones   kernel/kallsyms.c...
636
  	return 0;
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
637
  }
67fc4e0cb   Jason Wessel   kdb: core for kgd...
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
  #ifdef	CONFIG_KGDB_KDB
  const char *kdb_walk_kallsyms(loff_t *pos)
  {
  	static struct kallsym_iter kdb_walk_kallsyms_iter;
  	if (*pos == 0) {
  		memset(&kdb_walk_kallsyms_iter, 0,
  		       sizeof(kdb_walk_kallsyms_iter));
  		reset_iter(&kdb_walk_kallsyms_iter, 0);
  	}
  	while (1) {
  		if (!update_iter(&kdb_walk_kallsyms_iter, *pos))
  			return NULL;
  		++*pos;
  		/* Some debugging symbols have no name.  Ignore them. */
  		if (kdb_walk_kallsyms_iter.name[0])
  			return kdb_walk_kallsyms_iter.name;
  	}
  }
  #endif	/* CONFIG_KGDB_KDB */
15ad7cdcf   Helge Deller   [PATCH] struct se...
657
  static const struct file_operations kallsyms_operations = {
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
658
659
660
  	.open = kallsyms_open,
  	.read = seq_read,
  	.llseek = seq_lseek,
5a0c6a0d1   Martin Peschke   kallsyms: cleanup...
661
  	.release = seq_release_private,
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
662
663
664
665
  };
  
  static int __init kallsyms_init(void)
  {
33e0d57f5   Linus Torvalds   Revert "kernel: m...
666
  	proc_create("kallsyms", 0444, NULL, &kallsyms_operations);
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
667
668
  	return 0;
  }
ad6ccfad6   Manish Katiyar   kernel/kallsyms.c...
669
  device_initcall(kallsyms_init);