]> git.ipfire.org Git - thirdparty/binutils-gdb.git/commitdiff
NEWS: sframe: mention new semantics for SFrame FDE function start addr
authorIndu Bhagat <indu.bhagat@oracle.com>
Thu, 3 Apr 2025 19:26:09 +0000 (12:26 -0700)
committerIndu Bhagat <indu.bhagat@oracle.com>
Wed, 25 Jun 2025 19:57:51 +0000 (12:57 -0700)
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]

binutils/NEWS
gas/NEWS
ld/NEWS

index a62410607a32ca6a13d534c2ab1d8b6e8ac5d05b..963cfe6538eadb3392a576f9803dad26d83f6b21 100644 (file)
@@ -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.
index f0ffe2db54ba9a36e7caf96ee4ec5352bec4b215..9e29bc191ea43fa65a474d53bc44541209f2e390 100644 (file)
--- 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 b101dec4ed52e2e764d50b197aa5b55ca7a278f1..477e3a0bfd372c2312b4ef736948d69a88fa82b5 100644 (file)
--- 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.