blob: fdb6f5e3a2a428b83a2a1cf06214b9014c1b6023 [file] [log] [blame]
/*
* Copyright (C) 2015 The Android Open Source Project
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
#include <gtest/gtest.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
#include <android-base/file.h>
#include <android-base/logging.h>
#include <android-base/stringprintf.h>
#include <android-base/strings.h>
#if defined(__ANDROID__)
#include <android-base/properties.h>
#endif
#include <map>
#include <memory>
#include <regex>
#include <thread>
#include "command.h"
#include "environment.h"
#include "ETMRecorder.h"
#include "event_selection_set.h"
#include "get_test_data.h"
#include "record.h"
#include "record_file.h"
#include "test_util.h"
#include "thread_tree.h"
using namespace simpleperf;
using namespace PerfFileFormat;
static std::unique_ptr<Command> RecordCmd() {
return CreateCommandInstance("record");
}
static const char* GetDefaultEvent() {
return HasHardwareCounter() ? "cpu-cycles" : "task-clock";
}
static bool RunRecordCmd(std::vector<std::string> v,
const char* output_file = nullptr) {
bool has_event = false;
for (auto& arg : v) {
if (arg == "-e" || arg == "--group") {
has_event = true;
break;
}
}
if (!has_event) {
v.insert(v.end(), {"-e", GetDefaultEvent()});
}
std::unique_ptr<TemporaryFile> tmpfile;
std::string out_file;
if (output_file != nullptr) {
out_file = output_file;
} else {
tmpfile.reset(new TemporaryFile);
out_file = tmpfile->path;
}
v.insert(v.end(), {"-o", out_file, "sleep", SLEEP_SEC});
return RecordCmd()->Run(v);
}
TEST(record_cmd, no_options) {
ASSERT_TRUE(RunRecordCmd({}));
}
TEST(record_cmd, system_wide_option) {
TEST_IN_ROOT(ASSERT_TRUE(RunRecordCmd({"-a"})));
}
void CheckEventType(const std::string& record_file, const std::string& event_type,
uint64_t sample_period, uint64_t sample_freq) {
const EventType* type = FindEventTypeByName(event_type);
ASSERT_TRUE(type != nullptr);
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(record_file);
ASSERT_TRUE(reader);
std::vector<EventAttrWithId> attrs = reader->AttrSection();
for (auto& attr : attrs) {
if (attr.attr->type == type->type && attr.attr->config == type->config) {
if (attr.attr->freq == 0) {
ASSERT_EQ(sample_period, attr.attr->sample_period);
ASSERT_EQ(sample_freq, 0u);
} else {
ASSERT_EQ(sample_period, 0u);
ASSERT_EQ(sample_freq, attr.attr->sample_freq);
}
return;
}
}
FAIL();
}
TEST(record_cmd, sample_period_option) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"-c", "100000"}, tmpfile.path));
CheckEventType(tmpfile.path, GetDefaultEvent(), 100000u, 0);
}
TEST(record_cmd, event_option) {
ASSERT_TRUE(RunRecordCmd({"-e", "cpu-clock"}));
}
TEST(record_cmd, freq_option) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"-f", "99"}, tmpfile.path));
CheckEventType(tmpfile.path, GetDefaultEvent(), 0, 99u);
ASSERT_TRUE(RunRecordCmd({"-e", "cpu-clock", "-f", "99"}, tmpfile.path));
CheckEventType(tmpfile.path, "cpu-clock", 0, 99u);
ASSERT_FALSE(RunRecordCmd({"-f", std::to_string(UINT_MAX)}));
}
TEST(record_cmd, multiple_freq_or_sample_period_option) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"-f", "99", "-e", "task-clock", "-c", "1000000", "-e",
"cpu-clock"}, tmpfile.path));
CheckEventType(tmpfile.path, "task-clock", 0, 99u);
CheckEventType(tmpfile.path, "cpu-clock", 1000000u, 0u);
}
TEST(record_cmd, output_file_option) {
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-o", tmpfile.path, "-e", GetDefaultEvent(), "sleep", SLEEP_SEC}));
}
TEST(record_cmd, dump_kernel_mmap) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader =
RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader != nullptr);
std::vector<std::unique_ptr<Record>> records = reader->DataSection();
ASSERT_GT(records.size(), 0U);
bool have_kernel_mmap = false;
for (auto& record : records) {
if (record->type() == PERF_RECORD_MMAP) {
const MmapRecord* mmap_record =
static_cast<const MmapRecord*>(record.get());
if (strcmp(mmap_record->filename, DEFAULT_KERNEL_MMAP_NAME) == 0 ||
strcmp(mmap_record->filename, DEFAULT_KERNEL_MMAP_NAME_PERF) == 0) {
have_kernel_mmap = true;
break;
}
}
}
ASSERT_TRUE(have_kernel_mmap);
}
TEST(record_cmd, dump_build_id_feature) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader =
RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader != nullptr);
const FileHeader& file_header = reader->FileHeader();
ASSERT_TRUE(file_header.features[FEAT_BUILD_ID / 8] &
(1 << (FEAT_BUILD_ID % 8)));
ASSERT_GT(reader->FeatureSectionDescriptors().size(), 0u);
}
TEST(record_cmd, tracepoint_event) {
TEST_IN_ROOT(ASSERT_TRUE(RunRecordCmd({"-a", "-e", "sched:sched_switch"})));
}
TEST(record_cmd, rN_event) {
TEST_REQUIRE_HW_COUNTER();
OMIT_TEST_ON_NON_NATIVE_ABIS();
size_t event_number;
if (GetBuildArch() == ARCH_ARM64 || GetBuildArch() == ARCH_ARM) {
// As in D5.10.2 of the ARMv8 manual, ARM defines the event number space for PMU. part of the
// space is for common event numbers (which will stay the same for all ARM chips), part of the
// space is for implementation defined events. Here 0x08 is a common event for instructions.
event_number = 0x08;
} else if (GetBuildArch() == ARCH_X86_32 || GetBuildArch() == ARCH_X86_64) {
// As in volume 3 chapter 19 of the Intel manual, 0x00c0 is the event number for instruction.
event_number = 0x00c0;
} else {
GTEST_LOG_(INFO) << "Omit arch " << GetBuildArch();
return;
}
std::string event_name = android::base::StringPrintf("r%zx", event_number);
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"-e", event_name}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
std::vector<EventAttrWithId> attrs = reader->AttrSection();
ASSERT_EQ(1u, attrs.size());
ASSERT_EQ(PERF_TYPE_RAW, attrs[0].attr->type);
ASSERT_EQ(event_number, attrs[0].attr->config);
}
TEST(record_cmd, branch_sampling) {
TEST_REQUIRE_HW_COUNTER();
if (IsBranchSamplingSupported()) {
ASSERT_TRUE(RunRecordCmd({"-b"}));
ASSERT_TRUE(RunRecordCmd({"-j", "any,any_call,any_ret,ind_call"}));
ASSERT_TRUE(RunRecordCmd({"-j", "any,k"}));
ASSERT_TRUE(RunRecordCmd({"-j", "any,u"}));
ASSERT_FALSE(RunRecordCmd({"-j", "u"}));
} else {
GTEST_LOG_(INFO) << "This test does nothing as branch stack sampling is "
"not supported on this device.";
}
}
TEST(record_cmd, event_modifier) {
ASSERT_TRUE(RunRecordCmd({"-e", GetDefaultEvent() + std::string(":u")}));
}
TEST(record_cmd, fp_callchain_sampling) {
ASSERT_TRUE(RunRecordCmd({"--call-graph", "fp"}));
}
TEST(record_cmd, fp_callchain_sampling_warning_on_arm) {
if (GetBuildArch() != ARCH_ARM) {
GTEST_LOG_(INFO) << "This test does nothing as it only tests on arm arch.";
return;
}
ASSERT_EXIT(
{
exit(RunRecordCmd({"--call-graph", "fp"}) ? 0 : 1);
},
testing::ExitedWithCode(0), "doesn't work well on arm");
}
TEST(record_cmd, system_wide_fp_callchain_sampling) {
TEST_IN_ROOT(ASSERT_TRUE(RunRecordCmd({"-a", "--call-graph", "fp"})));
}
bool IsInNativeAbi() {
static int in_native_abi = -1;
if (in_native_abi == -1) {
FILE* fp = popen("uname -m", "re");
char buf[40];
memset(buf, '\0', sizeof(buf));
CHECK_EQ(fgets(buf, sizeof(buf), fp), buf);
pclose(fp);
std::string s = buf;
in_native_abi = 1;
if (GetBuildArch() == ARCH_X86_32 || GetBuildArch() == ARCH_X86_64) {
if (s.find("86") == std::string::npos) {
in_native_abi = 0;
}
} else if (GetBuildArch() == ARCH_ARM || GetBuildArch() == ARCH_ARM64) {
if (s.find("arm") == std::string::npos && s.find("aarch64") == std::string::npos) {
in_native_abi = 0;
}
}
}
return in_native_abi == 1;
}
static bool InCloudAndroid() {
#if defined(__i386__) || defined(__x86_64__)
#if defined(__ANDROID__)
std::string prop_value = android::base::GetProperty("ro.build.flavor", "");
if (android::base::StartsWith(prop_value, "cf_x86_phone") ||
android::base::StartsWith(prop_value, "aosp_cf_x86_phone")) {
return true;
}
#endif
#endif
return false;
}
bool HasTracepointEvents() {
static int has_tracepoint_events = -1;
if (has_tracepoint_events == -1) {
// Cloud Android doesn't support tracepoint events.
has_tracepoint_events = InCloudAndroid() ? 0 : 1;
}
return has_tracepoint_events == 1;
}
bool HasHardwareCounter() {
static int has_hw_counter = -1;
if (has_hw_counter == -1) {
// Cloud Android doesn't have hardware counters.
has_hw_counter = InCloudAndroid() ? 0 : 1;
#if defined(__arm__)
std::string cpu_info;
if (android::base::ReadFileToString("/proc/cpuinfo", &cpu_info)) {
std::string hardware = GetHardwareFromCpuInfo(cpu_info);
if (std::regex_search(hardware, std::regex(R"(i\.MX6.*Quad)")) ||
std::regex_search(hardware, std::regex(R"(SC7731e)")) ||
std::regex_search(hardware, std::regex(R"(Qualcomm Technologies, Inc MSM8909)")) ||
std::regex_search(hardware, std::regex(R"(Broadcom STB \(Flattened Device Tree\))"))) {
has_hw_counter = 0;
}
}
#endif
}
return has_hw_counter == 1;
}
bool HasPmuCounter() {
static int has_pmu_counter = -1;
if (has_pmu_counter == -1) {
has_pmu_counter = 0;
for (auto& event_type : GetAllEventTypes()) {
if (event_type.IsPmuEvent()) {
has_pmu_counter = 1;
break;
}
}
}
return has_pmu_counter == 1;
}
TEST(record_cmd, dwarf_callchain_sampling) {
OMIT_TEST_ON_NON_NATIVE_ABIS();
ASSERT_TRUE(IsDwarfCallChainSamplingSupported());
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
ASSERT_TRUE(RunRecordCmd({"-p", pid, "--call-graph", "dwarf"}));
ASSERT_TRUE(RunRecordCmd({"-p", pid, "--call-graph", "dwarf,16384"}));
ASSERT_FALSE(RunRecordCmd({"-p", pid, "--call-graph", "dwarf,65536"}));
ASSERT_TRUE(RunRecordCmd({"-p", pid, "-g"}));
}
TEST(record_cmd, system_wide_dwarf_callchain_sampling) {
OMIT_TEST_ON_NON_NATIVE_ABIS();
ASSERT_TRUE(IsDwarfCallChainSamplingSupported());
TEST_IN_ROOT(RunRecordCmd({"-a", "--call-graph", "dwarf"}));
}
TEST(record_cmd, no_unwind_option) {
OMIT_TEST_ON_NON_NATIVE_ABIS();
ASSERT_TRUE(IsDwarfCallChainSamplingSupported());
ASSERT_TRUE(RunRecordCmd({"--call-graph", "dwarf", "--no-unwind"}));
ASSERT_FALSE(RunRecordCmd({"--no-unwind"}));
}
TEST(record_cmd, post_unwind_option) {
OMIT_TEST_ON_NON_NATIVE_ABIS();
ASSERT_TRUE(IsDwarfCallChainSamplingSupported());
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
ASSERT_TRUE(RunRecordCmd({"-p", pid, "--call-graph", "dwarf", "--post-unwind"}));
ASSERT_TRUE(RunRecordCmd({"-p", pid, "--call-graph", "dwarf", "--post-unwind=yes"}));
ASSERT_TRUE(RunRecordCmd({"-p", pid, "--call-graph", "dwarf", "--post-unwind=no"}));
}
TEST(record_cmd, existing_processes) {
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(2, &workloads);
std::string pid_list = android::base::StringPrintf(
"%d,%d", workloads[0]->GetPid(), workloads[1]->GetPid());
ASSERT_TRUE(RunRecordCmd({"-p", pid_list}));
}
TEST(record_cmd, existing_threads) {
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(2, &workloads);
// Process id can also be used as thread id in linux.
std::string tid_list = android::base::StringPrintf(
"%d,%d", workloads[0]->GetPid(), workloads[1]->GetPid());
ASSERT_TRUE(RunRecordCmd({"-t", tid_list}));
}
TEST(record_cmd, no_monitored_threads) {
TemporaryFile tmpfile;
ASSERT_FALSE(RecordCmd()->Run({"-o", tmpfile.path}));
ASSERT_FALSE(RecordCmd()->Run({"-o", tmpfile.path, ""}));
}
TEST(record_cmd, more_than_one_event_types) {
ASSERT_TRUE(RunRecordCmd({"-e", "task-clock,cpu-clock"}));
ASSERT_TRUE(RunRecordCmd({"-e", "task-clock", "-e", "cpu-clock"}));
}
TEST(record_cmd, mmap_page_option) {
ASSERT_TRUE(RunRecordCmd({"-m", "1"}));
ASSERT_FALSE(RunRecordCmd({"-m", "0"}));
ASSERT_FALSE(RunRecordCmd({"-m", "7"}));
}
static void CheckKernelSymbol(const std::string& path, bool need_kallsyms,
bool* success) {
*success = false;
std::unique_ptr<RecordFileReader> reader =
RecordFileReader::CreateInstance(path);
ASSERT_TRUE(reader != nullptr);
std::vector<std::unique_ptr<Record>> records = reader->DataSection();
bool has_kernel_symbol_records = false;
for (const auto& record : records) {
if (record->type() == SIMPLE_PERF_RECORD_KERNEL_SYMBOL) {
has_kernel_symbol_records = true;
}
}
bool require_kallsyms = need_kallsyms && CheckKernelSymbolAddresses();
ASSERT_EQ(require_kallsyms, has_kernel_symbol_records);
*success = true;
}
TEST(record_cmd, kernel_symbol) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"--no-dump-symbols"}, tmpfile.path));
bool success;
CheckKernelSymbol(tmpfile.path, true, &success);
ASSERT_TRUE(success);
ASSERT_TRUE(RunRecordCmd({"--no-dump-symbols", "--no-dump-kernel-symbols"}, tmpfile.path));
CheckKernelSymbol(tmpfile.path, false, &success);
ASSERT_TRUE(success);
}
static void ProcessSymbolsInPerfDataFile(
const std::string& perf_data_file,
const std::function<bool(const Symbol&, uint32_t)>& callback) {
auto reader = RecordFileReader::CreateInstance(perf_data_file);
ASSERT_TRUE(reader);
std::string file_path;
uint32_t file_type;
uint64_t min_vaddr;
uint64_t file_offset_of_min_vaddr;
std::vector<Symbol> symbols;
std::vector<uint64_t> dex_file_offsets;
size_t read_pos = 0;
while (reader->ReadFileFeature(read_pos, &file_path, &file_type, &min_vaddr,
&file_offset_of_min_vaddr, &symbols, &dex_file_offsets)) {
for (const auto& symbol : symbols) {
if (callback(symbol, file_type)) {
return;
}
}
}
}
// Check if dumped symbols in perf.data matches our expectation.
static bool CheckDumpedSymbols(const std::string& path, bool allow_dumped_symbols) {
bool has_dumped_symbols = false;
auto callback = [&](const Symbol&, uint32_t) {
has_dumped_symbols = true;
return true;
};
ProcessSymbolsInPerfDataFile(path, callback);
// It is possible that there are no samples hitting functions having symbols.
// So "allow_dumped_symbols = true" doesn't guarantee "has_dumped_symbols = true".
if (!allow_dumped_symbols && has_dumped_symbols) {
return false;
}
return true;
}
TEST(record_cmd, no_dump_symbols) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({}, tmpfile.path));
ASSERT_TRUE(CheckDumpedSymbols(tmpfile.path, true));
ASSERT_TRUE(RunRecordCmd({"--no-dump-symbols", "--no-dump-kernel-symbols"}, tmpfile.path));
ASSERT_TRUE(CheckDumpedSymbols(tmpfile.path, false));
OMIT_TEST_ON_NON_NATIVE_ABIS();
ASSERT_TRUE(IsDwarfCallChainSamplingSupported());
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
ASSERT_TRUE(RunRecordCmd({"-p", pid, "-g"}, tmpfile.path));
ASSERT_TRUE(CheckDumpedSymbols(tmpfile.path, true));
ASSERT_TRUE(RunRecordCmd({"-p", pid, "-g", "--no-dump-symbols", "--no-dump-kernel-symbols"},
tmpfile.path));
ASSERT_TRUE(CheckDumpedSymbols(tmpfile.path, false));
}
TEST(record_cmd, dump_kernel_symbols) {
if (!IsRoot()) {
GTEST_LOG_(INFO) << "Test requires root privilege";
return;
}
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-a", "-o", tmpfile.path, "-e", GetDefaultEvent(), "sleep", "1"}));
bool has_kernel_symbols = false;
auto callback = [&](const Symbol&, uint32_t file_type) {
if (file_type == DSO_KERNEL) {
has_kernel_symbols = true;
}
return has_kernel_symbols;
};
ProcessSymbolsInPerfDataFile(tmpfile.path, callback);
ASSERT_TRUE(has_kernel_symbols);
}
TEST(record_cmd, group_option) {
ASSERT_TRUE(RunRecordCmd({"--group", "task-clock,cpu-clock", "-m", "16"}));
ASSERT_TRUE(RunRecordCmd({"--group", "task-clock,cpu-clock", "--group",
"task-clock:u,cpu-clock:u", "--group",
"task-clock:k,cpu-clock:k", "-m", "16"}));
}
TEST(record_cmd, symfs_option) {
ASSERT_TRUE(RunRecordCmd({"--symfs", "/"}));
}
TEST(record_cmd, duration_option) {
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"--duration", "1.2", "-p", std::to_string(getpid()), "-o",
tmpfile.path, "--in-app", "-e", GetDefaultEvent()}));
ASSERT_TRUE(RecordCmd()->Run(
{"--duration", "1", "-o", tmpfile.path, "-e", GetDefaultEvent(), "sleep", "2"}));
}
TEST(record_cmd, support_modifier_for_clock_events) {
for (const std::string& e : {"cpu-clock", "task-clock"}) {
for (const std::string& m : {"u", "k"}) {
ASSERT_TRUE(RunRecordCmd({"-e", e + ":" + m})) << "event " << e << ":"
<< m;
}
}
}
TEST(record_cmd, handle_SIGHUP) {
TemporaryFile tmpfile;
int pipefd[2];
ASSERT_EQ(0, pipe(pipefd));
int read_fd = pipefd[0];
int write_fd = pipefd[1];
char data[8] = {};
std::thread thread([&]() {
android::base::ReadFully(read_fd, data, 7);
kill(getpid(), SIGHUP);
});
ASSERT_TRUE(
RecordCmd()->Run({"-o", tmpfile.path, "--start_profiling_fd", std::to_string(write_fd), "-e",
GetDefaultEvent(), "sleep", "1000000"}));
thread.join();
close(write_fd);
close(read_fd);
ASSERT_STREQ(data, "STARTED");
}
TEST(record_cmd, stop_when_no_more_targets) {
TemporaryFile tmpfile;
std::atomic<int> tid(0);
std::thread thread([&]() {
tid = gettid();
sleep(1);
});
thread.detach();
while (tid == 0);
ASSERT_TRUE(RecordCmd()->Run(
{"-o", tmpfile.path, "-t", std::to_string(tid), "--in-app", "-e", GetDefaultEvent()}));
}
TEST(record_cmd, donot_stop_when_having_targets) {
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
uint64_t start_time_in_ns = GetSystemClock();
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run(
{"-o", tmpfile.path, "-p", pid, "--duration", "3", "-e", GetDefaultEvent()}));
uint64_t end_time_in_ns = GetSystemClock();
ASSERT_GT(end_time_in_ns - start_time_in_ns, static_cast<uint64_t>(2e9));
}
TEST(record_cmd, start_profiling_fd_option) {
int pipefd[2];
ASSERT_EQ(0, pipe(pipefd));
int read_fd = pipefd[0];
int write_fd = pipefd[1];
ASSERT_EXIT(
{
close(read_fd);
exit(RunRecordCmd({"--start_profiling_fd", std::to_string(write_fd)}) ? 0 : 1);
},
testing::ExitedWithCode(0), "");
close(write_fd);
std::string s;
ASSERT_TRUE(android::base::ReadFdToString(read_fd, &s));
close(read_fd);
ASSERT_EQ("STARTED", s);
}
TEST(record_cmd, record_meta_info_feature) {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
auto& info_map = reader->GetMetaInfoFeature();
ASSERT_NE(info_map.find("simpleperf_version"), info_map.end());
ASSERT_NE(info_map.find("timestamp"), info_map.end());
#if defined(__ANDROID__)
ASSERT_NE(info_map.find("product_props"), info_map.end());
ASSERT_NE(info_map.find("android_version"), info_map.end());
#endif
}
// See http://b/63135835.
TEST(record_cmd, cpu_clock_for_a_long_time) {
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run(
{"-e", "cpu-clock", "-o", tmpfile.path, "-p", pid, "--duration", "3"}));
}
TEST(record_cmd, dump_regs_for_tracepoint_events) {
TEST_REQUIRE_HOST_ROOT();
TEST_REQUIRE_TRACEPOINT_EVENTS();
OMIT_TEST_ON_NON_NATIVE_ABIS();
// Check if the kernel can dump registers for tracepoint events.
// If not, probably a kernel patch below is missing:
// "5b09a094f2 arm64: perf: Fix callchain parse error with kernel tracepoint events"
ASSERT_TRUE(IsDumpingRegsForTracepointEventsSupported());
}
TEST(record_cmd, trace_offcpu_option) {
// On linux host, we need root privilege to read tracepoint events.
TEST_REQUIRE_HOST_ROOT();
TEST_REQUIRE_TRACEPOINT_EVENTS();
OMIT_TEST_ON_NON_NATIVE_ABIS();
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"--trace-offcpu", "-f", "1000"}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
auto info_map = reader->GetMetaInfoFeature();
ASSERT_EQ(info_map["trace_offcpu"], "true");
CheckEventType(tmpfile.path, "sched:sched_switch", 1u, 0u);
}
TEST(record_cmd, exit_with_parent_option) {
ASSERT_TRUE(RunRecordCmd({"--exit-with-parent"}));
}
TEST(record_cmd, clockid_option) {
if (!IsSettingClockIdSupported()) {
ASSERT_FALSE(RunRecordCmd({"--clockid", "monotonic"}));
} else {
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"--clockid", "monotonic"}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
auto info_map = reader->GetMetaInfoFeature();
ASSERT_EQ(info_map["clockid"], "monotonic");
}
}
TEST(record_cmd, generate_samples_by_hw_counters) {
TEST_REQUIRE_HW_COUNTER();
std::vector<std::string> events = {"cpu-cycles", "instructions"};
for (auto& event : events) {
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-e", event, "-o", tmpfile.path, "sleep", "1"}));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
bool has_sample = false;
ASSERT_TRUE(reader->ReadDataSection([&](std::unique_ptr<Record> r) {
if (r->type() == PERF_RECORD_SAMPLE) {
has_sample = true;
}
return true;
}));
ASSERT_TRUE(has_sample);
}
}
TEST(record_cmd, callchain_joiner_options) {
ASSERT_TRUE(RunRecordCmd({"--no-callchain-joiner"}));
ASSERT_TRUE(RunRecordCmd({"--callchain-joiner-min-matching-nodes", "2"}));
}
TEST(record_cmd, dashdash) {
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-o", tmpfile.path, "-e", GetDefaultEvent(), "--", "sleep", "1"}));
}
TEST(record_cmd, size_limit_option) {
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-o", tmpfile.path, "-p", pid, "--size-limit", "1k", "--duration",
"1", "-e", GetDefaultEvent()}));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
ASSERT_GT(reader->FileHeader().data.size, 1000u);
ASSERT_LT(reader->FileHeader().data.size, 2000u);
ASSERT_FALSE(RunRecordCmd({"--size-limit", "0"}));
}
TEST(record_cmd, support_mmap2) {
// mmap2 is supported in kernel >= 3.16. If not supported, please cherry pick below kernel
// patches:
// 13d7a2410fa637 perf: Add attr->mmap2 attribute to an event
// f972eb63b1003f perf: Pass protection and flags bits through mmap2 interface.
ASSERT_TRUE(IsMmap2Supported());
}
TEST(record_cmd, kernel_bug_making_zero_dyn_size) {
// Test a kernel bug that makes zero dyn_size in kernel < 3.13. If it fails, please cherry pick
// below kernel patch: 0a196848ca365e perf: Fix arch_perf_out_copy_user default
OMIT_TEST_ON_NON_NATIVE_ABIS();
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-o", tmpfile.path, "-p", pid, "--call-graph", "dwarf,8",
"--no-unwind", "--duration", "1", "-e", GetDefaultEvent()}));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
bool has_sample = false;
ASSERT_TRUE(reader->ReadDataSection([&](std::unique_ptr<Record> r) {
if (r->type() == PERF_RECORD_SAMPLE && !r->InKernel()) {
SampleRecord* sr = static_cast<SampleRecord*>(r.get());
if (sr->stack_user_data.dyn_size == 0) {
return false;
}
has_sample = true;
}
return true;
}));
ASSERT_TRUE(has_sample);
}
TEST(record_cmd, kernel_bug_making_zero_dyn_size_for_kernel_samples) {
// Test a kernel bug that makes zero dyn_size for syscalls of 32-bit applications in 64-bit
// kernels. If it fails, please cherry pick below kernel patch:
// 02e184476eff8 perf/core: Force USER_DS when recording user stack data
OMIT_TEST_ON_NON_NATIVE_ABIS();
TEST_REQUIRE_HOST_ROOT();
TEST_REQUIRE_TRACEPOINT_EVENTS();
std::vector<std::unique_ptr<Workload>> workloads;
CreateProcesses(1, &workloads);
std::string pid = std::to_string(workloads[0]->GetPid());
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run({"-e", "sched:sched_switch", "-o", tmpfile.path, "-p", pid,
"--call-graph", "dwarf,8", "--no-unwind", "--duration", "1"}));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
bool has_sample = false;
ASSERT_TRUE(reader->ReadDataSection([&](std::unique_ptr<Record> r) {
if (r->type() == PERF_RECORD_SAMPLE && r->InKernel()) {
SampleRecord* sr = static_cast<SampleRecord*>(r.get());
if (sr->stack_user_data.dyn_size == 0) {
return false;
}
has_sample = true;
}
return true;
}));
ASSERT_TRUE(has_sample);
}
TEST(record_cmd, cpu_percent_option) {
ASSERT_TRUE(RunRecordCmd({"--cpu-percent", "50"}));
ASSERT_FALSE(RunRecordCmd({"--cpu-percent", "0"}));
ASSERT_FALSE(RunRecordCmd({"--cpu-percent", "101"}));
}
class RecordingAppHelper {
public:
bool InstallApk(const std::string& apk_path, const std::string& package_name) {
return app_helper_.InstallApk(apk_path, package_name);
}
bool StartApp(const std::string& start_cmd) {
return app_helper_.StartApp(start_cmd);
}
bool RecordData(const std::string& record_cmd) {
std::vector<std::string> args = android::base::Split(record_cmd, " ");
args.emplace_back("-o");
args.emplace_back(perf_data_file_.path);
return RecordCmd()->Run(args);
}
bool CheckData(const std::function<bool(const char*)>& process_symbol) {
bool success = false;
auto callback = [&](const Symbol& symbol, uint32_t) {
if (process_symbol(symbol.DemangledName())) {
success = true;
}
return success;
};
ProcessSymbolsInPerfDataFile(perf_data_file_.path, callback);
return success;
}
private:
AppHelper app_helper_;
TemporaryFile perf_data_file_;
};
static void TestRecordingApps(const std::string& app_name) {
RecordingAppHelper helper;
// Bring the app to foreground to avoid no samples.
ASSERT_TRUE(helper.StartApp("am start " + app_name + "/.MainActivity"));
ASSERT_TRUE(helper.RecordData("--app " + app_name + " -g --duration 3 -e " + GetDefaultEvent()));
// Check if we can profile Java code by looking for a Java method name in dumped symbols, which
// is app_name + ".MainActivity$1.run".
const std::string expected_class_name = app_name + ".MainActivity";
const std::string expected_method_name = "run";
auto process_symbol = [&](const char* name) {
return strstr(name, expected_class_name.c_str()) != nullptr &&
strstr(name, expected_method_name.c_str()) != nullptr;
};
ASSERT_TRUE(helper.CheckData(process_symbol));
}
TEST(record_cmd, app_option_for_debuggable_app) {
TEST_REQUIRE_APPS();
SetRunInAppToolForTesting(true, false);
TestRecordingApps("com.android.simpleperf.debuggable");
SetRunInAppToolForTesting(false, true);
TestRecordingApps("com.android.simpleperf.debuggable");
}
TEST(record_cmd, app_option_for_profileable_app) {
TEST_REQUIRE_APPS();
SetRunInAppToolForTesting(false, true);
TestRecordingApps("com.android.simpleperf.profileable");
}
TEST(record_cmd, record_java_app) {
#if defined(__ANDROID__)
RecordingAppHelper helper;
// 1. Install apk.
ASSERT_TRUE(helper.InstallApk(GetTestData("DisplayBitmaps.apk"),
"com.example.android.displayingbitmaps"));
ASSERT_TRUE(helper.InstallApk(GetTestData("DisplayBitmapsTest.apk"),
"com.example.android.displayingbitmaps.test"));
// 2. Start the app.
ASSERT_TRUE(
helper.StartApp("am instrument -w -r -e debug false -e class "
"com.example.android.displayingbitmaps.tests.GridViewTest "
"com.example.android.displayingbitmaps.test/"
"androidx.test.runner.AndroidJUnitRunner"));
// 3. Record perf.data.
SetRunInAppToolForTesting(true, true);
ASSERT_TRUE(helper.RecordData(
"-e cpu-clock --app com.example.android.displayingbitmaps -g --duration 10"));
// 4. Check perf.data.
auto process_symbol = [&](const char* name) {
#if !defined(IN_CTS_TEST)
const char* expected_name_with_keyguard = "androidx.test.runner"; // when screen is locked
if (strstr(name, expected_name_with_keyguard) != nullptr) {
return true;
}
#endif
const char* expected_name = "androidx.test.espresso"; // when screen stays awake
return strstr(name, expected_name) != nullptr;
};
ASSERT_TRUE(helper.CheckData(process_symbol));
#else
GTEST_LOG_(INFO) << "This test tests a function only available on Android.";
#endif
}
TEST(record_cmd, record_native_app) {
#if defined(__ANDROID__)
// In case of non-native ABI guest symbols are never directly executed, thus
// don't appear in perf.data. Instead binary translator executes code
// translated from guest at runtime.
OMIT_TEST_ON_NON_NATIVE_ABIS();
RecordingAppHelper helper;
// 1. Install apk.
ASSERT_TRUE(helper.InstallApk(GetTestData("EndlessTunnel.apk"), "com.google.sample.tunnel"));
// 2. Start the app.
ASSERT_TRUE(
helper.StartApp("am start -n com.google.sample.tunnel/android.app.NativeActivity -a "
"android.intent.action.MAIN -c android.intent.category.LAUNCHER"));
// 3. Record perf.data.
SetRunInAppToolForTesting(true, true);
ASSERT_TRUE(helper.RecordData("-e cpu-clock --app com.google.sample.tunnel -g --duration 10"));
// 4. Check perf.data.
auto process_symbol = [&](const char* name) {
const char* expected_name_with_keyguard = "NativeActivity"; // when screen is locked
if (strstr(name, expected_name_with_keyguard) != nullptr) {
return true;
}
const char* expected_name = "PlayScene::DoFrame"; // when screen is awake
return strstr(name, expected_name) != nullptr;
};
ASSERT_TRUE(helper.CheckData(process_symbol));
#else
GTEST_LOG_(INFO) << "This test tests a function only available on Android.";
#endif
}
TEST(record_cmd, no_cut_samples_option) {
ASSERT_TRUE(RunRecordCmd({"--no-cut-samples"}));
}
TEST(record_cmd, cs_etm_event) {
if (!ETMRecorder::GetInstance().CheckEtmSupport()) {
GTEST_LOG_(INFO) << "Omit this test since etm isn't supported on this device";
return;
}
TemporaryFile tmpfile;
ASSERT_TRUE(RunRecordCmd({"-e", "cs-etm"}, tmpfile.path));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
// cs-etm uses sample period instead of sample freq.
ASSERT_EQ(reader->AttrSection().size(), 1u);
const perf_event_attr* attr = reader->AttrSection()[0].attr;
ASSERT_EQ(attr->freq, 0);
ASSERT_EQ(attr->sample_period, 1);
bool has_auxtrace_info = false;
bool has_auxtrace = false;
bool has_aux = false;
ASSERT_TRUE(reader->ReadDataSection([&](std::unique_ptr<Record> r) {
if (r->type() == PERF_RECORD_AUXTRACE_INFO) {
has_auxtrace_info = true;
} else if (r->type() == PERF_RECORD_AUXTRACE) {
has_auxtrace = true;
} else if (r->type() == PERF_RECORD_AUX) {
has_aux = true;
}
return true;
}));
ASSERT_TRUE(has_auxtrace_info);
ASSERT_TRUE(has_auxtrace);
ASSERT_TRUE(has_aux);
}
TEST(record_cmd, aux_buffer_size_option) {
if (!ETMRecorder::GetInstance().CheckEtmSupport()) {
GTEST_LOG_(INFO) << "Omit this test since etm isn't supported on this device";
return;
}
ASSERT_TRUE(RunRecordCmd({"-e", "cs-etm", "--aux-buffer-size", "1m"}));
// not page size aligned
ASSERT_FALSE(RunRecordCmd({"-e", "cs-etm", "--aux-buffer-size", "1024"}));
// not power of two
ASSERT_FALSE(RunRecordCmd({"-e", "cs-etm", "--aux-buffer-size", "12k"}));
}
TEST(record_cmd, include_filter_option) {
TEST_REQUIRE_HW_COUNTER();
if (!ETMRecorder::GetInstance().CheckEtmSupport()) {
GTEST_LOG_(INFO) << "Omit this test since etm isn't supported on this device";
return;
}
FILE* fp = popen("which sleep", "r");
ASSERT_TRUE(fp != nullptr);
std::string path;
ASSERT_TRUE(android::base::ReadFdToString(fileno(fp), &path));
pclose(fp);
path = android::base::Trim(path);
std::string sleep_exec_path;
ASSERT_TRUE(android::base::Realpath(path, &sleep_exec_path));
// --include-filter doesn't apply to cpu-cycles.
ASSERT_FALSE(RunRecordCmd({"--include-filter", sleep_exec_path}));
TemporaryFile record_file;
ASSERT_TRUE(
RunRecordCmd({"-e", "cs-etm", "--include-filter", sleep_exec_path}, record_file.path));
TemporaryFile inject_file;
ASSERT_TRUE(
CreateCommandInstance("inject")->Run({"-i", record_file.path, "-o", inject_file.path}));
std::string data;
ASSERT_TRUE(android::base::ReadFileToString(inject_file.path, &data));
// Only instructions in sleep_exec_path are traced.
for (auto& line : android::base::Split(data, "\n")) {
if (android::base::StartsWith(line, "dso ")) {
std::string dso = line.substr(strlen("dso "), sleep_exec_path.size());
ASSERT_EQ(dso, sleep_exec_path);
}
}
}
TEST(record_cmd, pmu_event_option) {
TEST_REQUIRE_PMU_COUNTER();
TEST_REQUIRE_HW_COUNTER();
std::string event_string;
if (GetBuildArch() == ARCH_X86_64) {
event_string = "cpu/cpu-cycles/";
} else if (GetBuildArch() == ARCH_ARM64) {
event_string = "armv8_pmuv3/cpu_cycles/";
} else {
GTEST_LOG_(INFO) << "Omit arch " << GetBuildArch();
return;
}
TEST_IN_ROOT(ASSERT_TRUE(RunRecordCmd({"-e", event_string})));
}
TEST(record_cmd, exclude_perf_option) {
ASSERT_TRUE(RunRecordCmd({"--exclude-perf"}));
if (IsRoot()) {
TemporaryFile tmpfile;
ASSERT_TRUE(RecordCmd()->Run(
{"-a", "--exclude-perf", "--duration", "1", "-e", GetDefaultEvent(), "-o", tmpfile.path}));
std::unique_ptr<RecordFileReader> reader = RecordFileReader::CreateInstance(tmpfile.path);
ASSERT_TRUE(reader);
pid_t perf_pid = getpid();
ASSERT_TRUE(reader->ReadDataSection([&](std::unique_ptr<Record> r) {
if (r->type() == PERF_RECORD_SAMPLE) {
if (static_cast<SampleRecord*>(r.get())->tid_data.pid == perf_pid) {
return false;
}
}
return true;
}));
}
}