1 /* Main program of GNU linker.
2 Copyright (C) 1991-2021 Free Software Foundation, Inc.
3 Written by Steve Chamberlain steve@cygnus.com
5 This file is part of the GNU Binutils.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
20 MA 02110-1301, USA. */
24 #include "safe-ctype.h"
25 #include "libiberty.h"
29 #include "filenames.h"
30 #include "elf/common.h"
43 #if BFD_SUPPORTS_PLUGINS
45 #include "plugin-api.h"
46 #endif /* BFD_SUPPORTS_PLUGINS */
48 /* Somewhere above, sys/stat.h got included. */
49 #if !defined(S_ISDIR) && defined(S_IFDIR)
50 #define S_ISDIR(m) (((m) & S_IFMT) == S_IFDIR)
55 #ifndef TARGET_SYSTEM_ROOT
56 #define TARGET_SYSTEM_ROOT ""
61 FILE *saved_script_handle
= NULL
;
62 FILE *previous_script_handle
= NULL
;
63 bfd_boolean force_make_executable
= FALSE
;
66 const char *output_filename
= "a.out";
68 /* Name this program was invoked by. */
71 /* The prefix for system library directories. */
72 const char *ld_sysroot
;
74 /* The canonical representation of ld_sysroot. */
75 char *ld_canon_sysroot
;
76 int ld_canon_sysroot_len
;
78 /* Set by -G argument, for targets like MIPS ELF. */
79 int g_switch_value
= 8;
81 /* Nonzero means print names of input files as processed. */
82 unsigned int trace_files
;
84 /* Nonzero means report actions taken by the linker, and describe the linker script in use. */
87 /* Nonzero means version number was printed, so exit successfully
88 instead of complaining if no input files are given. */
89 bfd_boolean version_printed
;
91 /* TRUE if we should demangle symbol names. */
92 bfd_boolean demangling
;
94 args_type command_line
;
96 ld_config_type config
;
98 sort_type sort_section
;
100 static const char *get_sysroot
102 static char *get_emulation
104 static bfd_boolean add_archive_element
105 (struct bfd_link_info
*, bfd
*, const char *, bfd
**);
106 static void multiple_definition
107 (struct bfd_link_info
*, struct bfd_link_hash_entry
*,
108 bfd
*, asection
*, bfd_vma
);
109 static void multiple_common
110 (struct bfd_link_info
*, struct bfd_link_hash_entry
*,
111 bfd
*, enum bfd_link_hash_type
, bfd_vma
);
112 static void add_to_set
113 (struct bfd_link_info
*, struct bfd_link_hash_entry
*,
114 bfd_reloc_code_real_type
, bfd
*, asection
*, bfd_vma
);
115 static void constructor_callback
116 (struct bfd_link_info
*, bfd_boolean
, const char *, bfd
*,
117 asection
*, bfd_vma
);
118 static void warning_callback
119 (struct bfd_link_info
*, const char *, const char *, bfd
*,
120 asection
*, bfd_vma
);
121 static void warning_find_reloc
122 (bfd
*, asection
*, void *);
123 static void undefined_symbol
124 (struct bfd_link_info
*, const char *, bfd
*, asection
*, bfd_vma
,
126 static void reloc_overflow
127 (struct bfd_link_info
*, struct bfd_link_hash_entry
*, const char *,
128 const char *, bfd_vma
, bfd
*, asection
*, bfd_vma
);
129 static void reloc_dangerous
130 (struct bfd_link_info
*, const char *, bfd
*, asection
*, bfd_vma
);
131 static void unattached_reloc
132 (struct bfd_link_info
*, const char *, bfd
*, asection
*, bfd_vma
);
133 static bfd_boolean notice
134 (struct bfd_link_info
*, struct bfd_link_hash_entry
*,
135 struct bfd_link_hash_entry
*, bfd
*, asection
*, bfd_vma
, flagword
);
137 static struct bfd_link_callbacks link_callbacks
=
143 constructor_callback
,
153 ldlang_override_segment_assignment
,
154 ldlang_ctf_acquire_strings
,
156 ldlang_ctf_new_dynsym
,
157 ldlang_write_ctf_late
160 static bfd_assert_handler_type default_bfd_assert_handler
;
161 static bfd_error_handler_type default_bfd_error_handler
;
163 struct bfd_link_info link_info
;
165 struct dependency_file
167 struct dependency_file
*next
;
171 static struct dependency_file
*dependency_files
, *dependency_files_tail
;
174 track_dependency_files (const char *filename
)
176 struct dependency_file
*dep
177 = (struct dependency_file
*) xmalloc (sizeof (*dep
));
178 dep
->name
= xstrdup (filename
);
180 if (dependency_files
== NULL
)
181 dependency_files
= dep
;
183 dependency_files_tail
->next
= dep
;
184 dependency_files_tail
= dep
;
188 write_dependency_file (void)
191 struct dependency_file
*dep
;
193 out
= fopen (config
.dependency_file
, FOPEN_WT
);
196 einfo (_("%F%P: cannot open dependency file %s: %E\n"),
197 config
.dependency_file
);
200 fprintf (out
, "%s:", output_filename
);
202 for (dep
= dependency_files
; dep
!= NULL
; dep
= dep
->next
)
203 fprintf (out
, " \\\n %s", dep
->name
);
206 for (dep
= dependency_files
; dep
!= NULL
; dep
= dep
->next
)
207 fprintf (out
, "\n%s:\n", dep
->name
);
215 bfd_cache_close_all ();
216 #if BFD_SUPPORTS_PLUGINS
217 plugin_call_cleanup ();
219 if (output_filename
&& delete_output_file_on_failure
)
220 unlink_if_ordinary (output_filename
);
223 /* Hook to notice BFD assertions. */
226 ld_bfd_assert_handler (const char *fmt
, const char *bfdver
,
227 const char *file
, int line
)
229 config
.make_executable
= FALSE
;
230 (*default_bfd_assert_handler
) (fmt
, bfdver
, file
, line
);
233 /* Hook the bfd error/warning handler for --fatal-warnings. */
236 ld_bfd_error_handler (const char *fmt
, va_list ap
)
238 if (config
.fatal_warnings
)
239 config
.make_executable
= FALSE
;
240 (*default_bfd_error_handler
) (fmt
, ap
);
244 main (int argc
, char **argv
)
247 long start_time
= get_run_time ();
249 #if defined (HAVE_SETLOCALE) && defined (HAVE_LC_MESSAGES)
250 setlocale (LC_MESSAGES
, "");
252 #if defined (HAVE_SETLOCALE)
253 setlocale (LC_CTYPE
, "");
255 bindtextdomain (PACKAGE
, LOCALEDIR
);
256 textdomain (PACKAGE
);
258 program_name
= argv
[0];
259 xmalloc_set_program_name (program_name
);
261 START_PROGRESS (program_name
, 0);
263 expandargv (&argc
, &argv
);
265 if (bfd_init () != BFD_INIT_MAGIC
)
266 einfo (_("%F%P: fatal error: libbfd ABI mismatch\n"));
268 bfd_set_error_program_name (program_name
);
270 /* We want to notice and fail on those nasty BFD assertions which are
271 likely to signal incorrect output being generated but otherwise may
273 default_bfd_assert_handler
= bfd_set_assert_handler (ld_bfd_assert_handler
);
275 /* Also hook the bfd error/warning handler for --fatal-warnings. */
276 default_bfd_error_handler
= bfd_set_error_handler (ld_bfd_error_handler
);
278 xatexit (ld_cleanup
);
280 /* Set up the sysroot directory. */
281 ld_sysroot
= get_sysroot (argc
, argv
);
283 ld_canon_sysroot
= lrealpath (ld_sysroot
);
284 if (ld_canon_sysroot
)
286 ld_canon_sysroot_len
= strlen (ld_canon_sysroot
);
288 /* is_sysrooted_pathname() relies on no trailing dirsep. */
289 if (ld_canon_sysroot_len
> 0
290 && IS_DIR_SEPARATOR (ld_canon_sysroot
[ld_canon_sysroot_len
- 1]))
291 ld_canon_sysroot
[--ld_canon_sysroot_len
] = '\0';
294 ld_canon_sysroot_len
= -1;
296 /* Set the default BFD target based on the configured target. Doing
297 this permits the linker to be configured for a particular target,
298 and linked against a shared BFD library which was configured for
299 a different target. The macro TARGET is defined by Makefile. */
300 if (!bfd_set_default_target (TARGET
))
302 einfo (_("%X%P: can't set BFD default target to `%s': %E\n"), TARGET
);
313 config
.build_constructors
= TRUE
;
314 config
.rpath_separator
= ':';
315 config
.split_by_reloc
= (unsigned) -1;
316 config
.split_by_file
= (bfd_size_type
) -1;
317 config
.make_executable
= TRUE
;
318 config
.magic_demand_paged
= TRUE
;
319 config
.text_read_only
= TRUE
;
320 config
.print_map_discarded
= TRUE
;
321 link_info
.disable_target_specific_optimizations
= -1;
323 command_line
.warn_mismatch
= TRUE
;
324 command_line
.warn_search_mismatch
= TRUE
;
325 command_line
.check_section_addresses
= -1;
327 /* We initialize DEMANGLING based on the environment variable
328 COLLECT_NO_DEMANGLE. The gcc collect2 program will demangle the
329 output of the linker, unless COLLECT_NO_DEMANGLE is set in the
330 environment. Acting the same way here lets us provide the same
331 interface by default. */
332 demangling
= getenv ("COLLECT_NO_DEMANGLE") == NULL
;
334 link_info
.allow_undefined_version
= TRUE
;
335 link_info
.keep_memory
= TRUE
;
336 link_info
.combreloc
= TRUE
;
337 link_info
.strip_discarded
= TRUE
;
338 link_info
.prohibit_multiple_definition_absolute
= FALSE
;
339 link_info
.textrel_check
= DEFAULT_LD_TEXTREL_CHECK
;
340 link_info
.emit_hash
= DEFAULT_EMIT_SYSV_HASH
;
341 link_info
.emit_gnu_hash
= DEFAULT_EMIT_GNU_HASH
;
342 link_info
.callbacks
= &link_callbacks
;
343 link_info
.input_bfds_tail
= &link_info
.input_bfds
;
344 /* SVR4 linkers seem to set DT_INIT and DT_FINI based on magic _init
345 and _fini symbols. We are compatible. */
346 link_info
.init_function
= "_init";
347 link_info
.fini_function
= "_fini";
348 link_info
.relax_pass
= 1;
349 link_info
.extern_protected_data
= -1;
350 link_info
.dynamic_undefined_weak
= -1;
351 link_info
.pei386_auto_import
= -1;
352 link_info
.spare_dynamic_tags
= 5;
353 link_info
.path_separator
= ':';
354 #ifdef DEFAULT_FLAG_COMPRESS_DEBUG
355 link_info
.compress_debug
= COMPRESS_DEBUG_GABI_ZLIB
;
357 #ifdef DEFAULT_NEW_DTAGS
358 link_info
.new_dtags
= DEFAULT_NEW_DTAGS
;
360 link_info
.start_stop_gc
= FALSE
;
361 link_info
.start_stop_visibility
= STV_PROTECTED
;
363 ldfile_add_arch ("");
364 emulation
= get_emulation (argc
, argv
);
365 ldemul_choose_mode (emulation
);
366 default_target
= ldemul_choose_target (argc
, argv
);
369 ldemul_before_parse ();
370 lang_has_input_file
= FALSE
;
371 parse_args (argc
, argv
);
373 if (config
.hash_table_size
!= 0)
374 bfd_hash_set_default_size (config
.hash_table_size
);
376 #if BFD_SUPPORTS_PLUGINS
377 /* Now all the plugin arguments have been gathered, we can load them. */
378 plugin_load_plugins ();
379 #endif /* BFD_SUPPORTS_PLUGINS */
381 ldemul_set_symbols ();
383 /* If we have not already opened and parsed a linker script,
384 try the default script from command line first. */
385 if (saved_script_handle
== NULL
386 && command_line
.default_script
!= NULL
)
388 ldfile_open_script_file (command_line
.default_script
);
389 parser_input
= input_script
;
393 /* If we have not already opened and parsed a linker script
394 read the emulation's appropriate default script. */
395 if (saved_script_handle
== NULL
)
398 char *s
= ldemul_get_script (&isfile
);
401 ldfile_open_default_command_file (s
);
405 lex_redirect (s
, _("built in linker script"), 1);
407 parser_input
= input_script
;
414 if (saved_script_handle
)
415 info_msg (_("using external linker script:"));
417 info_msg (_("using internal linker script:"));
418 info_msg ("\n==================================================\n");
420 if (saved_script_handle
)
422 static const int ld_bufsz
= 8193;
424 char *buf
= (char *) xmalloc (ld_bufsz
);
426 rewind (saved_script_handle
);
427 while ((n
= fread (buf
, 1, ld_bufsz
- 1, saved_script_handle
)) > 0)
430 info_msg ("%s", buf
);
432 rewind (saved_script_handle
);
439 info_msg (ldemul_get_script (&isfile
));
442 info_msg ("\n==================================================\n");
445 if (command_line
.force_group_allocation
446 || !bfd_link_relocatable (&link_info
))
447 link_info
.resolve_section_groups
= TRUE
;
449 link_info
.resolve_section_groups
= FALSE
;
451 if (command_line
.print_output_format
)
452 info_msg ("%s\n", lang_get_output_target ());
456 /* If the only command line argument has been -v or --version or --verbose
457 then ignore any input files provided by linker scripts and exit now.
458 We do not want to create an output file when the linker is just invoked
459 to provide version information. */
460 if (argc
== 2 && version_printed
)
463 if (link_info
.inhibit_common_definition
&& !bfd_link_dll (&link_info
))
464 einfo (_("%F%P: --no-define-common may not be used without -shared\n"));
466 if (!lang_has_input_file
)
468 if (version_printed
|| command_line
.print_output_format
)
470 einfo (_("%F%P: no input files\n"));
474 info_msg (_("%P: mode %s\n"), emulation
);
476 ldemul_after_parse ();
478 if (config
.map_filename
)
480 if (strcmp (config
.map_filename
, "-") == 0)
482 config
.map_file
= stdout
;
486 config
.map_file
= fopen (config
.map_filename
, FOPEN_WT
);
487 if (config
.map_file
== (FILE *) NULL
)
489 bfd_set_error (bfd_error_system_call
);
490 einfo (_("%F%P: cannot open map file %s: %E\n"),
491 config
.map_filename
);
494 link_info
.has_map_file
= TRUE
;
499 /* Print error messages for any missing symbols, for any warning
500 symbols, and possibly multiple definitions. */
501 if (bfd_link_relocatable (&link_info
))
502 link_info
.output_bfd
->flags
&= ~EXEC_P
;
504 link_info
.output_bfd
->flags
|= EXEC_P
;
506 if ((link_info
.compress_debug
& COMPRESS_DEBUG
))
508 link_info
.output_bfd
->flags
|= BFD_COMPRESS
;
509 if (link_info
.compress_debug
== COMPRESS_DEBUG_GABI_ZLIB
)
510 link_info
.output_bfd
->flags
|= BFD_COMPRESS_GABI
;
515 if (config
.map_file
!= NULL
)
517 if (command_line
.cref
)
518 output_cref (config
.map_file
!= NULL
? config
.map_file
: stdout
);
519 if (nocrossref_list
!= NULL
)
520 check_nocrossrefs ();
521 if (command_line
.print_memory_usage
)
522 lang_print_memory_usage ();
525 struct bfd_link_hash_entry
*h
;
527 h
= bfd_link_hash_lookup (link_info
.hash
, "__image_base__", 0,0,1);
528 fprintf (stderr
, "lookup = %p val %lx\n", h
, h
? h
->u
.def
.value
: 1);
534 if (config
.dependency_file
!= NULL
)
535 write_dependency_file ();
537 /* Even if we're producing relocatable output, some non-fatal errors should
538 be reported in the exit status. (What non-fatal errors, if any, do we
539 want to ignore for relocatable output?) */
540 if (!config
.make_executable
&& !force_make_executable
)
543 einfo (_("%P: link errors found, deleting executable `%s'\n"),
546 /* The file will be removed by ld_cleanup. */
551 if (!bfd_close (link_info
.output_bfd
))
552 einfo (_("%F%P: %pB: final close failed: %E\n"), link_info
.output_bfd
);
554 /* If the --force-exe-suffix is enabled, and we're making an
555 executable file and it doesn't end in .exe, copy it to one
557 if (!bfd_link_relocatable (&link_info
)
558 && command_line
.force_exe_suffix
)
560 int len
= strlen (output_filename
);
563 || (strcasecmp (output_filename
+ len
- 4, ".exe") != 0
564 && strcasecmp (output_filename
+ len
- 4, ".dll") != 0))
568 const int bsize
= 4096;
569 char *buf
= (char *) xmalloc (bsize
);
571 char *dst_name
= (char *) xmalloc (len
+ 5);
573 strcpy (dst_name
, output_filename
);
574 strcat (dst_name
, ".exe");
575 src
= fopen (output_filename
, FOPEN_RB
);
576 dst
= fopen (dst_name
, FOPEN_WB
);
579 einfo (_("%F%P: unable to open for source of copy `%s'\n"),
582 einfo (_("%F%P: unable to open for destination of copy `%s'\n"),
584 while ((l
= fread (buf
, 1, bsize
, src
)) > 0)
586 int done
= fwrite (buf
, 1, l
, dst
);
589 einfo (_("%P: error writing file `%s'\n"), dst_name
);
593 if (fclose (dst
) == EOF
)
594 einfo (_("%P: error closing file `%s'\n"), dst_name
);
601 END_PROGRESS (program_name
);
605 long run_time
= get_run_time () - start_time
;
608 fprintf (stderr
, _("%s: total time in link: %ld.%06ld\n"),
609 program_name
, run_time
/ 1000000, run_time
% 1000000);
613 /* Prevent ld_cleanup from doing anything, after a successful link. */
614 output_filename
= NULL
;
620 /* If the configured sysroot is relocatable, try relocating it based on
621 default prefix FROM. Return the relocated directory if it exists,
622 otherwise return null. */
625 get_relative_sysroot (const char *from ATTRIBUTE_UNUSED
)
627 #ifdef TARGET_SYSTEM_ROOT_RELOCATABLE
631 path
= make_relative_prefix (program_name
, from
, TARGET_SYSTEM_ROOT
);
634 if (stat (path
, &s
) == 0 && S_ISDIR (s
.st_mode
))
642 /* Return the sysroot directory. Return "" if no sysroot is being used. */
645 get_sysroot (int argc
, char **argv
)
648 const char *path
= NULL
;
650 for (i
= 1; i
< argc
; i
++)
651 if (CONST_STRNEQ (argv
[i
], "--sysroot="))
652 path
= argv
[i
] + strlen ("--sysroot=");
655 path
= get_relative_sysroot (BINDIR
);
658 path
= get_relative_sysroot (TOOLBINDIR
);
661 path
= TARGET_SYSTEM_ROOT
;
663 if (IS_DIR_SEPARATOR (*path
) && path
[1] == 0)
669 /* We need to find any explicitly given emulation in order to initialize the
670 state that's needed by the lex&yacc argument parser (parse_args). */
673 get_emulation (int argc
, char **argv
)
678 emulation
= getenv (EMULATION_ENVIRON
);
679 if (emulation
== NULL
)
680 emulation
= DEFAULT_EMULATION
;
682 for (i
= 1; i
< argc
; i
++)
684 if (CONST_STRNEQ (argv
[i
], "-m"))
686 if (argv
[i
][2] == '\0')
691 emulation
= argv
[i
+ 1];
695 einfo (_("%F%P: missing argument to -m\n"));
697 else if (strcmp (argv
[i
], "-mips1") == 0
698 || strcmp (argv
[i
], "-mips2") == 0
699 || strcmp (argv
[i
], "-mips3") == 0
700 || strcmp (argv
[i
], "-mips4") == 0
701 || strcmp (argv
[i
], "-mips5") == 0
702 || strcmp (argv
[i
], "-mips32") == 0
703 || strcmp (argv
[i
], "-mips32r2") == 0
704 || strcmp (argv
[i
], "-mips32r3") == 0
705 || strcmp (argv
[i
], "-mips32r5") == 0
706 || strcmp (argv
[i
], "-mips32r6") == 0
707 || strcmp (argv
[i
], "-mips64") == 0
708 || strcmp (argv
[i
], "-mips64r2") == 0
709 || strcmp (argv
[i
], "-mips64r3") == 0
710 || strcmp (argv
[i
], "-mips64r5") == 0
711 || strcmp (argv
[i
], "-mips64r6") == 0)
713 /* FIXME: The arguments -mips1, -mips2, -mips3, etc. are
714 passed to the linker by some MIPS compilers. They
715 generally tell the linker to use a slightly different
716 library path. Perhaps someday these should be
717 implemented as emulations; until then, we just ignore
718 the arguments and hope that nobody ever creates
719 emulations named ips1, ips2 or ips3. */
721 else if (strcmp (argv
[i
], "-m486") == 0)
723 /* FIXME: The argument -m486 is passed to the linker on
724 some Linux systems. Hope that nobody creates an
725 emulation named 486. */
730 emulation
= &argv
[i
][2];
739 add_ysym (const char *name
)
741 if (link_info
.notice_hash
== NULL
)
743 link_info
.notice_hash
744 = (struct bfd_hash_table
*) xmalloc (sizeof (struct bfd_hash_table
));
745 if (!bfd_hash_table_init_n (link_info
.notice_hash
,
747 sizeof (struct bfd_hash_entry
),
749 einfo (_("%F%P: bfd_hash_table_init failed: %E\n"));
752 if (bfd_hash_lookup (link_info
.notice_hash
, name
, TRUE
, TRUE
) == NULL
)
753 einfo (_("%F%P: bfd_hash_lookup failed: %E\n"));
757 add_ignoresym (struct bfd_link_info
*info
, const char *name
)
759 if (info
->ignore_hash
== NULL
)
761 info
->ignore_hash
= xmalloc (sizeof (struct bfd_hash_table
));
762 if (!bfd_hash_table_init_n (info
->ignore_hash
,
764 sizeof (struct bfd_hash_entry
),
766 einfo (_("%F%P: bfd_hash_table_init failed: %E\n"));
769 if (bfd_hash_lookup (info
->ignore_hash
, name
, TRUE
, TRUE
) == NULL
)
770 einfo (_("%F%P: bfd_hash_lookup failed: %E\n"));
773 /* Record a symbol to be wrapped, from the --wrap option. */
776 add_wrap (const char *name
)
778 if (link_info
.wrap_hash
== NULL
)
781 = (struct bfd_hash_table
*) xmalloc (sizeof (struct bfd_hash_table
));
782 if (!bfd_hash_table_init_n (link_info
.wrap_hash
,
784 sizeof (struct bfd_hash_entry
),
786 einfo (_("%F%P: bfd_hash_table_init failed: %E\n"));
789 if (bfd_hash_lookup (link_info
.wrap_hash
, name
, TRUE
, TRUE
) == NULL
)
790 einfo (_("%F%P: bfd_hash_lookup failed: %E\n"));
793 /* Handle the -retain-symbols-file option. */
796 add_keepsyms_file (const char *filename
)
803 if (link_info
.strip
== strip_some
)
804 einfo (_("%X%P: error: duplicate retain-symbols-file\n"));
806 file
= fopen (filename
, "r");
809 bfd_set_error (bfd_error_system_call
);
810 einfo ("%X%P: %s: %E\n", filename
);
814 link_info
.keep_hash
= (struct bfd_hash_table
*)
815 xmalloc (sizeof (struct bfd_hash_table
));
816 if (!bfd_hash_table_init (link_info
.keep_hash
, bfd_hash_newfunc
,
817 sizeof (struct bfd_hash_entry
)))
818 einfo (_("%F%P: bfd_hash_table_init failed: %E\n"));
821 buf
= (char *) xmalloc (bufsize
);
833 while (!ISSPACE (c
) && c
!= EOF
)
840 buf
= (char *) xrealloc (buf
, bufsize
);
847 if (bfd_hash_lookup (link_info
.keep_hash
, buf
, TRUE
, TRUE
) == NULL
)
848 einfo (_("%F%P: bfd_hash_lookup for insertion failed: %E\n"));
852 if (link_info
.strip
!= strip_none
)
853 einfo (_("%P: `-retain-symbols-file' overrides `-s' and `-S'\n"));
856 link_info
.strip
= strip_some
;
860 /* Callbacks from the BFD linker routines. */
862 /* This is called when BFD has decided to include an archive member in
866 add_archive_element (struct bfd_link_info
*info
,
869 bfd
**subsbfd ATTRIBUTE_UNUSED
)
871 lang_input_statement_type
*input
;
872 lang_input_statement_type
*parent
;
873 lang_input_statement_type orig_input
;
875 input
= (lang_input_statement_type
*)
876 xcalloc (1, sizeof (lang_input_statement_type
));
877 input
->header
.type
= lang_input_statement_enum
;
878 input
->filename
= bfd_get_filename (abfd
);
879 input
->local_sym_name
= bfd_get_filename (abfd
);
880 input
->the_bfd
= abfd
;
882 /* Save the original data for trace files/tries below, as plugins
883 (if enabled) may possibly alter it to point to a replacement
884 BFD, but we still want to output the original BFD filename. */
886 #if BFD_SUPPORTS_PLUGINS
887 if (link_info
.lto_plugin_active
)
889 /* We must offer this archive member to the plugins to claim. */
890 plugin_maybe_claim (input
);
891 if (input
->flags
.claimed
)
893 if (no_more_claiming
)
895 /* Don't claim new IR symbols after all IR symbols have
898 info_msg ("%pI: no new IR symbols to claim\n",
900 input
->flags
.claimed
= 0;
903 input
->flags
.claim_archive
= TRUE
;
904 *subsbfd
= input
->the_bfd
;
907 #endif /* BFD_SUPPORTS_PLUGINS */
909 if (link_info
.input_bfds_tail
== &input
->the_bfd
->link
.next
910 || input
->the_bfd
->link
.next
!= NULL
)
912 /* We have already loaded this element, and are attempting to
913 load it again. This can happen when the archive map doesn't
914 match actual symbols defined by the element. */
916 bfd_set_error (bfd_error_malformed_archive
);
920 /* Set the file_chain pointer of archives to the last element loaded
921 from the archive. See ldlang.c:find_rescan_insertion. */
922 parent
= bfd_usrdata (abfd
->my_archive
);
923 if (parent
!= NULL
&& !parent
->flags
.reload
)
924 parent
->next
= input
;
926 ldlang_add_file (input
);
928 if (config
.map_file
!= NULL
)
930 static bfd_boolean header_printed
;
931 struct bfd_link_hash_entry
*h
;
935 h
= bfd_link_hash_lookup (info
->hash
, name
, FALSE
, FALSE
, TRUE
);
937 && info
->pei386_auto_import
938 && CONST_STRNEQ (name
, "__imp_"))
939 h
= bfd_link_hash_lookup (info
->hash
, name
+ 6, FALSE
, FALSE
, TRUE
);
951 case bfd_link_hash_defined
:
952 case bfd_link_hash_defweak
:
953 from
= h
->u
.def
.section
->owner
;
956 case bfd_link_hash_undefined
:
957 case bfd_link_hash_undefweak
:
958 from
= h
->u
.undef
.abfd
;
961 case bfd_link_hash_common
:
962 from
= h
->u
.c
.p
->section
->owner
;
969 minfo (_("Archive member included to satisfy reference by file (symbol)\n\n"));
970 header_printed
= TRUE
;
973 if (abfd
->my_archive
== NULL
974 || bfd_is_thin_archive (abfd
->my_archive
))
976 minfo ("%s", bfd_get_filename (abfd
));
977 len
= strlen (bfd_get_filename (abfd
));
981 minfo ("%s(%s)", bfd_get_filename (abfd
->my_archive
),
982 bfd_get_filename (abfd
));
983 len
= (strlen (bfd_get_filename (abfd
->my_archive
))
984 + strlen (bfd_get_filename (abfd
))
1000 minfo ("%pB ", from
);
1002 minfo ("(%pT)\n", h
->root
.string
);
1004 minfo ("(%s)\n", name
);
1009 || (trace_files
&& bfd_is_thin_archive (orig_input
.the_bfd
->my_archive
)))
1010 info_msg ("%pI\n", &orig_input
);
1014 /* This is called when BFD has discovered a symbol which is defined
1018 multiple_definition (struct bfd_link_info
*info
,
1019 struct bfd_link_hash_entry
*h
,
1029 if (info
->allow_multiple_definition
)
1034 case bfd_link_hash_defined
:
1035 osec
= h
->u
.def
.section
;
1036 oval
= h
->u
.def
.value
;
1037 obfd
= h
->u
.def
.section
->owner
;
1039 case bfd_link_hash_indirect
:
1040 osec
= bfd_ind_section_ptr
;
1048 /* Ignore a redefinition of an absolute symbol to the
1049 same value; it's harmless. */
1050 if (h
->type
== bfd_link_hash_defined
1051 && bfd_is_abs_section (osec
)
1052 && bfd_is_abs_section (nsec
)
1056 /* If either section has the output_section field set to
1057 bfd_abs_section_ptr, it means that the section is being
1058 discarded, and this is not really a multiple definition at all.
1059 FIXME: It would be cleaner to somehow ignore symbols defined in
1060 sections which are being discarded. */
1061 if (!info
->prohibit_multiple_definition_absolute
1062 && ((osec
->output_section
!= NULL
1063 && ! bfd_is_abs_section (osec
)
1064 && bfd_is_abs_section (osec
->output_section
))
1065 || (nsec
->output_section
!= NULL
1066 && !bfd_is_abs_section (nsec
)
1067 && bfd_is_abs_section (nsec
->output_section
))))
1070 name
= h
->root
.string
;
1078 if (!info
->warn_multiple_definition
)
1080 einfo (_("%P: %C: multiple definition of `%pT'"),
1081 nbfd
, nsec
, nval
, name
);
1083 einfo (_("; %D: first defined here"), obfd
, osec
, oval
);
1086 if (RELAXATION_ENABLED_BY_USER
)
1088 einfo (_("%P: disabling relaxation; it will not work with multiple definitions\n"));
1093 /* This is called when there is a definition of a common symbol, or
1094 when a common symbol is found for a symbol that is already defined,
1095 or when two common symbols are found. We only do something if
1096 -warn-common was used. */
1099 multiple_common (struct bfd_link_info
*info ATTRIBUTE_UNUSED
,
1100 struct bfd_link_hash_entry
*h
,
1102 enum bfd_link_hash_type ntype
,
1107 enum bfd_link_hash_type otype
;
1110 if (!config
.warn_common
)
1113 name
= h
->root
.string
;
1115 if (otype
== bfd_link_hash_common
)
1117 obfd
= h
->u
.c
.p
->section
->owner
;
1118 osize
= h
->u
.c
.size
;
1120 else if (otype
== bfd_link_hash_defined
1121 || otype
== bfd_link_hash_defweak
)
1123 obfd
= h
->u
.def
.section
->owner
;
1128 /* FIXME: It would nice if we could report the BFD which defined
1129 an indirect symbol, but we don't have anywhere to store the
1135 if (ntype
== bfd_link_hash_defined
1136 || ntype
== bfd_link_hash_defweak
1137 || ntype
== bfd_link_hash_indirect
)
1139 ASSERT (otype
== bfd_link_hash_common
);
1141 einfo (_("%P: %pB: warning: definition of `%pT' overriding common"
1145 einfo (_("%P: %pB: warning: definition of `%pT' overriding common\n"),
1148 else if (otype
== bfd_link_hash_defined
1149 || otype
== bfd_link_hash_defweak
1150 || otype
== bfd_link_hash_indirect
)
1152 ASSERT (ntype
== bfd_link_hash_common
);
1154 einfo (_("%P: %pB: warning: common of `%pT' overridden by definition"
1158 einfo (_("%P: %pB: warning: common of `%pT' overridden by definition\n"),
1163 ASSERT (otype
== bfd_link_hash_common
&& ntype
== bfd_link_hash_common
);
1167 einfo (_("%P: %pB: warning: common of `%pT' overridden"
1168 " by larger common from %pB\n"),
1171 einfo (_("%P: %pB: warning: common of `%pT' overridden"
1172 " by larger common\n"),
1175 else if (nsize
> osize
)
1178 einfo (_("%P: %pB: warning: common of `%pT' overriding"
1179 " smaller common from %pB\n"),
1182 einfo (_("%P: %pB: warning: common of `%pT' overriding"
1183 " smaller common\n"),
1189 einfo (_("%P: %pB and %pB: warning: multiple common of `%pT'\n"),
1192 einfo (_("%P: %pB: warning: multiple common of `%pT'\n"),
1198 /* This is called when BFD has discovered a set element. H is the
1199 entry in the linker hash table for the set. SECTION and VALUE
1200 represent a value which should be added to the set. */
1203 add_to_set (struct bfd_link_info
*info ATTRIBUTE_UNUSED
,
1204 struct bfd_link_hash_entry
*h
,
1205 bfd_reloc_code_real_type reloc
,
1210 if (config
.warn_constructors
)
1211 einfo (_("%P: warning: global constructor %s used\n"),
1214 if (!config
.build_constructors
)
1217 ldctor_add_set_entry (h
, reloc
, NULL
, section
, value
);
1219 if (h
->type
== bfd_link_hash_new
)
1221 h
->type
= bfd_link_hash_undefined
;
1222 h
->u
.undef
.abfd
= abfd
;
1223 /* We don't call bfd_link_add_undef to add this to the list of
1224 undefined symbols because we are going to define it
1229 /* This is called when BFD has discovered a constructor. This is only
1230 called for some object file formats--those which do not handle
1231 constructors in some more clever fashion. This is similar to
1232 adding an element to a set, but less general. */
1235 constructor_callback (struct bfd_link_info
*info
,
1236 bfd_boolean constructor
,
1243 struct bfd_link_hash_entry
*h
;
1244 char set_name
[1 + sizeof "__CTOR_LIST__"];
1246 if (config
.warn_constructors
)
1247 einfo (_("%P: warning: global constructor %s used\n"), name
);
1249 if (!config
.build_constructors
)
1252 /* Ensure that BFD_RELOC_CTOR exists now, so that we can give a
1253 useful error message. */
1254 if (bfd_reloc_type_lookup (info
->output_bfd
, BFD_RELOC_CTOR
) == NULL
1255 && (bfd_link_relocatable (info
)
1256 || bfd_reloc_type_lookup (abfd
, BFD_RELOC_CTOR
) == NULL
))
1257 einfo (_("%F%P: BFD backend error: BFD_RELOC_CTOR unsupported\n"));
1260 if (bfd_get_symbol_leading_char (abfd
) != '\0')
1261 *s
++ = bfd_get_symbol_leading_char (abfd
);
1263 strcpy (s
, "__CTOR_LIST__");
1265 strcpy (s
, "__DTOR_LIST__");
1267 h
= bfd_link_hash_lookup (info
->hash
, set_name
, TRUE
, TRUE
, TRUE
);
1268 if (h
== (struct bfd_link_hash_entry
*) NULL
)
1269 einfo (_("%F%P: bfd_link_hash_lookup failed: %E\n"));
1270 if (h
->type
== bfd_link_hash_new
)
1272 h
->type
= bfd_link_hash_undefined
;
1273 h
->u
.undef
.abfd
= abfd
;
1274 /* We don't call bfd_link_add_undef to add this to the list of
1275 undefined symbols because we are going to define it
1279 ldctor_add_set_entry (h
, BFD_RELOC_CTOR
, name
, section
, value
);
1282 /* A structure used by warning_callback to pass information through
1283 bfd_map_over_sections. */
1285 struct warning_callback_info
1288 const char *warning
;
1293 /* Look through the relocs to see if we can find a plausible address
1294 for SYMBOL in ABFD. Return TRUE if found. Otherwise return FALSE. */
1297 symbol_warning (const char *warning
, const char *symbol
, bfd
*abfd
)
1299 struct warning_callback_info cinfo
;
1301 if (!bfd_generic_link_read_symbols (abfd
))
1302 einfo (_("%F%P: %pB: could not read symbols: %E\n"), abfd
);
1304 cinfo
.found
= FALSE
;
1305 cinfo
.warning
= warning
;
1306 cinfo
.symbol
= symbol
;
1307 cinfo
.asymbols
= bfd_get_outsymbols (abfd
);
1308 bfd_map_over_sections (abfd
, warning_find_reloc
, &cinfo
);
1312 /* This is called when there is a reference to a warning symbol. */
1315 warning_callback (struct bfd_link_info
*info ATTRIBUTE_UNUSED
,
1316 const char *warning
,
1322 /* This is a hack to support warn_multiple_gp. FIXME: This should
1323 have a cleaner interface, but what? */
1324 if (!config
.warn_multiple_gp
1325 && strcmp (warning
, "using multiple gp values") == 0)
1328 if (section
!= NULL
)
1329 einfo ("%P: %C: %s%s\n", abfd
, section
, address
, _("warning: "), warning
);
1330 else if (abfd
== NULL
)
1331 einfo ("%P: %s%s\n", _("warning: "), warning
);
1332 else if (symbol
== NULL
)
1333 einfo ("%P: %pB: %s%s\n", abfd
, _("warning: "), warning
);
1334 else if (!symbol_warning (warning
, symbol
, abfd
))
1337 /* Search all input files for a reference to SYMBOL. */
1338 for (b
= info
->input_bfds
; b
; b
= b
->link
.next
)
1339 if (b
!= abfd
&& symbol_warning (warning
, symbol
, b
))
1341 einfo ("%P: %pB: %s%s\n", abfd
, _("warning: "), warning
);
1345 /* This is called by warning_callback for each section. It checks the
1346 relocs of the section to see if it can find a reference to the
1347 symbol which triggered the warning. If it can, it uses the reloc
1348 to give an error message with a file and line number. */
1351 warning_find_reloc (bfd
*abfd
, asection
*sec
, void *iarg
)
1353 struct warning_callback_info
*info
= (struct warning_callback_info
*) iarg
;
1357 arelent
**p
, **pend
;
1362 relsize
= bfd_get_reloc_upper_bound (abfd
, sec
);
1364 einfo (_("%F%P: %pB: could not read relocs: %E\n"), abfd
);
1368 relpp
= (arelent
**) xmalloc (relsize
);
1369 relcount
= bfd_canonicalize_reloc (abfd
, sec
, relpp
, info
->asymbols
);
1371 einfo (_("%F%P: %pB: could not read relocs: %E\n"), abfd
);
1374 pend
= p
+ relcount
;
1375 for (; p
< pend
&& *p
!= NULL
; p
++)
1379 if (q
->sym_ptr_ptr
!= NULL
1380 && *q
->sym_ptr_ptr
!= NULL
1381 && strcmp (bfd_asymbol_name (*q
->sym_ptr_ptr
), info
->symbol
) == 0)
1383 /* We found a reloc for the symbol we are looking for. */
1384 einfo ("%P: %C: %s%s\n", abfd
, sec
, q
->address
, _("warning: "),
1394 #if SUPPORT_ERROR_HANDLING_SCRIPT
1395 char * error_handling_script
= NULL
;
1398 /* This is called when an undefined symbol is found. */
1401 undefined_symbol (struct bfd_link_info
*info
,
1408 static char *error_name
;
1409 static unsigned int error_count
;
1411 #define MAX_ERRORS_IN_A_ROW 5
1413 if (info
->ignore_hash
!= NULL
1414 && bfd_hash_lookup (info
->ignore_hash
, name
, FALSE
, FALSE
) != NULL
)
1417 if (config
.warn_once
)
1419 /* Only warn once about a particular undefined symbol. */
1420 add_ignoresym (info
, name
);
1423 /* We never print more than a reasonable number of errors in a row
1424 for a single symbol. */
1425 if (error_name
!= NULL
1426 && strcmp (name
, error_name
) == 0)
1432 error_name
= xstrdup (name
);
1435 #if SUPPORT_ERROR_HANDLING_SCRIPT
1436 if (error_handling_script
!= NULL
1437 && error_count
< MAX_ERRORS_IN_A_ROW
)
1443 argv
[0] = error_handling_script
;
1444 argv
[1] = "undefined-symbol";
1445 argv
[2] = (char *) name
;
1449 einfo (_("%P: About to run error handling script '%s' with arguments: '%s' '%s'\n"),
1450 argv
[0], argv
[1], argv
[2]);
1452 res
= pex_one (PEX_SEARCH
, error_handling_script
, argv
,
1453 N_("error handling script"),
1454 NULL
/* Send stdout to random, temp file. */,
1455 NULL
/* Write to stderr. */,
1459 einfo (_("%P: Failed to run error handling script '%s', reason: "),
1460 error_handling_script
);
1461 /* FIXME: We assume here that errrno == err. */
1464 /* We ignore the return status of the script and
1465 carry on to issue the normal error message. */
1467 #endif /* SUPPORT_ERROR_HANDLING_SCRIPT */
1469 if (section
!= NULL
)
1471 if (error_count
< MAX_ERRORS_IN_A_ROW
)
1474 einfo (_("%X%P: %C: undefined reference to `%pT'\n"),
1475 abfd
, section
, address
, name
);
1477 einfo (_("%P: %C: warning: undefined reference to `%pT'\n"),
1478 abfd
, section
, address
, name
);
1480 else if (error_count
== MAX_ERRORS_IN_A_ROW
)
1483 einfo (_("%X%P: %D: more undefined references to `%pT' follow\n"),
1484 abfd
, section
, address
, name
);
1486 einfo (_("%P: %D: warning: more undefined references to `%pT' follow\n"),
1487 abfd
, section
, address
, name
);
1494 if (error_count
< MAX_ERRORS_IN_A_ROW
)
1497 einfo (_("%X%P: %pB: undefined reference to `%pT'\n"),
1500 einfo (_("%P: %pB: warning: undefined reference to `%pT'\n"),
1503 else if (error_count
== MAX_ERRORS_IN_A_ROW
)
1506 einfo (_("%X%P: %pB: more undefined references to `%pT' follow\n"),
1509 einfo (_("%P: %pB: warning: more undefined references to `%pT' follow\n"),
1517 /* Counter to limit the number of relocation overflow error messages
1518 to print. Errors are printed as it is decremented. When it's
1519 called and the counter is zero, a final message is printed
1520 indicating more relocations were omitted. When it gets to -1, no
1521 such errors are printed. If it's initially set to a value less
1522 than -1, all such errors will be printed (--verbose does this). */
1524 int overflow_cutoff_limit
= 10;
1526 /* This is called when a reloc overflows. */
1529 reloc_overflow (struct bfd_link_info
*info
,
1530 struct bfd_link_hash_entry
*entry
,
1532 const char *reloc_name
,
1538 if (overflow_cutoff_limit
== -1)
1541 einfo ("%X%H:", abfd
, section
, address
);
1543 if (overflow_cutoff_limit
>= 0
1544 && overflow_cutoff_limit
-- == 0)
1546 einfo (_(" additional relocation overflows omitted from the output\n"));
1552 while (entry
->type
== bfd_link_hash_indirect
1553 || entry
->type
== bfd_link_hash_warning
)
1554 entry
= entry
->u
.i
.link
;
1555 switch (entry
->type
)
1557 case bfd_link_hash_undefined
:
1558 case bfd_link_hash_undefweak
:
1559 einfo (_(" relocation truncated to fit: "
1560 "%s against undefined symbol `%pT'"),
1561 reloc_name
, entry
->root
.string
);
1563 case bfd_link_hash_defined
:
1564 case bfd_link_hash_defweak
:
1565 einfo (_(" relocation truncated to fit: "
1566 "%s against symbol `%pT' defined in %pA section in %pB"),
1567 reloc_name
, entry
->root
.string
,
1568 entry
->u
.def
.section
,
1569 entry
->u
.def
.section
== bfd_abs_section_ptr
1570 ? info
->output_bfd
: entry
->u
.def
.section
->owner
);
1578 einfo (_(" relocation truncated to fit: %s against `%pT'"),
1581 einfo ("+%v", addend
);
1585 /* This is called when a dangerous relocation is made. */
1588 reloc_dangerous (struct bfd_link_info
*info ATTRIBUTE_UNUSED
,
1589 const char *message
,
1594 einfo (_("%X%H: dangerous relocation: %s\n"),
1595 abfd
, section
, address
, message
);
1598 /* This is called when a reloc is being generated attached to a symbol
1599 that is not being output. */
1602 unattached_reloc (struct bfd_link_info
*info ATTRIBUTE_UNUSED
,
1608 einfo (_("%X%H: reloc refers to symbol `%pT' which is not being output\n"),
1609 abfd
, section
, address
, name
);
1612 /* This is called if link_info.notice_all is set, or when a symbol in
1613 link_info.notice_hash is found. Symbols are put in notice_hash
1614 using the -y option, while notice_all is set if the --cref option
1615 has been supplied, or if there are any NOCROSSREFS sections in the
1616 linker script; and if plugins are active, since they need to monitor
1617 all references from non-IR files. */
1620 notice (struct bfd_link_info
*info
,
1621 struct bfd_link_hash_entry
*h
,
1622 struct bfd_link_hash_entry
*inh ATTRIBUTE_UNUSED
,
1626 flagword flags ATTRIBUTE_UNUSED
)
1632 if (command_line
.cref
|| nocrossref_list
!= NULL
)
1633 return handle_asneeded_cref (abfd
, (enum notice_asneeded_action
) value
);
1637 name
= h
->root
.string
;
1638 if (info
->notice_hash
!= NULL
1639 && bfd_hash_lookup (info
->notice_hash
, name
, FALSE
, FALSE
) != NULL
)
1641 if (bfd_is_und_section (section
))
1642 einfo (_("%P: %pB: reference to %s\n"), abfd
, name
);
1644 einfo (_("%P: %pB: definition of %s\n"), abfd
, name
);
1647 if (command_line
.cref
|| nocrossref_list
!= NULL
)
1648 add_cref (name
, abfd
, section
, value
);