Home | History | Annotate | Download | only in simpleperf
      1 /*
      2  * Copyright (C) 2015 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 
     17 #include "event_attr.h"
     18 
     19 #include <inttypes.h>
     20 #include <stdio.h>
     21 #include <string>
     22 #include <unordered_map>
     23 
     24 #include <android-base/logging.h>
     25 
     26 #include "environment.h"
     27 #include "event_type.h"
     28 #include "utils.h"
     29 
     30 static std::string BitsToString(const std::string& name, uint64_t bits,
     31                                 const std::vector<std::pair<int, std::string>>& bit_names) {
     32   std::string result;
     33   for (auto& p : bit_names) {
     34     if (bits & p.first) {
     35       bits &= ~p.first;
     36       if (!result.empty()) {
     37         result += ", ";
     38       }
     39       result += p.second;
     40     }
     41   }
     42   if (bits != 0) {
     43     LOG(DEBUG) << "unknown " << name << " bits: " << std::hex << bits;
     44   }
     45   return result;
     46 }
     47 
     48 static std::string SampleTypeToString(uint64_t sample_type) {
     49   static std::vector<std::pair<int, std::string>> sample_type_names = {
     50       {PERF_SAMPLE_ADDR, "addr"},
     51       {PERF_SAMPLE_BRANCH_STACK, "branch_stack"},
     52       {PERF_SAMPLE_CALLCHAIN, "callchain"},
     53       {PERF_SAMPLE_CPU, "cpu"},
     54       {PERF_SAMPLE_ID, "id"},
     55       {PERF_SAMPLE_IP, "ip"},
     56       {PERF_SAMPLE_PERIOD, "period"},
     57       {PERF_SAMPLE_RAW, "raw"},
     58       {PERF_SAMPLE_READ, "read"},
     59       {PERF_SAMPLE_REGS_USER, "regs_user"},
     60       {PERF_SAMPLE_STACK_USER, "stack_user"},
     61       {PERF_SAMPLE_STREAM_ID, "stream_id"},
     62       {PERF_SAMPLE_TID, "tid"},
     63       {PERF_SAMPLE_TIME, "time"},
     64   };
     65   return BitsToString("sample_type", sample_type, sample_type_names);
     66 }
     67 
     68 static std::string ReadFormatToString(uint64_t read_format) {
     69   static std::vector<std::pair<int, std::string>> read_format_names = {
     70       {PERF_FORMAT_TOTAL_TIME_ENABLED, "total_time_enabled"},
     71       {PERF_FORMAT_TOTAL_TIME_RUNNING, "total_time_running"},
     72       {PERF_FORMAT_ID, "id"},
     73       {PERF_FORMAT_GROUP, "group"},
     74   };
     75   return BitsToString("read_format", read_format, read_format_names);
     76 }
     77 
     78 perf_event_attr CreateDefaultPerfEventAttr(const EventType& event_type) {
     79   perf_event_attr attr;
     80   memset(&attr, 0, sizeof(attr));
     81   attr.size = sizeof(perf_event_attr);
     82   attr.type = event_type.type;
     83   attr.config = event_type.config;
     84   attr.mmap = 1;
     85   attr.comm = 1;
     86   attr.disabled = 0;
     87   // Changing read_format affects the layout of the data read from perf_event_file, namely
     88   // PerfCounter in event_fd.h.
     89   attr.read_format =
     90       PERF_FORMAT_TOTAL_TIME_ENABLED | PERF_FORMAT_TOTAL_TIME_RUNNING | PERF_FORMAT_ID;
     91   attr.sample_type |= PERF_SAMPLE_IP | PERF_SAMPLE_TID | PERF_SAMPLE_TIME | PERF_SAMPLE_PERIOD |
     92       PERF_SAMPLE_CPU | PERF_SAMPLE_ID;
     93 
     94   if (attr.type == PERF_TYPE_TRACEPOINT) {
     95     // Tracepoint information are stored in raw data in sample records.
     96     if (CanRecordRawData()) {
     97       attr.sample_type |= PERF_SAMPLE_RAW;
     98     }
     99   }
    100   return attr;
    101 }
    102 
    103 void DumpPerfEventAttr(const perf_event_attr& attr, size_t indent) {
    104   std::string event_name = GetEventNameByAttr(attr);
    105   PrintIndented(indent, "event_attr: for event type %s\n", event_name.c_str());
    106 
    107   PrintIndented(indent + 1, "type %u, size %u, config %llu\n", attr.type, attr.size, attr.config);
    108 
    109   if (attr.freq != 0) {
    110     PrintIndented(indent + 1, "sample_freq %llu\n", attr.sample_freq);
    111   } else {
    112     PrintIndented(indent + 1, "sample_period %llu\n", attr.sample_period);
    113   }
    114 
    115   PrintIndented(indent + 1, "sample_type (0x%llx) %s\n", attr.sample_type,
    116                 SampleTypeToString(attr.sample_type).c_str());
    117 
    118   PrintIndented(indent + 1, "read_format (0x%llx) %s\n", attr.read_format,
    119                 ReadFormatToString(attr.read_format).c_str());
    120 
    121   PrintIndented(indent + 1, "disabled %u, inherit %u, pinned %u, exclusive %u\n", attr.disabled,
    122                 attr.inherit, attr.pinned, attr.exclusive);
    123 
    124   PrintIndented(indent + 1, "exclude_user %u, exclude_kernel %u, exclude_hv %u\n",
    125                 attr.exclude_user, attr.exclude_kernel, attr.exclude_hv);
    126 
    127   PrintIndented(indent + 1, "exclude_idle %u, mmap %u, comm %u, freq %u\n", attr.exclude_idle,
    128                 attr.mmap, attr.comm, attr.freq);
    129 
    130   PrintIndented(indent + 1, "inherit_stat %u, enable_on_exec %u, task %u\n", attr.inherit_stat,
    131                 attr.enable_on_exec, attr.task);
    132 
    133   PrintIndented(indent + 1, "watermark %u, precise_ip %u, mmap_data %u\n", attr.watermark,
    134                 attr.precise_ip, attr.mmap_data);
    135 
    136   PrintIndented(indent + 1, "sample_id_all %u, exclude_host %u, exclude_guest %u\n",
    137                 attr.sample_id_all, attr.exclude_host, attr.exclude_guest);
    138   PrintIndented(indent + 1, "branch_sample_type 0x%" PRIx64 "\n", attr.branch_sample_type);
    139   PrintIndented(indent + 1, "exclude_callchain_kernel %u, exclude_callchain_user %u\n",
    140                 attr.exclude_callchain_kernel, attr.exclude_callchain_user);
    141   PrintIndented(indent + 1, "sample_regs_user 0x%" PRIx64 "\n", attr.sample_regs_user);
    142   PrintIndented(indent + 1, "sample_stack_user 0x%" PRIx64 "\n", attr.sample_stack_user);
    143 }
    144 
    145 bool GetCommonEventIdPositionsForAttrs(std::vector<perf_event_attr>& attrs,
    146                                            size_t* event_id_pos_in_sample_records,
    147                                            size_t* event_id_reverse_pos_in_non_sample_records) {
    148   // When there are more than one perf_event_attrs, we need to read event id
    149   // in each record to decide current record should use which attr. So
    150   // we need to determine the event id position in a record here.
    151   std::vector<uint64_t> sample_types;
    152   for (const auto& attr : attrs) {
    153     sample_types.push_back(attr.sample_type);
    154   }
    155   // First determine event_id_pos_in_sample_records.
    156   // If PERF_SAMPLE_IDENTIFIER is enabled, it is just after perf_event_header.
    157   // If PERF_SAMPLE_ID is enabled, then PERF_SAMPLE_IDENTIFIER | IP | TID | TIME | ADDR
    158   // should also be the same.
    159   bool identifier_enabled = true;
    160   bool id_enabled = true;
    161   uint64_t flags_before_id_mask = PERF_SAMPLE_IDENTIFIER | PERF_SAMPLE_IP | PERF_SAMPLE_TID |
    162       PERF_SAMPLE_TIME | PERF_SAMPLE_ADDR;
    163   uint64_t flags_before_id = sample_types[0] & flags_before_id_mask;
    164   bool flags_before_id_are_the_same = true;
    165   for (auto type : sample_types) {
    166     identifier_enabled &= (type & PERF_SAMPLE_IDENTIFIER) != 0;
    167     id_enabled &= (type & PERF_SAMPLE_ID) != 0;
    168     flags_before_id_are_the_same &= (type & flags_before_id_mask) == flags_before_id;
    169   }
    170   if (identifier_enabled) {
    171     *event_id_pos_in_sample_records = sizeof(perf_event_header);
    172   } else if (id_enabled && flags_before_id_are_the_same) {
    173     uint64_t pos = sizeof(perf_event_header);
    174     while (flags_before_id != 0) {
    175       // Each flags takes 8 bytes in sample records.
    176       flags_before_id &= flags_before_id - 1;
    177       pos += 8;
    178     }
    179     *event_id_pos_in_sample_records = pos;
    180   } else {
    181     LOG(ERROR) << "perf_event_attrs don't have a common event id position in sample records";
    182     return false;
    183   }
    184 
    185   // Secondly determine event_id_reverse_pos_in_non_sample_record.
    186   // If sample_id_all is not enabled, there is no event id in non sample records.
    187   // If PERF_SAMPLE_IDENTIFIER is enabled, it is at the last 8 bytes of the record.
    188   // If PERF_SAMPLE_ID is enabled, then PERF_SAMPLE_IDENTIFIER | CPU | STREAM_ID should
    189   // also be the same.
    190   bool sample_id_all_enabled = true;
    191   for (const auto& attr : attrs) {
    192     if (attr.sample_id_all == 0) {
    193       sample_id_all_enabled = false;
    194     }
    195   }
    196   if (!sample_id_all_enabled) {
    197     LOG(ERROR) << "there are perf_event_attrs not enabling sample_id_all, so can't determine "
    198                << "perf_event_attr for non sample records";
    199     return false;
    200   }
    201   uint64_t flags_after_id_mask = PERF_SAMPLE_IDENTIFIER | PERF_SAMPLE_CPU | PERF_SAMPLE_STREAM_ID;
    202   uint64_t flags_after_id = sample_types[0] & flags_after_id_mask;
    203   bool flags_after_id_are_the_same = true;
    204   for (auto type : sample_types) {
    205     flags_after_id_are_the_same &= (type & flags_after_id_mask) == flags_after_id;
    206   }
    207   if (identifier_enabled) {
    208     *event_id_reverse_pos_in_non_sample_records = 8;
    209   } else if (id_enabled && flags_after_id_are_the_same) {
    210     uint64_t pos = 8;
    211     while (flags_after_id != 0) {
    212       // Each flag takes 8 bytes in sample_id of non sample records.
    213       flags_after_id &= flags_after_id - 1;
    214       pos += 8;
    215     }
    216     *event_id_reverse_pos_in_non_sample_records = pos;
    217   } else {
    218     LOG(ERROR) << "perf_event_attrs don't have a common event id reverse position in non sample records";
    219     return false;
    220   }
    221   return true;
    222 }
    223 
    224 bool IsTimestampSupported(const perf_event_attr& attr) {
    225   return attr.sample_id_all && (attr.sample_type & PERF_SAMPLE_TIME);
    226 }
    227 
    228 bool IsCpuSupported(const perf_event_attr& attr) {
    229   return attr.sample_id_all && (attr.sample_type & PERF_SAMPLE_CPU);
    230 }
    231 
    232 std::string GetEventNameByAttr(const perf_event_attr& attr) {
    233   for (const auto& event_type : GetAllEventTypes()) {
    234     if (event_type.type == attr.type && event_type.config == attr.config) {
    235       std::string name = event_type.name;
    236       if (attr.exclude_user && !attr.exclude_kernel) {
    237         name += ":k";
    238       } else if (attr.exclude_kernel && !attr.exclude_user) {
    239         name += ":u";
    240       }
    241       return name;
    242     }
    243   }
    244   return "unknown";
    245 }
    246