From: H.J. Lu <hjl.tools@gmail.com>
Date: Sat, 25 May 2024 14:44:59 +0000 (-0700)
Subject: ld: Document -pie -Ttext-segment=ORG generates ET_EXEC
X-Git-Tag: gdb-15-branchpoint~1
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=0daa17bf187cebd5b200f4fd5405cc55e75c391f;p=thirdparty%2Fbinutils-gdb.git

ld: Document -pie -Ttext-segment=ORG generates ET_EXEC

This is the v2 patch I am checking in.

H.J.
---

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}