Streamline --list-metrics command line option in rocprof-compute (#310)

* Remove L2 channels from --list-metrics

--list-metrics moved to general options

List metrics for the current architecture

Filter blocks for metrics

Removed test for --list-metrics in profile mode

Test the options don't throw error

Fixed --config-dir error

Test stdout for command line options

Provide path list for loading panel configs

Show L2 Cache (per) channel metrics

Changed command line option names

Can show two levels only

Removed filtering blocks

Moved blocks to original position

Removed filter block tests

Removed filtering

Formaating fix

Readability enhancement

Test formatting

Filter L2 channels without sysinfo

Show avilable metrics for current arch

Intermediate commit

Fixed tests

Added argument sanitization

Added list_metrics to ctest

merge iconflict resolution

Updated test marker

Updated changelog

Fixed formatting

* Updated docs

projects/rocprofiler-compute/docs/how-to/analyze/cli.rst

@@ -72,13 +72,13 @@ There are three high-level GPU analysis views:
    * Visualized memory chart requires the width of the terminal output to be greater than or equal to 234 to display the whole chart properly.
    * Visualized Roofline chart is adapted to the initial terminal size only. If it is not clear, you may need to adjust the terminal size and regenerate it to check the display effect. Roofline analysis provides detailed, structured table output with measured empirical peak values for comparison.
 
-.. _cli-list-metrics:
+.. _cli-list-available-metrics:
 
-2. Use ``--list-metrics`` to generate a list of available metrics for inspection.
+2. Use ``--list-available-metrics`` to generate a list of available metrics for inspection.
 
    .. code-block:: shell-session
 
-      $ rocprof-compute analyze -p workloads/vcopy/MI200/ --list-metrics gfx90a
+      $ rocprof-compute analyze -p workloads/vcopy/MI200/ --list-available-metrics
 
                                        __                                       _
        _ __ ___   ___ _ __  _ __ ___  / _|       ___ ___  _ __ ___  _ __  _   _| |_ ___

projects/rocprofiler-compute/docs/how-to/profile/mode.rst

@@ -359,11 +359,11 @@ The following example only collects the counters required to calculate ``Total V
    ...
 
 
-To see a list of available hardware report blocks, use the ``--list-metrics`` option.
+To see a list of available hardware report blocks, use the ``--list-available-metrics`` option.
 
 .. code-block:: shell-session
 
-   $ rocprof-compute profile --list-metrics
+   $ rocprof-compute profile --list-available-metrics
 
                                     __                                       _
     _ __ ___   ___ _ __  _ __ ___  / _|       ___ ___  _ __ ___  _ __  _   _| |_ ___

projects/rocprofiler-compute/docs/how-to/use.rst

@@ -61,13 +61,14 @@ Common filters to customize data collection include:
 
 See :ref:`Filtering <filtering>` for an in-depth walkthrough.
 
-To view available metrics by hardware block, use the ``profile`` mode ``--list-metrics``
-option with an optional system architecture argument (inferred if not provided):
+To view available metrics by hardware block, use the ``--list-metrics``
+option with a system architecture argument or ``--list-available-metrics``
+to view the metrics for current system architecture:
 
 .. code-block:: shell
 
-   $ rocprof-compute profile --list-metrics
-   $ rocprof-compute profile --list-metrics <sys_arch>
+   $ rocprof-compute --list-metrics <sys_arch>
+   $ rocprof-compute profile --list-available-metrics
 
 .. _basic-analyze-cli: