[lld-macho][nfc] Added some notes on deliberate differences btw LD64 vs LLD-MACHO

For future references and to help with debugging crashes, this could be useful.

Differential Revision: https://reviews.llvm.org/D110464
This commit is contained in:
Vy Nguyen 2021-09-24 21:39:30 -04:00
parent edff0070a1
commit 6b715e9c4d
1 changed files with 16 additions and 0 deletions

16
lld/MachO/ld64-vs-lld.rst Normal file
View File

@ -0,0 +1,16 @@
==================
LD64 vs LLD-MACHO
==================
This doc lists all significant deliberate differences in behavior between LD64 and LLD-MachO.
ObjC symbols treatment
**********************
There are differences in how LLD and LD64 handle ObjC symbols loaded from archives.
- LD64:
* Duplicate ObjC symbols from the same archives will not raise an error. LD64 will pick the first one.
* Duplicate ObjC symbols from different archives will raise a "duplicate symbol" error.
- LLD:
* Duplicate symbols, regardless of which archives they are from, will raise errors.