mirror of
https://github.com/torvalds/linux.git
synced 2024-12-02 09:01:34 +00:00
1b69346e7a
Add a test to check function symbols do not overlap and are not zero length. The main motivation for the test is to make it easier to review changes to PLT symbol synthesis i.e. changes to dso__synthesize_plt_symbols(). By default the test uses the perf executable as a test DSO, but a specific DSO can be specified via a new perf test option "--dso". The test is useful in the following ways: - Any DSO can be tested, even ones that do not run on the current architecture. For example, using cross-compiled DSOs to see how well perf handles different architectures. - With verbose > 1 (e.g. -vv), all the symbols are printed, which makes it easier to see issues. - perf removes duplicate symbols and expands zero-length symbols to reach the next symbol, however that is done before adding synthesized symbols, so the test is checking those also. Example: $ perf test -v Symbols 74: Symbols : --- start --- test child forked, pid 154918 Testing /home/user/bin/perf Overlapping symbols: 7d000-7f3a0 g _init 7d030-7d040 g __printf_chk@plt test child finished with -1 ---- end ---- Symbols: FAILED! Note the test fails because perf expands the _init symbol over the PLT because there are no PLT symbols at that point, but then dso__synthesize_plt_symbols() creates them. Signed-off-by: Adrian Hunter <adrian.hunter@intel.com> Tested-by: Arnaldo Carvalho de Melo <acme@redhat.com> Acked-by: Ian Rogers <irogers@google.com> Cc: Jiri Olsa <jolsa@kernel.org> Cc: Namhyung Kim <namhyung@kernel.org> Link: https://lore.kernel.org/r/20230120123456.12449-2-adrian.hunter@intel.com Signed-off-by: Arnaldo Carvalho de Melo <acme@redhat.com>
40 lines
841 B
Plaintext
40 lines
841 B
Plaintext
perf-test(1)
|
|
============
|
|
|
|
NAME
|
|
----
|
|
perf-test - Runs sanity tests.
|
|
|
|
SYNOPSIS
|
|
--------
|
|
[verse]
|
|
'perf test [<options>] [{list <test-name-fragment>|[<test-name-fragments>|<test-numbers>]}]'
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
This command does assorted sanity tests, initially through linked routines but
|
|
also will look for a directory with more tests in the form of scripts.
|
|
|
|
To get a list of available tests use 'perf test list', specifying a test name
|
|
fragment will show all tests that have it.
|
|
|
|
To run just specific tests, inform test name fragments or the numbers obtained
|
|
from 'perf test list'.
|
|
|
|
OPTIONS
|
|
-------
|
|
-s::
|
|
--skip::
|
|
Tests to skip (comma separated numeric list).
|
|
|
|
-v::
|
|
--verbose::
|
|
Be more verbose.
|
|
|
|
-F::
|
|
--dont-fork::
|
|
Do not fork child for each test, run all tests within single process.
|
|
|
|
--dso::
|
|
Specify a DSO for the "Symbols" test.
|