From: Indu Bhagat <indu.bhagat@oracle.com>
Date: Thu, 3 Apr 2025 19:26:09 +0000 (-0700)
Subject: NEWS: sframe: mention new semantics for SFrame FDE function start addr
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=603cc93252a4f1e3f4026d06c0cf7eb883be997c;p=thirdparty%2Fbinutils-gdb.git

NEWS: sframe: mention new semantics for SFrame FDE function start addr

The SFrame FDE's function start address is always emitted as follows by
GAS and ld:  it is the offset of the start PC of the respective function
from the FDE field itself.

GAS and ld will emit a flag SFRAME_F_FDE_FUNC_START_ADDR_PCREL set to 1
when emitting the field in this encoding.

binutils/
	* NEWS: Announce the change of encoding for SFrame FDE func
	start addr field.
---

diff --git a/binutils/NEWS b/binutils/NEWS
index a4599d91ad9..2e12486fdee 100644
--- a/binutils/NEWS
+++ b/binutils/NEWS
@@ -1,5 +1,15 @@
 -*- text -*-
 
+* For SFrame stack trace format, the function start address in each SFrame FDE
+  has a changed encoding:  The 32-bit signed integer now holds the offset of
+  the start PC of the associated function from the sfde_func_start_address
+  field itself (instead of the earlier where it was the offset from the start
+  of the SFrame section itself).  All SFrame sections generated by gas and ld
+  generate the new encoding by default, with the (new) flag set:
+  SFRAME_F_FDE_FUNC_START_ADDR_PCREL to indicate the changed encoding.
+
+  Relocatable SFrame links are now fixed.
+
 * For RISC-V dis-assembler, the definition of mapping symbol $x is changed,
   so the file needs to be rebuilt since 2.45 once used .option arch directives.