From efd7ef39ba4e78b4bf81197bd1c20052d45b5a72 Mon Sep 17 00:00:00 2001 From: sunface Date: Wed, 23 Feb 2022 09:47:21 +0800 Subject: [PATCH] update cargo profile --- contents/cargo/reference/profiles.md | 84 +++++++++++++++++++++++++++- 1 file changed, 83 insertions(+), 1 deletion(-) diff --git a/contents/cargo/reference/profiles.md b/contents/cargo/reference/profiles.md index 1143f49d..6e325b5e 100644 --- a/contents/cargo/reference/profiles.md +++ b/contents/cargo/reference/profiles.md @@ -45,6 +45,8 @@ cargo build --profile release-lto 与默认的 profile 相同，自定义 profile 的编译结果也存放在 [`target/`](https://course.rs/cargo/guide/build-cache.html) 下的同名目录中，例如 `--profile release-lto` 的输出结果存储在 `target/release-lto` 中。 +## 默认profile + ## profile设置 下面我们来看看 profile 中可以进行哪些优化设置。 @@ -68,4 +70,84 @@ cargo build --profile release-lto 如果想要了解更多，可以参考 [rustc 文档](https://doc.rust-lang.org/stable/rustc/profile-guided-optimization.html)，这里有更高级的优化技巧。 -#### lto \ No newline at end of file +#### debug +`debug` 控制 [`-C debuginfo`](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#debuginfo) 标志，而后者用于控制最终二进制文件输出的 `debug` 信息量。 + +支持的选项包括: + +- `0` 或 `false`：不输出任何 debug 信息 +- `1`: 行信息 +- `2`: 完整的 debug 信息 + +#### split-debuginfo +`split-debuginfo` 控制 [-C split-debuginfo](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#split-debuginfo) 标志，用于决定输出的 debug 信息是存放在二进制可执行文件里还是邻近的文件中。 + +#### debug-assertions +该字段控制 [-C debug-assertions](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#debug-assertions) 标志，可以开启或关闭其中一个[条件编译](https://doc.rust-lang.org/stable/reference/conditional-compilation.html#debug_assertions)选项： `cfg(debug_assertions)`。 + +`debug-assertion` 会提供运行时的检查，该检查只能用于 `debug` 模式，原因是对于 `release` 来说，这种检查的成本较为高昂。 + +大家熟悉的 [`debug_assert!`](https://course.rs/test/assertion.html#debug_assert-系列) 宏也是通过该标志开启的。 + + +支持的选项包括 : + +- `true`: 开启 +- `false`: 关闭 + +#### overflow-checks +用于控制 [-C overflow-checks](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#overflow-checks) 标志，该标志可以控制运行时的整数溢出行为。**当开启后，整数溢出会导致 `panic`**。 + +支持的选项包括 : + +- `true`: 开启 +- `false`: 关闭 + +#### lto +`lto` 用于控制 [`-C lto`](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#lto) 标志，而后者可以控制 LLVM 的[链接时优化( link time optimizations )](https://llvm.org/docs/LinkTimeOptimization.html)。通过对整个程序进行分析，并以增加链接时间为代价，LTO 可以生成更加优化的代码。 + +支持的选项包括： + +- `false`: 只会对代码生成单元中的本地包进行 `thin LTO` 优化，若代码生成单元数为 1 或者 `opt-level` 为 0，则不会进行任何 LTO 优化 +- `true` 或 `fat`：对依赖图中的所有包进行 `fat LTO` 优化 +- `thin`：对依赖图的所有包进行 [`thin LTO`](http://blog.llvm.org/2016/06/thinlto-scalable-and-incremental-lto.html)，相比 `fat` 来说，它仅牺牲了一点性能，但是换来了链接时间的可观减少 +- `off`： 禁用 LTO + +如果大家想了解跨语言 LTO，可以看下 [-C linker-plugin-lto](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#linker-plugin-lto) 标志。 + +#### panic +`panic` 控制 [-C panic](https://doc.rust-lang.org/stable/cargo/reference/profiles.html#codegen-units) 标志，它可以控制 `panic` 策略的选择。 + +支持的选项包括: + +- `"unwind"`: 遇到 panic 后对栈进行展开( unwind ) +- `"abort"`: 遇到 panic 后直接停止程序 + +当设置为 `"unwind"` 时，具体的栈展开信息取决于特定的平台，例如 `NVPTX` 不支持 `unwind`，因此程序只能 "abort"。 + +测试、基准性能测试、构建脚本和过程宏会忽略 `panic` 设置，目前来说它们要求是 `"unwind"`，如果大家希望修改成 `"abort"`，可以看看 [panic-abort-tests ](https://doc.rust-lang.org/stable/cargo/reference/unstable.html#panic-abort-tests)。 + +另外，当你使用 `"abort"` 策略且在执行测试时，由于上述的要求，除了测试代码外，所有的依赖库也会忽略该 `"abort"` 设置而使用 `"unwind"` 策略。 + +#### incremental +`incremental` 控制 [-C incremental](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#incremental) 标志，用于开启或关闭增量编译。开启增量编译时，`rustc` 会将必要的信息存放到硬盘中( `target` 目录中 )，当下次编译时，这些信息可以被复用以改善编译时间。 + +支持的选项包括: + +- `true`： 启用 +- `false`: 关闭 + +**增量编译只能用于工作空间的成员和通过 `path` 引入的本地依赖。** + +大家还可以通过[环境变量](https://doc.rust-lang.org/stable/cargo/reference/environment-variables.html) `CARGO_INCREMENTAL` 或 Cargo 配置 [build.incremental](https://doc.rust-lang.org/stable/cargo/reference/config.html#buildincremental) 在全局对 `incremental` 进行覆盖。 + +#### codegen-units +`codegen-units` 控制 [-C codegen-units](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#codegen-units) 标志，可以指定一个包会被分隔为多少个代码生成单元。**更多的代码生成单元会提升代码的并行编译速度，但是可能会降低运行速度。** + +对于增量编译，默认值是 256，非增量编译是 16。 + +#### r-path +用于控制 [-C rpath](https://doc.rust-lang.org/stable/rustc/codegen-options/index.html#rpath)标志，可以控制 [`rpath`](https://en.wikipedia.org/wiki/Rpath) 的启用与关闭。 + +`rpath` 代表硬编码到二进制可执行文件或库文件中的**运行时代码搜索(runtime search path)**，动态链接库的加载器就通过它来搜索所需的库。 +