[lld] r259606 - ELF: Write about the current policy to README.

Rui Ueyama via llvm-commits llvm-commits at lists.llvm.org
Tue Feb 2 15:45:54 PST 2016

Author: ruiu
Date: Tue Feb  2 17:45:54 2016
New Revision: 259606

URL: http://llvm.org/viewvc/llvm-project?rev=259606&view=rev
ELF: Write about the current policy to README.


Modified: lld/trunk/ELF/README.md
URL: http://llvm.org/viewvc/llvm-project/lld/trunk/ELF/README.md?rev=259606&r1=259605&r2=259606&view=diff
--- lld/trunk/ELF/README.md (original)
+++ lld/trunk/ELF/README.md Tue Feb  2 17:45:54 2016
@@ -19,3 +19,16 @@ Achieving good performance is one of our
 conclusion, but we are optimistic about that as it currently seems to be faster
 than GNU gold. It will be interesting to compare when we are close to feature
+Library Use
+You can embed LLD to your program by linking against it and calling the linker's
+entry point function lld::elf2::link.
+The current policy is that it is your reponsibility to give trustworthy object
+files. The function is guaranteed to return as long as you do not pass corrupted
+or malicious object files. A corrupted file could cause a fatal error or SEGV.
+That being said, you don't need to worry too much about it if you create object
+files in a usual way and give them to the linker (it is naturally expected to
+work, or otherwise it's a linker's bug.)

More information about the llvm-commits mailing list