1 // options.c -- handle command line options for gold
3 // Copyright (C) 2006-2019 Free Software Foundation, Inc.
4 // Written by Ian Lance Taylor <iant@google.com>.
6 // This file is part of gold.
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.
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.
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.
32 #include "filenames.h"
33 #include "libiberty.h"
35 #include "../bfd/bfdver.h"
39 #include "target-select.h"
47 Position_dependent_options::default_options_;
52 // This flag is TRUE if we should register the command-line options as they
53 // are constructed. It is set after construction of the options within
54 // class Position_dependent_options.
55 static bool ready_to_register = false;
57 // This global variable is set up as General_options is constructed.
58 static std::vector<const One_option*> registered_options;
60 // These are set up at the same time -- the variables that accept one
61 // dash, two, or require -z. A single variable may be in more than
62 // one of these data structures.
63 typedef Unordered_map<std::string, One_option*> Option_map;
64 static Option_map* long_options = NULL;
65 static One_option* short_options[128];
68 One_option::register_option()
70 if (!ready_to_register)
73 registered_options.push_back(this);
75 // We can't make long_options a static Option_map because we can't
76 // guarantee that will be initialized before register_option() is
78 if (long_options == NULL)
79 long_options = new Option_map;
81 // TWO_DASHES means that two dashes are preferred, but one is ok too.
82 if (!this->longname.empty())
83 (*long_options)[this->longname] = this;
85 const int shortname_as_int = static_cast<int>(this->shortname);
86 gold_assert(shortname_as_int >= 0 && shortname_as_int < 128);
87 if (this->shortname != '\0')
89 gold_assert(short_options[shortname_as_int] == NULL);
90 short_options[shortname_as_int] = this;
95 One_option::print() const
100 if (this->shortname != '\0')
102 len += printf("-%c", this->shortname);
105 // -z takes long-names only.
106 gold_assert(this->dashes != DASH_Z);
107 len += printf(" %s", gettext(this->helparg));
111 if (!this->longname.empty()
112 && !(this->longname[0] == this->shortname
113 && this->longname[1] == '\0'))
117 switch (this->dashes)
119 case options::ONE_DASH: case options::EXACTLY_ONE_DASH:
122 case options::TWO_DASHES: case options::EXACTLY_TWO_DASHES:
125 case options::DASH_Z:
126 len += printf("-z ");
131 len += printf("%s", this->longname.c_str());
134 // For most options, we print "--frob FOO". But for -z
135 // we print "-z frob=FOO".
136 len += printf("%c%s", this->dashes == options::DASH_Z ? '=' : ' ',
137 gettext(this->helparg));
146 for (; len < 30; ++len)
149 printf("%s", gettext(this->helpstring));
150 if (this->is_default)
151 printf(" (%s)", _("default"));
158 printf(_("Usage: %s [options] file...\nOptions:\n"), gold::program_name);
160 std::vector<const One_option*>::const_iterator it;
161 for (it = registered_options.begin(); it != registered_options.end(); ++it)
164 // config.guess and libtool.m4 look in ld --help output for the
165 // string "supported targets".
166 printf(_("%s: supported targets:"), gold::program_name);
167 std::vector<const char*> supported_names;
168 gold::supported_target_names(&supported_names);
169 for (std::vector<const char*>::const_iterator p = supported_names.begin();
170 p != supported_names.end();
175 printf(_("%s: supported emulations:"), gold::program_name);
176 supported_names.clear();
177 gold::supported_emulation_names(&supported_names);
178 for (std::vector<const char*>::const_iterator p = supported_names.begin();
179 p != supported_names.end();
184 // REPORT_BUGS_TO is defined in bfd/bfdver.h.
185 const char* report = REPORT_BUGS_TO;
187 printf(_("Report bugs to %s\n"), report);
190 // For bool, arg will be NULL (boolean options take no argument);
191 // we always just set to true.
193 parse_bool(const char*, const char*, bool* retval)
199 parse_uint(const char* option_name, const char* arg, int* retval)
202 *retval = strtol(arg, &endptr, 0);
203 if (*endptr != '\0' || *retval < 0)
204 gold_fatal(_("%s: invalid option value (expected an integer): %s"),
209 parse_int(const char* option_name, const char* arg, int* retval)
212 *retval = strtol(arg, &endptr, 0);
214 gold_fatal(_("%s: invalid option value (expected an integer): %s"),
219 parse_uint64(const char* option_name, const char* arg, uint64_t* retval)
222 *retval = strtoull(arg, &endptr, 0);
224 gold_fatal(_("%s: invalid option value (expected an integer): %s"),
229 parse_double(const char* option_name, const char* arg, double* retval)
232 *retval = strtod(arg, &endptr);
234 gold_fatal(_("%s: invalid option value "
235 "(expected a floating point number): %s"),
240 parse_percent(const char* option_name, const char* arg, double* retval)
243 *retval = strtod(arg, &endptr) / 100.0;
245 gold_fatal(_("%s: invalid option value "
246 "(expected a floating point number): %s"),
251 parse_string(const char* option_name, const char* arg, const char** retval)
254 gold_fatal(_("%s: must take a non-empty argument"), option_name);
259 parse_optional_string(const char*, const char* arg, const char** retval)
265 parse_dirlist(const char*, const char* arg, Dir_list* retval)
267 retval->push_back(Search_directory(arg, false));
271 parse_set(const char*, const char* arg, String_set* retval)
273 retval->insert(std::string(arg));
277 parse_choices(const char* option_name, const char* arg, const char** retval,
278 const char* choices[], int num_choices)
280 for (int i = 0; i < num_choices; i++)
281 if (strcmp(choices[i], arg) == 0)
287 // If we get here, the user did not enter a valid choice, so we die.
288 std::string choices_list;
289 for (int i = 0; i < num_choices; i++)
291 choices_list += choices[i];
292 if (i != num_choices - 1)
293 choices_list += ", ";
295 gold_fatal(_("%s: must take one of the following arguments: %s"),
296 option_name, choices_list.c_str());
299 } // End namespace options.
301 // Define the handler for "special" options (set via DEFINE_special).
304 General_options::parse_help(const char*, const char*, Command_line*)
307 ::exit(EXIT_SUCCESS);
311 General_options::parse_version(const char* opt, const char*, Command_line*)
313 bool print_short = (opt[0] == '-' && opt[1] == 'v');
314 gold::print_version(print_short);
315 this->printed_version_ = true;
317 ::exit(EXIT_SUCCESS);
321 General_options::parse_V(const char*, const char*, Command_line*)
323 gold::print_version(true);
324 this->printed_version_ = true;
326 printf(_(" Supported targets:\n"));
327 std::vector<const char*> supported_names;
328 gold::supported_target_names(&supported_names);
329 for (std::vector<const char*>::const_iterator p = supported_names.begin();
330 p != supported_names.end();
334 printf(_(" Supported emulations:\n"));
335 supported_names.clear();
336 gold::supported_emulation_names(&supported_names);
337 for (std::vector<const char*>::const_iterator p = supported_names.begin();
338 p != supported_names.end();
344 General_options::parse_defsym(const char*, const char* arg,
345 Command_line* cmdline)
347 cmdline->script_options().define_symbol(arg);
351 General_options::parse_discard_all(const char*, const char*,
354 this->discard_locals_ = DISCARD_ALL;
358 General_options::parse_discard_locals(const char*, const char*,
361 this->discard_locals_ = DISCARD_LOCALS;
365 General_options::parse_discard_none(const char*, const char*,
368 this->discard_locals_ = DISCARD_NONE;
372 General_options::parse_incremental(const char*, const char*,
375 this->incremental_mode_ = INCREMENTAL_AUTO;
379 General_options::parse_no_incremental(const char*, const char*,
382 this->incremental_mode_ = INCREMENTAL_OFF;
386 General_options::parse_incremental_full(const char*, const char*,
389 this->incremental_mode_ = INCREMENTAL_FULL;
393 General_options::parse_incremental_update(const char*, const char*,
396 this->incremental_mode_ = INCREMENTAL_UPDATE;
400 General_options::parse_incremental_changed(const char*, const char*,
403 this->implicit_incremental_ = true;
404 this->incremental_disposition_ = INCREMENTAL_CHANGED;
408 General_options::parse_incremental_unchanged(const char*, const char*,
411 this->implicit_incremental_ = true;
412 this->incremental_disposition_ = INCREMENTAL_UNCHANGED;
416 General_options::parse_incremental_unknown(const char*, const char*,
419 this->implicit_incremental_ = true;
420 this->incremental_disposition_ = INCREMENTAL_CHECK;
424 General_options::parse_incremental_startup_unchanged(const char*, const char*,
427 this->implicit_incremental_ = true;
428 this->incremental_startup_disposition_ = INCREMENTAL_UNCHANGED;
432 General_options::parse_library(const char*, const char* arg,
433 Command_line* cmdline)
435 Input_file_argument::Input_file_type type;
439 type = Input_file_argument::INPUT_FILE_TYPE_SEARCHED_FILE;
444 type = Input_file_argument::INPUT_FILE_TYPE_LIBRARY;
447 Input_file_argument file(name, type, "", false, *this);
448 cmdline->inputs().add_file(file);
452 General_options::parse_plugin(const char*, const char* arg,
455 this->add_plugin(arg);
458 // Parse --plugin-opt.
461 General_options::parse_plugin_opt(const char*, const char* arg,
464 this->add_plugin_option(arg);
468 General_options::parse_R(const char* option, const char* arg,
469 Command_line* cmdline)
472 if (::stat(arg, &s) != 0 || S_ISDIR(s.st_mode))
473 this->add_to_rpath(arg);
475 this->parse_just_symbols(option, arg, cmdline);
479 General_options::parse_just_symbols(const char*, const char* arg,
480 Command_line* cmdline)
482 Input_file_argument file(arg, Input_file_argument::INPUT_FILE_TYPE_FILE,
484 cmdline->inputs().add_file(file);
487 // Handle --section-start.
490 General_options::parse_section_start(const char*, const char* arg,
493 const char* eq = strchr(arg, '=');
496 gold_error(_("invalid argument to --section-start; "
497 "must be SECTION=ADDRESS"));
501 std::string section_name(arg, eq - arg);
504 const char* val_start = eq;
505 if (eq[0] == '0' && (eq[1] == 'x' || eq[1] == 'X'))
509 gold_error(_("--section-start address missing"));
514 for (; *eq != '\0'; ++eq)
518 gold_error(_("--section-start argument %s is not a valid hex number"),
523 addr += hex_value(*eq);
526 this->section_starts_[section_name] = addr;
529 // Look up a --section-start value.
532 General_options::section_start(const char* secname, uint64_t* paddr) const
534 if (this->section_starts_.empty())
536 std::map<std::string, uint64_t>::const_iterator p =
537 this->section_starts_.find(secname);
538 if (p == this->section_starts_.end())
545 General_options::parse_static(const char*, const char*, Command_line*)
547 this->set_static(true);
551 General_options::parse_script(const char*, const char* arg,
552 Command_line* cmdline)
554 if (!read_commandline_script(arg, cmdline))
555 gold::gold_fatal(_("unable to parse script file %s"), arg);
559 General_options::parse_version_script(const char*, const char* arg,
560 Command_line* cmdline)
562 if (!read_version_script(arg, cmdline))
563 gold::gold_fatal(_("unable to parse version script file %s"), arg);
567 General_options::parse_dynamic_list(const char*, const char* arg,
568 Command_line* cmdline)
570 if (!read_dynamic_list(arg, cmdline, &this->dynamic_list_))
571 gold::gold_fatal(_("unable to parse dynamic-list script file %s"), arg);
572 this->have_dynamic_list_ = true;
576 General_options::parse_start_group(const char*, const char*,
577 Command_line* cmdline)
579 cmdline->inputs().start_group();
583 General_options::parse_end_group(const char*, const char*,
584 Command_line* cmdline)
586 cmdline->inputs().end_group();
590 General_options::parse_start_lib(const char*, const char*,
591 Command_line* cmdline)
593 cmdline->inputs().start_lib(cmdline->position_dependent_options());
597 General_options::parse_end_lib(const char*, const char*,
598 Command_line* cmdline)
600 cmdline->inputs().end_lib();
603 // The function add_excluded_libs() in ld/ldlang.c of GNU ld breaks up a list
604 // of names separated by commas or colons and puts them in a linked list.
605 // We implement the same parsing of names here but store names in an unordered
606 // map to speed up searching of names.
609 General_options::parse_exclude_libs(const char*, const char* arg,
616 size_t length = strcspn(p, ",:");
617 this->excluded_libs_.insert(std::string(p, length));
618 p += (p[length] ? length + 1 : length);
622 // The checking logic is based on the function check_excluded_libs() in
623 // ld/ldlang.c of GNU ld but our implementation is different because we use
624 // an unordered map instead of a linked list, which is what GNU ld uses. GNU
625 // ld searches sequentially in the excluded libs list. For a given archive,
626 // a match is found if the archive's name matches exactly one of the list
627 // entry or if the archive's name is of the form FOO.a and FOO matches exactly
628 // one of the list entry. An entry "ALL" in the list is considered as a
629 // wild-card and matches any given name.
632 General_options::check_excluded_libs(const std::string &name) const
634 Unordered_set<std::string>::const_iterator p;
636 // Exit early for the most common case.
637 if (excluded_libs_.empty())
640 // If we see "ALL", all archives are excluded from automatic export.
641 p = excluded_libs_.find(std::string("ALL"));
642 if (p != excluded_libs_.end())
645 // First strip off any directories in name.
646 const char* basename = lbasename(name.c_str());
648 // Try finding an exact match.
649 p = excluded_libs_.find(std::string(basename));
650 if (p != excluded_libs_.end())
653 // Try matching NAME without ".a" at the end.
654 size_t length = strlen(basename);
656 && (basename[length - 2] == '.')
657 && (basename[length - 1] == 'a'))
659 p = excluded_libs_.find(std::string(basename, length - 2));
660 if (p != excluded_libs_.end())
667 // Recognize input and output target names. The GNU linker accepts
668 // these with --format and --oformat. This code is intended to be
669 // minimally compatible. In practice for an ELF target this would be
670 // the same target as the input files; that name always start with
671 // "elf". Non-ELF targets would be "srec", "symbolsrec", "tekhex",
674 General_options::Object_format
675 General_options::string_to_object_format(const char* arg)
677 if (strncmp(arg, "elf", 3) == 0 || strcmp(arg, "default") == 0)
678 return gold::General_options::OBJECT_FORMAT_ELF;
679 else if (strcmp(arg, "binary") == 0)
680 return gold::General_options::OBJECT_FORMAT_BINARY;
683 gold::gold_error(_("format '%s' not supported; treating as elf "
684 "(supported formats: elf, binary)"),
686 return gold::General_options::OBJECT_FORMAT_ELF;
691 General_options::object_format_to_string(General_options::Object_format fmt)
695 case General_options::OBJECT_FORMAT_ELF:
697 case General_options::OBJECT_FORMAT_BINARY:
705 General_options::parse_fix_v4bx(const char*, const char*,
708 this->fix_v4bx_ = FIX_V4BX_REPLACE;
712 General_options::parse_fix_v4bx_interworking(const char*, const char*,
715 this->fix_v4bx_ = FIX_V4BX_INTERWORKING;
719 General_options::parse_EB(const char*, const char*, Command_line*)
721 this->endianness_ = ENDIANNESS_BIG;
725 General_options::parse_EL(const char*, const char*, Command_line*)
727 this->endianness_ = ENDIANNESS_LITTLE;
731 General_options::copy_from_posdep_options(
732 const Position_dependent_options& posdep)
734 this->set_as_needed(posdep.as_needed());
735 this->set_Bdynamic(posdep.Bdynamic());
737 General_options::object_format_to_string(posdep.format_enum()));
738 this->set_whole_archive(posdep.whole_archive());
739 this->set_incremental_disposition(posdep.incremental_disposition());
743 General_options::parse_push_state(const char*, const char*, Command_line*)
745 Position_dependent_options* posdep = new Position_dependent_options(*this);
746 this->options_stack_.push_back(posdep);
750 General_options::parse_pop_state(const char*, const char*, Command_line*)
752 if (this->options_stack_.empty())
754 gold::gold_error(_("unbalanced --push-state/--pop-state"));
757 Position_dependent_options* posdep = this->options_stack_.back();
758 this->options_stack_.pop_back();
759 this->copy_from_posdep_options(*posdep);
763 } // End namespace gold.
772 _("%s: use the --help option for usage information\n"),
774 ::exit(EXIT_FAILURE);
778 usage(const char* msg, const char* opt)
782 gold::program_name, opt, msg);
786 // If the default sysroot is relocatable, try relocating it based on
790 get_relative_sysroot(const char* from)
792 char* path = make_relative_prefix(gold::program_name, from,
797 if (::stat(path, &s) == 0 && S_ISDIR(s.st_mode))
805 // Return the default sysroot. This is set by the --with-sysroot
806 // option to configure. Note we do not free the return value of
807 // get_relative_sysroot, which is a small memory leak, but is
808 // necessary since we store this pointer directly in General_options.
811 get_default_sysroot()
813 const char* sysroot = TARGET_SYSTEM_ROOT;
814 if (*sysroot == '\0')
817 if (TARGET_SYSTEM_ROOT_RELOCATABLE)
819 char* path = get_relative_sysroot(BINDIR);
821 path = get_relative_sysroot(TOOLBINDIR);
829 // Parse a long option. Such options have the form
830 // <-|--><option>[=arg]. If "=arg" is not present but the option
831 // takes an argument, the next word is taken to the be the argument.
832 // If equals_only is set, then only the <option>=<arg> form is
833 // accepted, not the <option><space><arg> form. Returns a One_option
834 // struct or NULL if argv[i] cannot be parsed as a long option. In
835 // the not-NULL case, *arg is set to the option's argument (NULL if
836 // the option takes no argument), and *i is advanced past this option.
837 // NOTE: it is safe for argv and arg to point to the same place.
838 gold::options::One_option*
839 parse_long_option(int argc, const char** argv, bool equals_only,
840 const char** arg, int* i)
842 const char* const this_argv = argv[*i];
844 const char* equals = strchr(this_argv, '=');
845 const char* option_start = this_argv + strspn(this_argv, "-");
846 std::string option(option_start,
847 equals ? equals - option_start : strlen(option_start));
849 gold::options::Option_map::iterator it
850 = gold::options::long_options->find(option);
851 if (it == gold::options::long_options->end())
854 gold::options::One_option* retval = it->second;
856 // If the dash-count doesn't match, we fail.
857 if (this_argv[0] != '-') // no dashes at all: had better be "-z <longopt>"
859 if (retval->dashes != gold::options::DASH_Z)
862 else if (this_argv[1] != '-') // one dash
864 if (retval->dashes != gold::options::ONE_DASH
865 && retval->dashes != gold::options::EXACTLY_ONE_DASH
866 && retval->dashes != gold::options::TWO_DASHES)
869 else // two dashes (or more!)
871 if (retval->dashes != gold::options::TWO_DASHES
872 && retval->dashes != gold::options::EXACTLY_TWO_DASHES
873 && retval->dashes != gold::options::ONE_DASH)
877 // Now that we know the option is good (or else bad in a way that
878 // will cause us to die), increment i to point past this argv.
881 // Figure out the option's argument, if any.
882 if (!retval->takes_argument())
885 usage(_("unexpected argument"), this_argv);
893 else if (retval->takes_optional_argument())
894 *arg = retval->default_value;
895 else if (*i < argc && !equals_only)
898 usage(_("missing argument"), this_argv);
904 // Parse a short option. Such options have the form -<option>[arg].
905 // If "arg" is not present but the option takes an argument, the next
906 // word is taken to the be the argument. If the option does not take
907 // an argument, it may be followed by another short option. Returns a
908 // One_option struct or NULL if argv[i] cannot be parsed as a short
909 // option. In the not-NULL case, *arg is set to the option's argument
910 // (NULL if the option takes no argument), and *i is advanced past
911 // this option. This function keeps *i the same if we parsed a short
912 // option that does not take an argument, that looks to be followed by
913 // another short option in the same word.
914 gold::options::One_option*
915 parse_short_option(int argc, const char** argv, int pos_in_argv_i,
916 const char** arg, int* i)
918 const char* const this_argv = argv[*i];
920 if (this_argv[0] != '-')
923 // We handle -z as a special case.
924 static gold::options::One_option dash_z("", gold::options::DASH_Z,
925 'z', "", NULL, "Z-OPTION", false,
927 gold::options::One_option* retval = NULL;
928 if (this_argv[pos_in_argv_i] == 'z')
932 const int char_as_int = static_cast<int>(this_argv[pos_in_argv_i]);
933 if (char_as_int > 0 && char_as_int < 128)
934 retval = gold::options::short_options[char_as_int];
940 // Figure out the option's argument, if any.
941 if (!retval->takes_argument())
944 // We only advance past this argument if it's the only one in argv.
945 if (this_argv[pos_in_argv_i + 1] == '\0')
950 // If we take an argument, we'll eat up this entire argv entry.
952 if (this_argv[pos_in_argv_i + 1] != '\0')
953 *arg = this_argv + pos_in_argv_i + 1;
954 else if (retval->takes_optional_argument())
955 *arg = retval->default_value;
959 usage(_("missing argument"), this_argv);
962 // If we're a -z option, we need to parse our argument as a
963 // long-option, e.g. "-z stacksize=8192".
964 if (retval == &dash_z)
967 const char* dash_z_arg = *arg;
968 retval = parse_long_option(1, arg, true, arg, &dummy_i);
970 usage(_("unknown -z option"), dash_z_arg);
976 } // End anonymous namespace.
981 General_options::General_options()
982 : printed_version_(false),
983 execstack_status_(EXECSTACK_FROM_INPUT),
984 icf_status_(ICF_NONE),
989 have_dynamic_list_(false),
990 incremental_mode_(INCREMENTAL_OFF),
991 incremental_disposition_(INCREMENTAL_STARTUP),
992 incremental_startup_disposition_(INCREMENTAL_CHECK),
993 implicit_incremental_(false),
995 symbols_to_retain_(),
997 fix_v4bx_(FIX_V4BX_NONE),
998 endianness_(ENDIANNESS_NOT_SET),
999 discard_locals_(DISCARD_SEC_MERGE),
1000 orphan_handling_enum_(ORPHAN_PLACE)
1002 // Turn off option registration once construction is complete.
1003 gold::options::ready_to_register = false;
1006 General_options::Object_format
1007 General_options::format_enum() const
1009 return General_options::string_to_object_format(this->format());
1012 General_options::Object_format
1013 General_options::oformat_enum() const
1015 return General_options::string_to_object_format(this->oformat());
1018 // Add the sysroot, if any, to the search paths.
1021 General_options::add_sysroot()
1023 if (this->sysroot() == NULL || this->sysroot()[0] == '\0')
1025 this->set_sysroot(get_default_sysroot());
1026 if (this->sysroot() == NULL || this->sysroot()[0] == '\0')
1030 char* canonical_sysroot = lrealpath(this->sysroot());
1032 for (Dir_list::iterator p = this->library_path_.value.begin();
1033 p != this->library_path_.value.end();
1035 p->add_sysroot(this->sysroot(), canonical_sysroot);
1037 free(canonical_sysroot);
1040 // Return whether FILENAME is in a system directory.
1043 General_options::is_in_system_directory(const std::string& filename) const
1045 for (Dir_list::const_iterator p = this->library_path_.value.begin();
1046 p != this->library_path_.value.end();
1049 // We use a straight string comparison rather than calling
1050 // FILENAME_CMP because we are only interested in the cases
1051 // where we found the file in a system directory, which means
1052 // that we used the directory name as a prefix for a -L search.
1053 if (p->is_system_directory()
1054 && filename.compare(0, p->name().size(), p->name()) == 0)
1060 // Add a plugin to the list of plugins.
1063 General_options::add_plugin(const char* filename)
1065 if (this->plugins_ == NULL)
1066 this->plugins_ = new Plugin_manager(*this);
1067 this->plugins_->add_plugin(filename);
1070 // Add a plugin option to a plugin.
1073 General_options::add_plugin_option(const char* arg)
1075 if (this->plugins_ == NULL)
1076 gold_fatal("--plugin-opt requires --plugin.");
1077 this->plugins_->add_plugin_option(arg);
1080 // Set up variables and other state that isn't set up automatically by
1081 // the parse routine, and ensure options don't contradict each other
1082 // and are otherwise kosher.
1085 General_options::finalize()
1087 // Normalize the strip modifiers. They have a total order:
1088 // strip_all > strip_debug > strip_non_line > strip_debug_gdb.
1089 // If one is true, set all beneath it to true as well.
1090 if (this->strip_all())
1091 this->set_strip_debug(true);
1092 if (this->strip_debug())
1093 this->set_strip_debug_non_line(true);
1094 if (this->strip_debug_non_line())
1095 this->set_strip_debug_gdb(true);
1097 if (this->Bshareable())
1098 this->set_shared(true);
1100 // If the user specifies both -s and -r, convert the -s to -S.
1101 // -r requires us to keep externally visible symbols!
1102 if (this->strip_all() && this->relocatable())
1104 this->set_strip_all(false);
1105 gold_assert(this->strip_debug());
1108 // For us, -dc and -dp are synonyms for --define-common.
1110 this->set_define_common(true);
1112 this->set_define_common(true);
1114 // We also set --define-common if we're not relocatable, as long as
1115 // the user didn't explicitly ask for something different.
1116 if (!this->user_set_define_common())
1117 this->set_define_common(!this->relocatable());
1119 // execstack_status_ is a three-state variable; update it based on
1120 // -z [no]execstack.
1121 if (this->execstack())
1122 this->set_execstack_status(EXECSTACK_YES);
1123 else if (this->noexecstack())
1124 this->set_execstack_status(EXECSTACK_NO);
1126 // icf_status_ is a three-state variable; update it based on the
1127 // value of this->icf().
1128 if (strcmp(this->icf(), "none") == 0)
1129 this->set_icf_status(ICF_NONE);
1130 else if (strcmp(this->icf(), "safe") == 0)
1131 this->set_icf_status(ICF_SAFE);
1133 this->set_icf_status(ICF_ALL);
1135 // Handle the optional argument for --demangle.
1136 if (this->user_set_demangle())
1138 this->set_do_demangle(true);
1139 const char* style = this->demangle();
1142 enum demangling_styles style_code;
1144 style_code = cplus_demangle_name_to_style(style);
1145 if (style_code == unknown_demangling)
1146 gold_fatal("unknown demangling style '%s'", style);
1147 cplus_demangle_set_style(style_code);
1150 else if (this->user_set_no_demangle())
1151 this->set_do_demangle(false);
1154 // Testing COLLECT_NO_DEMANGLE makes our default demangling
1155 // behaviour identical to that of gcc's linker wrapper.
1156 this->set_do_demangle(getenv("COLLECT_NO_DEMANGLE") == NULL);
1159 // Parse the --orphan-handling argument.
1160 if (this->user_set_orphan_handling())
1162 if (strcmp(this->orphan_handling(), "place") == 0)
1163 this->set_orphan_handling_enum(ORPHAN_PLACE);
1164 else if (strcmp(this->orphan_handling(), "discard") == 0)
1165 this->set_orphan_handling_enum(ORPHAN_DISCARD);
1166 else if (strcmp(this->orphan_handling(), "warn") == 0)
1167 this->set_orphan_handling_enum(ORPHAN_WARN);
1168 else if (strcmp(this->orphan_handling(), "error") == 0)
1169 this->set_orphan_handling_enum(ORPHAN_ERROR);
1172 // -M is equivalent to "-Map -".
1173 if (this->print_map() && !this->user_set_Map())
1176 this->set_user_set_Map();
1179 // Using -n or -N implies -static.
1180 if (this->nmagic() || this->omagic())
1181 this->set_static(true);
1183 // If --thread_count is specified, it applies to
1184 // --thread-count-{initial,middle,final}, though it doesn't override
1186 if (this->thread_count() > 0 && this->thread_count_initial() == 0)
1187 this->set_thread_count_initial(this->thread_count());
1188 if (this->thread_count() > 0 && this->thread_count_middle() == 0)
1189 this->set_thread_count_middle(this->thread_count());
1190 if (this->thread_count() > 0 && this->thread_count_final() == 0)
1191 this->set_thread_count_final(this->thread_count());
1193 // Let's warn if you set the thread-count but we're going to ignore it.
1194 #ifndef ENABLE_THREADS
1195 if (this->threads())
1197 gold_warning(_("ignoring --threads: "
1198 "%s was compiled without thread support"),
1200 this->set_threads(false);
1202 if (this->thread_count() > 0 || this->thread_count_initial() > 0
1203 || this->thread_count_middle() > 0 || this->thread_count_final() > 0)
1204 gold_warning(_("ignoring --thread-count: "
1205 "%s was compiled without thread support"),
1209 #ifndef ENABLE_PLUGINS
1210 if (this->has_plugins())
1211 gold_fatal(_("cannot use --plugin: "
1212 "%s was compiled without plugin support"),
1216 std::string libpath;
1217 if (this->user_set_Y())
1219 libpath = this->Y();
1220 if (libpath.compare(0, 2, "P,") == 0)
1221 libpath.erase(0, 2);
1223 else if (!this->nostdlib())
1225 #ifndef NATIVE_LINKER
1226 #define NATIVE_LINKER 0
1228 const char* p = LIB_PATH;
1229 if (strcmp(p, "::DEFAULT::") != 0)
1231 else if (NATIVE_LINKER
1232 || this->user_set_sysroot()
1233 || *TARGET_SYSTEM_ROOT != '\0')
1235 this->add_to_library_path_with_sysroot("/lib");
1236 this->add_to_library_path_with_sysroot("/usr/lib");
1239 this->add_to_library_path_with_sysroot(TOOLLIBDIR);
1242 if (!libpath.empty())
1248 next_pos = libpath.find(':', pos);
1249 size_t len = (next_pos == std::string::npos
1253 this->add_to_library_path_with_sysroot(libpath.substr(pos, len));
1256 while (next_pos != std::string::npos);
1259 // Parse the contents of -retain-symbols-file into a set.
1260 if (this->retain_symbols_file())
1263 in.open(this->retain_symbols_file());
1265 gold_fatal(_("unable to open -retain-symbols-file file %s: %s"),
1266 this->retain_symbols_file(), strerror(errno));
1268 std::getline(in, line); // this chops off the trailing \n, if any
1271 if (!line.empty() && line[line.length() - 1] == '\r') // Windows
1272 line.resize(line.length() - 1);
1273 this->symbols_to_retain_.insert(line);
1274 std::getline(in, line);
1278 // -Bgroup implies --unresolved-symbols=report-all.
1279 if (this->Bgroup() && !this->user_set_unresolved_symbols())
1280 this->set_unresolved_symbols("report-all");
1282 // -shared implies --allow-shlib-undefined. Currently
1283 // ---allow-shlib-undefined controls warnings issued based on the
1284 // -symbol table. --unresolved-symbols controls warnings issued
1285 // -based on relocations.
1286 if (this->shared() && !this->user_set_allow_shlib_undefined())
1287 this->set_allow_shlib_undefined(true);
1289 // Normalize library_path() by adding the sysroot to all directories
1290 // in the path, as appropriate.
1291 this->add_sysroot();
1293 // Now that we've normalized the options, check for contradictory ones.
1294 if (this->shared() && this->is_static())
1295 gold_fatal(_("-shared and -static are incompatible"));
1296 if (this->shared() && this->pie())
1297 gold_fatal(_("-shared and -pie are incompatible"));
1298 if (this->pie() && this->is_static())
1299 gold_fatal(_("-pie and -static are incompatible"));
1301 if (this->shared() && this->relocatable())
1302 gold_fatal(_("-shared and -r are incompatible"));
1303 if (this->pie() && this->relocatable())
1304 gold_fatal(_("-pie and -r are incompatible"));
1306 if (!this->shared())
1308 if (this->filter() != NULL)
1309 gold_fatal(_("-F/--filter may not used without -shared"));
1310 if (this->any_auxiliary())
1311 gold_fatal(_("-f/--auxiliary may not be used without -shared"));
1314 // TODO: implement support for -retain-symbols-file with -r, if needed.
1315 if (this->relocatable() && this->retain_symbols_file())
1316 gold_fatal(_("-retain-symbols-file does not yet work with -r"));
1318 if (this->oformat_enum() != General_options::OBJECT_FORMAT_ELF
1321 || this->relocatable()))
1322 gold_fatal(_("binary output format not compatible "
1323 "with -shared or -pie or -r"));
1325 if (this->user_set_hash_bucket_empty_fraction()
1326 && (this->hash_bucket_empty_fraction() < 0.0
1327 || this->hash_bucket_empty_fraction() >= 1.0))
1328 gold_fatal(_("--hash-bucket-empty-fraction value %g out of range "
1330 this->hash_bucket_empty_fraction());
1332 if (this->implicit_incremental_ && this->incremental_mode_ == INCREMENTAL_OFF)
1333 gold_fatal(_("Options --incremental-changed, --incremental-unchanged, "
1334 "--incremental-unknown require the use of --incremental"));
1336 // Check for options that are not compatible with incremental linking.
1337 // Where an option can be disabled without seriously changing the semantics
1338 // of the link, we turn the option off; otherwise, we issue a fatal error.
1340 if (this->incremental_mode_ != INCREMENTAL_OFF)
1342 if (this->relocatable())
1343 gold_fatal(_("incremental linking is not compatible with -r"));
1344 if (this->emit_relocs())
1345 gold_fatal(_("incremental linking is not compatible with "
1347 if (this->has_plugins())
1348 gold_fatal(_("incremental linking is not compatible with --plugin"));
1350 gold_fatal(_("incremental linking is not compatible with -z relro"));
1352 gold_fatal(_("incremental linking is not compatible with -pie"));
1353 if (this->gc_sections())
1355 gold_warning(_("ignoring --gc-sections for an incremental link"));
1356 this->set_gc_sections(false);
1358 if (this->icf_enabled())
1360 gold_warning(_("ignoring --icf for an incremental link"));
1361 this->set_icf_status(ICF_NONE);
1363 if (strcmp(this->compress_debug_sections(), "none") != 0)
1365 gold_warning(_("ignoring --compress-debug-sections for an "
1366 "incremental link"));
1367 this->set_compress_debug_sections("none");
1371 // --rosegment-gap implies --rosegment.
1372 if (this->user_set_rosegment_gap())
1373 this->set_rosegment(true);
1375 // FIXME: we can/should be doing a lot more sanity checking here.
1378 // Search_directory methods.
1380 // This is called if we have a sysroot. Apply the sysroot if
1381 // appropriate. Record whether the directory is in the sysroot.
1384 Search_directory::add_sysroot(const char* sysroot,
1385 const char* canonical_sysroot)
1387 gold_assert(*sysroot != '\0');
1388 if (this->put_in_sysroot_)
1390 if (!IS_DIR_SEPARATOR(this->name_[0])
1391 && !IS_DIR_SEPARATOR(sysroot[strlen(sysroot) - 1]))
1392 this->name_ = '/' + this->name_;
1393 this->name_ = sysroot + this->name_;
1394 this->is_in_sysroot_ = true;
1398 // Check whether this entry is in the sysroot. To do this
1399 // correctly, we need to use canonical names. Otherwise we will
1400 // get confused by the ../../.. paths that gcc tends to use.
1401 char* canonical_name = lrealpath(this->name_.c_str());
1402 int canonical_name_len = strlen(canonical_name);
1403 int canonical_sysroot_len = strlen(canonical_sysroot);
1404 if (canonical_name_len > canonical_sysroot_len
1405 && IS_DIR_SEPARATOR(canonical_name[canonical_sysroot_len]))
1407 canonical_name[canonical_sysroot_len] = '\0';
1408 if (FILENAME_CMP(canonical_name, canonical_sysroot) == 0)
1409 this->is_in_sysroot_ = true;
1411 free(canonical_name);
1415 // Input_arguments methods.
1417 // Add a file to the list.
1420 Input_arguments::add_file(Input_file_argument& file)
1422 file.set_arg_serial(++this->file_count_);
1423 if (this->in_group_)
1425 gold_assert(!this->input_argument_list_.empty());
1426 gold_assert(this->input_argument_list_.back().is_group());
1427 return this->input_argument_list_.back().group()->add_file(file);
1431 gold_assert(!this->input_argument_list_.empty());
1432 gold_assert(this->input_argument_list_.back().is_lib());
1433 return this->input_argument_list_.back().lib()->add_file(file);
1435 this->input_argument_list_.push_back(Input_argument(file));
1436 return this->input_argument_list_.back();
1442 Input_arguments::start_group()
1444 if (this->in_group_)
1445 gold_fatal(_("May not nest groups"));
1447 gold_fatal(_("may not nest groups in libraries"));
1448 Input_file_group* group = new Input_file_group();
1449 this->input_argument_list_.push_back(Input_argument(group));
1450 this->in_group_ = true;
1456 Input_arguments::end_group()
1458 if (!this->in_group_)
1459 gold_fatal(_("Group end without group start"));
1460 this->in_group_ = false;
1466 Input_arguments::start_lib(const Position_dependent_options& options)
1469 gold_fatal(_("may not nest libraries"));
1470 if (this->in_group_)
1471 gold_fatal(_("may not nest libraries in groups"));
1472 Input_file_lib* lib = new Input_file_lib(options);
1473 this->input_argument_list_.push_back(Input_argument(lib));
1474 this->in_lib_ = true;
1480 Input_arguments::end_lib()
1483 gold_fatal(_("lib end without lib start"));
1484 this->in_lib_ = false;
1487 // Command_line options.
1489 Command_line::Command_line()
1493 // Pre_options is the hook that sets the ready_to_register flag.
1495 Command_line::Pre_options::Pre_options()
1497 gold::options::ready_to_register = true;
1500 // Process the command line options. For process_one_option, i is the
1501 // index of argv to process next, and must be an option (that is,
1502 // start with a dash). The return value is the index of the next
1503 // option to process (i+1 or i+2, or argc to indicate processing is
1504 // done). no_more_options is set to true if (and when) "--" is seen
1508 Command_line::process_one_option(int argc, const char** argv, int i,
1509 bool* no_more_options)
1511 gold_assert(argv[i][0] == '-' && !(*no_more_options));
1513 // If we are reading "--", then just set no_more_options and return.
1514 if (argv[i][1] == '-' && argv[i][2] == '\0')
1516 *no_more_options = true;
1521 options::One_option* option = NULL;
1522 const char* arg = NULL;
1524 // First, try to process argv as a long option.
1525 option = parse_long_option(argc, argv, false, &arg, &new_i);
1528 option->reader->parse_to_value(argv[i], arg, this, &this->options_);
1532 // Now, try to process argv as a short option. Since several short
1533 // options can be combined in one argv, we may have to parse a lot
1534 // until we're done reading this argv.
1535 int pos_in_argv_i = 1;
1538 option = parse_short_option(argc, argv, pos_in_argv_i, &arg, &new_i);
1541 option->reader->parse_to_value(argv[i], arg, this, &this->options_);
1547 // I guess it's neither a long option nor a short option.
1548 usage(_("unknown option"), argv[i]);
1554 Command_line::process(int argc, const char** argv)
1556 bool no_more_options = false;
1560 this->position_options_.copy_from_options(this->options());
1561 if (no_more_options || argv[i][0] != '-')
1563 Input_file_argument file(argv[i],
1564 Input_file_argument::INPUT_FILE_TYPE_FILE,
1565 "", false, this->position_options_);
1566 this->inputs_.add_file(file);
1570 i = process_one_option(argc, argv, i, &no_more_options);
1573 if (this->inputs_.in_group())
1575 fprintf(stderr, _("%s: missing group end\n"), program_name);
1579 if (this->inputs_.in_lib())
1581 fprintf(stderr, _("%s: missing lib end\n"), program_name);
1585 // Normalize the options and ensure they don't contradict each other.
1586 this->options_.finalize();
1589 // Finalize the version script options and return them.
1591 const Version_script_info&
1592 Command_line::version_script()
1594 this->options_.finalize_dynamic_list();
1595 Version_script_info* vsi = this->script_options_.version_script_info();
1600 } // End namespace gold.