2010-01-20 17:28:45 +00:00
|
|
|
perf-buildid-cache(1)
|
|
|
|
=====================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
|
|
|
perf-buildid-cache - Manage build-id cache.
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
|
|
|
[verse]
|
2010-05-04 13:48:22 +00:00
|
|
|
'perf buildid-cache <options>'
|
2010-01-20 17:28:45 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2010-07-28 14:30:10 +00:00
|
|
|
This command manages the build-id cache. It can add and remove files to/from
|
|
|
|
the cache. In the future it should as well purge older entries, set upper
|
|
|
|
limits for the space used by the cache, etc.
|
2010-01-20 17:28:45 +00:00
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
-------
|
|
|
|
-a::
|
|
|
|
--add=::
|
|
|
|
Add specified file to the cache.
|
2013-10-14 13:57:29 +00: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-20 17:28:45 +00:00
|
|
|
-r::
|
|
|
|
--remove=::
|
2010-07-28 14:30:10 +00:00
|
|
|
Remove specified file from the cache.
|
2012-12-07 19:28:27 +00:00
|
|
|
-M::
|
2014-12-17 20:24:45 +00:00
|
|
|
--missing=::
|
2012-12-07 19:28:27 +00:00
|
|
|
List missing build ids in the cache for the specified file.
|
2013-02-07 09:02:11 +00:00
|
|
|
-u::
|
|
|
|
--update::
|
|
|
|
Update specified file of the cache. It can be used to update kallsyms
|
|
|
|
kernel dso to vmlinux in order to support annotation.
|
2010-01-20 17:28:45 +00:00
|
|
|
-v::
|
|
|
|
--verbose::
|
|
|
|
Be more verbose.
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2010-05-04 13:48:22 +00:00
|
|
|
linkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-buildid-list[1]
|