1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<!-- This file documents the GNU linker LD 4(GNU Toolchain for the A-profile Architecture 10.3-2021.07 (arm-10.29)) 5version 2.36.1. 6 7Copyright (C) 1991-2021 Free Software Foundation, Inc. 8 9Permission is granted to copy, distribute and/or modify this document 10under the terms of the GNU Free Documentation License, Version 1.3 11or any later version published by the Free Software Foundation; 12with no Invariant Sections, with no Front-Cover Texts, and with no 13Back-Cover Texts. A copy of the license is included in the 14section entitled "GNU Free Documentation License". --> 15<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 16<head> 17<title>LD: HPPA ELF32</title> 18 19<meta name="description" content="LD: HPPA ELF32"> 20<meta name="keywords" content="LD: HPPA ELF32"> 21<meta name="resource-type" content="document"> 22<meta name="distribution" content="global"> 23<meta name="Generator" content="makeinfo"> 24<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 25<link href="index.html#Top" rel="start" title="Top"> 26<link href="LD-Index.html#LD-Index" rel="index" title="LD Index"> 27<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 28<link href="Machine-Dependent.html#Machine-Dependent" rel="up" title="Machine Dependent"> 29<link href="M68K.html#M68K" rel="next" title="M68K"> 30<link href="ARM.html#ARM" rel="previous" title="ARM"> 31<style type="text/css"> 32<!-- 33a.summary-letter {text-decoration: none} 34blockquote.smallquotation {font-size: smaller} 35div.display {margin-left: 3.2em} 36div.example {margin-left: 3.2em} 37div.indentedblock {margin-left: 3.2em} 38div.lisp {margin-left: 3.2em} 39div.smalldisplay {margin-left: 3.2em} 40div.smallexample {margin-left: 3.2em} 41div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 42div.smalllisp {margin-left: 3.2em} 43kbd {font-style:oblique} 44pre.display {font-family: inherit} 45pre.format {font-family: inherit} 46pre.menu-comment {font-family: serif} 47pre.menu-preformatted {font-family: serif} 48pre.smalldisplay {font-family: inherit; font-size: smaller} 49pre.smallexample {font-size: smaller} 50pre.smallformat {font-family: inherit; font-size: smaller} 51pre.smalllisp {font-size: smaller} 52span.nocodebreak {white-space:nowrap} 53span.nolinebreak {white-space:nowrap} 54span.roman {font-family:serif; font-weight:normal} 55span.sansserif {font-family:sans-serif; font-weight:normal} 56ul.no-bullet {list-style: none} 57--> 58</style> 59 60 61</head> 62 63<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 64<a name="HPPA-ELF32"></a> 65<div class="header"> 66<p> 67Next: <a href="M68K.html#M68K" accesskey="n" rel="next">M68K</a>, Previous: <a href="ARM.html#ARM" accesskey="p" rel="previous">ARM</a>, Up: <a href="Machine-Dependent.html#Machine-Dependent" accesskey="u" rel="up">Machine Dependent</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="LD-Index.html#LD-Index" title="Index" rel="index">Index</a>]</p> 68</div> 69<hr> 70<a name="ld-and-HPPA-32_002dbit-ELF-Support"></a> 71<h3 class="section">5.4 <code>ld</code> and HPPA 32-bit ELF Support</h3> 72<a name="index-HPPA-multiple-sub_002dspace-stubs"></a> 73<a name="index-_002d_002dmulti_002dsubspace"></a> 74<p>When generating a shared library, <code>ld</code> will by default generate 75import stubs suitable for use with a single sub-space application. 76The ‘<samp>--multi-subspace</samp>’ switch causes <code>ld</code> to generate export 77stubs, and different (larger) import stubs suitable for use with 78multiple sub-spaces. 79</p> 80<a name="index-HPPA-stub-grouping"></a> 81<a name="index-_002d_002dstub_002dgroup_002dsize_003dN-1"></a> 82<p>Long branch stubs and import/export stubs are placed by <code>ld</code> in 83stub sections located between groups of input sections. 84‘<samp>--stub-group-size</samp>’ specifies the maximum size of a group of input 85sections handled by one stub section. Since branch offsets are signed, 86a stub section may serve two groups of input sections, one group before 87the stub section, and one group after it. However, when using 88conditional branches that require stubs, it may be better (for branch 89prediction) that stub sections only serve one group of input sections. 90A negative value for ‘<samp>N</samp>’ chooses this scheme, ensuring that 91branches to stubs always use a negative offset. Two special values of 92‘<samp>N</samp>’ are recognized, ‘<samp>1</samp>’ and ‘<samp>-1</samp>’. These both instruct 93<code>ld</code> to automatically size input section groups for the branch types 94detected, with the same behaviour regarding stub placement as other 95positive or negative values of ‘<samp>N</samp>’ respectively. 96</p> 97<p>Note that ‘<samp>--stub-group-size</samp>’ does not split input sections. A 98single input section larger than the group size specified will of course 99create a larger group (of one section). If input sections are too 100large, it may not be possible for a branch to reach its stub. 101</p> 102 103 104 105 106 107</body> 108</html> 109