Browse Source

[docs] Coverage: document issue with the BFD linker

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@305743 91177308-0d34-0410-b5e6-96231b3b80d8
Vedant Kumar 8 years ago
parent
commit
ff84b94035
1 changed files with 5 additions and 0 deletions
  1. 5 0
      docs/SourceBasedCodeCoverage.rst

+ 5 - 0
docs/SourceBasedCodeCoverage.rst

@@ -274,6 +274,11 @@ To specify an alternate directory for raw profiles, use
 Drawbacks and limitations
 Drawbacks and limitations
 =========================
 =========================
 
 
+* Prior to version 2.26, the GNU binutils BFD linker is not able link programs
+  with coverage enabled when the ``--gc-sections`` is enabled. The suggested
+  workaround is to either upgrade to a newer version of BFD, or to use the Gold
+  linker.
+
 * Code coverage does not handle unpredictable changes in control flow or stack
 * Code coverage does not handle unpredictable changes in control flow or stack
   unwinding in the presence of exceptions precisely. Consider the following
   unwinding in the presence of exceptions precisely. Consider the following
   function:
   function: