Skip to content

Commit d66a8fd

Browse files
committed
WIP: Begin documenting other link section formats
1 parent d0dc4f9 commit d66a8fd

1 file changed

Lines changed: 30 additions & 0 deletions

File tree

src/abi.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,6 +121,26 @@ r[abi.link_section.format]
121121
The format of the `link_section` attribute is platform-specific, and the
122122
supported options varies depending on the underlying object file format.
123123

124+
r[abi.link_section.elf]
125+
### Link section ELF format
126+
127+
TODO, maybe document `.hash` -> `SHT_HASH` etc.?
128+
129+
Or perhaps just link to <https://www.man7.org/linux/man-pages/man5/elf.5.html#:~:text=Various%20sections%20hold%20program%20and%20control%20information>?
130+
131+
r[abi.link_section.coff]
132+
### Link section COFF format
133+
134+
TODO. Something like:
135+
136+
r[abi.link_section.coff.syntax]
137+
```grammar,attributes
138+
COFFLinkSection -> IDENTIFIER (`$` COFFOrder)?
139+
COFFOrder -> IDENTIFIER
140+
```
141+
142+
See <https://learn.microsoft.com/en-us/windows/win32/debug/pe-format>.
143+
124144
r[abi.link_section.mach-o]
125145
### Link section Mach-O format
126146

@@ -146,6 +166,16 @@ Mach-O has four configurable fields: the segment, the section, the section type
146166
r[abi.link_section.mach-o.default-type]
147167
The section type defaults to `regular` if not set.
148168

169+
r[abi.link_section.wasm]
170+
### Link section WebAssembly format
171+
172+
TODO.
173+
174+
r[abi.link_section.coff]
175+
### Link section XCOFF format
176+
177+
TODO.
178+
149179
r[abi.export_name]
150180
## The `export_name` attribute
151181

0 commit comments

Comments
 (0)