更新时间:2023-11-16 GMT+08:00

配置文件

本节提供了静态加速配置文件动态加速配置文件中每个配置项的说明。

静态加速配置文件

应用加速工具默认静态加速配置信息如下,您可以自定义配置文件来优化应用。

表1 配置信息说明

模块名

描述

binary

定义二进制文件的相关属性。binary参数详情参见表2

parameter

用户定义的参数集合,工具根据此集合生成参数集。至少定义一个参数。

通过llvm-bolt -h命令可查看所有参数。

include

用户定义参数集中需包含的参数,允许定义多个参数,多个参数之间采用“与”逻辑。

选项以参数名为key,指定值为value。例如,frame-opt=none。
说明:
  • 若key无法指定值或不需要指定值时,仍需要以“=”结束,例如frame-opt=。
  • include和exclude配置包含同一个参数时,exclude的优先级大于include。

exclude

用户定义参数集中不需要包含的参数。允许定义多个参数,多个参数之间采用“与”逻辑。

说明:
  • 若key无法指定值或不需要指定值时,仍需要以“=”结束,例如frame-opt=。
  • include和exclude配置包含同一个参数时,exclude的优先级大于include。
表2 binary参数说明

选项名

值类型

默认值

选项描述

binary_out_path

string

"/data/hce-wae-auto"

定义自动生成的二进制文件的保存路径。

binary_file_suffix

string

"blot.auto"

定义自动生成的二进制文件名后缀。

静态加速配置文件示例

[binary]
binary_out_path = "/data/llvm_auto"
binary_num_threshold = 1000
binary_file_suffix = "blot.auto"

[parameter]
parameters =
    --align-blocks              # 允许添加参数前缀--
    frame-opt                   # 用户定义的参数集合中若不需要指定参数的值,则无需以=结束
    align-functions=1            # 用户定义参数集合中指定了参数对应的值,则生成的参数集中,所有参数组合中该参数的值都为1

[include]
align-blocks=                   # 参数无法指定值仍需以=结束
[exclude]
frame-opt=none                  # 指定参数及对应的值,生成的参数集中会过滤参数为frame-opt,且值为none的参数组合
indirect-call-promotion=         # 指定参数,该参数为枚举类型,则生成的参数集中会过滤所有参数为frame-opt的参数组合

动态加速配置文件

应用加速工具默认动态加速配置信息如下,您可以自定义配置文件来优化应用。

表3 配置信息说明

模块名

描述

[mission]优化运行中的应用所要配置的参数。

log-type

运行时日志采集方式,当前仅支持instrument方式。

hotpatch-type

热补丁模式,当前仅支持mode1即ptrace方式。

snapshot-path

优化后的二进制快照文件存放的目录路径。

origin-exe

原始应用的位置,使用instrument日志采集模式时,须指定此参数。

[stop-strategy]应用优化停止策略,请选择其中一种配置。

run-times

指定优化次数,达到该次数时动态加速工具会停止优化,当前仅支持1次。

period

指定优化周期,达到该时间周期时停止优化,单位为秒,取值范围为1~600。

condition

指定优化条件,达到该条件时停止优化,当前不支持。