]> git.lizzy.rs Git - rust.git/commitdiff
rustc-book: Document `-Z strip=val` option
authorVadim Petrochenkov <vadim.petrochenkov@gmail.com>
Mon, 11 May 2020 15:13:51 +0000 (18:13 +0300)
committerVadim Petrochenkov <vadim.petrochenkov@gmail.com>
Mon, 11 May 2020 15:16:40 +0000 (18:16 +0300)
src/doc/unstable-book/src/compiler-flags/strip.md [new file with mode: 0644]

diff --git a/src/doc/unstable-book/src/compiler-flags/strip.md b/src/doc/unstable-book/src/compiler-flags/strip.md
new file mode 100644 (file)
index 0000000..52cb981
--- /dev/null
@@ -0,0 +1,17 @@
+# `strip`
+
+The tracking issue for this feature is: [#72110](https://github.com/rust-lang/rust/issues/72110).
+
+------------------------
+
+Option `-Z strip=val` controls stripping of debuginfo and similar auxiliary data from binaries
+during linking.
+
+Supported values for this option are:
+
+- `none` - debuginfo and symbols (if they exist) are copied to the produced binary or separate files
+depending on the target (e.g. `.pdb` files in case of MSVC).
+- `debuginfo` - debuginfo sections and debuginfo symbols from the symbol table section
+are stripped at link time and are not copied to the produced binary or separate files.
+- `symbols` - same as `debuginfo`, but the rest of the symbol table section is stripped as well
+if the linker supports it.