summaryrefslogtreecommitdiffstats
path: root/llvm/docs/CommandGuide
diff options
context:
space:
mode:
authorAndrea Di Biagio <Andrea_DiBiagio@sn.scee.net>2018-08-27 14:52:52 +0000
committerAndrea Di Biagio <Andrea_DiBiagio@sn.scee.net>2018-08-27 14:52:52 +0000
commitb89b96c1b2791d07f39d37178864cf8bfc0c39e4 (patch)
treeee4b5467eb22611f800bb902ad537e4665b77679 /llvm/docs/CommandGuide
parent353adf437dbfb0b13f463af3c472fdc001186343 (diff)
downloadbcm5719-llvm-b89b96c1b2791d07f39d37178864cf8bfc0c39e4.tar.gz
bcm5719-llvm-b89b96c1b2791d07f39d37178864cf8bfc0c39e4.zip
[llvm-mca] Improved report generated by the SchedulerStatistics view.
Before this patch, the SchedulerStatistics only printed the maximum number of buffer entries consumed in each scheduler's queue at a given point of the simulation. This patch restructures the reported table, and adds an extra field named "Average number of used buffer entries" to it. This patch also uses different colors to help identifying bottlenecks caused by high scheduler's buffer pressure. llvm-svn: 340746
Diffstat (limited to 'llvm/docs/CommandGuide')
-rw-r--r--llvm/docs/CommandGuide/llvm-mca.rst20
1 files changed, 13 insertions, 7 deletions
diff --git a/llvm/docs/CommandGuide/llvm-mca.rst b/llvm/docs/CommandGuide/llvm-mca.rst
index 955adc0a049..5dcd97fb113 100644
--- a/llvm/docs/CommandGuide/llvm-mca.rst
+++ b/llvm/docs/CommandGuide/llvm-mca.rst
@@ -458,7 +458,8 @@ counters for the dispatch logic, the reorder buffer, the retire control unit,
and the register file.
Below is an example of ``-all-stats`` output generated by :program:`llvm-mca`
-for the dot-product example discussed in the previous sections.
+for 300 iterations of the dot-product example discussed in the previous
+sections.
.. code-block:: none
@@ -484,11 +485,16 @@ for the dot-product example discussed in the previous sections.
1, 306 (50.2%)
2, 297 (48.7%)
-
Scheduler's queue usage:
- JALU01, 0/20
- JFPU01, 18/18
- JLSAGU, 0/12
+ [1] Resource name.
+ [2] Average number of used buffer entries.
+ [3] Maximum number of used buffer entries.
+ [4] Total number of buffer entries.
+
+ [1] [2] [3] [4]
+ JALU01 0 0 20
+ JFPU01 17 18 18
+ JLSAGU 0 0 12
Retire Control Unit - number of cycles where we saw N instructions retired:
@@ -528,8 +534,8 @@ representing the number of instructions issued on some number of cycles. In
this case, of the 610 simulated cycles, single instructions were issued 306
times (50.2%) and there were 7 cycles where no instructions were issued.
-The *Scheduler's queue usage* table shows that the maximum number of buffer
-entries (i.e., scheduler queue entries) used at runtime. Resource JFPU01
+The *Scheduler's queue usage* table shows that the average and maximum number of
+buffer entries (i.e., scheduler queue entries) used at runtime. Resource JFPU01
reached its maximum (18 of 18 queue entries). Note that AMD Jaguar implements
three schedulers:
OpenPOWER on IntegriCloud