blob: 1c9c3a9746cecb7b0b82a25a52cff73b3beaa92f [file] [log] [blame]
// Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include <stdint.h>
#include <map>
#include <set>
#include <string>
#include <vector>
#include "base/macros.h"
#include "chromiumos-wide-profiling/kernel/perf_internals.h"
#include "chromiumos-wide-profiling/quipper_string.h"
#include "chromiumos-wide-profiling/utils.h"
namespace quipper {
// This is becoming more like a partial struct perf_evsel
struct PerfFileAttr {
struct perf_event_attr attr;
string name;
std::vector<u64> ids;
// Based on code in tools/perf/util/header.c, the metadata are of the following
// formats:
// Based on kernel/perf_internals.h
const size_t kBuildIDArraySize = 20;
const size_t kBuildIDStringLength = kBuildIDArraySize * 2;
struct CStringWithLength {
u32 len;
string str;
struct PerfStringMetadata {
u32 type;
std::vector<CStringWithLength> data;
struct PerfUint32Metadata {
u32 type;
std::vector<uint32_t> data;
struct PerfUint64Metadata {
u32 type;
std::vector<uint64_t> data;
typedef u32 num_siblings_type;
struct PerfCPUTopologyMetadata {
std::vector<CStringWithLength> core_siblings;
std::vector<CStringWithLength> thread_siblings;
struct PerfNodeTopologyMetadata {
u32 id;
u64 total_memory;
u64 free_memory;
CStringWithLength cpu_list;
struct BufferWithSize;
struct ConstBufferWithSize;
class PerfReader {
PerfReader() : sample_type_(0),
is_cross_endian_(0) {}
// Makes |build_id| fit the perf format, by either truncating it or adding
// zeros to the end so that it has length kBuildIDStringLength.
static void PerfizeBuildIDString(string* build_id);
// Changes |build_id| to the best guess of what the build id was before going
// through perf. Specifically, it keeps removing trailing sequences of four
// zero bytes (or eight '0' characters) until there are no more such
// sequences, or the build id would be empty if the process were repeated.
static void UnperfizeBuildIDString(string* build_id);
bool ReadFile(const string& filename);
bool ReadFromVector(const std::vector<char>& data);
bool ReadFromString(const string& str);
bool ReadFromPointer(const char* perf_data, size_t size);
// TODO(rohinmshah): GetSize should not use RegenerateHeader (so that it can
// be const). Ideally, RegenerateHeader would be deleted and instead of
// having out_header_ as an instance variable, it would be computed
// dynamically whenever needed.
// Returns the size in bytes that would be written by any of the methods that
// write the entire perf data file (WriteFile, WriteToPointer, etc).
size_t GetSize();
bool WriteFile(const string& filename);
bool WriteToVector(std::vector<char>* data);
bool WriteToString(string* str);
bool WriteToPointer(char* buffer, size_t size);
bool RegenerateHeader();
// Stores the mapping from filenames to build ids in build_id_events_.
// Returns true on success.
// Note: If |filenames_to_build_ids| contains a mapping for a filename for
// which there is already a build_id_event in build_id_events_, a duplicate
// build_id_event will be created, and the old build_id_event will NOT be
// deleted.
bool InjectBuildIDs(const std::map<string, string>& filenames_to_build_ids);
// Replaces existing filenames with filenames from |build_ids_to_filenames|
// by joining on build ids. If a build id in |build_ids_to_filenames| is not
// present in this parser, it is ignored.
bool Localize(const std::map<string, string>& build_ids_to_filenames);
// Same as Localize, but joins on filenames instead of build ids.
bool LocalizeUsingFilenames(const std::map<string, string>& filename_map);
// Stores a list of unique filenames found in MMAP/MMAP2 events into
// |filenames|. Any existing data in |filenames| will be lost.
void GetFilenames(std::vector<string>* filenames) const;
void GetFilenamesAsSet(std::set<string>* filenames) const;
// Uses build id events to populate |filenames_to_build_ids|.
// Any existing data in |filenames_to_build_ids| will be lost.
// Note: A filename returned by GetFilenames need not be present in this map,
// since there may be no build id event corresponding to the MMAP/MMAP2.
void GetFilenamesToBuildIDs(
std::map<string, string>* filenames_to_build_ids) const;
static bool IsSupportedEventType(uint32_t type);
// If a program using PerfReader calls events(), it could work with the
// resulting events by importing kernel/perf_internals.h. This would also
// apply to other forms of data (attributes, event types, build ids, etc.)
// However, there is no easy way to work with the sample info within events.
// The following two methods have been added for this purpose.
// Extracts from a perf event |event| info about the perf sample that
// contains the event. Stores info in |sample|.
bool ReadPerfSampleInfo(const event_t& event,
struct perf_sample* sample) const;
// Writes |sample| info back to a perf event |event|.
bool WritePerfSampleInfo(const perf_sample& sample,
event_t* event) const;
// Accessor funcs.
const std::vector<PerfFileAttr>& attrs() const {
return attrs_;
bool HaveEventNames() const {
for (const auto& attr : attrs_) {
if ( {
return false;
return true;
const std::vector<malloced_unique_ptr<event_t>>& events() const {
return events_;
const std::vector<build_id_event*>& build_id_events() const {
return build_id_events_;
const std::vector<char>& tracing_data() const {
return tracing_data_;
bool ReadHeader(const ConstBufferWithSize& data);
bool ReadAttrs(const ConstBufferWithSize& data);
bool ReadAttr(const ConstBufferWithSize& data, size_t* offset);
bool ReadEventAttr(const ConstBufferWithSize& data, size_t* offset,
perf_event_attr* attr);
bool ReadUniqueIDs(const ConstBufferWithSize& data, size_t num_ids,
size_t* offset, std::vector<u64>* ids);
bool ReadEventTypes(const ConstBufferWithSize& data);
// if event_size == 0, then not in an event.
bool ReadEventType(const ConstBufferWithSize& data, size_t attr_idx,
size_t event_size, size_t* offset);
bool ReadData(const ConstBufferWithSize& data);
// Reads metadata in normal mode.
bool ReadMetadata(const ConstBufferWithSize& data);
bool ReadTracingMetadata(const ConstBufferWithSize& data,
size_t offset, size_t size);
bool ReadBuildIDMetadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
bool ReadStringMetadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
bool ReadUint32Metadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
bool ReadUint64Metadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
bool ReadCPUTopologyMetadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
bool ReadNUMATopologyMetadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
bool ReadEventDescMetadata(const ConstBufferWithSize& data, u32 type,
size_t offset, size_t size);
// Read perf data from piped perf output data.
bool ReadPipedData(const ConstBufferWithSize& data);
bool ReadTracingMetadataEvent(const ConstBufferWithSize& data, size_t offset);
// Like WriteToPointer, but does not check if the buffer is large enough.
bool WriteToPointerWithoutCheckingSize(char* buffer, size_t size);
bool WriteHeader(const BufferWithSize& data) const;
bool WriteAttrs(const BufferWithSize& data) const;
bool WriteEventTypes(const BufferWithSize& data) const;
bool WriteData(const BufferWithSize& data) const;
bool WriteMetadata(const BufferWithSize& data) const;
// For writing the various types of metadata.
bool WriteBuildIDMetadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
bool WriteStringMetadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
bool WriteUint32Metadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
bool WriteUint64Metadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
bool WriteEventDescMetadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
bool WriteCPUTopologyMetadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
bool WriteNUMATopologyMetadata(u32 type, size_t* offset,
const BufferWithSize& data) const;
// For reading event blocks within piped perf data.
bool ReadAttrEventBlock(const ConstBufferWithSize& data, size_t offset,
size_t size);
bool ReadPerfEventBlock(const event_t& event);
// Returns the number of types of metadata stored.
size_t GetNumMetadata() const;
// For computing the sizes of the various types of metadata.
size_t GetBuildIDMetadataSize() const;
size_t GetStringMetadataSize() const;
size_t GetUint32MetadataSize() const;
size_t GetUint64MetadataSize() const;
size_t GetEventDescMetadataSize() const;
size_t GetCPUTopologyMetadataSize() const;
size_t GetNUMATopologyMetadataSize() const;
// Returns true if we should write the number of strings for the string
// metadata of type |type|.
bool NeedsNumberOfStringData(u32 type) const;
// Replaces existing filenames in MMAP/MMAP2 events based on |filename_map|.
// This method does not change |build_id_events_|.
bool LocalizeMMapFilenames(const std::map<string, string>& filename_map);
std::vector<PerfFileAttr> attrs_;
std::vector<malloced_unique_ptr<event_t>> events_;
std::vector<build_id_event*> build_id_events_;
std::vector<PerfStringMetadata> string_metadata_;
std::vector<PerfUint32Metadata> uint32_metadata_;
std::vector<PerfUint64Metadata> uint64_metadata_;
PerfCPUTopologyMetadata cpu_topology_;
std::vector<PerfNodeTopologyMetadata> numa_topology_;
std::vector<char> tracing_data_;
uint64_t sample_type_;
uint64_t read_format_;
uint64_t metadata_mask_;
// Indicates that the perf data being read is from machine with a different
// endianness than the current machine.
bool is_cross_endian_;
u32 ReadPerfEventAttrSize(const ConstBufferWithSize& data,
size_t attr_offset);
// The file header is either a normal header or a piped header.
union {
struct perf_file_header header_;
struct perf_pipe_file_header piped_header_;
struct perf_file_header out_header_;
} // namespace quipper