1 perf-buildid-cache(1)
2 =====================
3
4 NAME
5 ----
6 perf-buildid-cache - Manage build-id cache.
7
8 SYNOPSIS
9 --------
10 [verse]
11 'perf buildid-cache <options>'
12
13 DESCRIPTION
14 -----------
15 This command manages the build-id cache. It ca
16 files to/from the cache. In the future it shou
17 the space used by the cache, etc.
18 This also scans the target binary for SDT (Sta
19 record it along with the buildid-cache, which
20 For more details, see linkperf:perf-probe[1].
21
22 OPTIONS
23 -------
24 -a::
25 --add=::
26 Add specified file to the cache.
27 -f::
28 --force::
29 Don't complain, do it.
30 -k::
31 --kcore::
32 Add specified kcore file to the cache.
33 /proc/kcore which requires root permis
34 running 'perf buildid-cache' as root m
35 not the user's. Use the -v option to s
36 Note that the copied file contains onl
37 image. Note also that files "kallsyms"
38 same directory and are also copied. A
39 permissions for root only. kcore will
40 kcore in the cache (with the same buil
41 the same addresses. Use the -v option
42 actually made.
43 -r::
44 --remove=::
45 Remove a cached binary which has same
46 from the cache.
47 -p::
48 --purge=::
49 Purge all cached binaries including ol
50 path from the cache.
51 -P::
52 --purge-all::
53 Purge all cached binaries. This will f
54 -M::
55 --missing=::
56 List missing build ids in the cache fo
57 -u::
58 --update=::
59 Update specified file of the cache. No
60 older entries since those may be still
61 (or remote) perf.data. Only if there i
62 exactly same build-id, that is replace
63 to update kallsyms and kernel dso to v
64 annotation.
65 -l::
66 --list::
67 List all valid binaries from cache.
68 -v::
69 --verbose::
70 Be more verbose.
71
72 --target-ns=PID:
73 Obtain mount namespace information fro
74 used when creating a uprobe for a proc
75 different mount namespace from the per
76
77 --debuginfod[=URLs]::
78 Specify debuginfod URL to be used when
79 it follows the same syntax as the DEBU
80
81 buildid-cache.debuginfod=http://192.
82
83 If the URLs is not specified, the valu
84 system environment variable is used.
85
86 SEE ALSO
87 --------
88 linkperf:perf-record[1], linkperf:perf-report[
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.