diff options
| author | Jonas Devlieghere <jonas@devlieghere.com> | 2023-09-22 11:27:33 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-09-22 11:27:33 -0700 |
| commit | 697b34fd966bef0a94e67870a5517e8102751c46 (patch) | |
| tree | 7f79a3ceab72abb6b5e032b4283bf40e1d799adc /llvm/docs/CommandGuide | |
| parent | d7359bcc760a1229f8dadae8fde4784cad57a839 (diff) | |
| download | llvm-697b34fd966bef0a94e67870a5517e8102751c46.zip llvm-697b34fd966bef0a94e67870a5517e8102751c46.tar.gz llvm-697b34fd966bef0a94e67870a5517e8102751c46.tar.bz2 | |
[dsymutil] Remove paper trail warnings (#67041)
Remove the paper trail warning from dsymutil and the DWARF linker. The
original purpose of this functionality was to leave a paper trail in the
output artifact about missing object files. The current implementation
however has diverged and is the source of a pretty serious bug:
- In the debug map parser, missing object files are not the only
warnings we emit. When paper trail warnings are enabled, all of them end
up in the dSYM which wasn't the goal.
- When warnings are associated with a object file in the debug map, it
is skipped by the DWARF linker. This only makes sense if the object file
is missing and is obviously incorrect for any other type of warning
(such as a missing symbol).
The combination of the two means that we can generate broken DWARF when
the feature is enabled. AFAIK it was only used by Apple and nobody I
spoke to has relied on it, so rather than fixing the broken behavior I
propose we remove it.
Diffstat (limited to 'llvm/docs/CommandGuide')
| -rw-r--r-- | llvm/docs/CommandGuide/dsymutil.rst | 7 |
1 files changed, 0 insertions, 7 deletions
diff --git a/llvm/docs/CommandGuide/dsymutil.rst b/llvm/docs/CommandGuide/dsymutil.rst index 0cc2a47..02243e2 100644 --- a/llvm/docs/CommandGuide/dsymutil.rst +++ b/llvm/docs/CommandGuide/dsymutil.rst @@ -100,13 +100,6 @@ OPTIONS Specifies an alternate ``path`` to place the dSYM bundle. The default dSYM bundle path is created by appending ``.dSYM`` to the executable name. -.. option:: --papertrail - - When running dsymutil as part of your build system, it can be desirable for - warnings to be part of the end product, rather than just being emitted to the - output stream. When enabled warnings are embedded in the linked DWARF debug - information. - .. option:: --remarks-drop-without-debug Drop remarks without valid debug locations. Without this flags, all remarks are kept. |