ld: HPPA ELF32

1 
1 4.5 'ld' and HPPA 32-bit ELF Support
1 ====================================
1 
1 When generating a shared library, 'ld' will by default generate import
1 stubs suitable for use with a single sub-space application.  The
1 '--multi-subspace' switch causes 'ld' to generate export stubs, and
1 different (larger) import stubs suitable for use with multiple
1 sub-spaces.
1 
1    Long branch stubs and import/export stubs are placed by 'ld' in stub
1 sections located between groups of input sections.  '--stub-group-size'
1 specifies the maximum size of a group of input sections handled by one
1 stub section.  Since branch offsets are signed, a stub section may serve
1 two groups of input sections, one group before the stub section, and one
1 group after it.  However, when using conditional branches that require
1 stubs, it may be better (for branch prediction) that stub sections only
1 serve one group of input sections.  A negative value for 'N' chooses
1 this scheme, ensuring that branches to stubs always use a negative
1 offset.  Two special values of 'N' are recognized, '1' and '-1'.  These
1 both instruct 'ld' to automatically size input section groups for the
1 branch types detected, with the same behaviour regarding stub placement
1 as other positive or negative values of 'N' respectively.
1 
1    Note that '--stub-group-size' does not split input sections.  A
1 single input section larger than the group size specified will of course
1 create a larger group (of one section).  If input sections are too
1 large, it may not be possible for a branch to reach its stub.
1