fix(linux): Fix headers and whitespace in AM64X performance rst

The performance guides use incorrect header hierarchy, fix
header hierarchy and whitespace to establish an easier to
read/parse html.

Signed-off-by: Judith Mendez <jm@ti.com>

Author: jmenti

source/devices/AM64X/linux/Linux_Performance_Guide.rst

@@ -1,8 +1,10 @@
-====================================
+#################################
  Linux 12.00.00 Performance Guide
-====================================
+#################################
 
-.. rubric::  **Read This First**
+***************
+Read This First
+***************
 
 **All performance numbers provided in this document are gathered using
 following Evaluation Modules unless otherwise specified.**
@@ -15,17 +17,23 @@ following Evaluation Modules unless otherwise specified.**
 
 Table:  Evaluation Modules
 
-.. rubric::  About This Manual
-   :name: about-this-manual-kernel-perf-guide
+*****************
+About This Manual
+*****************
 
 This document provides performance data for each of the device drivers
 which are part of the Processor SDK Linux package. This document should be
 used in conjunction with release notes and user guides provided with the
 Processor SDK Linux package for information on specific issues present
 with drivers included in a particular release.
 
-.. rubric::  If You Need Assistance
-   :name: if-you-need-assistance-kernel-perf-guide
-
 For further information or to report any problems, contact
 https://e2e.ti.com/ or https://support.ti.com/
+
+|
+
+*****************
+System Benchmarks
+*****************
+
+|

source/devices/AM64X/linux/RT_Linux_Performance_Guide.rst

@@ -1,9 +1,10 @@
-======================================
+###################################
 RT-linux 12.00.00 Performance Guide
-======================================
+###################################
 
-.. rubric::  **Read This First**
-   :name: read-this-first-rt-kernel-perf-guide
+***************
+Read This First
+***************
 
 **All performance numbers provided in this document are gathered using
 following Evaluation Modules unless otherwise specified.**
@@ -16,29 +17,30 @@ following Evaluation Modules unless otherwise specified.**
 
 Table:  Evaluation Modules
 
-.. rubric::  About This Manual
-   :name: about-this-manual-rt-kernel-perf-guide
+*****************
+About This Manual
+*****************
 
 This document provides performance data for each of the device drivers
 which are part of the Processor SDK Linux package. This document should be
 used in conjunction with release notes and user guides provided with the
 Processor SDK Linux package for information on specific issues present
 with drivers included in a particular release.
 
-.. rubric::  If You Need Assistance
-   :name: if-you-need-assistance-rt-kernel-perf-guide
-
 For further information or to report any problems, contact
 https://e2e.ti.com/ or https://support.ti.com/
 
 |
 
+*****************
 System Benchmarks
------------------
+*****************
 
+|
 
 LMBench
-^^^^^^^
+=======
+
 LMBench is a collection of microbenchmarks of which the memory bandwidth
 and latency related ones are typically used to estimate processor
 memory system performance. More information about lmbench at
@@ -182,7 +184,8 @@ Execute the LMBench with the following:
     "tcp_latency_using_localhost (microsec)","0.97 (min 0.75, max 1.22)"
 
 Dhrystone
-^^^^^^^^^
+=========
+
 Dhrystone is a core only benchmark that runs from warm L1 caches in all
 modern processors. It scales linearly with clock speed. For standard ARM
 cores the DMIPS/MHz score will be identical with the same compiler and flags.
@@ -195,15 +198,16 @@ cores the DMIPS/MHz score will be identical with the same compiler and flags.
     "dhrystone_per_second (dhrystonep)","4855981.60 (min 4761905.00, max 5000000.00)"
 
 Whetstone
-^^^^^^^^^
+=========
 
 .. csv-table:: Whetstone Benchmarks
     :header: "Benchmarks","am64xx-hsevm: perf"
 
     "whetstone (mips)","3611.08 (min 3333.30, max 5000.00)"
 
 Linpack
-^^^^^^^
+=======
+
 Linpack measures peak double precision (64 bit) floating point performance in
 solving a dense linear system.
 
@@ -213,7 +217,8 @@ solving a dense linear system.
     "linpack (kflops)","411621.33 (min 411424.00, max 411819.00)"
 
 CoreMarkPro
-^^^^^^^^^^^
+===========
+
 CoreMark®-Pro is a comprehensive, advanced processor benchmark that works with
 and enhances the market-proven industry-standard EEMBC CoreMark® benchmark.
 While CoreMark stresses the CPU pipeline, CoreMark-Pro tests the entire processor,
@@ -248,11 +253,13 @@ and floating-point workloads, and data sets for utilizing larger memory subsyste
     "sha-test (workloads/)","114.94"
     "zip-test (workloads/)","26.01 (min 14.39, max 28.57)"
 
+|
+
 Boot-time Measurement
----------------------
+=====================
 
 Boot media: MMCSD
-^^^^^^^^^^^^^^^^^
+-----------------
 
 .. csv-table:: Linux boot time MMCSD
     :header: "Boot Configuration","am64xx-hsevm: Boot time in seconds: avg(min,max)"
@@ -264,7 +271,8 @@ Boot time numbers [avg, min, max] are measured from "Starting kernel" to Linux p
 |
 
 Ethernet
---------
+========
+
 Ethernet performance benchmarks were measured using :command:`netperf` 2.7.1 https://hewlettpackard.github.io/netperf/doc/netperf.html
 Test procedures were modeled after those defined in RFC-2544:
 https://tools.ietf.org/html/rfc2544, where the DUT is the TI device
@@ -330,29 +338,29 @@ Running the following commands will trigger :command:`netperf` clients to measur
    netperf -H <DUT ip> -j -C -l 60 -t UDP_STREAM -b <burst_size> -w <wait_time> -- -m <UDP datagram size>
       -k DIRECTION,THROUGHPUT,MEAN_LATENCY,LOCAL_CPU_UTIL,REMOTE_CPU_UTIL,LOCAL_BYTES_SENT,REMOTE_BYTES_RECVD,LOCAL_SEND_SIZE
 
-CPSW/CPSW2g/CPSW3g Ethernet Driver
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+CPSW/CPSW2g/CPSW3g Ethernet
+---------------------------
 
 - CPSW3g: AM64x
 
-.. rubric::  TCP Bidirectional Throughput
-   :name: CPSW2g-tcp-bidirectional-throughput
+TCP Bidirectional Throughput
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. csv-table:: CPSW2g TCP Bidirectional Throughput
     :header: "Command Used","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: CPU Load % (LOCAL_CPU_UTIL)"
 
     "netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_STREAM; netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_MAERTS","1100.48 (min 1064.93, max 1125.49)","99.80 (min 99.68, max 99.87)"
 
-.. rubric::  TCP Bidirectional Throughput Interrupt Pacing
-   :name: CPSW2g-tcp-bidirectional-throughput-interrupt-pacing
+TCP Bidirectional Throughput Interrupt Pacing
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. csv-table:: CPSW2g TCP Bidirectional Throughput Interrupt Pacing
     :header: "Command Used","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: CPU Load % (LOCAL_CPU_UTIL)"
 
     "netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_STREAM; netperf -H 192.168.0.1 -j -c -C -l 60 -t TCP_MAERTS","1129.68 (min 1104.10, max 1180.26)","92.57 (min 77.95, max 98.21)"
 
-.. rubric::  UDP Throughput
-   :name: CPSW2g-udp-throughput-0-loss
+UDP Throughput
+^^^^^^^^^^^^^^
 
 .. csv-table:: CPSW2g UDP Egress Throughput 0 loss
     :header: "Frame Size(bytes)","am64xx-hsevm: UDP Datagram Size(bytes) (LOCAL_SEND_SIZE)","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: Packets Per Second (kPPS)","am64xx-hsevm: CPU Load % (LOCAL_CPU_UTIL)"
@@ -379,27 +387,27 @@ CPSW/CPSW2g/CPSW3g Ethernet Driver
     "1024","","586.35 (min 540.95, max 621.28)","71.67 (min 66.00, max 76.00)","66.59 (min 65.50, max 68.59)","30.88 (min 27.41, max 35.21)"
     "1518","","634.14 (min 592.61, max 686.45)","53.75 (min 50.00, max 58.00)","65.50 (min 64.50, max 66.73)","32.49 (min 28.27, max 35.88)"
 
-ICSSG Ethernet Driver
-^^^^^^^^^^^^^^^^^^^^^
+ICSSG Ethernet
+--------------
 
-.. rubric::  TCP Bidirectional Throughput
-   :name: tcp-bidirectional-throughput
+TCP Bidirectional Throughput
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. csv-table:: ICSSG TCP Bidirectional Throughput
     :header: "Command Used","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: CPU Load % (LOCAL_CPU_UTIL)"
 
     "netperf -H 192.168.2.1 -j -c -C -l 60 -t TCP_STREAM; netperf -H 192.168.2.1 -j -c -C -l 60 -t TCP_MAERTS","812.01 (min 355.31, max 1121.74)","83.12 (min 74.78, max 99.72)"
 
-.. rubric::  TCP Bidirectional Throughput Interrupt Pacing
-   :name: ICSSG-tcp-bidirectional-throughput-interrupt-pacing
+TCP Bidirectional Throughput Interrupt Pacing
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. csv-table:: ICSSG TCP Bidirectional Throughput Interrupt Pacing
     :header: "Command Used","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: CPU Load % (LOCAL_CPU_UTIL)"
 
     "netperf -H 192.168.2.1 -j -c -C -l 60 -t TCP_STREAM; netperf -H 192.168.2.1 -j -c -C -l 60 -t TCP_MAERTS","528.47 (min 363.92, max 1021.70)","50.15 (min 38.53, max 84.08)"
 
-.. rubric::  UDP Egress Throughput
-   :name: udp-egress-throughput-0-loss
+UDP Egress Throughput
+^^^^^^^^^^^^^^^^^^^^^
 
 .. csv-table:: ICSSG UDP Egress Throughput 0 loss
     :header: "Frame Size(bytes)","am64xx-hsevm: UDP Datagram Size(bytes) (LOCAL_SEND_SIZE)","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: Packets Per Second (kPPS)","am64xx-hsevm: CPU Load % (LOCAL_CPU_UTIL)"
@@ -410,8 +418,8 @@ ICSSG Ethernet Driver
     "1024","","421.89 (min 20.48, max 646.48)","51.67 (min 3.00, max 79.00)","59.85 (min 0.95, max 89.47)"
     "1472","","225.95 (min 9.42, max 866.11)","19.25 (min 1.00, max 74.00)","23.84 (min 0.19, max 88.88)"
 
-.. rubric::  UDP Ingress Throughput
-   :name: udp-ingress-throughput-0-loss
+UDP Ingress Throughput
+^^^^^^^^^^^^^^^^^^^^^^
 
 .. csv-table:: ICSSG UDP Ingress Throughput 0 loss
     :header: "Frame Size(bytes)","am64xx-hsevm: UDP Datagram Size(bytes) (LOCAL_SEND_SIZE)","am64xx-hsevm: THROUGHPUT (Mbits/sec)","am64xx-hsevm: Packets Per Second (kPPS)","am64xx-hsevm: CPU Load %"
@@ -424,23 +432,22 @@ ICSSG Ethernet Driver
 
 |
 
-OSPI Flash Driver
------------------
-
-
-.. rubric:: AM64XX-EVM
-   :name: am64xx-evm-ospi
+OSPI
+====
 
-.. rubric:: RAW
-   :name: am64xx-evm-ospi-raw
+OSPI RAW
+--------
 
 .. csv-table:: OSPI Raw Flash Driver
     :header: "File size (Mbytes)","am64xx-hsevm: Raw Read Throughput (Mbytes/sec)"
 
     "50","120.03 (min 34.72, max 142.86)"
 
-EMMC Driver
------------
+|
+
+EMMC
+====
+
 .. warning::
 
   **IMPORTANT**: The performance numbers can be severely affected if the media is
@@ -450,7 +457,7 @@ EMMC Driver
   re-mount in async mode.
 
 EMMC EXT4 FIO 1G
-^^^^^^^^^^^^^^^^
+----------------
 
 .. csv-table:: EMMC EXT4 FIO 1G
     :header: "Buffer size (bytes)","am64xx-hsevm: Write EXT4 Throughput (Mbytes/sec)","am64xx-hsevm: Write EXT4 CPU Load (%)","am64xx-hsevm: Read EXT4 Throughput (Mbytes/sec)","am64xx-hsevm: Read EXT4 CPU Load (%)"
@@ -461,7 +468,7 @@ EMMC EXT4 FIO 1G
     "256k","60.88 (min 59.70, max 61.40)","5.90 (min 5.76, max 6.02)","174.00","8.94 (min 8.35, max 9.48)"
 
 EMMC EXT4
-"""""""""
+---------
 
 .. csv-table:: EMMC EXT4
     :header: "Buffer size (bytes)","am64xx-hsevm: Write EXT4 Throughput (Mbytes/sec)","am64xx-hsevm: Write EXT4 CPU Load (%)","am64xx-hsevm: Read EXT4 Throughput (Mbytes/sec)","am64xx-hsevm: Read EXT4 CPU Load (%)"
@@ -473,7 +480,7 @@ EMMC EXT4
     "5242880","54.16 (min 49.90, max 55.64)","10.63 (min 9.14, max 14.63)","182.84 (min 182.76, max 182.90)","27.89 (min 27.03, max 28.57)"
 
 EMMC VFAT
-"""""""""
+---------
 
 .. csv-table:: EMMC VFAT
     :header: "Buffer size (bytes)","am64xx-hsevm: Write VFAT Throughput (Mbytes/sec)","am64xx-hsevm: Write VFAT CPU Load (%)","am64xx-hsevm: Read VFAT Throughput (Mbytes/sec)","am64xx-hsevm: Read VFAT CPU Load (%)"
@@ -484,8 +491,8 @@ EMMC VFAT
     "1048576","48.91 (min 40.22, max 51.96)","13.10 (min 10.95, max 19.49)","166.64 (min 165.06, max 168.68)","27.83 (min 25.62, max 28.80)"
     "5242880","49.84 (min 40.55, max 54.04)","13.15 (min 11.19, max 19.67)","166.79 (min 165.93, max 167.42)","28.51 (min 27.87, max 29.03)"
 
-UBoot EMMC Driver
------------------
+UBoot EMMC
+----------
 
 .. csv-table:: UBOOT EMMC RAW
     :header: "File size (bytes in hex)","am64xx-hsevm: Write Throughput (Kbytes/sec)","am64xx-hsevm: Read Throughput (Kbytes/sec)"
@@ -494,7 +501,7 @@ UBoot EMMC Driver
     "4000000","60759.37 (min 59308.60, max 61651.93)","172614.84 (min 172463.16, max 172918.21)"
 
 MMCSD
------
+=====
 
 .. warning::
 
@@ -505,8 +512,7 @@ MMCSD
   re-mount in async mode.
 
 MMC EXT4 FIO 1G
-^^^^^^^^^^^^^^^
-
+---------------
 
 .. csv-table:: MMC EXT4 FIO 1G
     :header: "Buffer size (bytes)","am64xx-hsevm: Write EXT4 Throughput (Mbytes/sec)","am64xx-hsevm: Write EXT4 CPU Load (%)","am64xx-hsevm: Read EXT4 Throughput (Mbytes/sec)","am64xx-hsevm: Read EXT4 CPU Load (%)"
@@ -517,7 +523,7 @@ MMC EXT4 FIO 1G
     "256k","38.15 (min 37.80, max 38.70)","4.64 (min 4.50, max 4.76)","83.47 (min 83.10, max 83.90)","6.51 (min 6.19, max 7.09)"
 
 MMC EXT4
-^^^^^^^^
+--------
 
 .. csv-table:: MMC EXT4
     :header: "Buffer size (bytes)","am64xx-hsevm: Write Raw Throughput (Mbytes/sec)","am64xx-hsevm: Write Raw CPU Load (%)","am64xx-hsevm: Read Raw Throughput (Mbytes/sec)","am64xx-hsevm: Read Raw CPU Load (%)"
@@ -535,11 +541,11 @@ The performance numbers were captured using the following:
 
 |
 
-CRYPTO Driver
--------------
+CRYPTO
+======
 
 OpenSSL Performance
-^^^^^^^^^^^^^^^^^^^
+-------------------
 
 .. csv-table:: OpenSSL Performance
     :header: "Algorithm","Buffer Size (in bytes)","am64xx-hsevm: throughput (KBytes/Sec)"