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/?a=commitdiff_plain;h=31e26a0f4917eb9a95f22af854bde91b42cd4064;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.
        * gas/NEWS: Announce the emission of new flag
	  SFRAME_F_FDE_FUNC_START_ADDR_PCREL.
        * ld/NEWS: Likewise.  Relocatable links are now fixed.

---
[Changes in V4]
  - In gas/NEWS, updated:
    From: "Setting the flag is necessary for fixing relocatable SFrame links"
    To: "Setting the flag ensures compliance with the updated SFrame V2 specification"
[End of changes in V4]

[Changes in V3]
  - Add items in gas/NEWS and ld/NEWS too.
  - Adjusted binutils/NEWS text a bit.
[End of changes in V3]

[No changes in V2]
---

diff --git a/binutils/NEWS b/binutils/NEWS
index a62410607a3..963cfe6538e 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
+  now default to this new encoding, setting the (new)
+  SFRAME_F_FDE_FUNC_START_ADDR_PCREL flag.
+
+  Relocatable SFrame links are now fixed.
+
 * Readelf now recognizes RISC-V GNU_PROPERTY_RISCV_FEATURE_1_CFI_SS and
   GNU_PROPERTY_RISCV_FEATURE_1_CFI_LP_UNLABELED for zicfiss and zicfilp
   extensions.
diff --git a/gas/NEWS b/gas/NEWS
index f0ffe2db54b..9e29bc191ea 100644
--- a/gas/NEWS
+++ b/gas/NEWS
@@ -1,5 +1,10 @@
 -*- text -*-
 
+* All SFrame sections generated by gas have the header flag
+  SFRAME_F_FDE_FUNC_START_ADDR_PCREL set.  gas was already emitting SFrame
+  sections with the applicable encoding.  Setting the flag ensures compliance
+  with the updated SFrame V2 specification.
+
 * Support for x86 AVX10.2 256 bit rounding has been dropped, as all the
   hardware would directly support 512 bit vecotr width.
 
diff --git a/ld/NEWS b/ld/NEWS
index b101dec4ed5..477e3a0bfd3 100644
--- a/ld/NEWS
+++ b/ld/NEWS
@@ -1,5 +1,10 @@
 -*- text -*-
 
+* All SFrame sections generated by the linker have the header flag
+  SFRAME_F_FDE_FUNC_START_ADDR_PCREL set to indicate the new encoding for
+  sfde_func_start_address field in the SFrame section.  Relocatable SFrame
+  links are now fixed.
+
 * On RISC-V, add new PLT formats, and GNU property merge rules for zicfiss and
   zicfilp extensions.