aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAustin Clements <austin@google.com>2024-12-26 17:58:32 -0500
committerAustin Clements <austin@google.com>2025-01-02 08:05:13 -0800
commit660603b9713a79910b66260598546926f798c66a (patch)
treefdccbd49db7d6077e3fc155f75831c6e0758096b
parent4363924f06c8e74de37c8a80a6e089d456e885a8 (diff)
downloadgo-x-website-660603b9713a79910b66260598546926f798c66a.tar.xz
_content/doc/go1.24: edit debug/elf section
This API changed since this section was written. Also, make it much more succinct. Change-Id: Id22dd3203b453d245e40d91dccc2dc2e1a42e672 Reviewed-on: https://go-review.googlesource.com/c/website/+/638879 LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Reviewed-by: Ian Lance Taylor <iant@google.com>
-rw-r--r--_content/doc/go1.24.md30
1 files changed, 11 insertions, 19 deletions
diff --git a/_content/doc/go1.24.md b/_content/doc/go1.24.md
index e8cc2fe3..2fd85e2b 100644
--- a/_content/doc/go1.24.md
+++ b/_content/doc/go1.24.md
@@ -514,27 +514,19 @@ revert to recomputing the CRT values.
#### [`debug/elf`](/pkg/debug/elf/)
-The [`debug/elf`](/pkg/debug/elf) package adds several new constants, types, and methods to add support for handling dynamic versions and version flags in ELF (Executable and Linkable Format) files:
-
-Several new types have been introduced:
-- [`DynamicVersion`](/pkg/debug/elf#DynamicVersion) struct represents a dynamic version entry in the ELF file.
-- [`DynamicVersionDep`](/pkg/debug/elf#DynamicVersionDep) struct represents a dependency of a dynamic version.
-- [`DynamicVersionNeed`](/pkg/debug/elf#DynamicVersionNeed) struct represents a required dynamic version in the ELF file.
-- [`DynamicVersionFlag`](/pkg/debug/elf#DynamicVersionFlag) is a new type defined as uint16, representing flags for dynamic versions.
- - [`VER_FLG_BASE`](/pkg/debug/elf#VER_FLG_BASE) version definition of the file.
- - [`VER_FLG_WEAK`](/pkg/debug/elf#VER_FLG_WEAK) weak version identifier.
- - [`VER_FLG_INFO`](/pkg/debug/elf#VER_FLG_INFO) reference exists for informational purposes.
-- [`SymbolVersionFlag`](/pkg/debug/elf#SymbolVersionFlag) is a new type defined as uint8, representing version flags for ELF symbols.
- - [`VerFlagNone`](/pkg/debug/elf#VerFlagNone) no flags.
- - [`VerFlagLocal`](/pkg/debug/elf#VerFlagLocal) symbol has local scope.
- - [`VerFlagGlobal`](/pkg/debug/elf#VerFlagGlobal) symbol has global scope.
- - [`VerFlagHidden`](/pkg/debug/elf#VerFlagHidden) symbol is hidden.
-
-The following methods have been added:
-- [`File.DynamicVersionNeeds`](/pkg/debug/elf#File.DynamicVersionNeeds) method returns a list of dynamic version needs in the ELF file, representing dependencies required by the executable.
-- [`File.DynamicVersions`](/pkg/debug/elf#File.DynamicVersions) retrieves a list of dynamic versions defined in the ELF file.
<!-- go.dev/issue/63952 -->
+The [`debug/elf`](/pkg/debug/elf) package adds support for handling symbol
+versions in dynamic ELF (Executable and Linkable Format) files.
+The new [`File.DynamicVersions`](/pkg/debug/elf#File.DynamicVersions) method
+returns a list of dynamic versions defined in the ELF file.
+The new [`File.DynamicVersionNeeds`](/pkg/debug/elf#File.DynamicVersionNeeds)
+method returns a list of dynamic versions required by this ELF file that are
+defined in other ELF objects.
+Finally, the new [`Symbol.HasVersion`](/pkg/debug/elf#Symbol) and
+[`Symbol.VersionIndex`](/pkg/debug/elf#Symbol) fields indicate the version of a
+symbol.
+
#### [`encoding`](/pkg/encoding/)
Two new interfaces, [`TextAppender`](/pkg/encoding#TextAppender) and [`BinaryAppender`](/pkg/encoding#BinaryAppender), have been