85e3875ad7
D150312 added a TODO: TODO: consider renaming the field `StartAtCycle` and `Cycles` to `AcquireAtCycle` and `ReleaseAtCycle` respectively, to stress the fact that resource allocation is now represented as an interval, relatively to the issue cycle of the instruction. This patch implements that TODO. This naming clarifies how to use these fields in the scheduler. In addition it was confusing that `StartAtCycle` was singular but `Cycles` was plural. This renaming fixes this inconsistency. This commit as previously reverted since it missed renaming that came down after rebasing. This version of the commit fixes those problems. Differential Revision: https://reviews.llvm.org/D158568
104 lines
3.8 KiB
C++
104 lines
3.8 KiB
C++
//===--------------------- ResourcePressureView.h ---------------*- C++ -*-===//
|
|
//
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
/// \file
|
|
///
|
|
/// This file define class ResourcePressureView.
|
|
/// Class ResourcePressureView observes hardware events generated by
|
|
/// the Pipeline object and collects statistics related to resource usage at
|
|
/// instruction granularity.
|
|
/// Resource pressure information is then printed out to a stream in the
|
|
/// form of a table like the one from the example below:
|
|
///
|
|
/// Resources:
|
|
/// [0] - JALU0
|
|
/// [1] - JALU1
|
|
/// [2] - JDiv
|
|
/// [3] - JFPM
|
|
/// [4] - JFPU0
|
|
/// [5] - JFPU1
|
|
/// [6] - JLAGU
|
|
/// [7] - JSAGU
|
|
/// [8] - JSTC
|
|
/// [9] - JVIMUL
|
|
///
|
|
/// Resource pressure per iteration:
|
|
/// [0] [1] [2] [3] [4] [5] [6] [7] [8] [9]
|
|
/// 0.00 0.00 0.00 0.00 2.00 2.00 0.00 0.00 0.00 0.00
|
|
///
|
|
/// Resource pressure by instruction:
|
|
/// [0] [1] [2] [3] [4] [5] [6] [7] [8] [9] Instructions:
|
|
/// - - - - - 1.00 - - - - vpermilpd $1, %xmm0,
|
|
/// %xmm1
|
|
/// - - - - 1.00 - - - - - vaddps %xmm0, %xmm1,
|
|
/// %xmm2
|
|
/// - - - - - 1.00 - - - - vmovshdup %xmm2, %xmm3
|
|
/// - - - - 1.00 - - - - - vaddss %xmm2, %xmm3,
|
|
/// %xmm4
|
|
///
|
|
/// In this example, we have AVX code executed on AMD Jaguar (btver2).
|
|
/// Both shuffles and vector floating point add operations on XMM registers have
|
|
/// a reciprocal throughput of 1cy.
|
|
/// Each add is issued to pipeline JFPU0, while each shuffle is issued to
|
|
/// pipeline JFPU1. The overall pressure per iteration is reported by two
|
|
/// tables: the first smaller table is the resource pressure per iteration;
|
|
/// the second table reports resource pressure per instruction. Values are the
|
|
/// average resource cycles consumed by an instruction.
|
|
/// Every vector add from the example uses resource JFPU0 for an average of 1cy
|
|
/// per iteration. Consequently, the resource pressure on JFPU0 is of 2cy per
|
|
/// iteration.
|
|
///
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef LLVM_TOOLS_LLVM_MCA_RESOURCEPRESSUREVIEW_H
|
|
#define LLVM_TOOLS_LLVM_MCA_RESOURCEPRESSUREVIEW_H
|
|
|
|
#include "Views/InstructionView.h"
|
|
#include "llvm/ADT/ArrayRef.h"
|
|
#include "llvm/ADT/DenseMap.h"
|
|
#include "llvm/MC/MCInst.h"
|
|
#include "llvm/MC/MCInstPrinter.h"
|
|
#include "llvm/MC/MCSubtargetInfo.h"
|
|
#include "llvm/Support/JSON.h"
|
|
|
|
namespace llvm {
|
|
namespace mca {
|
|
|
|
/// This class collects resource pressure statistics and it is able to print
|
|
/// out all the collected information as a table to an output stream.
|
|
class ResourcePressureView : public InstructionView {
|
|
unsigned LastInstructionIdx;
|
|
|
|
// Map to quickly obtain the ResourceUsage column index from a processor
|
|
// resource ID.
|
|
llvm::DenseMap<unsigned, unsigned> Resource2VecIndex;
|
|
|
|
// Table of resources used by instructions.
|
|
std::vector<ReleaseAtCycles> ResourceUsage;
|
|
unsigned NumResourceUnits;
|
|
|
|
void printResourcePressurePerIter(llvm::raw_ostream &OS) const;
|
|
void printResourcePressurePerInst(llvm::raw_ostream &OS) const;
|
|
|
|
public:
|
|
ResourcePressureView(const llvm::MCSubtargetInfo &sti,
|
|
llvm::MCInstPrinter &Printer,
|
|
llvm::ArrayRef<llvm::MCInst> S);
|
|
|
|
void onEvent(const HWInstructionEvent &Event) override;
|
|
void printView(llvm::raw_ostream &OS) const override {
|
|
printResourcePressurePerIter(OS);
|
|
printResourcePressurePerInst(OS);
|
|
}
|
|
StringRef getNameAsString() const override { return "ResourcePressureView"; }
|
|
json::Value toJSON() const override;
|
|
};
|
|
} // namespace mca
|
|
} // namespace llvm
|
|
|
|
#endif
|