Debian Codegraph @

man/stap-prep.1

raw
1 .\" -*- nroff -*-
2 .TH STAP\-PREP 1
3 .SH NAME
4 stap\-prep \- prepare system for systemtap use
5
6 .\" macros
7 .\" do not nest SAMPLEs
8 .de SAMPLE
9 .br
10
11 .nr oldin \\n(.i
12 .RS
13 .nf
14 .nh
15 ..
16 .de ESAMPLE
17 .hy
18 .fi
19 .RE
20 .in \\n[oldin]u
21
22 ..
23
24 .SH SYNOPSIS
25
26 .br
27 .B stap\-prep
28 [
29 .I KERNEL_VERSION
30 ]
31
32 .SH DESCRIPTION
33
34 The stap\-prep executable prepares the system for systemtap use by
35 installing kernel headers, debug symbols and build tools that match
36 the currently running kernel or optionally the kernel version given by
37 the user.
38
39 If the debuginfod\-find tool is installed and is able to fetch
40 debuginfo for a kernel component, it is assumed to remain available
41 later. In this case, no debug symbols will be downloaded during
42 stap\-prep.
43
44 The exact behavior of stap\-prep may be customized by the
45 distribution maintainers. It might for example only give suggestions
46 and not actually install the required packages if that is difficult to
47 automate.
48
49 .SH EXAMPLES
50 .SAMPLE
51 $ stap-prep
52 Please install linux-image-3.2.0-2-amd64-dbg
53 .ESAMPLE
54
55 .SH SEE ALSO
56 .nh
57 .BR http://sourceware.org/elfutils/Debuginfod.html
58 .nf
59 .IR stap (1)
60
61 .SH BUGS
62 Use the Bugzilla link of the project web page or our mailing list.
63 .nh
64 .BR http://sourceware.org/systemtap/ , <[email protected]> .
65 .hy