report

Command Function

Analyzes the generated data files, computes the proportion of each microarchitectural pipeline using the top-down method, and displays the analysis results in the terminal.

Syntax

./devopt.sh report [-h] -i INPUT [-p SOURCE_PATH]

Parameter Description

Example

1. View information about the report command.

   ./devopt.sh report -h

   Command output:

   USAGE
     devopt.sh report [-h]  -i INPUT [-p SOURCE_PATH]
   
   DESCRIPTION
     Analyzes the collected data and displays the analysis result on the terminal.
   
   OPTIONS
     -h, --help              
     Displays help information and exits.
   
     -i INPUT, --input INPUT 
     Specifies a data file.
   
     -p SOURCE_PATH, --project SOURCE_PATH
     Specifies the source file directory, which is used to locate the source code.
   
   EXAMPLE
     # Analyze the collected data and view the analysis result in interactive mode.
     devopt.sh report -i /home/output/devopt_pid_timestamp.rawdata -p /home/project/test

2. Run the report command to analyze the collected data and view the analysis result in interactive mode.

   1	./devopt.sh report -i /home/output/devopt_3315674_20260513155321.rawdata -p /home/project/test

   The tool summary screen is displayed, as shown in the following figure:

   

   Table 2 Areas on the tool summary screen

   Area	Name	Description
   1	Table area	Displays function information in the source file. For details about the fields, see Table 3. You can use the search box in the table area to quickly search for a function.
   2	Call stack area	Displays function call information. You can press e to collapse or expand the information.
   3	Hints area	Displays the memory source code optimization process. For details, see Example.
   4	Shortcut key area	Displays shortcut key information. For details, see Table 4.

   

   The x86 package of the Dynamic Code Optimizer does not support the display of the hints area.

   Table 3 Fields in the table area

   Field	Description
   func	Function name in the source file.
   file	Name of the source file where the function is located.
   module	Module to which the function belongs.
   percentage(%)	Percentage of the function duration to the total duration.
   issue	Type of a detected issue. A value of M indicates a false sharing issue.
   avg(ms)	Average duration of the function, in ms.
   min(ms)	Minimum duration of the function, in ms.
   max(ms)	Maximum duration of the function, in ms.
   P99(ms)	99th percentile duration, indicating that 99% of function durations do not exceed this value.
   frt_bound(%)	Function-level top-down Frontend Bound metrics, including Fetch Latency Bound (ITLB Miss, ICache Miss, BP_Misp_Flush, OoO Flush, and Static Predictor Flush) and Fetch Bandwidth Bound.
   mem_bound(%)	Function-level top-down Memory Bound metrics, including L1 Bound, L2 Bound, L3 or DRAM Bound, and Store Bound.
   core_bound(%)	Function-level top-down Core Bound metrics, including Exe Ports Util, Resource Bound*, FSU Stall, DIV Stall, and FDIV Stall.
   bad_spec(%)	Function-level top-down Bad Speculation metrics, including Branch Mispredicts (Indirect Branch, Push Branch, Pop Branch, and Other Branch) and Machine Clears (Nuke Flush and Other Flush).
   retiring(%)	Function-level top-down Retiring metric, indicating the proportion of instructions that end normally.

   Table 4 Shortcut keys

   Shortcut Key	Description
   Ctrl+C	Exits the current screen and returns to the CLI.
   Tab	Switches the selected area within the tool screen.
   Enter	Goes to the details screen of the selected data.
   F1	Switches within the selected area.
   /	Selects the search box.
   Space	Displays the data screen size selector.
   h	Displays help information.
   e	Collapses or expands function call information in the call stack area.
   ↑/↓	Scrolls the vertical scrollbar up or down.
   ←/→	Scrolls the horizontal scrollbar left or right.
   PageDown/PageUp	Quickly scrolls the vertical scrollbar up or down.
   q/Esc	Returns from the tool's details screen to the summary screen.

3. Select any row in the table area on the summary screen and press Enter to open the details screen for the selected data, as shown in the following figure:

   

   Table 5 Areas on the tool details screen

   Area	Name	Description
   1	Source Code	Displays the source code of the file where the function is located.
   2	Assembly Code	Displays the assembly code of the function.
   3	Code Suggestions	Displays source code optimization suggestions.
   4	Shortcut keys	Displays shortcut key information. For details, see Table 4.