[4/4] ld: Document --text-section-ordering-file FILE
Checks
Commit Message
--text-section-ordering-file FILE is supported only in ELF and PE COFF
linkers which support input .text.* sections.
* NEWS: Mention --text-section-ordering-file FILE.
* ld.texi: Document text-section-ordering-file FILE.
---
ld/NEWS | 3 +++
ld/ld.texi | 11 +++++++++++
2 files changed, 14 insertions(+)
@@ -1,5 +1,8 @@
-*- text -*-
+* Add the linker option, --text-section-ordering-file FILE, for ELF and
+ PE COFF linker to specify the input text section order.
+
Changes in 2.42:
* Add -z mark-plt/-z nomark-plt options to x86-64 ELF linker to mark PLT
@@ -2541,6 +2541,17 @@ patterns in the linker script.
This option will apply @code{SORT_BY_ALIGNMENT} to all wildcard section
patterns in the linker script.
+@kindex text-section-ordering-file=@file{file}
+@item text-section-ordering-file=@file{file}
+This option groups input text sections together in the order specified
+in the file which contains the list of text section wildcards starting
+with @code{.}, separated by whitespace.
+
+If the @option{verbose} option is enabled, the contents of the text
+section ordering file will be reported.
+
+This option is supported only in ELF and PE COFF linkers.
+
@kindex --spare-dynamic-tags
@item --spare-dynamic-tags=@var{count}
This option specifies the number of empty slots to leave in the