/*
* 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 <stdio.h>
#include <map>
#include <string>
#include <vector>
#include <android-base/logging.h>
#include <android-base/test_utils.h>
#include "command.h"
#include "environment.h"
#include "event_attr.h"
#include "event_fd.h"
#include "event_selection_set.h"
#include "event_type.h"
static bool IsEventTypeSupported(const EventType& event_type) {
if (event_type.type != PERF_TYPE_RAW) {
perf_event_attr attr = CreateDefaultPerfEventAttr(event_type);
// Exclude kernel to list supported events even when
// /proc/sys/kernel/perf_event_paranoid is 2.
attr.exclude_kernel = 1;
return IsEventAttrSupported(attr);
}
if (event_type.limited_arch == "arm" && GetBuildArch() != ARCH_ARM &&
GetBuildArch() != ARCH_ARM64) {
return false;
}
// Because the kernel may not check whether the raw event is supported by the cpu pmu.
// We can't decide whether the raw event is supported by calling perf_event_open().
// Instead, we can check if it can collect some real number.
perf_event_attr attr = CreateDefaultPerfEventAttr(event_type);
std::unique_ptr<EventFd> event_fd = EventFd::OpenEventFile(attr, gettid(), -1, nullptr);
if (event_fd == nullptr) {
return false;
}
auto work_function = []() {
TemporaryFile tmpfile;
FILE* fp = fopen(tmpfile.path, "w");
if (fp == nullptr) {
return;
}
for (int i = 0; i < 10; ++i) {
fprintf(fp, "output some data\n");
}
fclose(fp);
};
work_function();
PerfCounter counter;
if (!event_fd->ReadCounter(&counter)) {
return false;
}
return (counter.value != 0u);
}
static void PrintEventTypesOfType(uint32_t type, const std::string& type_name,
const std::vector<EventType>& event_types) {
printf("List of %s:\n", type_name.c_str());
if (type == PERF_TYPE_RAW && (GetBuildArch() == ARCH_ARM || GetBuildArch() == ARCH_ARM64)) {
printf(" # Please refer to PMU event numbers listed in ARMv8 manual for details.\n");
printf(" # A possible link is https://developer.arm.com/docs/ddi0487/latest/arm-architecture-reference-manual-armv8-for-armv8-a-architecture-profile.\n");
}
for (auto& event_type : event_types) {
if (event_type.type == type) {
if (IsEventTypeSupported(event_type)) {
printf(" %s", event_type.name.c_str());
if (!event_type.description.empty()) {
printf("\t\t# %s", event_type.description.c_str());
}
printf("\n");
}
}
}
printf("\n");
}
class ListCommand : public Command {
public:
ListCommand()
: Command("list", "list available event types",
// clang-format off
"Usage: simpleperf list [options] [hw|sw|cache|raw|tracepoint]\n"
" List all available event types.\n"
" Filters can be used to show only event types belong to selected types:\n"
" hw hardware events\n"
" sw software events\n"
" cache hardware cache events\n"
" raw raw pmu events\n"
" tracepoint tracepoint events\n"
"Options:\n"
"--show-features Show features supported on the device, including:\n"
" dwarf-based-call-graph\n"
" trace-offcpu\n"
// clang-format on
) {
}
bool Run(const std::vector<std::string>& args) override;
private:
void ShowFeatures();
};
bool ListCommand::Run(const std::vector<std::string>& args) {
if (!CheckPerfEventLimit()) {
return false;
}
static std::map<std::string, std::pair<int, std::string>> type_map = {
{"hw", {PERF_TYPE_HARDWARE, "hardware events"}},
{"sw", {PERF_TYPE_SOFTWARE, "software events"}},
{"cache", {PERF_TYPE_HW_CACHE, "hw-cache events"}},
{"raw", {PERF_TYPE_RAW, "raw events provided by cpu pmu"}},
{"tracepoint", {PERF_TYPE_TRACEPOINT, "tracepoint events"}},
{"user-space-sampler", {SIMPLEPERF_TYPE_USER_SPACE_SAMPLERS, "user-space samplers"}},
};
std::vector<std::string> names;
if (args.empty()) {
for (auto& item : type_map) {
names.push_back(item.first);
}
} else {
for (auto& arg : args) {
if (type_map.find(arg) != type_map.end()) {
names.push_back(arg);
} else if (arg == "--show-features") {
ShowFeatures();
return true;
} else {
LOG(ERROR) << "unknown event type category: " << arg << ", try using \"help list\"";
return false;
}
}
}
auto& event_types = GetAllEventTypes();
for (auto& name : names) {
auto it = type_map.find(name);
PrintEventTypesOfType(it->second.first, it->second.second, event_types);
}
return true;
}
void ListCommand::ShowFeatures() {
if (IsDwarfCallChainSamplingSupported()) {
printf("dwarf-based-call-graph\n");
}
if (IsDumpingRegsForTracepointEventsSupported()) {
printf("trace-offcpu\n");
}
if (IsSettingClockIdSupported()) {
printf("set-clockid\n");
}
}
void RegisterListCommand() {
RegisterCommand("list", [] { return std::unique_ptr<Command>(new ListCommand); });
}