ARM-software / abi-aa

Application Binary Interface for the Arm® Architecture
Other
938 stars 188 forks source link

[DesignDocuments] Rationale for GNU Properties in sysvabi #229

Open smithp35 opened 11 months ago

smithp35 commented 11 months ago

Add a design rationale for use of GNU properties as well as guidelines for how these should be used for properties in the AArch64 processor space.

Pull request https://github.com/ARM-software/abi-aa/pull/228 moves the GNU properties and other dynamic section properties specific to SystemV ABI to the SystemV ABI document.

Arm has typically left metadata in exectuables and shared-libraries to the platform. Only defining metadata for relocatable objects. With platforms such as Linux the most frequently run software on AArch64, Arm needs to document the metadata that it is using for SystemV platforms.

We have chosen to use GNU properties and to document these in the sysvabi64.rst document.

smithp35 commented 11 months ago

I don't think the PDF creation is to do with this pull-request as I didn't add the directory to the generate-pdfs script and the same attribute error happens in other documents.

Looks like we may need to upgrade rst2pdf to 0.101 for python 3.12 compatibility.