2010-01-21 01:28:45 +08:00
|
|
|
perf-buildid-cache(1)
|
|
|
|
=====================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
perf-buildid-cache - Manage build-id cache.
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
[verse]
|
2010-05-04 21:48:22 +08:00
|
|
|
'perf buildid-cache <options>'
|
2010-01-21 01:28:45 +08:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2015-02-27 12:50:26 +08:00
|
|
|
This command manages the build-id cache. It can add, remove, update and purge
|
|
|
|
files to/from the cache. In the future it should as well set upper limits for
|
|
|
|
the space used by the cache, etc.
|
2016-07-01 16:04:10 +08:00
|
|
|
This also scans the target binary for SDT (Statically Defined Tracing) and
|
|
|
|
record it along with the buildid-cache, which will be used by perf-probe.
|
|
|
|
For more details, see linkperf:perf-probe[1].
|
2010-01-21 01:28:45 +08:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
-a::
|
|
|
|
--add=::
|
|
|
|
Add specified file to the cache.
|
2017-11-16 22:26:07 +08:00
|
|
|
-f::
|
|
|
|
--force::
|
|
|
|
Don't complain, do it.
|
2013-10-14 21:57:29 +08:00
|
|
|
-k::
|
|
|
|
--kcore::
|
|
|
|
Add specified kcore file to the cache. For the current host that is
|
|
|
|
/proc/kcore which requires root permissions to read. Be aware that
|
|
|
|
running 'perf buildid-cache' as root may update root's build-id cache
|
|
|
|
not the user's. Use the -v option to see where the file is created.
|
|
|
|
Note that the copied file contains only code sections not the whole core
|
|
|
|
image. Note also that files "kallsyms" and "modules" must also be in the
|
|
|
|
same directory and are also copied. All 3 files are created with read
|
|
|
|
permissions for root only. kcore will not be added if there is already a
|
|
|
|
kcore in the cache (with the same build-id) that has the same modules at
|
|
|
|
the same addresses. Use the -v option to see if a copy of kcore is
|
|
|
|
actually made.
|
2010-01-21 01:28:45 +08:00
|
|
|
-r::
|
|
|
|
--remove=::
|
2015-02-27 12:50:26 +08:00
|
|
|
Remove a cached binary which has same build-id of specified file
|
|
|
|
from the cache.
|
|
|
|
-p::
|
|
|
|
--purge=::
|
|
|
|
Purge all cached binaries including older caches which have specified
|
|
|
|
path from the cache.
|
2018-04-17 12:13:46 +08:00
|
|
|
-P::
|
|
|
|
--purge-all::
|
|
|
|
Purge all cached binaries. This will flush out entire cache.
|
2012-12-08 03:28:27 +08:00
|
|
|
-M::
|
2014-12-18 04:24:45 +08:00
|
|
|
--missing=::
|
2012-12-08 03:28:27 +08:00
|
|
|
List missing build ids in the cache for the specified file.
|
2013-02-07 17:02:11 +08:00
|
|
|
-u::
|
2015-02-26 14:54:40 +08:00
|
|
|
--update=::
|
|
|
|
Update specified file of the cache. Note that this doesn't remove
|
2021-03-24 00:09:15 +08:00
|
|
|
older entries since those may be still needed for annotating old
|
2015-02-26 14:54:40 +08:00
|
|
|
(or remote) perf.data. Only if there is already a cache which has
|
|
|
|
exactly same build-id, that is replaced by new one. It can be used
|
|
|
|
to update kallsyms and kernel dso to vmlinux in order to support
|
|
|
|
annotation.
|
2018-04-17 12:13:45 +08:00
|
|
|
-l::
|
|
|
|
--list::
|
|
|
|
List all valid binaries from cache.
|
2010-01-21 01:28:45 +08:00
|
|
|
-v::
|
|
|
|
--verbose::
|
|
|
|
Be more verbose.
|
|
|
|
|
2017-07-06 09:48:11 +08:00
|
|
|
--target-ns=PID:
|
|
|
|
Obtain mount namespace information from the target pid. This is
|
|
|
|
used when creating a uprobe for a process that resides in a
|
|
|
|
different mount namespace from the perf(1) utility.
|
|
|
|
|
2021-12-10 04:04:25 +08:00
|
|
|
--debuginfod[=URLs]::
|
2020-12-14 18:54:55 +08:00
|
|
|
Specify debuginfod URL to be used when retrieving perf.data binaries,
|
|
|
|
it follows the same syntax as the DEBUGINFOD_URLS variable, like:
|
|
|
|
|
|
|
|
buildid-cache.debuginfod=http://192.168.122.174:8002
|
|
|
|
|
2021-12-10 04:04:25 +08:00
|
|
|
If the URLs is not specified, the value of DEBUGINFOD_URLS
|
|
|
|
system environment variable is used.
|
|
|
|
|
2010-01-21 01:28:45 +08:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
2010-05-04 21:48:22 +08:00
|
|
|
linkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-buildid-list[1]
|