bjoernager/rust
bjoernager/rust
1
Fork 0
Code Activity

Revise strip-symbols paragraph

Browse source
This commit is contained in:
Jubilee Young 2024-04-01 14:07:59 -07:00
parent 973663db9d
commit 4994f73a27
1 changed files with 5 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

11
src/doc/rustc/src/codegen-options/index.md
View file

@ -555,12 +555,11 @@ Supported values for this option are:
section are stripped at link time and are not copied to the produced binary section are stripped at link time and are not copied to the produced binary
or separate files. This should leave backtraces mostly-intact but may make or separate files. This should leave backtraces mostly-intact but may make
using a debugger like gdb or lldb ineffectual. using a debugger like gdb or lldb ineffectual.
- `symbols` - same as `debuginfo`, but the rest of the symbol table section is - `symbols` - same as `debuginfo`, but the rest of the symbol table section is stripped as well,
stripped as well if the linker supports it. On platforms which depend on the depending on platform support. On platforms which depend on this symbol table for backtraces,
binary's symbol table for backtraces, profiling, and similar, this can affect profiling, and similar, this can affect them so negatively as to make the trace incomprehensible.
them so negatively as to make the results completely incomprehensible. Programs which may be combined with others, such as CLI pipelines and developer tooling,
Programs which may be combined with others, using e.g. CLI pipelines, or any or even anything which wants crash-reporting, should usually avoid `-Cstrip=symbols`.
developer tooling whatsoever, should avoid stripping symbols for this reason.
## symbol-mangling-version ## symbol-mangling-version