Add a Developer Resources section with links to ABI documentation by tgross35 · Pull Request #3047 · rust-lang/rustc-dev-guide

tgross35 · 2026-10-10T12:26:27Z

We need to refer to these rather often, but there hasn't been a common place to locate this information.

rustbot · 2026-10-10T12:26:30Z

Thanks for the PR. If you have write access, feel free to merge this PR if it does not need reviews. You can request a review using r? rustc-dev-guide or r? <username>.

tgross35 · 2026-10-10T12:28:23Z

+A 2018 version of the document "Qualcomm Hexagon Application Binary Interface" is available at
+<https://docs.qualcomm.com/doc/80-N2040-23/80-N2040-23_REV_K_Qualcomm_Hexagon_Application_Binary_Interface_User_Guide.pdf>.


@androm3da I know Hexagon undergoes active development, is this the most recent spec?

View changes since the review

I think there was one published this week - I'll find it.

https://docs.qualcomm.com/doc/80-N2040-23/

Since that PDF was published, Qualcomm has shifted towards webpage manuals. So I think this link should be where new ABI spec updates get published in the future.

Thanks! Added

programmerjake · 2026-10-10T12:52:51Z

+There are a few relevant documents for PowerPC ABI:
+
+* [_System V Application Binary Interface: PowerPC Processor
+  Supplement_](http://refspecs.linux-foundation.org/elf/elfspec_ppc.pdf) is the original 32-bit


Suggested change

Supplement_](http://refspecs.linux-foundation.org/elf/elfspec_ppc.pdf) is the original 32-bit

Supplement_](https://refspecs.linuxfoundation.org/elf/elfspec_ppc.pdf) is the original 32-bit

found a non-borked https url

View changes since the review

That's the one I was looking at too, updated it now

beetrees · 2026-10-10T13:18:44Z

+
+#### MIPS
+
+TODO link to o32, n32, and n64 if possible.


I looked into this a couple of years ago, and the best I found was:

o32: 3rd edition from February 1996: https://refspecs.linuxfoundation.org/elf/mipsabi.pdf
n32: "MIPSpro™ N32 ABI Handbook" from October 2002: https://irix7.com/techpubs/007-2816-005.pdf
n64: "MIPSpro™ 64-Bit Porting and Transition Guide": https://irix7.com/techpubs/007-2391-006.pdf

View changes since the review

I think the second doc also defines n64. Added all of these, thanks

beetrees · 2026-10-10T13:27:15Z

+  Supplement_](http://refspecs.linux-foundation.org/elf/elfspec_ppc.pdf) is the original 32-bit
+  PowerPC ABI specification.
+* [_Power Architecture™ 32-bit Application Binary Interface Supplement 1.0 - Linux® &
+  Embedded_](https://example61560.wordpress.com/wp-content/uploads/2016/11/powerpc_abi.pdf) is the


Better link: https://web.archive.org/web/20120608163804/https://www.power.org/resources/downloads/Power-Arch-32-bit-ABI-supp-1.0-Unified.pdf

View changes since the review

beetrees · 2026-10-10T13:30:47Z

+
+#### SPARC
+
+TODO


Available here: https://sparc.org/technical-documents/specifications/. "SCD 2.4.1" is the latest, with the 32-bit section just containing the (minor) changes from the previous version, "SPARC psABI 3.0".

View changes since the review

Added this one as well

tshepang · 2026-10-10T14:44:25Z

maybe name the page platform-specifics.md, though am thinking maybe this info should live in rustc book, which has platform-specific details

View changes since the review

I figured this can hold more than only platform specifics (even though that's all this PR adds), since we didn't really have a home for other things like that currently. Also considered the rustc book but I think this may be a bit niche for something user-facing, though I don't know what's best.

Developer Resources feels too general as a title, like for example, some of the other appendices could fit in that title

That's fair, since the whole thing is really a developer resource. Renamed to "additional resources" which I think is a bit better, though it still could match other appendix entries.

pmur · 2026-10-12T15:39:56Z

+  PowerPC64 targets.
+* [_64-bit ELF V2 ABI Specification: Power
+  Architecture_](https://openpower.foundation/specifications/64bitelfabi/) is the replacement ABI
+  and used by default on most PowerPC64 targets.


I think the links look OK. It's always a pain to dredge up these documents.

View changes since the review

We need to refer to these rather often, but there hasn't been a common place to locate this information.

tgross35 · 2026-10-14T12:43:04Z

Thanks all for taking a look

rustbot added the S-waiting-on-review Status: this PR is waiting for a reviewer to verify its content label Oct 10, 2026

tgross35 commented Oct 10, 2026

View reviewed changes

programmerjake reviewed Oct 10, 2026

View reviewed changes

beetrees reviewed Oct 10, 2026

View reviewed changes

tshepang reviewed Oct 10, 2026

View reviewed changes

tgross35 force-pushed the abi branch from 2d47b2a to 43997e4 Compare October 10, 2026 15:57

pmur reviewed Oct 12, 2026

View reviewed changes

Add a Developer Resources section with links to ABI documentation

0d73e1b

We need to refer to these rather often, but there hasn't been a common place to locate this information.

tgross35 force-pushed the abi branch from 43997e4 to 0d73e1b Compare October 14, 2026 12:40

tgross35 merged commit bfbca95 into rust-lang:main Oct 14, 2026
4 checks passed

rustbot removed the S-waiting-on-review Status: this PR is waiting for a reviewer to verify its content label Oct 14, 2026

tgross35 deleted the abi branch October 14, 2026 12:43

		A 2018 version of the document "Qualcomm Hexagon Application Binary Interface" is available at
		<https://docs.qualcomm.com/doc/80-N2040-23/80-N2040-23_REV_K_Qualcomm_Hexagon_Application_Binary_Interface_User_Guide.pdf>.

	Supplement_](http://refspecs.linux-foundation.org/elf/elfspec_ppc.pdf) is the original 32-bit
	Supplement_](https://refspecs.linuxfoundation.org/elf/elfspec_ppc.pdf) is the original 32-bit


		#### SPARC

		TODO

Conversation

tgross35 commented Oct 10, 2026

Uh oh!

rustbot commented Oct 10, 2026

Uh oh!

tgross35 Oct 10, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

programmerjake Oct 10, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

beetrees Oct 10, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

beetrees Oct 10, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

beetrees Oct 10, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tshepang Oct 10, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

pmur Oct 12, 2026 • edited by rustbot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

tgross35 commented Oct 14, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

tgross35 Oct 10, 2026 •

edited by rustbot

Loading

programmerjake Oct 10, 2026 •

edited by rustbot

Loading

beetrees Oct 10, 2026 •

edited by rustbot

Loading

beetrees Oct 10, 2026 •

edited by rustbot

Loading

beetrees Oct 10, 2026 •

edited by rustbot

Loading

tshepang Oct 10, 2026 •

edited by rustbot

Loading

pmur Oct 12, 2026 •

edited by rustbot

Loading