1# Test that the linker reports undefined symbol errors correctly.
2# By Ian Lance Taylor, Cygnus Support
3#
4#   Copyright (C) 1995-2014 Free Software Foundation, Inc.
5#
6# This file is part of the GNU Binutils.
7#
8# This program is free software; you can redistribute it and/or modify
9# it under the terms of the GNU General Public License as published by
10# the Free Software Foundation; either version 3 of the License, or
11# (at your option) any later version.
12#
13# This program is distributed in the hope that it will be useful,
14# but WITHOUT ANY WARRANTY; without even the implied warranty of
15# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16# GNU General Public License for more details.
17#
18# You should have received a copy of the GNU General Public License
19# along with this program; if not, write to the Free Software
20# Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
21# MA 02110-1301, USA.
22
23set testund "undefined"
24set testfn "undefined function"
25set testline "undefined line"
26
27if { ![is_remote host] && [which $CC] == 0 } {
28    verbose "Could not find C compiler!" 1
29    untested $testund
30    untested $testfn
31    untested $testline
32    return
33}
34
35if ![ld_compile "$CC -g" $srcdir/$subdir/undefined.c tmpdir/undefined.o] {
36    verbose "Unable to compile test file!" 1
37    unresolved $testund
38    unresolved $testfn
39    unresolved $testline
40    return
41}
42
43remote_file host delete "tmpdir/undefined"
44
45set flags [big_or_little_endian]
46
47# Using -e start prevents the SunOS linker from trying to build a
48# shared library.
49send_log "$ld -e start $flags -o tmpdir/undefined tmpdir/undefined.o\n"
50set exec_output [run_host_cmd "$ld" "-e start $flags -o tmpdir/undefined tmpdir/undefined.o"]
51
52send_log "$exec_output\n"
53verbose "$exec_output"
54
55proc checkund { string testname } {
56    global exec_output
57
58    if [string match "*$string*" $exec_output] {
59	pass $testname
60    } else {
61	fail $testname
62    }
63}
64
65set mu "undefined reference to `*this_function_is_not_defined'"
66checkund $mu $testund
67
68# ARM PE defaults to using stabs debugging, which we can't handle for
69# a COFF file.
70#setup_xfail "arm*-*-pe*"
71
72# For Xtensa on GNU Linux systems (or any other system where PIC code is
73# always used), the address of the undefined function is in a literal pool
74# outside the function, so that both the "undefined function" and "undefined
75# line" tests fail.
76setup_xfail xtensa*-*-linux*
77
78set mf "tmpdir/undefined.o* In function `function':"
79checkund $mf $testfn
80
81if ![is_elf_format] {
82    # COFF SH gets this test wrong--it reports line 10, because although
83    # the jump is at line 9, the function address, and the reloc, is
84    # stored at the end of the function.
85    setup_xfail "sh-*-*"
86
87    # ARM PE defaults to using stabs debugging, which we can't handle for
88    # a COFF file.
89    #setup_xfail "arm*-*-pe*"
90}
91
92set ml "undefined.c:9: undefined reference to `*this_function_is_not_defined'"
93# With targets that use elf/dwarf2, such as the arm-elf
94# toolchain, the code in bfd/elf.c:_bfd_elf_find_nearest_line() is called
95# in order to locate the file name/line number where the undefined
96# reference occurs.  Unfortunately this tries to use the dwarf2 debug
97# information held in the .debug_info section.  This section contains a series
98# of comp_unit structures, each of which has a low/high address range
99# representing the span of memory locations covered by that structure.  The
100# structures also index into other structures held in the .debug_line section
101# and together they can translate memory locations back into file/function/line
102# number addresses in the source code.  Since the information about the memory
103# region covered by a comp_unit is only determined at link time, the low/high
104# addresses in the .debug_info section and the line addresses in the .debug_line
105# section are computed by generating relocs against known symbols in the object
106# code.
107#
108# When the undefined reference is detected, the relocs in the dwarf2
109# debug sections have not yet been resolved, so the low/high addresses and the
110# line number address are all set at zero.  Thus when _bfd_elf_find_nearest_line()
111# calls _bfd_dwarf2_find_nearest_line() no comp_unit can be found which
112# actually covers the address where the reference occured, and so
113# _bfd_elf_find_nearest_line() fails.
114#
115# The upshot of all of this, is that the error message reported by the
116# linker, instead of having a source file name & line number as in:
117#
118#   undefined.c:9: undefined reference to `this_function_is_not_defined'
119#
120# has an object file & section address instead:
121#
122#   undefined.0(.text+0xc): undefined reference to `this_function_is_not_defined'
123#
124# hence the xfails below.
125
126setup_xfail mcore-*-elf
127setup_xfail mep-*-*
128setup_xfail mips-sgi-irix6*
129setup_xfail "sh64-*-*"
130# Fails for the MSP430 because it uses SYM_DIFF relocs but it does
131# not provide a special_function for handling them.  If optimization
132# is enabled then this test passes because function()'s prologue is
133# eliminated.
134setup_xfail "msp430-*-*"
135
136# The undefined test fails on 31 bit s/390 because the address of the
137# function `this_function_is_not_defined' is stored in the literal pool of
138# the function. Therefore the line number in the error message is 8 instead
139# of 9. On 64 bit s/390 this works because of the new brasl instruction that
140# doesn't need a literal pool entry.
141setup_xfail s390-*-*
142
143# See comments above for Xtensa.
144setup_xfail xtensa*-*-linux*
145setup_xfail hppa*64*-*-*
146
147checkund $ml $testline
148