itsscb/cargo
1
0
Fork 0
mirror of https://github.com/rust-lang/cargo.git synced 2025-09-25 11:14:46 +00:00
Code Issues Packages Projects Releases Wiki Activity

Auto merge of #12407 - keith:ks/clarify-lto-setting-passing-clinker-plugin-lto, r=ehuss

Browse Source 
Clarify `lto` setting passing `-Clinker-plugin-lto`

Previously this document implied that the `lto` setting only controlled `-C lto` but in some cases it can also pass `-C linker-plugin-lto`

1b3eb297f9/src/cargo/core/compiler/mod.rs (L1234)
This commit is contained in:
bors 2023-07-28 18:03:39 +00:00
commit e9999571f6
1 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
src/doc/src/reference/profiles.md
View File

@ -155,9 +155,10 @@ The valid options are:
#### lto
The `lto` setting controls the [`-C lto` flag] which controls LLVM's [link
time optimizations]. LTO can produce better optimized code, using
whole-program analysis, at the cost of longer linking time.
The `lto` setting controls `rustc`'s [`-C lto`], [`-C linker-plugin-lto`], and
[`-C embed-bitcode`] options, which control LLVM's [link time optimizations].
LTO can produce better optimized code, using whole-program analysis, at the cost
of longer linking time.
The valid options are:
@ -171,11 +172,15 @@ The valid options are:
similar to "fat".
* `"off"`: Disables LTO.
See also the [`-C linker-plugin-lto`] `rustc` flag for cross-language LTO.
See the [linker-plugin-lto chapter] if you are interested in cross-language LTO.
This is not yet supported natively in Cargo, but can be performed via
`RUSTFLAGS`.
[`-C lto` flag]: ../../rustc/codegen-options/index.html#lto
[`-C lto`]: ../../rustc/codegen-options/index.html#lto
[link time optimizations]: https://llvm.org/docs/LinkTimeOptimization.html
[`-C linker-plugin-lto`]: ../../rustc/codegen-options/index.html#linker-plugin-lto
[`-C embed-bitcode`]: ../../rustc/codegen-options/index.html#embed-bitcode
[linker-plugin-lto chapter]: ../../rustc/linker-plugin-lto.html
["thin" LTO]: http://blog.llvm.org/2016/06/thinlto-scalable-and-incremental-lto.html
#### panic