X-Git-Url: http://drtracing.org/?a=blobdiff_plain;f=gold%2Foptions.h;h=23c9658be3ae4e2d6fd447316d8a17bfb7140821;hb=c88960d081f0b37ec03c66a13115e2a68e40d1ad;hp=b22060afa16f4a4336c89d99b80a49080079cda7;hpb=dc3f80feec3ab89febde78bc6d11655431555365;p=deliverable%2Fbinutils-gdb.git diff --git a/gold/options.h b/gold/options.h index b22060afa1..23c9658be3 100644 --- a/gold/options.h +++ b/gold/options.h @@ -1,6 +1,6 @@ // options.h -- handle command line options for gold -*- C++ -*- -// Copyright 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc. +// Copyright (C) 2006-2016 Free Software Foundation, Inc. // Written by Ian Lance Taylor . // This file is part of gold. @@ -53,14 +53,21 @@ class Command_line; class General_options; class Search_directory; class Input_file_group; +class Input_file_lib; class Position_dependent_options; class Target; class Plugin_manager; +class Script_info; // Incremental build action for a specific file, as selected by the user. enum Incremental_disposition { + // Startup files that appear before the first disposition option. + // These will default to INCREMENTAL_CHECK unless the + // --incremental-startup-unchanged option is given. + // (For files added implicitly by gcc before any user options.) + INCREMENTAL_STARTUP, // Determine the status from the timestamp (default). INCREMENTAL_CHECK, // Assume the file changed from the previous build. @@ -95,6 +102,9 @@ parse_uint64(const char* option_name, const char* arg, uint64_t* retval); extern void parse_double(const char* option_name, const char* arg, double* retval); +extern void +parse_percent(const char* option_name, const char* arg, double* retval); + extern void parse_string(const char* option_name, const char* arg, const char** retval); @@ -110,7 +120,7 @@ parse_set(const char* option_name, const char* arg, String_set* retval); extern void parse_choices(const char* option_name, const char* arg, const char** retval, - const char* choices[], int num_choices); + const char* choices[], int num_choices); struct Struct_var; @@ -158,7 +168,7 @@ struct One_option Struct_var* reader; One_option(const char* ln, Dashes d, char sn, const char* dv, - const char* hs, const char* ha, bool oa, Struct_var* r) + const char* hs, const char* ha, bool oa, Struct_var* r) : longname(ln), dashes(d), shortname(sn), default_value(dv ? dv : ""), helpstring(hs), helparg(ha), optional_arg(oa), reader(r) { @@ -209,7 +219,7 @@ struct Struct_var // OPTIONS: the global General_options object. Used by DEFINE_special. virtual void parse_to_value(const char* option, const char* arg, - Command_line* cmdline, General_options* options) = 0; + Command_line* cmdline, General_options* options) = 0; virtual ~Struct_var() // To make gcc happy. { } @@ -220,16 +230,16 @@ struct Struct_special : public Struct_var { // If you change this, change the parse-fn in DEFINE_special as well. typedef void (General_options::*Parse_function)(const char*, const char*, - Command_line*); + Command_line*); Struct_special(const char* varname, Dashes dashes, char shortname, - Parse_function parse_function, - const char* helpstring, const char* helparg) + Parse_function parse_function, + const char* helpstring, const char* helparg) : option(varname, dashes, shortname, "", helpstring, helparg, false, this), parse(parse_function) { } void parse_to_value(const char* option, const char* arg, - Command_line* cmdline, General_options* options) + Command_line* cmdline, General_options* options) { (options->*(this->parse))(option, arg, cmdline); } One_option option; @@ -244,18 +254,24 @@ struct Struct_special : public Struct_var // var() and set_var() as General_options methods. Arguments as are // for the constructor for One_option. param_type__ is the same as // type__ for built-in types, and "const type__ &" otherwise. +// +// When we define the linker command option "assert", the macro argument +// varname__ of DEFINE_var below will be replaced by "assert". On Mac OSX +// assert.h is included implicitly by one of the library headers we use. To +// avoid unintended macro substitution of "assert()", we need to enclose +// varname__ with parenthese. #define DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - default_value_as_string__, helpstring__, helparg__, \ - optional_arg__, type__, param_type__, parse_fn__) \ + default_value_as_string__, helpstring__, helparg__, \ + optional_arg__, type__, param_type__, parse_fn__) \ public: \ param_type__ \ - varname__() const \ + (varname__)() const \ { return this->varname__##_.value; } \ - \ + \ bool \ user_set_##varname__() const \ { return this->varname__##_.user_set_via_option; } \ - \ + \ void \ set_user_set_##varname__() \ { this->varname__##_.user_set_via_option = true; } \ @@ -265,18 +281,18 @@ struct Struct_special : public Struct_var { \ Struct_##varname__() \ : option(#varname__, dashes__, shortname__, default_value_as_string__, \ - helpstring__, helparg__, optional_arg__, this), \ - user_set_via_option(false), value(default_value__) \ + helpstring__, helparg__, optional_arg__, this), \ + user_set_via_option(false), value(default_value__) \ { } \ - \ + \ void \ parse_to_value(const char* option_name, const char* arg, \ - Command_line*, General_options*) \ + Command_line*, General_options*) \ { \ parse_fn__(option_name, arg, &this->value); \ this->user_set_via_option = true; \ } \ - \ + \ options::One_option option; \ bool user_set_via_option; \ type__ value; \ @@ -292,68 +308,71 @@ struct Struct_special : public Struct_var // VARNAME, we also create an option called no-VARNAME (or, for a -z // option, noVARNAME). #define DEFINE_bool(varname__, dashes__, shortname__, default_value__, \ - helpstring__, no_helpstring__) \ + helpstring__, no_helpstring__) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - default_value__ ? "true" : "false", helpstring__, NULL, \ - false, bool, bool, options::parse_bool) \ + default_value__ ? "true" : "false", helpstring__, NULL, \ + false, bool, bool, options::parse_bool) \ struct Struct_no_##varname__ : public options::Struct_var \ { \ Struct_no_##varname__() : option((dashes__ == options::DASH_Z \ ? "no" #varname__ \ : "no-" #varname__), \ dashes__, '\0', \ - default_value__ ? "false" : "true", \ - no_helpstring__, NULL, false, this) \ + default_value__ ? "false" : "true", \ + no_helpstring__, NULL, false, this) \ { } \ - \ + \ void \ parse_to_value(const char*, const char*, \ - Command_line*, General_options* options) \ - { options->set_##varname__(false); } \ - \ + Command_line*, General_options* options) \ + { \ + options->set_##varname__(false); \ + options->set_user_set_##varname__(); \ + } \ + \ options::One_option option; \ }; \ Struct_no_##varname__ no_##varname__##_initializer_ #define DEFINE_enable(varname__, dashes__, shortname__, default_value__, \ - helpstring__, no_helpstring__) \ + helpstring__, no_helpstring__) \ DEFINE_var(enable_##varname__, dashes__, shortname__, default_value__, \ - default_value__ ? "true" : "false", helpstring__, NULL, \ - false, bool, bool, options::parse_bool) \ + default_value__ ? "true" : "false", helpstring__, NULL, \ + false, bool, bool, options::parse_bool) \ struct Struct_disable_##varname__ : public options::Struct_var \ { \ Struct_disable_##varname__() : option("disable-" #varname__, \ - dashes__, '\0', \ - default_value__ ? "false" : "true", \ - no_helpstring__, NULL, false, this) \ + dashes__, '\0', \ + default_value__ ? "false" : "true", \ + no_helpstring__, NULL, false, this) \ { } \ - \ + \ void \ parse_to_value(const char*, const char*, \ - Command_line*, General_options* options) \ + Command_line*, General_options* options) \ { options->set_enable_##varname__(false); } \ - \ + \ options::One_option option; \ }; \ Struct_disable_##varname__ disable_##varname__##_initializer_ #define DEFINE_int(varname__, dashes__, shortname__, default_value__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - #default_value__, helpstring__, helparg__, false, \ - int, int, options::parse_int) + #default_value__, helpstring__, helparg__, false, \ + int, int, options::parse_int) #define DEFINE_uint(varname__, dashes__, shortname__, default_value__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - #default_value__, helpstring__, helparg__, false, \ - int, int, options::parse_uint) + #default_value__, helpstring__, helparg__, false, \ + int, int, options::parse_uint) #define DEFINE_uint64(varname__, dashes__, shortname__, default_value__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - #default_value__, helpstring__, helparg__, false, \ - uint64_t, uint64_t, options::parse_uint64) + #default_value__, helpstring__, helparg__, false, \ + uint64_t, uint64_t, options::parse_uint64) #define DEFINE_double(varname__, dashes__, shortname__, default_value__, \ helpstring__, helparg__) \ @@ -361,20 +380,26 @@ struct Struct_special : public Struct_var #default_value__, helpstring__, helparg__, false, \ double, double, options::parse_double) +#define DEFINE_percent(varname__, dashes__, shortname__, default_value__, \ + helpstring__, helparg__) \ + DEFINE_var(varname__, dashes__, shortname__, default_value__ / 100.0, \ + #default_value__, helpstring__, helparg__, false, \ + double, double, options::parse_percent) + #define DEFINE_string(varname__, dashes__, shortname__, default_value__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - default_value__, helpstring__, helparg__, false, \ - const char*, const char*, options::parse_string) + default_value__, helpstring__, helparg__, false, \ + const char*, const char*, options::parse_string) // This is like DEFINE_string, but we convert each occurrence to a // Search_directory and store it in a vector. Thus we also have the // add_to_VARNAME() method, to append to the vector. #define DEFINE_dirlist(varname__, dashes__, shortname__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, , \ - "", helpstring__, helparg__, false, options::Dir_list, \ - const options::Dir_list&, options::parse_dirlist) \ + "", helpstring__, helparg__, false, options::Dir_list, \ + const options::Dir_list&, options::parse_dirlist) \ void \ add_to_##varname__(const char* new_value) \ { options::parse_dirlist(NULL, new_value, &this->varname__##_.value); } \ @@ -384,10 +409,10 @@ struct Struct_special : public Struct_var // This is like DEFINE_string, but we store a set of strings. #define DEFINE_set(varname__, dashes__, shortname__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, , \ - "", helpstring__, helparg__, false, options::String_set, \ - const options::String_set&, options::parse_set) \ + "", helpstring__, helparg__, false, options::String_set, \ + const options::String_set&, options::parse_set) \ public: \ bool \ any_##varname__() const \ @@ -397,8 +422,8 @@ struct Struct_special : public Struct_var is_##varname__(const char* symbol) const \ { \ return (!this->varname__##_.value.empty() \ - && (this->varname__##_.value.find(std::string(symbol)) \ - != this->varname__##_.value.end())); \ + && (this->varname__##_.value.find(std::string(symbol)) \ + != this->varname__##_.value.end())); \ } \ \ options::String_set::const_iterator \ @@ -413,17 +438,17 @@ struct Struct_special : public Struct_var // After helparg__ should come an initializer list, like // {"foo", "bar", "baz"} #define DEFINE_enum(varname__, dashes__, shortname__, default_value__, \ - helpstring__, helparg__, ...) \ + helpstring__, helparg__, ...) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - default_value__, helpstring__, helparg__, false, \ - const char*, const char*, parse_choices_##varname__) \ + default_value__, helpstring__, helparg__, false, \ + const char*, const char*, parse_choices_##varname__) \ private: \ static void parse_choices_##varname__(const char* option_name, \ - const char* arg, \ - const char** retval) { \ + const char* arg, \ + const char** retval) { \ const char* choices[] = __VA_ARGS__; \ options::parse_choices(option_name, arg, retval, \ - choices, sizeof(choices) / sizeof(*choices)); \ + choices, sizeof(choices) / sizeof(*choices)); \ } // This is like DEFINE_bool, but VARNAME is the name of a different @@ -473,22 +498,48 @@ struct Struct_special : public Struct_var }; \ Struct_no_##option__ no_##option__##_initializer_ +// This is like DEFINE_uint64, but VARNAME is the name of a different +// option. This option becomes an alias for that one. +#define DEFINE_uint64_alias(option__, varname__, dashes__, shortname__, \ + helpstring__, helparg__) \ + private: \ + struct Struct_##option__ : public options::Struct_var \ + { \ + Struct_##option__() \ + : option(#option__, dashes__, shortname__, "", helpstring__, \ + helparg__, false, this) \ + { } \ + \ + void \ + parse_to_value(const char* option_name, const char* arg, \ + Command_line*, General_options* options) \ + { \ + uint64_t value; \ + options::parse_uint64(option_name, arg, &value); \ + options->set_##varname__(value); \ + options->set_user_set_##varname__(); \ + } \ + \ + options::One_option option; \ + }; \ + Struct_##option__ option__##_; + // This is used for non-standard flags. It defines no functions; it // just calls General_options::parse_VARNAME whenever the flag is // seen. We declare parse_VARNAME as a static member of // General_options; you are responsible for defining it there. // helparg__ should be NULL iff this special-option is a boolean. #define DEFINE_special(varname__, dashes__, shortname__, \ - helpstring__, helparg__) \ + helpstring__, helparg__) \ private: \ void parse_##varname__(const char* option, const char* arg, \ - Command_line* inputs); \ + Command_line* inputs); \ struct Struct_##varname__ : public options::Struct_special \ { \ Struct_##varname__() \ : options::Struct_special(#varname__, dashes__, shortname__, \ - &General_options::parse_##varname__, \ - helpstring__, helparg__) \ + &General_options::parse_##varname__, \ + helpstring__, helparg__) \ { } \ }; \ Struct_##varname__ varname__##_initializer_ @@ -500,8 +551,8 @@ struct Struct_special : public Struct_var default_value__, \ helpstring__, helparg__) \ DEFINE_var(varname__, dashes__, shortname__, default_value__, \ - default_value__, helpstring__, helparg__, true, \ - const char*, const char*, options::parse_optional_string) + default_value__, helpstring__, helparg__, true, \ + const char*, const char*, options::parse_optional_string) // A directory to search. For each directory we record whether it is // in the sysroot. We need to know this so that, if a linker script @@ -518,7 +569,7 @@ class Search_directory { } // This is the usual constructor. - Search_directory(const char* name, bool put_in_sysroot) + Search_directory(const std::string& name, bool put_in_sysroot) : name_(name), put_in_sysroot_(put_in_sysroot), is_in_sysroot_(false) { if (this->name_.empty()) @@ -569,11 +620,11 @@ class General_options // NOTE: For every option that you add here, also consider if you // should add it to Position_dependent_options. DEFINE_special(help, options::TWO_DASHES, '\0', - N_("Report usage information"), NULL); + N_("Report usage information"), NULL); DEFINE_special(version, options::TWO_DASHES, 'v', - N_("Report version information"), NULL); + N_("Report version information"), NULL); DEFINE_special(V, options::EXACTLY_ONE_DASH, '\0', - N_("Report version and target information"), NULL); + N_("Report version and target information"), NULL); // These options are sorted approximately so that for each letter in // the alphabet, we show the option whose shortname is that letter @@ -590,12 +641,17 @@ class General_options N_("Do not allow multiple definitions"), false); DEFINE_bool(allow_shlib_undefined, options::TWO_DASHES, '\0', false, - N_("Allow unresolved references in shared libraries"), - N_("Do not allow unresolved references in shared libraries")); + N_("Allow unresolved references in shared libraries"), + N_("Do not allow unresolved references in shared libraries")); + + DEFINE_bool(apply_dynamic_relocs, options::TWO_DASHES, '\0', true, + N_("Apply link-time values for dynamic relocations (default)"), + N_("(aarch64 only) Do not apply link-time values " + "for dynamic relocations")); DEFINE_bool(as_needed, options::TWO_DASHES, '\0', false, - N_("Only set DT_NEEDED for shared libraries if used"), - N_("Always DT_NEEDED for shared libraries")); + N_("Only set DT_NEEDED for shared libraries if used"), + N_("Always DT_NEEDED for shared libraries")); DEFINE_enum(assert, options::ONE_DASH, '\0', NULL, N_("Ignored"), N_("[ignored]"), @@ -606,39 +662,48 @@ class General_options // accept any string. We'll fail later (when the string is parsed), // if the target isn't actually supported. DEFINE_string(format, options::TWO_DASHES, 'b', "elf", - N_("Set input format"), ("[elf,binary]")); + N_("Set input format"), ("[elf,binary]")); DEFINE_bool(Bdynamic, options::ONE_DASH, '\0', true, - N_("-l searches for shared libraries"), NULL); + N_("-l searches for shared libraries"), NULL); DEFINE_bool_alias(Bstatic, Bdynamic, options::ONE_DASH, '\0', N_("-l does not search for shared libraries"), NULL, true); + DEFINE_bool_alias(dy, Bdynamic, options::ONE_DASH, '\0', + N_("alias for -Bdynamic"), NULL, false); + DEFINE_bool_alias(dn, Bdynamic, options::ONE_DASH, '\0', + N_("alias for -Bstatic"), NULL, true); + + DEFINE_bool(Bgroup, options::ONE_DASH, '\0', false, + N_("Use group name lookup rules for shared library"), NULL); DEFINE_bool(Bsymbolic, options::ONE_DASH, '\0', false, - N_("Bind defined symbols locally"), NULL); + N_("Bind defined symbols locally"), NULL); DEFINE_bool(Bsymbolic_functions, options::ONE_DASH, '\0', false, N_("Bind defined function symbols locally"), NULL); - DEFINE_optional_string(build_id, options::TWO_DASHES, '\0', "sha1", + DEFINE_optional_string(build_id, options::TWO_DASHES, '\0', "tree", N_("Generate build ID note"), N_("[=STYLE]")); + DEFINE_uint64(build_id_chunk_size_for_treehash, + options::TWO_DASHES, '\0', 2 << 20, + N_("Chunk size for '--build-id=tree'"), N_("SIZE")); + + DEFINE_uint64(build_id_min_file_size_for_treehash, options::TWO_DASHES, + '\0', 40 << 20, + N_("Minimum output file size for '--build-id=tree' to work" + " differently than '--build-id=sha1'"), N_("SIZE")); + DEFINE_bool(check_sections, options::TWO_DASHES, '\0', true, N_("Check segment addresses for overlaps (default)"), N_("Do not check segment addresses for overlaps")); -#ifdef HAVE_ZLIB_H DEFINE_enum(compress_debug_sections, options::TWO_DASHES, '\0', "none", - N_("Compress .debug_* sections in the output file"), - ("[none,zlib]"), - {"none", "zlib"}); -#else - DEFINE_enum(compress_debug_sections, options::TWO_DASHES, '\0', "none", - N_("Compress .debug_* sections in the output file"), - N_("[none]"), - {"none"}); -#endif + N_("Compress .debug_* sections in the output file"), + ("[none,zlib,zlib-gnu,zlib-gabi]"), + {"none", "zlib", "zlib-gnu", "zlib-gabi"}); DEFINE_bool(copy_dt_needed_entries, options::TWO_DASHES, '\0', false, N_("Not supported"), @@ -648,20 +713,24 @@ class General_options N_("Output cross reference table"), N_("Do not output cross reference table")); + DEFINE_bool(ctors_in_init_array, options::TWO_DASHES, '\0', true, + N_("Use DT_INIT_ARRAY for all constructors (default)"), + N_("Handle constructors as directed by compiler")); + DEFINE_bool(define_common, options::TWO_DASHES, 'd', false, - N_("Define common symbols"), - N_("Do not define common symbols")); + N_("Define common symbols"), + N_("Do not define common symbols")); DEFINE_bool(dc, options::ONE_DASH, '\0', false, - N_("Alias for -d"), NULL); + N_("Alias for -d"), NULL); DEFINE_bool(dp, options::ONE_DASH, '\0', false, - N_("Alias for -d"), NULL); + N_("Alias for -d"), NULL); DEFINE_string(debug, options::TWO_DASHES, '\0', "", - N_("Turn on debugging"), - N_("[all,files,script,task][,...]")); + N_("Turn on debugging"), + N_("[all,files,script,task][,...]")); DEFINE_special(defsym, options::TWO_DASHES, '\0', - N_("Define a symbol"), N_("SYMBOL=EXPRESSION")); + N_("Define a symbol"), N_("SYMBOL=EXPRESSION")); DEFINE_optional_string(demangle, options::TWO_DASHES, '\0', NULL, N_("Demangle C++ symbols in log messages"), @@ -672,55 +741,116 @@ class General_options NULL); DEFINE_bool(detect_odr_violations, options::TWO_DASHES, '\0', false, - N_("Try to detect violations of the One Definition Rule"), - NULL); + N_("Look for violations of the C++ One Definition Rule"), + N_("Do not look for violations of the C++ One Definition Rule")); - DEFINE_bool(discard_all, options::TWO_DASHES, 'x', false, - N_("Delete all local symbols"), NULL); - DEFINE_bool(discard_locals, options::TWO_DASHES, 'X', false, - N_("Delete all temporary local symbols"), NULL); + DEFINE_special(discard_all, options::TWO_DASHES, 'x', + N_("Delete all local symbols"), NULL); + DEFINE_special(discard_locals, options::TWO_DASHES, 'X', + N_("Delete all temporary local symbols"), NULL); + DEFINE_special(discard_none, options::TWO_DASHES, '\0', + N_("Keep all local symbols"), NULL); DEFINE_bool(dynamic_list_data, options::TWO_DASHES, '\0', false, - N_("Add data symbols to dynamic symbols"), NULL); + N_("Add data symbols to dynamic symbols"), NULL); DEFINE_bool(dynamic_list_cpp_new, options::TWO_DASHES, '\0', false, - N_("Add C++ operator new/delete to dynamic symbols"), NULL); + N_("Add C++ operator new/delete to dynamic symbols"), NULL); DEFINE_bool(dynamic_list_cpp_typeinfo, options::TWO_DASHES, '\0', false, - N_("Add C++ typeinfo to dynamic symbols"), NULL); + N_("Add C++ typeinfo to dynamic symbols"), NULL); DEFINE_special(dynamic_list, options::TWO_DASHES, '\0', - N_("Read a list of dynamic symbols"), N_("FILE")); + N_("Read a list of dynamic symbols"), N_("FILE")); DEFINE_string(entry, options::TWO_DASHES, 'e', NULL, - N_("Set program start address"), N_("ADDRESS")); + N_("Set program start address"), N_("ADDRESS")); DEFINE_special(exclude_libs, options::TWO_DASHES, '\0', N_("Exclude libraries from automatic export"), N_(("lib,lib ..."))); DEFINE_bool(export_dynamic, options::TWO_DASHES, 'E', false, - N_("Export all dynamic symbols"), + N_("Export all dynamic symbols"), N_("Do not export all dynamic symbols (default)")); + DEFINE_set(export_dynamic_symbol, options::TWO_DASHES, '\0', + N_("Export SYMBOL to dynamic symbol table"), N_("SYMBOL")); + + DEFINE_special(EB, options::ONE_DASH, '\0', + N_("Link big-endian objects."), NULL); + + DEFINE_special(EL, options::ONE_DASH, '\0', + N_("Link little-endian objects."), NULL); + DEFINE_bool(eh_frame_hdr, options::TWO_DASHES, '\0', false, - N_("Create exception frame header"), NULL); + N_("Create exception frame header"), NULL); + + DEFINE_bool(enum_size_warning, options::TWO_DASHES, '\0', true, NULL, + N_("(ARM only) Do not warn about objects with incompatible " + "enum sizes")); + + DEFINE_set(auxiliary, options::TWO_DASHES, 'f', + N_("Auxiliary filter for shared object symbol table"), + N_("SHLIB")); + + DEFINE_string(filter, options::TWO_DASHES, 'F', NULL, + N_("Filter for shared object symbol table"), + N_("SHLIB")); DEFINE_bool(fatal_warnings, options::TWO_DASHES, '\0', false, N_("Treat warnings as errors"), N_("Do not treat warnings as errors")); DEFINE_string(fini, options::ONE_DASH, '\0', "_fini", - N_("Call SYMBOL at unload-time"), N_("SYMBOL")); + N_("Call SYMBOL at unload-time"), N_("SYMBOL")); + + DEFINE_bool(fix_cortex_a8, options::TWO_DASHES, '\0', false, + N_("(ARM only) Fix binaries for Cortex-A8 erratum."), + N_("(ARM only) Do not fix binaries for Cortex-A8 erratum.")); + + DEFINE_bool(fix_cortex_a53_843419, options::TWO_DASHES, '\0', false, + N_("(AArch64 only) Fix Cortex-A53 erratum 843419."), + N_("(AArch64 only) Do not fix Cortex-A53 erratum 843419.")); + + DEFINE_bool(fix_cortex_a53_835769, options::TWO_DASHES, '\0', false, + N_("(AArch64 only) Fix Cortex-A53 erratum 835769."), + N_("(AArch64 only) Do not fix Cortex-A53 erratum 835769.")); + + DEFINE_bool(fix_arm1176, options::TWO_DASHES, '\0', true, + N_("(ARM only) Fix binaries for ARM1176 erratum."), + N_("(ARM only) Do not fix binaries for ARM1176 erratum.")); + + DEFINE_bool(merge_exidx_entries, options::TWO_DASHES, '\0', true, + N_("(ARM only) Merge exidx entries in debuginfo."), + N_("(ARM only) Do not merge exidx entries in debuginfo.")); + + DEFINE_special(fix_v4bx, options::TWO_DASHES, '\0', + N_("(ARM only) Rewrite BX rn as MOV pc, rn for ARMv4"), + NULL); + + DEFINE_special(fix_v4bx_interworking, options::TWO_DASHES, '\0', + N_("(ARM only) Rewrite BX rn branch to ARMv4 interworking " + "veneer"), + NULL); + + DEFINE_bool(long_plt, options::TWO_DASHES, '\0', false, + N_("(ARM only) Generate long PLT entries"), + N_("(ARM only) Do not generate long PLT entries")); DEFINE_bool(g, options::EXACTLY_ONE_DASH, '\0', false, N_("Ignored"), NULL); - DEFINE_string(soname, options::ONE_DASH, 'h', NULL, - N_("Set shared library name"), N_("FILENAME")); + DEFINE_bool(gdb_index, options::TWO_DASHES, '\0', false, + N_("Generate .gdb_index section"), + N_("Do not generate .gdb_index section")); - DEFINE_bool(i, options::EXACTLY_ONE_DASH, '\0', false, - N_("Ignored"), NULL); + DEFINE_bool(gnu_unique, options::TWO_DASHES, '\0', true, + N_("Enable STB_GNU_UNIQUE symbol binding (default)"), + N_("Disable STB_GNU_UNIQUE symbol binding")); + + DEFINE_string(soname, options::ONE_DASH, 'h', NULL, + N_("Set shared library name"), N_("FILENAME")); DEFINE_double(hash_bucket_empty_fraction, options::TWO_DASHES, '\0', 0.0, N_("Min fraction of empty buckets in dynamic hash"), @@ -731,41 +861,93 @@ class General_options {"sysv", "gnu", "both"}); DEFINE_string(dynamic_linker, options::TWO_DASHES, 'I', NULL, - N_("Set dynamic linker path"), N_("PROGRAM")); + N_("Set dynamic linker path"), N_("PROGRAM")); + + DEFINE_special(incremental, options::TWO_DASHES, '\0', + N_("Do an incremental link if possible; " + "otherwise, do a full link and prepare output " + "for incremental linking"), NULL); + + DEFINE_special(no_incremental, options::TWO_DASHES, '\0', + N_("Do a full link (default)"), NULL); - DEFINE_bool(incremental, options::TWO_DASHES, '\0', false, - N_("Work in progress; do not use"), - N_("Do a full build")); + DEFINE_special(incremental_full, options::TWO_DASHES, '\0', + N_("Do a full link and " + "prepare output for incremental linking"), NULL); + + DEFINE_special(incremental_update, options::TWO_DASHES, '\0', + N_("Do an incremental link; exit if not possible"), NULL); + + DEFINE_string(incremental_base, options::TWO_DASHES, '\0', NULL, + N_("Set base file for incremental linking" + " (default is output file)"), + N_("FILE")); DEFINE_special(incremental_changed, options::TWO_DASHES, '\0', - N_("Assume files changed"), NULL); + N_("Assume files changed"), NULL); DEFINE_special(incremental_unchanged, options::TWO_DASHES, '\0', - N_("Assume files didn't change"), NULL); + N_("Assume files didn't change"), NULL); DEFINE_special(incremental_unknown, options::TWO_DASHES, '\0', - N_("Use timestamps to check files (default)"), NULL); + N_("Use timestamps to check files (default)"), NULL); + + DEFINE_special(incremental_startup_unchanged, options::TWO_DASHES, '\0', + N_("Assume startup files unchanged " + "(files preceding this option)"), NULL); + + DEFINE_percent(incremental_patch, options::TWO_DASHES, '\0', 10, + N_("Amount of extra space to allocate for patches"), + N_("PERCENT")); DEFINE_string(init, options::ONE_DASH, '\0', "_init", - N_("Call SYMBOL at load-time"), N_("SYMBOL")); + N_("Call SYMBOL at load-time"), N_("SYMBOL")); DEFINE_special(just_symbols, options::TWO_DASHES, '\0', - N_("Read only symbol values from FILE"), N_("FILE")); + N_("Read only symbol values from FILE"), N_("FILE")); - DEFINE_bool(keep_files_mapped, options::TWO_DASHES, '\0', + DEFINE_bool(map_whole_files, options::TWO_DASHES, '\0', sizeof(void*) >= 8, - N_("Map whole files to memory (default on 64-bit hosts)"), - N_("Map relevant file parts to memory (default on 32-bit " - "hosts)")); + N_("Map whole files to memory (default on 64-bit hosts)"), + N_("Map relevant file parts to memory (default on 32-bit " + "hosts)")); + DEFINE_bool(keep_files_mapped, options::TWO_DASHES, '\0', true, + N_("Keep files mapped across passes (default)"), + N_("Release mapped files after each pass")); + + DEFINE_bool(ld_generated_unwind_info, options::TWO_DASHES, '\0', true, + N_("Generate unwind information for PLT (default)"), + N_("Do not generate unwind information for PLT")); DEFINE_special(library, options::TWO_DASHES, 'l', - N_("Search for library LIBNAME"), N_("LIBNAME")); + N_("Search for library LIBNAME"), N_("LIBNAME")); DEFINE_dirlist(library_path, options::TWO_DASHES, 'L', - N_("Add directory to search path"), N_("DIR")); + N_("Add directory to search path"), N_("DIR")); + + DEFINE_bool(text_reorder, options::TWO_DASHES, '\0', true, + N_("Enable text section reordering for GCC section names " + "(default)"), + N_("Disable text section reordering for GCC section names")); + + DEFINE_bool(nostdlib, options::ONE_DASH, '\0', false, + N_("Only search directories specified on the command line."), + NULL); + + DEFINE_bool(rosegment, options::TWO_DASHES, '\0', false, + N_("Put read-only non-executable sections in their own segment"), + NULL); + + DEFINE_uint64(rosegment_gap, options::TWO_DASHES, '\0', -1U, + N_("Set offset between executable and read-only segments"), + N_("OFFSET")); DEFINE_string(m, options::EXACTLY_ONE_DASH, 'm', "", - N_("Ignored for compatibility"), N_("EMULATION")); + N_("Set GNU linker emulation; obsolete"), N_("EMULATION")); + + DEFINE_bool(mmap_output_file, options::TWO_DASHES, '\0', true, + N_("Map the output file for writing (default)."), + N_("Do not map the output file for writing.")); DEFINE_bool(print_map, options::TWO_DASHES, 'M', false, N_("Write map file on standard output"), NULL); @@ -778,7 +960,7 @@ class General_options N_("Do not page align data, do not make text readonly"), N_("Page align data, make text readonly")); - DEFINE_enable(new_dtags, options::EXACTLY_TWO_DASHES, '\0', false, + DEFINE_enable(new_dtags, options::EXACTLY_TWO_DASHES, '\0', true, N_("Enable use of DT_RUNPATH and DT_FLAGS"), N_("Disable use of DT_RUNPATH and DT_FLAGS")); @@ -790,29 +972,61 @@ class General_options NULL, false); DEFINE_string(output, options::TWO_DASHES, 'o', "a.out", - N_("Set output file name"), N_("FILE")); + N_("Set output file name"), N_("FILE")); DEFINE_uint(optimize, options::EXACTLY_ONE_DASH, 'O', 0, - N_("Optimize output file size"), N_("LEVEL")); + N_("Optimize output file size"), N_("LEVEL")); DEFINE_string(oformat, options::EXACTLY_TWO_DASHES, '\0', "elf", N_("Set output format"), N_("[binary]")); + DEFINE_bool(p, options::ONE_DASH, '\0', false, + N_("(ARM only) Ignore for backward compatibility"), NULL); + DEFINE_bool(pie, options::ONE_DASH, '\0', false, - N_("Create a position independent executable"), NULL); + N_("Create a position independent executable"), + N_("Do not create a position independent executable")); DEFINE_bool_alias(pic_executable, pie, options::TWO_DASHES, '\0', - N_("Create a position independent executable"), NULL, + N_("Create a position independent executable"), + N_("Do not create a position independent executable"), false); + DEFINE_bool(pic_veneer, options::TWO_DASHES, '\0', false, + N_("Force PIC sequences for ARM/Thumb interworking veneers"), + NULL); + + DEFINE_bool(pipeline_knowledge, options::ONE_DASH, '\0', false, + NULL, N_("(ARM only) Ignore for backward compatibility")); + + DEFINE_var(plt_align, options::TWO_DASHES, '\0', 0, "5", + N_("(PowerPC64 only) Align PLT call stubs to fit cache lines"), + N_("[=P2ALIGN]"), true, int, int, options::parse_uint); + + DEFINE_bool(plt_static_chain, options::TWO_DASHES, '\0', false, + N_("(PowerPC64 only) PLT call stubs should load r11"), + N_("(PowerPC64 only) PLT call stubs should not load r11")); + + DEFINE_bool(plt_thread_safe, options::TWO_DASHES, '\0', false, + N_("(PowerPC64 only) PLT call stubs with load-load barrier"), + N_("(PowerPC64 only) PLT call stubs without barrier")); + #ifdef ENABLE_PLUGINS DEFINE_special(plugin, options::TWO_DASHES, '\0', - N_("Load a plugin library"), N_("PLUGIN")); + N_("Load a plugin library"), N_("PLUGIN")); DEFINE_special(plugin_opt, options::TWO_DASHES, '\0', - N_("Pass an option to the plugin"), N_("OPTION")); + N_("Pass an option to the plugin"), N_("OPTION")); #endif + DEFINE_bool(posix_fallocate, options::TWO_DASHES, '\0', true, + N_("Use posix_fallocate to reserve space in the output file" + " (default)."), + N_("Use fallocate or ftruncate to reserve space.")); + DEFINE_bool(preread_archive_symbols, options::TWO_DASHES, '\0', false, - N_("Preread archive symbols when multi-threaded"), NULL); + N_("Preread archive symbols when multi-threaded"), NULL); + + DEFINE_bool(print_output_format, options::TWO_DASHES, '\0', false, + N_("Print default output format"), NULL); DEFINE_string(print_symbol_counts, options::TWO_DASHES, '\0', NULL, N_("Print symbols defined and used for each input"), @@ -822,29 +1036,35 @@ class General_options N_("Ignored for SVR4 compatibility"), NULL); DEFINE_bool(emit_relocs, options::TWO_DASHES, 'q', false, - N_("Generate relocations in output"), NULL); + N_("Generate relocations in output"), NULL); DEFINE_bool(relocatable, options::EXACTLY_ONE_DASH, 'r', false, - N_("Generate relocatable output"), NULL); + N_("Generate relocatable output"), NULL); + DEFINE_bool_alias(i, relocatable, options::EXACTLY_ONE_DASH, '\0', + N_("Synonym for -r"), NULL, false); DEFINE_bool(relax, options::TWO_DASHES, '\0', false, N_("Relax branches on certain targets"), NULL); DEFINE_string(retain_symbols_file, options::TWO_DASHES, '\0', NULL, - N_("keep only symbols listed in this file"), N_("FILE")); + N_("keep only symbols listed in this file"), N_("FILE")); // -R really means -rpath, but can mean --just-symbols for // compatibility with GNU ld. -rpath is always -rpath, so we list // it separately. DEFINE_special(R, options::EXACTLY_ONE_DASH, 'R', - N_("Add DIR to runtime search path"), N_("DIR")); + N_("Add DIR to runtime search path"), N_("DIR")); DEFINE_dirlist(rpath, options::ONE_DASH, '\0', - N_("Add DIR to runtime search path"), N_("DIR")); + N_("Add DIR to runtime search path"), N_("DIR")); DEFINE_dirlist(rpath_link, options::TWO_DASHES, '\0', - N_("Add DIR to link time shared library search path"), - N_("DIR")); + N_("Add DIR to link time shared library search path"), + N_("DIR")); + + DEFINE_string(section_ordering_file, options::TWO_DASHES, '\0', NULL, + N_("Layout sections in the order specified."), + N_("FILENAME")); DEFINE_special(section_start, options::TWO_DASHES, '\0', N_("Set address of section"), N_("SECTION=ADDRESS")); @@ -853,33 +1073,44 @@ class General_options N_("Sort common symbols by alignment"), N_("[={ascending,descending}]")); + DEFINE_enum(sort_section, options::TWO_DASHES, '\0', "none", + N_("Sort sections by name. \'--no-text-reorder\'" + " will override \'--sort-section=name\' for .text"), + N_("[none,name]"), + {"none", "name"}); + + DEFINE_uint(spare_dynamic_tags, options::TWO_DASHES, '\0', 5, + N_("Dynamic tag slots to reserve (default 5)"), + N_("COUNT")); + DEFINE_bool(strip_all, options::TWO_DASHES, 's', false, - N_("Strip all symbols"), NULL); + N_("Strip all symbols"), NULL); DEFINE_bool(strip_debug, options::TWO_DASHES, 'S', false, - N_("Strip debugging information"), NULL); + N_("Strip debugging information"), NULL); DEFINE_bool(strip_debug_non_line, options::TWO_DASHES, '\0', false, - N_("Emit only debug line number information"), NULL); + N_("Emit only debug line number information"), NULL); DEFINE_bool(strip_debug_gdb, options::TWO_DASHES, '\0', false, - N_("Strip debug symbols that are unused by gdb " - "(at least versions <= 6.7)"), NULL); + N_("Strip debug symbols that are unused by gdb " + "(at least versions <= 7.4)"), NULL); DEFINE_bool(strip_lto_sections, options::TWO_DASHES, '\0', true, - N_("Strip LTO intermediate code sections"), NULL); + N_("Strip LTO intermediate code sections"), NULL); DEFINE_int(stub_group_size, options::TWO_DASHES , '\0', 1, - N_("(ARM only) The maximum distance from instructions in a group " - "of sections to their stubs. Negative values mean stubs " - "are always after the group. 1 means using default size.\n"), + N_("(ARM, PowerPC only) The maximum distance from instructions " + "in a group of sections to their stubs. Negative values mean " + "stubs are always after (PowerPC before) the group. 1 means " + "use default size.\n"), N_("SIZE")); DEFINE_bool(no_keep_memory, options::TWO_DASHES, '\0', false, - N_("Use less memory and more disk I/O " - "(included only for compatibility with GNU ld)"), NULL); + N_("Use less memory and more disk I/O " + "(included only for compatibility with GNU ld)"), NULL); DEFINE_bool(shared, options::ONE_DASH, 'G', false, - N_("Generate shared library"), NULL); + N_("Generate shared library"), NULL); DEFINE_bool(Bshareable, options::ONE_DASH, '\0', false, - N_("Generate shared library"), NULL); + N_("Generate shared library"), NULL); DEFINE_uint(split_stack_adjust_size, options::TWO_DASHES, '\0', 0x4000, N_("Stack size when -fsplit-stack function calls non-split"), @@ -888,71 +1119,92 @@ class General_options // This is not actually special in any way, but I need to give it // a non-standard accessor-function name because 'static' is a keyword. DEFINE_special(static, options::ONE_DASH, '\0', - N_("Do not link against shared libraries"), NULL); + N_("Do not link against shared libraries"), NULL); DEFINE_enum(icf, options::TWO_DASHES, '\0', "none", - N_("Identical Code Folding. " - "\'--icf=safe\' folds only ctors and dtors."), - ("[none,all,safe]"), - {"none", "all", "safe"}); + N_("Identical Code Folding. " + "\'--icf=safe\' Folds ctors, dtors and functions whose" + " pointers are definitely not taken."), + ("[none,all,safe]"), + {"none", "all", "safe"}); DEFINE_uint(icf_iterations, options::TWO_DASHES , '\0', 0, - N_("Number of iterations of ICF (default 2)"), N_("COUNT")); + N_("Number of iterations of ICF (default 2)"), N_("COUNT")); DEFINE_bool(print_icf_sections, options::TWO_DASHES, '\0', false, - N_("List folded identical sections on stderr"), - N_("Do not list folded identical sections")); + N_("List folded identical sections on stderr"), + N_("Do not list folded identical sections")); DEFINE_set(keep_unique, options::TWO_DASHES, '\0', N_("Do not fold this symbol during ICF"), N_("SYMBOL")); DEFINE_bool(gc_sections, options::TWO_DASHES, '\0', false, - N_("Remove unused sections"), - N_("Don't remove unused sections (default)")); + N_("Remove unused sections"), + N_("Don't remove unused sections (default)")); DEFINE_bool(print_gc_sections, options::TWO_DASHES, '\0', false, - N_("List removed unused sections on stderr"), - N_("Do not list removed unused sections")); + N_("List removed unused sections on stderr"), + N_("Do not list removed unused sections")); DEFINE_bool(stats, options::TWO_DASHES, '\0', false, - N_("Print resource usage statistics"), NULL); + N_("Print resource usage statistics"), NULL); DEFINE_string(sysroot, options::TWO_DASHES, '\0', "", - N_("Set target system root directory"), N_("DIR")); + N_("Set target system root directory"), N_("DIR")); DEFINE_bool(trace, options::TWO_DASHES, 't', false, - N_("Print the name of each input file"), NULL); + N_("Print the name of each input file"), NULL); DEFINE_special(script, options::TWO_DASHES, 'T', - N_("Read linker script"), N_("FILE")); + N_("Read linker script"), N_("FILE")); DEFINE_bool(threads, options::TWO_DASHES, '\0', false, - N_("Run the linker multi-threaded"), - N_("Do not run the linker multi-threaded")); + N_("Run the linker multi-threaded"), + N_("Do not run the linker multi-threaded")); DEFINE_uint(thread_count, options::TWO_DASHES, '\0', 0, - N_("Number of threads to use"), N_("COUNT")); + N_("Number of threads to use"), N_("COUNT")); DEFINE_uint(thread_count_initial, options::TWO_DASHES, '\0', 0, - N_("Number of threads to use in initial pass"), N_("COUNT")); + N_("Number of threads to use in initial pass"), N_("COUNT")); DEFINE_uint(thread_count_middle, options::TWO_DASHES, '\0', 0, - N_("Number of threads to use in middle pass"), N_("COUNT")); + N_("Number of threads to use in middle pass"), N_("COUNT")); DEFINE_uint(thread_count_final, options::TWO_DASHES, '\0', 0, - N_("Number of threads to use in final pass"), N_("COUNT")); + N_("Number of threads to use in final pass"), N_("COUNT")); DEFINE_uint64(Tbss, options::ONE_DASH, '\0', -1U, - N_("Set the address of the bss segment"), N_("ADDRESS")); + N_("Set the address of the bss segment"), N_("ADDRESS")); DEFINE_uint64(Tdata, options::ONE_DASH, '\0', -1U, - N_("Set the address of the data segment"), N_("ADDRESS")); + N_("Set the address of the data segment"), N_("ADDRESS")); DEFINE_uint64(Ttext, options::ONE_DASH, '\0', -1U, - N_("Set the address of the text segment"), N_("ADDRESS")); + N_("Set the address of the text segment"), N_("ADDRESS")); + DEFINE_uint64_alias(Ttext_segment, Ttext, options::ONE_DASH, '\0', + N_("Set the address of the text segment"), + N_("ADDRESS")); + DEFINE_uint64(Trodata_segment, options::ONE_DASH, '\0', -1U, + N_("Set the address of the rodata segment"), N_("ADDRESS")); + + DEFINE_bool(toc_optimize, options::TWO_DASHES, '\0', true, + N_("(PowerPC64 only) Optimize TOC code sequences"), + N_("(PowerPC64 only) Don't optimize TOC code sequences")); + + DEFINE_bool(toc_sort, options::TWO_DASHES, '\0', true, + N_("(PowerPC64 only) Sort TOC and GOT sections"), + N_("(PowerPC64 only) Don't sort TOC and GOT sections")); DEFINE_set(undefined, options::TWO_DASHES, 'u', N_("Create undefined reference to SYMBOL"), N_("SYMBOL")); + DEFINE_enum(unresolved_symbols, options::TWO_DASHES, '\0', NULL, + N_("How to handle unresolved symbols"), + ("ignore-all,report-all,ignore-in-object-files," + "ignore-in-shared-libs"), + {"ignore-all", "report-all", "ignore-in-object-files", + "ignore-in-shared-libs"}); + DEFINE_bool(verbose, options::TWO_DASHES, '\0', false, - N_("Synonym for --debug=files"), NULL); + N_("Synonym for --debug=files"), NULL); DEFINE_special(version_script, options::TWO_DASHES, '\0', - N_("Read version script"), N_("FILE")); + N_("Read version script"), N_("FILE")); DEFINE_bool(warn_common, options::TWO_DASHES, '\0', false, N_("Warn about duplicate common symbols"), @@ -961,6 +1213,13 @@ class General_options DEFINE_bool(warn_constructors, options::TWO_DASHES, '\0', false, N_("Ignored"), N_("Ignored")); + DEFINE_bool(warn_execstack, options::TWO_DASHES, '\0', false, + N_("Warn if the stack is executable"), + N_("Do not warn if the stack is executable (default)")); + + DEFINE_bool(warn_mismatch, options::TWO_DASHES, '\0', true, + NULL, N_("Don't warn about mismatched input files")); + DEFINE_bool(warn_multiple_gp, options::TWO_DASHES, '\0', false, N_("Ignored"), NULL); @@ -979,16 +1238,23 @@ class General_options options::TWO_DASHES, '\0', N_("Report unresolved symbols as errors"), NULL, true); + DEFINE_bool(weak_unresolved_symbols, options::TWO_DASHES, '\0', false, + N_("Convert unresolved symbols to weak references"), + NULL); + + DEFINE_bool(wchar_size_warning, options::TWO_DASHES, '\0', true, NULL, + N_("(ARM only) Do not warn about objects with incompatible " + "wchar_t sizes")); DEFINE_bool(whole_archive, options::TWO_DASHES, '\0', false, - N_("Include all archive contents"), - N_("Include only needed archive contents")); + N_("Include all archive contents"), + N_("Include only needed archive contents")); DEFINE_set(wrap, options::TWO_DASHES, '\0', N_("Use wrapper functions for SYMBOL"), N_("SYMBOL")); DEFINE_set(trace_symbol, options::TWO_DASHES, 'y', - N_("Trace references to symbol"), N_("SYMBOL")); + N_("Trace references to symbol"), N_("SYMBOL")); DEFINE_bool(undefined_version, options::TWO_DASHES, '\0', true, N_("Allow unused version in script (default)"), @@ -999,9 +1265,19 @@ class General_options N_("PATH")); DEFINE_special(start_group, options::TWO_DASHES, '(', - N_("Start a library search group"), NULL); + N_("Start a library search group"), NULL); DEFINE_special(end_group, options::TWO_DASHES, ')', - N_("End a library search group"), NULL); + N_("End a library search group"), NULL); + + + DEFINE_special(start_lib, options::TWO_DASHES, '\0', + N_("Start a library"), NULL); + DEFINE_special(end_lib, options::TWO_DASHES, '\0', + N_("End a library "), NULL); + + DEFINE_string(fuse_ld, options::ONE_DASH, '\0', "", + N_("Ignored for GCC linker option compatibility"), + ""); // The -z options. @@ -1009,26 +1285,29 @@ class General_options N_("Sort dynamic relocs"), N_("Do not sort dynamic relocs")); DEFINE_uint64(common_page_size, options::DASH_Z, '\0', 0, - N_("Set common page size to SIZE"), N_("SIZE")); + N_("Set common page size to SIZE"), N_("SIZE")); DEFINE_bool(defs, options::DASH_Z, '\0', false, - N_("Report undefined symbols (even with --shared)"), - NULL); + N_("Report undefined symbols (even with --shared)"), + NULL); DEFINE_bool(execstack, options::DASH_Z, '\0', false, - N_("Mark output as requiring executable stack"), NULL); + N_("Mark output as requiring executable stack"), NULL); + DEFINE_bool(global, options::DASH_Z, '\0', false, + N_("Make symbols in DSO available for subsequently loaded " + "objects"), NULL); DEFINE_bool(initfirst, options::DASH_Z, '\0', false, N_("Mark DSO to be initialized first at runtime"), NULL); DEFINE_bool(interpose, options::DASH_Z, '\0', false, N_("Mark object to interpose all DSOs but executable"), NULL); - DEFINE_bool(lazy, options::DASH_Z, '\0', false, - N_("Mark object for lazy runtime binding (default)"), - NULL); + DEFINE_bool_alias(lazy, now, options::DASH_Z, '\0', + N_("Mark object for lazy runtime binding (default)"), + NULL, true); DEFINE_bool(loadfltr, options::DASH_Z, '\0', false, N_("Mark object requiring immediate process"), NULL); DEFINE_uint64(max_page_size, options::DASH_Z, '\0', 0, - N_("Set maximum page size to SIZE"), N_("SIZE")); + N_("Set maximum page size to SIZE"), N_("SIZE")); DEFINE_bool(muldefs, options::DASH_Z, '\0', false, N_("Allow multiple definitions of symbols"), NULL); @@ -1050,19 +1329,19 @@ class General_options N_("Mark DSO not available to dldump"), NULL); DEFINE_bool(noexecstack, options::DASH_Z, '\0', false, - N_("Mark output as not requiring executable stack"), NULL); + N_("Mark output as not requiring executable stack"), NULL); DEFINE_bool(now, options::DASH_Z, '\0', false, N_("Mark object for immediate function binding"), NULL); DEFINE_bool(origin, options::DASH_Z, '\0', false, N_("Mark DSO to indicate that needs immediate $ORIGIN " - "processing at runtime"), NULL); - DEFINE_bool(relro, options::DASH_Z, '\0', false, + "processing at runtime"), NULL); + DEFINE_bool(relro, options::DASH_Z, '\0', DEFAULT_LD_Z_RELRO, N_("Where possible mark variables read-only after relocation"), N_("Don't mark variables read-only after relocation")); DEFINE_bool(text, options::DASH_Z, '\0', false, N_("Do not permit relocations in read-only segments"), - NULL); + N_("Permit relocations in read-only segments (default)")); DEFINE_bool_alias(textoff, text, options::DASH_Z, '\0', N_("Permit relocations in read-only segments (default)"), NULL, true); @@ -1138,7 +1417,7 @@ class General_options should_retain_symbol(const char* symbol_name) const { if (symbols_to_retain_.empty()) // means flag wasn't specified - return true; + return true; return symbols_to_retain_.find(symbol_name) != symbols_to_retain_.end(); } @@ -1182,11 +1461,35 @@ class General_options in_dynamic_list(const char* symbol) const { return this->dynamic_list_.version_script_info()->symbol_is_local(symbol); } + // True if a --dynamic-list script was provided. + bool + have_dynamic_list() const + { return this->have_dynamic_list_; } + // Finalize the dynamic list. void finalize_dynamic_list() { this->dynamic_list_.version_script_info()->finalize(); } + // The mode selected by the --incremental options. + enum Incremental_mode + { + // No incremental linking (--no-incremental). + INCREMENTAL_OFF, + // Incremental update only (--incremental-update). + INCREMENTAL_UPDATE, + // Force a full link, but prepare for subsequent incremental link + // (--incremental-full). + INCREMENTAL_FULL, + // Incremental update if possible, fallback to full link (--incremental). + INCREMENTAL_AUTO + }; + + // The incremental linking mode. + Incremental_mode + incremental_mode() const + { return this->incremental_mode_; } + // The disposition given by the --incremental-changed, // --incremental-unchanged or --incremental-unknown option. The // value may change as we proceed parsing the command line flags. @@ -1194,10 +1497,16 @@ class General_options incremental_disposition() const { return this->incremental_disposition_; } + // The disposition to use for startup files (those that precede the + // first --incremental-changed, etc. option). + Incremental_disposition + incremental_startup_disposition() const + { return this->incremental_startup_disposition_; } + // Return true if S is the name of a library excluded from automatic // symbol export. bool - check_excluded_libs (const std::string &s) const; + check_excluded_libs(const std::string &s) const; // If an explicit start address was given for section SECNAME with // the --section-start option, return true and set *PADDR to the @@ -1205,11 +1514,66 @@ class General_options bool section_start(const char* secname, uint64_t* paddr) const; + // Return whether any --section-start option was used. + bool + any_section_start() const + { return !this->section_starts_.empty(); } + + enum Fix_v4bx + { + // Leave original instruction. + FIX_V4BX_NONE, + // Replace instruction. + FIX_V4BX_REPLACE, + // Generate an interworking veneer. + FIX_V4BX_INTERWORKING + }; + + Fix_v4bx + fix_v4bx() const + { return (this->fix_v4bx_); } + + enum Endianness + { + ENDIANNESS_NOT_SET, + ENDIANNESS_BIG, + ENDIANNESS_LITTLE + }; + + Endianness + endianness() const + { return this->endianness_; } + + bool + discard_all() const + { return this->discard_locals_ == DISCARD_ALL; } + + bool + discard_locals() const + { return this->discard_locals_ == DISCARD_LOCALS; } + + bool + discard_sec_merge() const + { return this->discard_locals_ == DISCARD_SEC_MERGE; } + private: // Don't copy this structure. General_options(const General_options&); General_options& operator=(const General_options&); + // What local symbols to discard. + enum Discard_locals + { + // Locals in merge sections (default). + DISCARD_SEC_MERGE, + // None (--discard-none). + DISCARD_NONE, + // Temporary locals (--discard-locals/-X). + DISCARD_LOCALS, + // All locals (--discard-all/-x). + DISCARD_ALL + }; + // Whether to mark the stack as executable. enum Execstack { @@ -1226,7 +1590,7 @@ class General_options // Do not fold any functions (Default or --icf=none). ICF_NONE, // All functions are candidates for folding. (--icf=all). - ICF_ALL, + ICF_ALL, // Only ctors and dtors are candidates for folding. (--icf=safe). ICF_SAFE }; @@ -1249,7 +1613,7 @@ class General_options // These are called by finalize() to set up the search-path correctly. void - add_to_library_path_with_sysroot(const char* arg) + add_to_library_path_with_sysroot(const std::string& arg) { this->add_search_directory_to_library_path(Search_directory(arg, true)); } // Apply any sysroot to the directory lists. @@ -1258,7 +1622,7 @@ class General_options // Add a plugin and its arguments to the list of plugins. void - add_plugin(const char *filename); + add_plugin(const char* filename); // Add a plugin option. void @@ -1280,13 +1644,20 @@ class General_options // script.cc, we store this as a Script_options object, even though // we only use a single Version_tree from it. Script_options dynamic_list_; + // Whether a --dynamic-list file was provided. + bool have_dynamic_list_; + // The incremental linking mode. + Incremental_mode incremental_mode_; // The disposition given by the --incremental-changed, // --incremental-unchanged or --incremental-unknown option. The // value may change as we proceed parsing the command line flags. Incremental_disposition incremental_disposition_; + // The disposition to use for startup files (those marked + // INCREMENTAL_STARTUP). + Incremental_disposition incremental_startup_disposition_; // Whether we have seen one of the options that require incremental - // build (--incremental-changed, --incremental-unchanged or - // --incremental-unknown) + // build (--incremental-changed, --incremental-unchanged, + // --incremental-unknown, or --incremental-startup-unchanged). bool implicit_incremental_; // Libraries excluded from automatic export, via --exclude-libs. Unordered_set excluded_libs_; @@ -1294,6 +1665,12 @@ class General_options Unordered_set symbols_to_retain_; // Map from section name to address from --section-start. std::map section_starts_; + // Whether to process armv4 bx instruction relocation. + Fix_v4bx fix_v4bx_; + // Endianness. + Endianness endianness_; + // What local symbols to discard. + Discard_locals discard_locals_; }; // The position-dependent options. We use this to store the state of @@ -1310,7 +1687,7 @@ class General_options type__ \ varname__() const \ { return this->varname__##_; } \ - \ + \ void \ set_##varname__(type__ value) \ { this->varname__##_ = value; } \ @@ -1321,7 +1698,7 @@ class Position_dependent_options { public: Position_dependent_options(const General_options& options - = Position_dependent_options::default_options_) + = Position_dependent_options::default_options_) { copy_from_options(options); } void copy_from_options(const General_options& options) @@ -1374,15 +1751,15 @@ class Input_file_argument // command line, such as --whole-archive. Input_file_argument() : name_(), type_(INPUT_FILE_TYPE_FILE), extra_search_path_(""), - just_symbols_(false), options_() + just_symbols_(false), options_(), arg_serial_(0) { } Input_file_argument(const char* name, Input_file_type type, - const char* extra_search_path, - bool just_symbols, - const Position_dependent_options& options) + const char* extra_search_path, + bool just_symbols, + const Position_dependent_options& options) : name_(name), type_(type), extra_search_path_(extra_search_path), - just_symbols_(just_symbols), options_(options) + just_symbols_(just_symbols), options_(options), arg_serial_(0) { } // You can also pass in a General_options instance instead of a @@ -1390,11 +1767,11 @@ class Input_file_argument // position-independent vars from the General_options and only store // those. Input_file_argument(const char* name, Input_file_type type, - const char* extra_search_path, - bool just_symbols, - const General_options& options) + const char* extra_search_path, + bool just_symbols, + const General_options& options) : name_(name), type_(type), extra_search_path_(extra_search_path), - just_symbols_(just_symbols), options_(options) + just_symbols_(just_symbols), options_(options), arg_serial_(0) { } const char* @@ -1417,8 +1794,8 @@ class Input_file_argument extra_search_path() const { return (this->extra_search_path_.empty() - ? NULL - : this->extra_search_path_.c_str()); + ? NULL + : this->extra_search_path_.c_str()); } // Return whether we should only read symbols from this file. @@ -1436,6 +1813,16 @@ class Input_file_argument || !this->extra_search_path_.empty()); } + // Set the serial number for this argument. + void + set_arg_serial(unsigned int arg_serial) + { this->arg_serial_ = arg_serial; } + + // Get the serial number. + unsigned int + arg_serial() const + { return this->arg_serial_; } + private: // We use std::string, not const char*, here for convenience when // using script files, so that we do not have to preserve the string @@ -1445,6 +1832,8 @@ class Input_file_argument std::string extra_search_path_; bool just_symbols_; Position_dependent_options options_; + // A unique index for this file argument in the argument list. + unsigned int arg_serial_; }; // A file or library, or a group, from the command line. @@ -1454,12 +1843,17 @@ class Input_argument public: // Create a file or library argument. explicit Input_argument(Input_file_argument file) - : is_file_(true), file_(file), group_(NULL) + : is_file_(true), file_(file), group_(NULL), lib_(NULL), script_info_(NULL) { } // Create a group argument. explicit Input_argument(Input_file_group* group) - : is_file_(false), group_(group) + : is_file_(false), group_(group), lib_(NULL), script_info_(NULL) + { } + + // Create a lib argument. + explicit Input_argument(Input_file_lib* lib) + : is_file_(false), group_(NULL), lib_(lib), script_info_(NULL) { } // Return whether this is a file. @@ -1470,7 +1864,12 @@ class Input_argument // Return whether this is a group. bool is_group() const - { return !this->is_file_; } + { return !this->is_file_ && this->lib_ == NULL; } + + // Return whether this is a lib. + bool + is_lib() const + { return this->lib_ != NULL; } // Return the information about the file. const Input_file_argument& @@ -1495,10 +1894,39 @@ class Input_argument return this->group_; } + // Return the information about the lib. + const Input_file_lib* + lib() const + { + gold_assert(!this->is_file_); + gold_assert(this->lib_); + return this->lib_; + } + + Input_file_lib* + lib() + { + gold_assert(!this->is_file_); + gold_assert(this->lib_); + return this->lib_; + } + + // If a script generated this argument, store a pointer to the script info. + // Currently used only for recording incremental link information. + void + set_script_info(Script_info* info) + { this->script_info_ = info; } + + Script_info* + script_info() const + { return this->script_info_; } + private: bool is_file_; Input_file_argument file_; Input_file_group* group_; + Input_file_lib* lib_; + Script_info* script_info_; }; typedef std::vector Input_argument_list; @@ -1516,9 +1944,12 @@ class Input_file_group { } // Add a file to the end of the group. - void + Input_argument& add_file(const Input_file_argument& arg) - { this->files_.push_back(Input_argument(arg)); } + { + this->files_.push_back(Input_argument(arg)); + return this->files_.back(); + } // Iterators to iterate over the group contents. @@ -1534,6 +1965,49 @@ class Input_file_group Input_argument_list files_; }; +// A lib from the command line. This is a set of arguments within +// --start-lib ... --end-lib. + +class Input_file_lib +{ + public: + typedef Input_argument_list::const_iterator const_iterator; + + Input_file_lib(const Position_dependent_options& options) + : files_(), options_(options) + { } + + // Add a file to the end of the lib. + Input_argument& + add_file(const Input_file_argument& arg) + { + this->files_.push_back(Input_argument(arg)); + return this->files_.back(); + } + + const Position_dependent_options& + options() const + { return this->options_; } + + // Iterators to iterate over the lib contents. + + const_iterator + begin() const + { return this->files_.begin(); } + + const_iterator + end() const + { return this->files_.end(); } + + size_t + size() const + { return this->files_.size(); } + + private: + Input_argument_list files_; + Position_dependent_options options_; +}; + // A list of files from the command line or a script. class Input_arguments @@ -1542,12 +2016,12 @@ class Input_arguments typedef Input_argument_list::const_iterator const_iterator; Input_arguments() - : input_argument_list_(), in_group_(false) + : input_argument_list_(), in_group_(false), in_lib_(false), file_count_(0) { } // Add a file. - void - add_file(const Input_file_argument& arg); + Input_argument& + add_file(Input_file_argument& arg); // Start a group (the --start-group option). void @@ -1557,11 +2031,24 @@ class Input_arguments void end_group(); + // Start a lib (the --start-lib option). + void + start_lib(const Position_dependent_options&); + + // End a lib (the --end-lib option). + void + end_lib(); + // Return whether we are currently in a group. bool in_group() const { return this->in_group_; } + // Return whether we are currently in a lib. + bool + in_lib() const + { return this->in_lib_; } + // The number of entries in the list. int size() const @@ -1582,9 +2069,18 @@ class Input_arguments empty() const { return this->input_argument_list_.empty(); } + // Return the number of input files. This may be larger than + // input_argument_list_.size(), because of files that are part + // of groups or libs. + int + number_of_input_files() const + { return this->file_count_; } + private: Input_argument_list input_argument_list_; bool in_group_; + bool in_lib_; + unsigned int file_count_; }; @@ -1612,7 +2108,7 @@ class Command_line // is set to true if argv[i] is "--". int process_one_option(int argc, const char** argv, int i, - bool* no_more_options); + bool* no_more_options); // Get the general options. const General_options& @@ -1641,7 +2137,7 @@ class Command_line // The number of input files. int number_of_input_files() const - { return this->inputs_.size(); } + { return this->inputs_.number_of_input_files(); } // Iterators to iterate over the list of input files.