mirror of
https://github.com/torvalds/linux.git
synced 2024-12-22 10:56:40 +00:00
6430a94ead
perf buildid-cache --add <binary> scans given binary and add
the SDT events to probe cache. "sdt_" prefix is appended for
all SDT providers to avoid event-name clash with other pre-defined
events. It is possible to use the cached SDT events as other cached
events, via perf probe --add "sdt_<provider>:<event>=<event>".
e.g.
----
# perf buildid-cache --add /lib/libc-2.17.so
# perf probe --cache --list | head -n 5
/usr/lib/libc-2.17.so (a6fb821bdf53660eb2c29f778757aef294d3d392):
sdt_libc:setjmp=setjmp
sdt_libc:longjmp=longjmp
sdt_libc:longjmp_target=longjmp_target
sdt_libc:memory_heap_new=memory_heap_new
# perf probe -x /usr/lib/libc-2.17.so \
-a sdt_libc:memory_heap_new=memory_heap_new
Added new event:
sdt_libc:memory_heap_new (on memory_heap_new
in /usr/lib/libc-2.17.so)
You can now use it in all perf tools, such as:
perf record -e sdt_libc:memory_heap_new -aR sleep 1
# perf probe -l
sdt_libc:memory_heap_new (on new_heap+183 in /usr/lib/libc-2.17.so)
----
Note that SDT event entries in probe-cache file is somewhat different
from normal cached events. Normal one starts with "#", but SDTs are
starting with "%".
Signed-off-by: Masami Hiramatsu <mhiramat@kernel.org>
Signed-off-by: Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
Cc: Ananth N Mavinakayanahalli <ananth@linux.vnet.ibm.com>
Cc: Brendan Gregg <brendan.d.gregg@gmail.com>
Cc: Hemant Kumar <hemant@linux.vnet.ibm.com>
Cc: Namhyung Kim <namhyung@kernel.org>
Cc: Peter Zijlstra <peterz@infradead.org>
Link: http://lkml.kernel.org/r/146736025058.27797.13043265488541434502.stgit@devbox
Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
67 lines
2.2 KiB
Plaintext
67 lines
2.2 KiB
Plaintext
perf-buildid-cache(1)
|
|
=====================
|
|
|
|
NAME
|
|
----
|
|
perf-buildid-cache - Manage build-id cache.
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf buildid-cache <options>'
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
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.
|
|
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].
|
|
|
|
OPTIONS
|
|
-------
|
|
-a::
|
|
--add=::
|
|
Add specified file to the cache.
|
|
-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.
|
|
-r::
|
|
--remove=::
|
|
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.
|
|
-M::
|
|
--missing=::
|
|
List missing build ids in the cache for the specified file.
|
|
-u::
|
|
--update=::
|
|
Update specified file of the cache. Note that this doesn't remove
|
|
older entires since those may be still needed for annotating old
|
|
(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.
|
|
|
|
-v::
|
|
--verbose::
|
|
Be more verbose.
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkperf:perf-record[1], linkperf:perf-report[1], linkperf:perf-buildid-list[1]
|