path

Command Function

Generates HTML-based visual analysis reports from data files, enabling easy inspection of high-frequency function call traces and latency information.

Syntax

devopt.sh path [-h] -i INPUT | -d INPUT1 INPUT2 [-o OUTPUT]

Parameter Description

**Table 1** Parameter description
Parameter	Option	Description
-h/--help	-	(Optional) Obtains help information.
-i/--input	-	(Optional) Data file.
-d/--diff	-	(Optional) Two data files, separated by a space. It generates an HTML-based visual analysis report for comparing high-frequency function call traces and latency information between the two data files. NOTE: When -i is selected, the -d parameter cannot be used, as they are incompatible. Only one of them can be specified to define the data file.
-o/--output	-	(Optional) Output directory for visual analysis reports. It defaults to the current working directory.

Example

View information about the path command.

./devopt.sh path -h

Command output:

USAGE
  devopt.sh path [-h] -i INPUT | -d INPUT1 INPUT2 [-o OUTPUT]

DESCRIPTION
  Analyzes data files and generates a visual analysis report.

OPTIONS
  -h, --help              
  Displays help information and exits.

  -i INPUT, --input INPUT 
  the input file

  -d INPUT1 INPUT2, --diff INPUT1 INPUT2
  diff two input files

  -o OUTPUT, --output OUTPUT
  Specifies the output directory for the HTML report. It defaults to the current directory.

EXAMPLES
  # Generate a visual analysis report of function and component call chains.
  devopt.sh path -i /home/output/devopt_pid_timestamp.rawdata
  # Compare two data files and generate a visual analysis report of function and component call chains.
  devopt.sh path -d /home/output/devopt_pid1_timestamp.rawdata /home/output/devopt_pid2_timestamp.rawdata
  # Specify a custom output directory for the generated HTML report.
  devopt.sh path -i /home/output/devopt_pid_timestamp.rawdata -o /home/reports

Specify a single data file to generate a visual report.

        
             ./devopt.sh path -i /home/output/devopt_3315674_20260513155321.rawdata -o /home/reports

Command output:

Successfully generated analysis report: "/home/reports/analysis_report_20260525112914.html"

The command output indicates that the command is executed successfully and a visual analysis report in HTML format is generated in the specified directory.

Open the visual report, as shown in the following figure:
- The figure shows the component call chain information of the process, including a main thread and a subthread group. When the subthread group is selected, it is displayed in a darker color, and the associated components and their interaction paths are displayed.
- The color of a subthread group is determined by the proportion of its subthreads relative to the total number of subthreads: light red for ≥80%, light orange for ≥50% and <80%, and light green for <50%.
Click Function Call Chain to view function call chain information for the main thread and child thread groups, as shown in the following figure:

The left panel shows the function call chain index, where the values indicate the proportion of each call chain. The middle panel displays detailed function call chain information in top-to-bottom order. Selecting any row displays the compiler version and dependency information in the right panel.

Specify two different data files to generate a visual report.

        
             ./devopt.sh path -d /home/output/devopt_3315674_20260513155321.rawdata /home/output/devopt_384999_20260515161218.rawdata -o /home/reports

Command output:

Successfully generated analysis report: "/home/reports/analysis_diff_report_20260528111152.html"

Open the visual report, as shown in the following figure:

The figure shows the component call chain information of a process on the Kunpeng and x86 platforms. On the Kunpeng platform, the process consists of one main thread and one subthread group containing three threads. On the x86 platform, it consists of one main thread and three subthread groups, each containing one thread. When a subthread group is selected, it is displayed in a darker color, and the associated components and their call chains are displayed.
The color of a subthread group is determined by the proportion of its subthreads relative to the total number of subthreads: light red for ≥80%, light orange for ≥50% and <80%, and light green for <50%.

Click Function Call Chain DIFF to view function call chain information for the main thread and child thread groups on different platforms, as shown in the following figure:

In the figure, the left side shows the function call chain index, while the right side shows detailed call chain information for the same call chain on different platforms. On the Kunpeng platform, call chain information is highlighted with a light green background, while on the x86 platform, it is highlighted with a light red background.

Parent topic: Commands and Parameters