Rate This Document
Findability
Accuracy
Completeness
Readability

A-FOT Command

Prerequisites

The A-FOT tool has been installed. For details, see Installation the Tool.

Command Function

Enables the full AutoFDO workflow (including sampling, analysis, and optimization) with minimal configuration, streamlining the use of the AutoFDO feature and boosting the performance.

There are two ways to use A-FOT: configuration file-based parameter optimization and command-line parameter optimization.

Syntax

a-fot [OPTION1 ARG1] [OPTION2 ARG2] [...]

Parameter Description

Table 1 perf mode parameters

Parameter

Option

Description

--config_file

-

Configuration file path.

--opt_mode

AutoFDO/AutoPrefetch/AutoBOLT

Optimization mode. Three optimization modes are available.

--perf_time

-

Perf sampling duration, in seconds.

--gcc_path

-

GCC compiler path.

--app_name

-

Application process name.

--bin_file

-

Executable file path.

--build_script

-

Application build script path.

--work_path

-

Script working directory (used to compile the application and store the configuration file).

--run_script

-

Application running script path.

--max_waiting_time

-

Maximum binary startup time, in seconds.

--check_success

-

Optimization check result, which indicates whether the optimization is successful (1: enabled; 0: disabled).

--build_mode

Bear/Wrapper

Build mode. Two build modes are available.

Table 2 Kernel mode parameters

Parameter

Option

Description

--config_file

-

Configuration file path.

--opt_mode

Auto_kernel_PGO

Optimization mode, which is set to Auto_kernel_PGO.

--pgo_mode

arc/all

Profile-guided optimization (PGO) mode, which is the feedback-directed optimization (FDO) mode for the kernel. The default value is all.

  • arc: enables only the arc profile.
  • all: enables full PGO.

--pgo_phase

1/2

Execution stage for kernel FDO. The tool performs different operations based on the specified stage. The default value is 1.

  • 1: stage of compiling and instrumenting the kernel
  • 2: stage of compiling and optimizing the kernel

--kernel_src

-

Directory for storing kernel source files.

--kernel_name

-

Local name of the kernel build. The tool will add the -pgoing or -pgoed suffix depending on the stage.

--work_path

-

Script working directory, which is used to store log files and configuration files.

--run_script

-

Application running script path.

--gcc_path

-

GCC compiler path.

--last_time

-

Timestamped directory created before restart.

-s

-

Silent mode (The system automatically restarts after kernel installation.)

-n

-

Indicates that the kernel is not automatically compiled.

--makefile

-

Path to the kernel source Makefile.

--kernel_config

-

Kernel configuration file path.

--data_dir

-

Directory of the original configuration file generated by the kernel, used when the kernel is not automatically compiled.