diff options
| author | David Wood <david.wood@huawei.com> | 2022-02-14 03:39:32 +0000 |
|---|---|---|
| committer | David Wood <david.wood@huawei.com> | 2022-04-18 03:47:51 +0100 |
| commit | 7593c50d431fdec34d9da2b820ce236f57757435 (patch) | |
| tree | 75dc9f6553f18f7f50d039e89d878fa3a65cc0de /config.toml.example | |
| parent | e27d9df4319bd822e64f620676543d31e9c7ae2c (diff) | |
| download | rust-7593c50d431fdec34d9da2b820ce236f57757435.tar.gz rust-7593c50d431fdec34d9da2b820ce236f57757435.zip | |
bootstrap: add split-debuginfo config
Replace `run-dysutil` option with more general `split-debuginfo` option that works on all platforms. Signed-off-by: David Wood <david.wood@huawei.com>
Diffstat (limited to 'config.toml.example')
| -rw-r--r-- | config.toml.example | 29 |
1 files changed, 22 insertions, 7 deletions
diff --git a/config.toml.example b/config.toml.example index 6e53d9b442f..b3946b67b0d 100644 --- a/config.toml.example +++ b/config.toml.example @@ -473,13 +473,28 @@ changelog-seen = 2 # FIXME(#61117): Some tests fail when this option is enabled. #debuginfo-level-tests = 0 -# Whether to run `dsymutil` on Apple platforms to gather debug info into .dSYM -# bundles. `dsymutil` adds time to builds for no clear benefit, and also makes -# it more difficult for debuggers to find debug info. The compiler currently -# defaults to running `dsymutil` to preserve its historical default, but when -# compiling the compiler itself, we skip it by default since we know it's safe -# to do so in that case. -#run-dsymutil = false +# Should rustc be build with split debuginfo? Default is platform dependent. +# Valid values are the same as those accepted by `-C split-debuginfo` +# (`off`/`unpacked`/`packed`). +# +# On Linux, packed split debuginfo is used by default, which splits debuginfo +# into a separate `rustc.dwp` file. Split DWARF on Linux results in lower +# linking times (there's less debuginfo for the linker to process), +# `split-debuginfo` is enabled on default for Linux. Unpacked debuginfo could +# technically work too, but the cost of running the DWARF packager is marginal +# and results in debuginfo being in a single file. +# +# On Apple platforms, unpacked split debuginfo is used by default. Unpacked +# debuginfo does not run `dsymutil`, which packages debuginfo from disparate +# object files into a single `.dSYM` file. `dsymutil` adds time to builds for +# no clear benefit, and also makes it more difficult for debuggers to find +# debug info. The compiler currently defaults to running `dsymutil` to preserve +# its historical default, but when compiling the compiler itself, we skip it by +# default since we know it's safe to do so in that case. +# +# On Windows platforms, packed debuginfo is the only supported option, +# producing a `.pdb` file. +#split-debuginfo = if linux { packed } else if windows { packed } else if apple { unpacked } # Whether or not `panic!`s generate backtraces (RUST_BACKTRACE) #backtrace = true |