
# 配置文件
本节提供了[静态加速配置文件]和[动态加速配置文件]中每个配置项的说明。
 #### 静态加速配置文件
应用加速工具默认静态加速配置信息如下，您可以自定义配置文件来优化应用。
图1应用加速工具默认静态加速配置信息示例   
![](https://support.huaweicloud.com/usermanual-hce/zh-cn_image_0000002480089048.png "点击放大")
表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。   |
   
 表2binary参数说明 
| 选项名                | 值类型    | 默认值                  | 选项描述               |
|:---|:---|:---|:---|
| binary_out_path    | string | "/data/hce-wae-auto" | 定义自动生成的二进制文件的保存路径。 |
| binary_file_suffix | string | "bolt.auto"          | 定义自动生成的二进制文件名后缀。   |
   
#### 静态加速配置文件示例
```
[binary]
binary_out_path = "/data/llvm_auto"
binary_num_threshold = 1000
binary_file_suffix = "bolt.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的参数组合
```
 #### 动态加速配置文件
应用加速工具默认动态加速配置信息如下，您可以自定义配置文件来优化应用。
图2应用加速工具默认动态加速配置信息示例   
![](https://support.huaweicloud.com/usermanual-hce/zh-cn_image_0000002512128967.png "点击放大")
配置文件中模块含义：
\[mission\]：优化运行中的应用所要配置的参数。
\[stop-strategy\]：应用优化停止策略，请选择其中一种配置。
表3配置信息说明 
| 模块名               | 参数名           | 描述                                    |
|:---|:---|:---|
| \[mission\]       | log-type      | 运行时日志采集方式，当前仅支持instrument方式。          |
| \[mission\]       | hotpatch-type | 热补丁模式，当前仅支持mode1即ptrace方式。            |
| \[mission\]       | snapshot-path | 优化后的二进制快照文件存放的目录路径。                   |
| \[mission\]       | origin-exe    | 原始应用的位置，使用instrument日志采集模式时，须指定此参数。   |
| \[stop-strategy\] | run-times     | 指定优化次数，达到该次数时动态加速工具会停止优化，当前仅支持1次。     |
| \[stop-strategy\] | period        | 指定优化周期，达到该时间周期时停止优化，单位为秒，取值范围为1\~600。 |
   
