WORKING DRAFT www.openpowerfoundation.org 64-Bit ELF V2 ABI Specification June 25, 2020 Revision 1.5_prd 64-Bit ELF V2 ABI Specification: Power Architecture System Software Work Group <[email protected]> IBM Revision 1.5_prd (June 25, 2020) Copyright © 2014-2020 OpenPOWER Foundation Copyright © 1999,2003, 2004, 2013, 2014 IBM Corporation WORKING DRAFT - Copyright © 2011 Power.org Copyright © 2003, 2004 Free Standards Group Copyright © 2002 Freescale Semiconductor, Inc Licensed under the GNU Free Documentation License, Version 1.3; with no Invariants Sections, with no Front-Cover Texts, and with no Back-Cover Texts (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.gnu.org/licenses/fdl-1.3.txt The limited permissions granted above are perpetual and will not be revoked by OpenPOWER or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis AND TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE OpenPOWER Foundation AS WELL AS THE AUTHORS AND DEVELOPERS OF THIS STANDARDS FINAL DELIVERABLE OR OTHER WORKING DRAFT - DOCUMENT HEREBY DISCLAIM ALL OTHER WARRANTIES AND CONDITIONS, EITHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO, ANY IMPLIED WARRANTIES, DUTIES OR CONDITIONS OF MERCHANTABILITY, OF FITNESS FOR A PARTICULAR PURPOSE, OF ACCURACY OR COMPLETENESS OF RESPONSES, OF RESULTS, OF WORKMANLIKE EFFORT, OF LACK OF VIRUSES, OF LACK OF NEGLIGENCE OR NON-INFRINGEMENT. OpenPOWER, the OpenPOWER logo, and openpowerfoundation.org are trademarks or registered trademarks of OpenPOWER Foundation, Inc., registered in many jurisdictions worldwide. Other company, product, and service names may be trademarks or service marks of others. Abstract The Executable and Linking Format (ELF) defines a linking interface for executables and shared objects in two parts: the first part is the generic System V ABI, the second part is a processor-specific supple- ment. WORKING DRAFT - This document, the OpenPOWER ABI for Linux Supplement for the Power Architecture 64-bit ELF V2 ABI, is the OpenPOWER-compliant processor-specific supplement for use with ELF V2 on 64-bit IBM Power Architecture® systems. This is not a complete System V ABI supplement because it does not define any library interfaces. This document establishes both big-endian and little-endian application binary interfaces. OpenPOW- ER-compliant processors in the 64-bit Power Architecture can execute in either big-endian or little-endian mode. Executables and executable-generated data (in general) that subscribes to either byte ordering is not portable to a system running in the other mode. This document is a Standards Track, Work Group work product owned by the System Software Workgroup and handled in compliance with the requirements outlined in the OpenPOWER Founda- tion Work Group (WG) Process document. It was created using the Master Template Guide version 1.0. Comments, questions, etc. can be submitted to the public mailing list for this document at WORKING DRAFT - <[email protected]>. OpenPOWER Foundation Workgroup Specification Work Group Confidential ii Standard Track WORKING DRAFT - WORKING DRAFT - WORKING DRAFT - WORKING DRAFT - WORKING DRAFT - WORKING DRAFT - WORKING DRAFT - WORKING DRAFT - 64-Bit ELF V2 ABI Specification June 25, 2020 Revision 1.5_prd Table of Contents Preface .......................................................................................................................................... ix 1. Conventions ...................................................................................................................... ix 2. Document change history ................................................................................................... x About this Document ..................................................................................................................... xi WORKING DRAFT - 1. Introduction ................................................................................................................................ 1 1.1. Reference Documentation ............................................................................................... 1 1.2. Changes from Revision 1.4 ............................................................................................. 2 2. Low-Level System Information ................................................................................................... 3 2.1. Machine Interface ............................................................................................................ 3 2.2. Function Calling Sequence ........................................................................................... 24 2.3. Coding Examples .......................................................................................................... 51 2.4. DWARF Definition ......................................................................................................... 75 2.5. Exception Handling ....................................................................................................... 76 3. Object Files .............................................................................................................................. 77 3.1. ELF Header .................................................................................................................. 77 3.2. Special Sections ............................................................................................................ 77 3.3. TOC .............................................................................................................................. 78 3.4. Symbol Table ................................................................................................................ 79 WORKING DRAFT - 3.5. Relocation Types ........................................................................................................... 81 3.6. Assembler- and Linker-Mediated Executable Optimization ............................................. 94 3.7. Thread Local Storage ABI ............................................................................................. 96 3.8. System Support Functions and Extensions ................................................................. 111 4. Program Loading and Dynamic Linking .................................................................................. 114 4.1. Program Loading ......................................................................................................... 114 4.2. Dynamic Linking .......................................................................................................... 123 5. Libraries ................................................................................................................................. 129 5.1. Library Requirements .................................................................................................. 129 5.2. POWER ISA-Specific API and ABI Extensions ............................................................ 131 6. Vector Programming Interfaces .............................................................................................. 132 6.1. Vector Data Types ....................................................................................................... 132 6.2. Vector Operators ......................................................................................................... 133 6.3. Vector Layout and Element Numbering ....................................................................... 133 WORKING DRAFT - 6.4. Vector Built-in Functions .............................................................................................. 134 6.5. Language-Specific Vector Support for Other Languages .............................................. 139 6.6. Library Interfaces ........................................................................................................ 141 A. Predefined Functions for Vector Programming ....................................................................... 143 A.1. Vector Built-In Functions ............................................................................................. 143 A.2. Built-In Vector Predicate Functions ............................................................................. 198 A.3. Coding Support ........................................................................................................... 206 A.4. VSCR Management Built-in Functions ........................................................................ 209 A.5. PowerSIMD API Named Constants ............................................................................. 210 A.6. Deprecated Compatibility Functions ............................................................................ 211 A.7. Deprecated Functions ................................................................................................. 218 B. Binary-Coded Decimal Built-In Functions ............................................................................... 236 B.1. BCD Header Functions ............................................................................................... 238 C. Glossary ................................................................................................................................ 242 WORKING DRAFT - D. OpenPOWER Foundation overview ......................................................................................