1 /* Linker file opening and searching.
2 Copyright (C) 1991-2020 Free Software Foundation, Inc.
4 This file is part of the GNU Binutils.
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston,
19 MA 02110-1301, USA. */
25 #include "safe-ctype.h"
35 #include "libiberty.h"
36 #include "filenames.h"
37 #if BFD_SUPPORTS_PLUGINS
38 #include "plugin-api.h"
40 #endif /* BFD_SUPPORTS_PLUGINS */
42 bfd_boolean ldfile_assumed_script
= FALSE
;
43 const char *ldfile_output_machine_name
= "";
44 unsigned long ldfile_output_machine
;
45 enum bfd_architecture ldfile_output_architecture
;
46 search_dirs_type
*search_head
;
49 static char *slash
= "";
51 #if defined (_WIN32) && !defined (__CYGWIN32__)
52 static char *slash
= "\\";
54 static char *slash
= "/";
58 typedef struct search_arch
61 struct search_arch
*next
;
64 static search_dirs_type
**search_tail_ptr
= &search_head
;
65 static search_arch_type
*search_arch_head
;
66 static search_arch_type
**search_arch_tail_ptr
= &search_arch_head
;
68 /* Test whether a pathname, after canonicalization, is the same or a
69 sub-directory of the sysroot directory. */
72 is_sysrooted_pathname (const char *name
)
78 if (ld_canon_sysroot
== NULL
)
81 realname
= lrealpath (name
);
82 len
= strlen (realname
);
84 if (len
> ld_canon_sysroot_len
85 && IS_DIR_SEPARATOR (realname
[ld_canon_sysroot_len
]))
87 realname
[ld_canon_sysroot_len
] = '\0';
88 result
= FILENAME_CMP (ld_canon_sysroot
, realname
) == 0;
95 /* Adds NAME to the library search path.
96 Makes a copy of NAME using xmalloc(). */
99 ldfile_add_library_path (const char *name
, bfd_boolean cmdline
)
101 search_dirs_type
*new_dirs
;
103 if (!cmdline
&& config
.only_cmd_line_lib_dirs
)
106 new_dirs
= (search_dirs_type
*) xmalloc (sizeof (search_dirs_type
));
107 new_dirs
->next
= NULL
;
108 new_dirs
->cmdline
= cmdline
;
109 *search_tail_ptr
= new_dirs
;
110 search_tail_ptr
= &new_dirs
->next
;
112 /* If a directory is marked as honoring sysroot, prepend the sysroot path
115 new_dirs
->name
= concat (ld_sysroot
, name
+ 1, (const char *) NULL
);
116 else if (CONST_STRNEQ (name
, "$SYSROOT"))
117 new_dirs
->name
= concat (ld_sysroot
, name
+ strlen ("$SYSROOT"), (const char *) NULL
);
119 new_dirs
->name
= xstrdup (name
);
122 /* Try to open a BFD for a lang_input_statement. */
125 ldfile_try_open_bfd (const char *attempt
,
126 lang_input_statement_type
*entry
)
128 entry
->the_bfd
= bfd_openr (attempt
, entry
->target
);
132 if (entry
->the_bfd
== NULL
)
133 info_msg (_("attempt to open %s failed\n"), attempt
);
135 info_msg (_("attempt to open %s succeeded\n"), attempt
);
138 if (entry
->the_bfd
== NULL
)
140 if (bfd_get_error () == bfd_error_invalid_target
)
141 einfo (_("%F%P: invalid BFD target `%s'\n"), entry
->target
);
145 track_dependency_files (attempt
);
147 /* Linker needs to decompress sections. */
148 entry
->the_bfd
->flags
|= BFD_DECOMPRESS
;
150 /* This is a linker input BFD. */
151 entry
->the_bfd
->is_linker_input
= 1;
153 #if BFD_SUPPORTS_PLUGINS
154 if (entry
->flags
.lto_output
)
155 entry
->the_bfd
->lto_output
= 1;
158 /* If we are searching for this file, see if the architecture is
159 compatible with the output file. If it isn't, keep searching.
160 If we can't open the file as an object file, stop the search
161 here. If we are statically linking, ensure that we don't link
164 In the code below, it's OK to exit early if the check fails,
165 closing the checked BFD and returning FALSE, but if the BFD
166 checks out compatible, do not exit early returning TRUE, or
167 the plugins will not get a chance to claim the file. */
169 if (entry
->flags
.search_dirs
|| !entry
->flags
.dynamic
)
173 if (bfd_check_format (entry
->the_bfd
, bfd_archive
))
174 check
= bfd_openr_next_archived_file (entry
->the_bfd
, NULL
);
176 check
= entry
->the_bfd
;
180 if (!bfd_check_format (check
, bfd_object
))
182 if (check
== entry
->the_bfd
183 && entry
->flags
.search_dirs
184 && bfd_get_error () == bfd_error_file_not_recognized
185 && !ldemul_unrecognized_file (entry
))
188 char *arg
, *arg1
, *arg2
, *arg3
;
191 /* Try to interpret the file as a linker script. */
192 ldfile_open_command_file (attempt
);
194 ldfile_assumed_script
= TRUE
;
195 parser_input
= input_selected
;
197 token
= INPUT_SCRIPT
;
203 if ((token
= yylex ()) != '(')
205 if ((token
= yylex ()) != NAME
)
213 if ((token
= yylex ()) != NAME
)
219 if ((token
= yylex ()) != ','
220 || (token
= yylex ()) != NAME
)
231 switch (command_line
.endian
)
237 arg
= arg2
? arg2
: arg1
; break;
239 arg
= arg3
? arg3
: arg1
; break;
241 if (strcmp (arg
, lang_get_output_target ()) != 0)
250 case VERS_IDENTIFIER
:
255 free (yylval
.bigint
.str
);
261 ldfile_assumed_script
= FALSE
;
266 if (command_line
.warn_search_mismatch
)
267 einfo (_("%P: skipping incompatible %s "
268 "when searching for %s\n"),
269 attempt
, entry
->local_sym_name
);
270 bfd_close (entry
->the_bfd
);
271 entry
->the_bfd
= NULL
;
278 if (!entry
->flags
.dynamic
&& (entry
->the_bfd
->flags
& DYNAMIC
) != 0)
280 einfo (_("%F%P: attempted static link of dynamic object `%s'\n"),
282 bfd_close (entry
->the_bfd
);
283 entry
->the_bfd
= NULL
;
287 if (entry
->flags
.search_dirs
288 && !bfd_arch_get_compatible (check
, link_info
.output_bfd
,
289 command_line
.accept_unknown_input_arch
)
290 /* XCOFF archives can have 32 and 64 bit objects. */
291 && !(bfd_get_flavour (check
) == bfd_target_xcoff_flavour
292 && (bfd_get_flavour (link_info
.output_bfd
)
293 == bfd_target_xcoff_flavour
)
294 && bfd_check_format (entry
->the_bfd
, bfd_archive
)))
296 if (command_line
.warn_search_mismatch
)
297 einfo (_("%P: skipping incompatible %s "
298 "when searching for %s\n"),
299 attempt
, entry
->local_sym_name
);
300 bfd_close (entry
->the_bfd
);
301 entry
->the_bfd
= NULL
;
307 #if BFD_SUPPORTS_PLUGINS
308 /* If plugins are active, they get first chance to claim
309 any successfully-opened input file. We skip archives
310 here; the plugin wants us to offer it the individual
311 members when we enumerate them, not the whole file. We
312 also ignore corefiles, because that's just weird. It is
313 a needed side-effect of calling bfd_check_format with
314 bfd_object that it sets the bfd's arch and mach, which
315 will be needed when and if we want to bfd_create a new
316 one using this one as a template. */
317 if (link_info
.lto_plugin_active
319 && bfd_check_format (entry
->the_bfd
, bfd_object
))
320 plugin_maybe_claim (entry
);
321 #endif /* BFD_SUPPORTS_PLUGINS */
323 /* It opened OK, the format checked out, and the plugins have had
324 their chance to claim it, so this is success. */
328 /* Search for and open the file specified by ENTRY. If it is an
329 archive, use ARCH, LIB and SUFFIX to modify the file name. */
332 ldfile_open_file_search (const char *arch
,
333 lang_input_statement_type
*entry
,
337 search_dirs_type
*search
;
339 /* If this is not an archive, try to open it in the current
341 if (!entry
->flags
.maybe_archive
)
343 if (entry
->flags
.sysrooted
&& IS_ABSOLUTE_PATH (entry
->filename
))
345 char *name
= concat (ld_sysroot
, entry
->filename
,
346 (const char *) NULL
);
347 if (ldfile_try_open_bfd (name
, entry
))
349 entry
->filename
= name
;
354 else if (ldfile_try_open_bfd (entry
->filename
, entry
))
357 if (IS_ABSOLUTE_PATH (entry
->filename
))
361 for (search
= search_head
; search
!= NULL
; search
= search
->next
)
365 if (entry
->flags
.dynamic
&& !bfd_link_relocatable (&link_info
))
367 if (ldemul_open_dynamic_archive (arch
, search
, entry
))
371 if (entry
->flags
.maybe_archive
&& !entry
->flags
.full_name_provided
)
372 string
= concat (search
->name
, slash
, lib
, entry
->filename
,
373 arch
, suffix
, (const char *) NULL
);
375 string
= concat (search
->name
, slash
, entry
->filename
,
378 if (ldfile_try_open_bfd (string
, entry
))
380 entry
->filename
= string
;
390 /* Open the input file specified by ENTRY.
391 PR 4437: Do not stop on the first missing file, but
392 continue processing other input files in case there
393 are more errors to report. */
396 ldfile_open_file (lang_input_statement_type
*entry
)
398 if (entry
->the_bfd
!= NULL
)
401 if (!entry
->flags
.search_dirs
)
403 if (ldfile_try_open_bfd (entry
->filename
, entry
))
406 if (filename_cmp (entry
->filename
, entry
->local_sym_name
) != 0)
407 einfo (_("%P: cannot find %s (%s): %E\n"),
408 entry
->filename
, entry
->local_sym_name
);
410 einfo (_("%P: cannot find %s: %E\n"), entry
->local_sym_name
);
412 entry
->flags
.missing_file
= TRUE
;
413 input_flags
.missing_file
= TRUE
;
417 search_arch_type
*arch
;
418 bfd_boolean found
= FALSE
;
420 /* If extra_search_path is set, entry->filename is a relative path.
421 Search the directory of the current linker script before searching
423 if (entry
->extra_search_path
)
425 char *path
= concat (entry
->extra_search_path
, slash
, entry
->filename
,
427 if (ldfile_try_open_bfd (path
, entry
))
429 entry
->filename
= path
;
430 entry
->flags
.search_dirs
= FALSE
;
437 /* Try to open <filename><suffix> or lib<filename><suffix>.a. */
438 for (arch
= search_arch_head
; arch
!= NULL
; arch
= arch
->next
)
440 found
= ldfile_open_file_search (arch
->name
, entry
, "lib", ".a");
444 found
= ldfile_open_file_search (arch
->name
, entry
, ":lib", ".a");
448 found
= ldemul_find_potential_libraries (arch
->name
, entry
);
453 /* If we have found the file, we don't need to search directories
456 entry
->flags
.search_dirs
= FALSE
;
459 if (entry
->flags
.sysrooted
461 && IS_ABSOLUTE_PATH (entry
->local_sym_name
))
462 einfo (_("%P: cannot find %s inside %s\n"),
463 entry
->local_sym_name
, ld_sysroot
);
464 #if SUPPORT_ERROR_HANDLING_SCRIPT
465 else if (error_handling_script
!= NULL
)
471 argv
[0] = error_handling_script
;
472 argv
[1] = "missing-lib";
473 argv
[2] = (char *) entry
->local_sym_name
;
477 einfo (_("%P: About to run error handling script '%s' with arguments: '%s' '%s'\n"),
478 argv
[0], argv
[1], argv
[2]);
480 res
= pex_one (PEX_SEARCH
, error_handling_script
, argv
,
481 N_("error handling script"),
482 NULL
/* Send stdout to random, temp file. */,
483 NULL
/* Write to stderr. */,
487 einfo (_("%P: Failed to run error handling script '%s', reason: "),
488 error_handling_script
);
489 /* FIXME: We assume here that errrno == err. */
492 else /* We ignore the return status of the script
493 and always print the error message. */
494 einfo (_("%P: cannot find %s\n"), entry
->local_sym_name
);
498 einfo (_("%P: cannot find %s\n"), entry
->local_sym_name
);
500 /* PR 25747: Be kind to users who forgot to add the
501 "lib" prefix to their library when it was created. */
502 for (arch
= search_arch_head
; arch
!= NULL
; arch
= arch
->next
)
504 if (ldfile_open_file_search (arch
->name
, entry
, "", ".a"))
506 const char * base
= lbasename (entry
->filename
);
508 einfo (_("%P: note to link with %s use -l:%s or rename it to lib%s\n"),
509 entry
->filename
, base
, base
);
510 bfd_close (entry
->the_bfd
);
511 entry
->the_bfd
= NULL
;
516 entry
->flags
.missing_file
= TRUE
;
517 input_flags
.missing_file
= TRUE
;
522 /* Try to open NAME. */
525 try_open (const char *name
, bfd_boolean
*sysrooted
)
529 result
= fopen (name
, "r");
532 *sysrooted
= is_sysrooted_pathname (name
);
537 info_msg (_("cannot find script file %s\n"), name
);
539 info_msg (_("opened script file %s\n"), name
);
545 /* Return TRUE iff directory DIR contains an "ldscripts" subdirectory. */
548 check_for_scripts_dir (char *dir
)
554 buf
= concat (dir
, "/ldscripts", (const char *) NULL
);
555 res
= stat (buf
, &s
) == 0 && S_ISDIR (s
.st_mode
);
560 /* Return the default directory for finding script files.
561 We look for the "ldscripts" directory in:
563 SCRIPTDIR (passed from Makefile)
564 (adjusted according to the current location of the binary)
565 the dir where this program is (for using it from the build tree). */
568 find_scripts_dir (void)
572 dir
= make_relative_prefix (program_name
, BINDIR
, SCRIPTDIR
);
575 if (check_for_scripts_dir (dir
))
580 dir
= make_relative_prefix (program_name
, TOOLBINDIR
, SCRIPTDIR
);
583 if (check_for_scripts_dir (dir
))
588 /* Look for "ldscripts" in the dir where our binary is. */
589 dir
= make_relative_prefix (program_name
, ".", ".");
592 if (check_for_scripts_dir (dir
))
600 /* If DEFAULT_ONLY is false, try to open NAME; if that fails, look for
601 it in directories specified with -L, then in the default script
602 directory. If DEFAULT_ONLY is true, the search is restricted to
603 the default script location. */
606 ldfile_find_command_file (const char *name
,
607 bfd_boolean default_only
,
608 bfd_boolean
*sysrooted
)
610 search_dirs_type
*search
;
613 static search_dirs_type
*script_search
;
617 /* First try raw name. */
618 result
= try_open (name
, sysrooted
);
625 char *script_dir
= find_scripts_dir ();
628 search_dirs_type
**save_tail_ptr
= search_tail_ptr
;
629 search_tail_ptr
= &script_search
;
630 ldfile_add_library_path (script_dir
, TRUE
);
631 search_tail_ptr
= save_tail_ptr
;
635 /* Temporarily append script_search to the path list so that the
636 paths specified with -L will be searched first. */
637 *search_tail_ptr
= script_search
;
639 /* Try now prefixes. */
640 for (search
= default_only
? script_search
: search_head
;
642 search
= search
->next
)
644 path
= concat (search
->name
, slash
, name
, (const char *) NULL
);
645 result
= try_open (path
, sysrooted
);
651 /* Restore the original path list. */
652 *search_tail_ptr
= NULL
;
657 enum script_open_style
{
663 struct script_name_list
665 struct script_name_list
*next
;
666 enum script_open_style open_how
;
670 /* Open command file NAME. */
673 ldfile_open_command_file_1 (const char *name
, enum script_open_style open_how
)
675 FILE *ldlex_input_stack
;
676 bfd_boolean sysrooted
;
677 static struct script_name_list
*processed_scripts
= NULL
;
678 struct script_name_list
*script
;
681 /* PR 24576: Catch the case where the user has accidentally included
682 the same linker script twice. */
683 for (script
= processed_scripts
; script
!= NULL
; script
= script
->next
)
685 if ((open_how
!= script_nonT
|| script
->open_how
!= script_nonT
)
686 && strcmp (name
, script
->name
) == 0)
688 einfo (_("%F%P: error: linker script file '%s'"
689 " appears multiple times\n"), name
);
694 /* FIXME: This memory is never freed, but that should not really matter.
695 It will be released when the linker exits, and it is unlikely to ever
696 be more than a few tens of bytes. */
698 script
= xmalloc (sizeof (*script
) + len
);
699 script
->next
= processed_scripts
;
700 script
->open_how
= open_how
;
701 memcpy (script
->name
, name
, len
+ 1);
702 processed_scripts
= script
;
704 ldlex_input_stack
= ldfile_find_command_file (name
,
705 open_how
== script_defaultT
,
707 if (ldlex_input_stack
== NULL
)
709 bfd_set_error (bfd_error_system_call
);
710 einfo (_("%F%P: cannot open linker script file %s: %E\n"), name
);
714 track_dependency_files (name
);
716 lex_push_file (ldlex_input_stack
, name
, sysrooted
);
720 saved_script_handle
= ldlex_input_stack
;
723 /* Open command file NAME in the current directory, -L directories,
724 the default script location, in that order. */
727 ldfile_open_command_file (const char *name
)
729 ldfile_open_command_file_1 (name
, script_nonT
);
733 ldfile_open_script_file (const char *name
)
735 ldfile_open_command_file_1 (name
, script_T
);
738 /* Open command file NAME at the default script location. */
741 ldfile_open_default_command_file (const char *name
)
743 ldfile_open_command_file_1 (name
, script_defaultT
);
747 ldfile_add_arch (const char *in_name
)
749 char *name
= xstrdup (in_name
);
750 search_arch_type
*new_arch
751 = (search_arch_type
*) xmalloc (sizeof (search_arch_type
));
753 ldfile_output_machine_name
= in_name
;
755 new_arch
->name
= name
;
756 new_arch
->next
= NULL
;
759 *name
= TOLOWER (*name
);
762 *search_arch_tail_ptr
= new_arch
;
763 search_arch_tail_ptr
= &new_arch
->next
;
767 /* Set the output architecture. */
770 ldfile_set_output_arch (const char *string
, enum bfd_architecture defarch
)
772 const bfd_arch_info_type
*arch
= bfd_scan_arch (string
);
776 ldfile_output_architecture
= arch
->arch
;
777 ldfile_output_machine
= arch
->mach
;
778 ldfile_output_machine_name
= arch
->printable_name
;
780 else if (defarch
!= bfd_arch_unknown
)
781 ldfile_output_architecture
= defarch
;
783 einfo (_("%F%P: cannot represent machine `%s'\n"), string
);