Skip to content

Commit ee954eb

Browse files
committed
WIP: Begin documenting other link section formats
1 parent 7f2c7d5 commit ee954eb

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

@@ -152,6 +172,16 @@ size.
152172
r[abi.link_section.mach-o.default-type]
153173
The section type defaults to `regular` if not set.
154174

175+
r[abi.link_section.wasm]
176+
### Link section WebAssembly format
177+
178+
TODO.
179+
180+
r[abi.link_section.coff]
181+
### Link section XCOFF format
182+
183+
TODO.
184+
155185
r[abi.export_name]
156186
## The `export_name` attribute
157187

0 commit comments

Comments
 (0)