Debian Codegraph @

man/warning::symbols.7stap

raw
1 .\" T
2 .TH WARNING::SYMBOLS 7stap
3 .SH NAME
4 warning::symbols \- systemtap missing-symbols warnings
5
6 .\" macros
7 .de SAMPLE
8
9 .nr oldin \\n(.i
10 .br
11 .RS
12 .nf
13 .nh
14 ..
15 .de ESAMPLE
16 .hy
17 .fi
18 .RE
19 .in \\n[oldin]u
20
21 ..
22
23 .SH DESCRIPTION
24
25 For some probing operations, where DWARF debugging data is not available,
26 systemtap needs ELF symbols for the relevant binaries. This allows at
27 least probe addresses to be calculated, some variables resolved, and with
28 @cast() and headers, maybe even some types.
29
30 .TP
31 kernel symbol table
32 Systemtap may need a linux-build style \fBSystem.map\fR file to find
33 addresses of kernel functions/data. It may be possible to create it
34 by hand:
35 .SAMPLE
36 % su
37 # cp /proc/kallsyms /boot/System.map-`uname -r`
38 or
39 # nm /lib/modules/`uname -r`/build/vmlinux > /boot/System.map-`uname -r`
40 .ESAMPLE
41
42 .TP
43 minisymbols
44 On some systems, binaries may be compiled with a subset of symbols
45 useful for function tracing and backtraces. This 'Minisymbols' is
46 a xz compressed section labeled .gnu_debugdata. Support for
47 minisymbols relies on elfutils version 0.156 or later.
48
49 .TP
50 compressed symbols
51 On some systems, symbols may be available, but compressed into
52 .IR .zdebug_*
53 sections. Support for compressed symbols relies on elfutils
54 version 0.153 or later.
55
56 .SH SEE ALSO
57 .nh
58 .nf
59 .IR stap (1),
60 .IR stappaths (7),
61 .IR strip (1),
62 .IR warning::debuginfo (7stap),
63 .IR error::dwarf (7stap),
64 .IR error::reporting (7stap),
65 .IR http://fedoraproject.org/wiki/Features/MiniDebugInfo