[binutils-gdb] ld: Document -pie -Ttext-segment=ORG generates ET_EXEC

[H.J. Lu]

https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=0daa17bf187cebd5b200f4fd5405cc55e75c391f

commit 0daa17bf187cebd5b200f4fd5405cc55e75c391f
Author: H.J. Lu <hjl.tools@gmail.com>
Date:   Sat May 25 07:44:59 2024 -0700

    ld: Document -pie -Ttext-segment=ORG generates ET_EXEC
    
    This is the v2 patch I am checking in.
    
    H.J.

Diff:
---
 ld/ld.texi | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/ld/ld.texi b/ld/ld.texi
index dd0af8e4f5e..ef3706fa7ac 100644
--- a/ld/ld.texi
+++ b/ld/ld.texi
@@ -2694,7 +2694,10 @@ Same as @option{--section-start}, with @code{.bss}, @code{.data} or
 @item -Ttext-segment=@var{org}
 @cindex text segment origin, cmd line
 When creating an ELF executable, it will set the address of the first
-byte of the text segment.
+byte of the text segment.  Note that when @option{-pie} is used with
+@option{-Ttext-segment=@var{org}}, the output executable is marked
+ET_EXEC so that the address of the first byte of the text segment will
+be guaranteed to be @var{org} at run time.
 
 @kindex -Trodata-segment=@var{org}
 @item -Trodata-segment=@var{org}