binutils-gdb/ld
Nelson Chu 50331d64f1 RISC-V: Clarify the addends of pc-relative access.
The original discussion was here,
https://github.com/riscv/riscv-elf-psabi-doc/issues/184

After discussing with Kito Cheng, I think the addends of %pcrel_hi
and %pcrel_lo are both allowed in GNU toolchain.  However, both of
the them mean the offset of symbols, rather than the pc address.
But the addends of %got_pcrel_hi and it's %pcrel_lo do not look
reasonable.  I believe gcc won't generate the got patterns with
addends, so linker should report dangerous relocation errors,
in case the assembly code use them.

Another issue was here,
https://sourceware.org/pipermail/binutils/2021-June/116983.html

At the beginnig, I suppose %pcrel_hi and %pcrel_lo are valid only
when they are in the same input section.  But Jim Wilson points out
that gcc may generate %hi and %lo in the different input sections,
when -freorder-blocks-and-partition option is used.  So that a memory
references for a loop may have the %hi outside the loop, but the %lo
remain in the loop.  However, it is hard to create the testcases,
to see if %pcrel_hi and %pcrel_lo have the same behavior.

Unfortunately, I notice that the current pcrel resolver cannot
work for the above case.  For now we build a hash table for pcrel
at the start of riscv_elf_relocate_section, and then free the hash
at the end.  But riscv_elf_relocate_section only handles an input
section at a time, so that means we can only resolve the %pcrel_hi
and %pcrel_lo which are in the same input section.  Otherwise, like
the above case, we will report "%pcrel_lo missing matching %pcrel_hi"
for them.  I have no plan to improve this in the short-term, so maybe
we can wait until someone meets the problem before we deal with it.

bfd/
    * elfnn-riscv.c (riscv_pcrel_hi_reloc): Added field to store
    the original relocation type, in case the type is converted to
    R_RISCV_HI20.
    (riscv_pcrel_lo_reloc): Removed unused name field.
    (riscv_pcrel_relocs): Added comments.
    (riscv_zero_pcrel_hi_reloc): Removed unused input_bfd.
    (riscv_record_pcrel_hi_reloc): Updated.
    (riscv_record_pcrel_lo_reloc): Likewise.
    (riscv_resolve_pcrel_lo_relocs): Likewise.  Check the original
    type of auipc, to make sure the %pcrel_lo without any addends.
    Otherwise, report dangerous relocation error.
    (riscv_elf_relocate_section): Updated above functions are changed.
    For R_RISCV_GOT_HI20, report dangerous relocation error when addend
    isn't zero.
ld/
    * testsuite/ld-riscv-elf/ld-riscv-elf.exp: Updated.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3a.d: New testcase.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3a.s: Likewise.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3b.d: New testcase.
    Should report error since the %pcrel_lo with addend refers to
    %got_pcrel_hi.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3b.s: Likewise.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3c.d: New testcase.
    Should report error since the %got_pcrel_hi with addend.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3c.s: Likewise.
    * testsuite/ld-riscv-elf/pcrel-lo-addend-3.ld: Likewise.
2021-06-22 17:14:55 +08:00
..
emulparams Use bool in ld 2021-03-31 10:49:23 +10:30
emultempl RISC-V: PR27566, Do not relax when data segment phase is exp_seg_relro_adjust. 2021-05-31 11:29:26 +08:00
po Remove arm-symbianelf 2021-02-09 23:36:16 +10:30
scripttempl PRU: Add alignment for resource table, and allow sizes of memory regions to be set from the command line. 2021-05-10 13:58:17 +01:00
testsuite RISC-V: Clarify the addends of pc-relative access. 2021-06-22 17:14:55 +08:00
.gitignore
aclocal.m4 Implement a workaround for GNU mak jobserver 2021-01-12 05:45:44 -08:00
ChangeLog RISC-V: Clarify the addends of pc-relative access. 2021-06-22 17:14:55 +08:00
ChangeLog-0001
ChangeLog-0203
ChangeLog-2004
ChangeLog-2005
ChangeLog-2006
ChangeLog-2007
ChangeLog-2008
ChangeLog-2009
ChangeLog-2010
ChangeLog-2011
ChangeLog-2012
ChangeLog-2013
ChangeLog-2014
ChangeLog-2015
ChangeLog-2016
ChangeLog-2017
ChangeLog-2018 ChangeLog rotation 2019-01-01 21:25:40 +10:30
ChangeLog-2019 ChangeLog rotation 2020-01-01 18:12:08 +10:30
ChangeLog-2020 ChangeLog rotation 2021-01-01 10:31:02 +10:30
ChangeLog-9197
ChangeLog-9899 PR27116, Spelling errors found by Debian style checker 2021-01-01 14:36:35 +10:30
config.in ENABLE_CHECKING in bfd, opcodes, binutils, ld 2021-04-13 00:35:44 +09:30
configure ENABLE_CHECKING in bfd, opcodes, binutils, ld 2021-04-13 00:35:44 +09:30
configure.ac ENABLE_CHECKING in bfd, opcodes, binutils, ld 2021-04-13 00:35:44 +09:30
configure.host Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
configure.tgt Remove arm-symbianelf 2021-02-09 23:36:16 +10:30
deffile.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
deffilep.y Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
dep-in.sed
elf-hints-local.h Remove bfd_stdint.h 2021-03-31 10:49:23 +10:30
fdl.texi
gen-doc.texi Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
genscrba.sh Automatic makefile dependencies for generated ld/e*.c 2019-04-13 12:13:22 +09:30
genscripts.sh Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
h8-doc.texi Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
ld.h C99 ld configury 2021-04-05 15:31:53 +09:30
ld.texi ld.texi: Move -z unique-symbol after -z undefs. 2021-06-18 07:33:30 -07:00
ldbuildid.c Remove strneq macro and use startswith. 2021-04-01 15:00:56 +02:00
ldbuildid.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldcref.c Use bool in ld 2021-03-31 10:49:23 +10:30
ldctor.c Use bool in ld 2021-03-31 10:49:23 +10:30
ldctor.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldelf.c PR27952, Disallow ET_DYN DF_1_PIE linker input 2021-06-11 14:06:47 +09:30
ldelf.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldelfgen.c When computing section link order for a relocateable link, ignore section sizes. 2021-05-07 10:57:47 +01:00
ldelfgen.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldemul.c Use bool in ld 2021-03-31 10:49:23 +10:30
ldemul.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldexp.c multiple definition warnings from script symbols 2021-05-07 16:25:40 +09:30
ldexp.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldfile.c Use bool in ld 2021-03-31 10:49:23 +10:30
ldfile.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldgram.y Use bool in ld 2021-03-31 10:49:23 +10:30
ldint.texi Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
ldlang.c PR27719, lang_mark_undefineds trashes memory 2021-04-12 11:57:03 +09:30
ldlang.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldlex-wrapper.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
ldlex.h ld: Add -no-pie 2021-06-17 09:57:40 -07:00
ldlex.l ld --defsym 2021-02-02 01:27:12 +10:30
ldmain.c multiple definition warnings from script symbols 2021-05-07 16:25:40 +09:30
ldmain.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldmisc.c Use bool in ld 2021-03-31 10:49:23 +10:30
ldmisc.h Use bool in ld 2021-03-31 10:49:23 +10:30
ldver.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
ldver.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
ldwrite.c Use bool in ld 2021-03-31 10:49:23 +10:30
ldwrite.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
lexsup.c ld: Add -no-pie 2021-06-17 09:57:40 -07:00
libdep_plugin.c PR27722, error: array subscript has type char 2021-04-13 16:14:20 +09:30
MAINTAINERS Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
Makefile.am Prevent libdel.dll.a from being installed on Windows based systems. 2021-05-11 11:06:53 +01:00
Makefile.in Prevent libdel.dll.a from being installed on Windows based systems. 2021-05-11 11:06:53 +01:00
mri.c Use bool in ld 2021-03-31 10:49:23 +10:30
mri.h Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
NEWS ld: Add -Bno-symbolic 2021-05-13 12:53:49 +09:30
pe-dll.c ld: warn about PE base relocations to sections above .reloc 2021-04-06 10:54:57 +02:00
pe-dll.h Use bool in ld 2021-03-31 10:49:23 +10:30
pep-dll.c Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
pep-dll.h Use bool in ld 2021-03-31 10:49:23 +10:30
plugin.c PR27719, lang_mark_undefineds trashes memory 2021-04-12 11:57:03 +09:30
plugin.h Use bool in ld 2021-03-31 10:49:23 +10:30
README Update year range in copyright notice of binutils files 2021-01-01 10:31:05 +10:30
stamp-h.in
sysdep.h C99 ld configury 2021-04-05 15:31:53 +09:30
testplug2.c Use bool in ld 2021-03-31 10:49:23 +10:30
testplug3.c Use bool in ld 2021-03-31 10:49:23 +10:30
testplug4.c Use bool in ld 2021-03-31 10:49:23 +10:30
testplug.c Use bool in ld 2021-03-31 10:49:23 +10:30
TODO

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

		README for LD

This is the GNU linker.  It is distributed with other "binary
utilities" which should be in ../binutils.  See ../binutils/README for
more general notes, including where to send bug reports.

There are many features of the linker:

* The linker uses a Binary File Descriptor library (../bfd)
  that it uses to read and write object files.  This helps
  insulate the linker itself from the format of object files.

* The linker supports a number of different object file
  formats.  It can even handle multiple formats at once:
  Read two input formats and write a third.

* The linker can be configured for cross-linking.

* The linker supports a control language.

* There is a user manual (ld.texi), as well as the
  beginnings of an internals manual (ldint.texi).

Installation
============

See ../binutils/README.

If you want to make a cross-linker, you may want to specify
a different search path of -lfoo libraries than the default.
You can do this by setting the LIB_PATH variable in ./Makefile
or using the --with-lib-path configure switch.

To build just the linker, make the target all-ld from the top level
directory (one directory above this one).

Porting to a new target
=======================

See the ldint.texi manual.

Reporting bugs etc
===========================

See ../binutils/README.

Known problems
==============

The Solaris linker normally exports all dynamic symbols from an
executable.  The GNU linker does not do this by default.  This is
because the GNU linker tries to present the same interface for all
similar targets (in this case, all native ELF targets).  This does not
matter for normal programs, but it can make a difference for programs
which try to dlopen an executable, such as PERL or Tcl.  You can make
the GNU linker export all dynamic symbols with the -E or
--export-dynamic command line option.

HP/UX 9.01 has a shell bug that causes the linker scripts to be
generated incorrectly.  The symptom of this appears to be "fatal error
- scanner input buffer overflow" error messages.  There are various
workarounds to this:
  * Build and install bash, and build with "make SHELL=bash".
  * Update to a version of HP/UX with a working shell (e.g., 9.05).
  * Replace "(. ${srcdir}/scripttempl/${SCRIPT_NAME}.sc)" in
    genscripts.sh with "sh ${srcdir}..." (no parens) and make sure the
    emulparams script used exports any shell variables it sets.

Copyright (C) 2012-2021 Free Software Foundation, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.