1 // options.c -- handle command line options for gold
3 // Copyright 2006, 2007, 2008 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.
30 #include "filenames.h"
31 #include "libiberty.h"
33 #include "../bfd/bfdver.h"
37 #include "target-select.h"
45 Position_dependent_options::default_options_;
50 // This global variable is set up as General_options is constructed.
51 static std::vector<const One_option*> registered_options;
53 // These are set up at the same time -- the variables that accept one
54 // dash, two, or require -z. A single variable may be in more than
55 // one of thes data structures.
56 typedef Unordered_map<std::string, One_option*> Option_map;
57 static Option_map* long_options = NULL;
58 static One_option* short_options[128];
61 One_option::register_option()
63 registered_options.push_back(this);
65 // We can't make long_options a static Option_map because we can't
66 // guarantee that will be initialized before register_option() is
68 if (long_options == NULL)
69 long_options = new Option_map;
71 // TWO_DASHES means that two dashes are preferred, but one is ok too.
72 if (!this->longname.empty())
73 (*long_options)[this->longname] = this;
75 const int shortname_as_int = static_cast<int>(this->shortname);
76 gold_assert(shortname_as_int >= 0 && shortname_as_int < 128);
77 if (this->shortname != '\0')
78 short_options[shortname_as_int] = this;
82 One_option::print() const
87 if (this->shortname != '\0')
89 len += printf("-%c", this->shortname);
92 // -z takes long-names only.
93 gold_assert(this->dashes != DASH_Z);
94 len += printf(" %s", gettext(this->helparg));
98 if (!this->longname.empty()
99 && !(this->longname[0] == this->shortname
100 && this->longname[1] == '\0'))
104 switch (this->dashes)
106 case options::ONE_DASH: case options::EXACTLY_ONE_DASH:
109 case options::TWO_DASHES: case options::EXACTLY_TWO_DASHES:
112 case options::DASH_Z:
113 len += printf("-z ");
118 len += printf("%s", this->longname.c_str());
121 // For most options, we print "--frob FOO". But for -z
122 // we print "-z frob=FOO".
123 len += printf("%c%s", this->dashes == options::DASH_Z ? '=' : ' ',
124 gettext(this->helparg));
133 for (; len < 30; ++len)
136 // TODO: if we're boolean, add " (default)" when appropriate.
137 printf("%s\n", gettext(this->helpstring));
143 printf(_("Usage: %s [options] file...\nOptions:\n"), gold::program_name);
145 std::vector<const One_option*>::const_iterator it;
146 for (it = registered_options.begin(); it != registered_options.end(); ++it)
149 // config.guess and libtool.m4 look in ld --help output for the
150 // string "supported targets".
151 printf(_("%s: supported targets:"), gold::program_name);
152 std::vector<const char*> supported_names;
153 gold::supported_target_names(&supported_names);
154 for (std::vector<const char*>::const_iterator p = supported_names.begin();
155 p != supported_names.end();
160 // REPORT_BUGS_TO is defined in bfd/bfdver.h.
161 const char* report = REPORT_BUGS_TO;
163 printf(_("Report bugs to %s\n"), report);
166 // For bool, arg will be NULL (boolean options take no argument);
167 // we always just set to true.
169 parse_bool(const char*, const char*, bool* retval)
175 parse_uint(const char* option_name, const char* arg, int* retval)
178 *retval = strtol(arg, &endptr, 0);
179 if (*endptr != '\0' || retval < 0)
180 gold_fatal(_("%s: invalid option value (expected an integer): %s"),
185 parse_uint64(const char* option_name, const char* arg, uint64_t *retval)
188 *retval = strtoull(arg, &endptr, 0);
190 gold_fatal(_("%s: invalid option value (expected an integer): %s"),
195 parse_double(const char* option_name, const char* arg, double* retval)
198 *retval = strtod(arg, &endptr);
200 gold_fatal(_("%s: invalid option value "
201 "(expected a floating point number): %s"),
206 parse_string(const char* option_name, const char* arg, const char** retval)
209 gold_fatal(_("%s: must take a non-empty argument"), option_name);
214 parse_optional_string(const char*, const char* arg, const char** retval)
220 parse_dirlist(const char*, const char* arg, Dir_list* retval)
222 retval->push_back(Search_directory(arg, false));
226 parse_set(const char*, const char* arg, String_set* retval)
228 retval->insert(std::string(arg));
232 parse_choices(const char* option_name, const char* arg, const char** retval,
233 const char* choices[], int num_choices)
235 for (int i = 0; i < num_choices; i++)
236 if (strcmp(choices[i], arg) == 0)
242 // If we get here, the user did not enter a valid choice, so we die.
243 std::string choices_list;
244 for (int i = 0; i < num_choices; i++)
246 choices_list += choices[i];
247 if (i != num_choices - 1)
248 choices_list += ", ";
250 gold_fatal(_("%s: must take one of the following arguments: %s"),
251 option_name, choices_list.c_str());
254 } // End namespace options.
256 // Define the handler for "special" options (set via DEFINE_special).
259 General_options::parse_help(const char*, const char*, Command_line*)
262 ::exit(EXIT_SUCCESS);
266 General_options::parse_version(const char* opt, const char*, Command_line*)
268 gold::print_version(opt[0] == '-' && opt[1] == 'v');
269 ::exit(EXIT_SUCCESS);
273 General_options::parse_V(const char*, const char*, Command_line*)
275 gold::print_version(true);
276 printf(_(" Supported targets:\n"));
277 std::vector<const char*> supported_names;
278 gold::supported_target_names(&supported_names);
279 for (std::vector<const char*>::const_iterator p = supported_names.begin();
280 p != supported_names.end();
286 General_options::parse_defsym(const char*, const char* arg,
287 Command_line* cmdline)
289 cmdline->script_options().define_symbol(arg);
293 General_options::parse_library(const char*, const char* arg,
294 Command_line* cmdline)
296 Input_file_argument file(arg, true, "", false, *this);
297 cmdline->inputs().add_file(file);
300 #ifdef ENABLE_PLUGINS
302 General_options::parse_plugin(const char*, const char* arg,
305 this->add_plugin(arg);
308 // Parse --plugin-opt.
311 General_options::parse_plugin_opt(const char*, const char* arg,
314 this->add_plugin_option(arg);
316 #endif // ENABLE_PLUGINS
319 General_options::parse_R(const char* option, const char* arg,
320 Command_line* cmdline)
323 if (::stat(arg, &s) != 0 || S_ISDIR(s.st_mode))
324 this->add_to_rpath(arg);
326 this->parse_just_symbols(option, arg, cmdline);
330 General_options::parse_just_symbols(const char*, const char* arg,
331 Command_line* cmdline)
333 Input_file_argument file(arg, false, "", true, *this);
334 cmdline->inputs().add_file(file);
338 General_options::parse_static(const char*, const char*, Command_line*)
340 this->set_static(true);
344 General_options::parse_script(const char*, const char* arg,
345 Command_line* cmdline)
347 if (!read_commandline_script(arg, cmdline))
348 gold::gold_fatal(_("unable to parse script file %s"), arg);
352 General_options::parse_version_script(const char*, const char* arg,
353 Command_line* cmdline)
355 if (!read_version_script(arg, cmdline))
356 gold::gold_fatal(_("unable to parse version script file %s"), arg);
360 General_options::parse_dynamic_list(const char*, const char* arg,
361 Command_line* cmdline)
363 if (!read_dynamic_list(arg, cmdline, &this->dynamic_list_))
364 gold::gold_fatal(_("unable to parse dynamic-list script file %s"), arg);
368 General_options::parse_start_group(const char*, const char*,
369 Command_line* cmdline)
371 cmdline->inputs().start_group();
375 General_options::parse_end_group(const char*, const char*,
376 Command_line* cmdline)
378 cmdline->inputs().end_group();
381 } // End namespace gold.
390 _("%s: use the --help option for usage information\n"),
392 ::exit(EXIT_FAILURE);
396 usage(const char* msg, const char *opt)
400 gold::program_name, opt, msg);
404 // Recognize input and output target names. The GNU linker accepts
405 // these with --format and --oformat. This code is intended to be
406 // minimally compatible. In practice for an ELF target this would be
407 // the same target as the input files; that name always start with
408 // "elf". Non-ELF targets would be "srec", "symbolsrec", "tekhex",
411 gold::General_options::Object_format
412 string_to_object_format(const char* arg)
414 if (strncmp(arg, "elf", 3) == 0)
415 return gold::General_options::OBJECT_FORMAT_ELF;
416 else if (strcmp(arg, "binary") == 0)
417 return gold::General_options::OBJECT_FORMAT_BINARY;
420 gold::gold_error(_("format '%s' not supported; treating as elf "
421 "(supported formats: elf, binary)"),
423 return gold::General_options::OBJECT_FORMAT_ELF;
427 // If the default sysroot is relocatable, try relocating it based on
431 get_relative_sysroot(const char* from)
433 char* path = make_relative_prefix(gold::program_name, from,
438 if (::stat(path, &s) == 0 && S_ISDIR(s.st_mode))
446 // Return the default sysroot. This is set by the --with-sysroot
447 // option to configure. Note we do not free the return value of
448 // get_relative_sysroot, which is a small memory leak, but is
449 // necessary since we store this pointer directly in General_options.
452 get_default_sysroot()
454 const char* sysroot = TARGET_SYSTEM_ROOT;
455 if (*sysroot == '\0')
458 if (TARGET_SYSTEM_ROOT_RELOCATABLE)
460 char* path = get_relative_sysroot(BINDIR);
462 path = get_relative_sysroot(TOOLBINDIR);
470 // Parse a long option. Such options have the form
471 // <-|--><option>[=arg]. If "=arg" is not present but the option
472 // takes an argument, the next word is taken to the be the argument.
473 // If equals_only is set, then only the <option>=<arg> form is
474 // accepted, not the <option><space><arg> form. Returns a One_option
475 // struct or NULL if argv[i] cannot be parsed as a long option. In
476 // the not-NULL case, *arg is set to the option's argument (NULL if
477 // the option takes no argument), and *i is advanced past this option.
478 // NOTE: it is safe for argv and arg to point to the same place.
479 gold::options::One_option*
480 parse_long_option(int argc, const char** argv, bool equals_only,
481 const char** arg, int* i)
483 const char* const this_argv = argv[*i];
485 const char* equals = strchr(this_argv, '=');
486 const char* option_start = this_argv + strspn(this_argv, "-");
487 std::string option(option_start,
488 equals ? equals - option_start : strlen(option_start));
490 gold::options::Option_map::iterator it
491 = gold::options::long_options->find(option);
492 if (it == gold::options::long_options->end())
495 gold::options::One_option* retval = it->second;
497 // If the dash-count doesn't match, we fail.
498 if (this_argv[0] != '-') // no dashes at all: had better be "-z <longopt>"
500 if (retval->dashes != gold::options::DASH_Z)
503 else if (this_argv[1] != '-') // one dash
505 if (retval->dashes != gold::options::ONE_DASH
506 && retval->dashes != gold::options::EXACTLY_ONE_DASH
507 && retval->dashes != gold::options::TWO_DASHES)
510 else // two dashes (or more!)
512 if (retval->dashes != gold::options::TWO_DASHES
513 && retval->dashes != gold::options::EXACTLY_TWO_DASHES
514 && retval->dashes != gold::options::ONE_DASH)
518 // Now that we know the option is good (or else bad in a way that
519 // will cause us to die), increment i to point past this argv.
522 // Figure out the option's argument, if any.
523 if (!retval->takes_argument())
526 usage(_("unexpected argument"), this_argv);
534 else if (retval->takes_optional_argument())
535 *arg = retval->default_value;
536 else if (*i < argc && !equals_only)
539 usage(_("missing argument"), this_argv);
545 // Parse a short option. Such options have the form -<option>[arg].
546 // If "arg" is not present but the option takes an argument, the next
547 // word is taken to the be the argument. If the option does not take
548 // an argument, it may be followed by another short option. Returns a
549 // One_option struct or NULL if argv[i] cannot be parsed as a short
550 // option. In the not-NULL case, *arg is set to the option's argument
551 // (NULL if the option takes no argument), and *i is advanced past
552 // this option. This function keeps *i the same if we parsed a short
553 // option that does not take an argument, that looks to be followed by
554 // another short option in the same word.
555 gold::options::One_option*
556 parse_short_option(int argc, const char** argv, int pos_in_argv_i,
557 const char** arg, int* i)
559 const char* const this_argv = argv[*i];
561 if (this_argv[0] != '-')
564 // We handle -z as a special case.
565 static gold::options::One_option dash_z("", gold::options::DASH_Z,
566 'z', "", "-z", "Z-OPTION", false,
568 gold::options::One_option* retval = NULL;
569 if (this_argv[pos_in_argv_i] == 'z')
573 const int char_as_int = static_cast<int>(this_argv[pos_in_argv_i]);
574 if (char_as_int > 0 && char_as_int < 128)
575 retval = gold::options::short_options[char_as_int];
581 // Figure out the option's argument, if any.
582 if (!retval->takes_argument())
585 // We only advance past this argument if it's the only one in argv.
586 if (this_argv[pos_in_argv_i + 1] == '\0')
591 // If we take an argument, we'll eat up this entire argv entry.
593 if (this_argv[pos_in_argv_i + 1] != '\0')
594 *arg = this_argv + pos_in_argv_i + 1;
595 else if (retval->takes_optional_argument())
596 *arg = retval->default_value;
600 usage(_("missing argument"), this_argv);
603 // If we're a -z option, we need to parse our argument as a
604 // long-option, e.g. "-z stacksize=8192".
605 if (retval == &dash_z)
608 const char* dash_z_arg = *arg;
609 retval = parse_long_option(1, arg, true, arg, &dummy_i);
611 usage(_("unknown -z option"), dash_z_arg);
617 } // End anonymous namespace.
622 General_options::General_options()
623 : execstack_status_(General_options::EXECSTACK_FROM_INPUT), static_(false),
624 do_demangle_(false), plugins_()
628 General_options::Object_format
629 General_options::format_enum() const
631 return string_to_object_format(this->format());
634 General_options::Object_format
635 General_options::oformat_enum() const
637 return string_to_object_format(this->oformat());
640 // Add the sysroot, if any, to the search paths.
643 General_options::add_sysroot()
645 if (this->sysroot() == NULL || this->sysroot()[0] == '\0')
647 this->set_sysroot(get_default_sysroot());
648 if (this->sysroot() == NULL || this->sysroot()[0] == '\0')
652 char* canonical_sysroot = lrealpath(this->sysroot());
654 for (Dir_list::iterator p = this->library_path_.value.begin();
655 p != this->library_path_.value.end();
657 p->add_sysroot(this->sysroot(), canonical_sysroot);
659 free(canonical_sysroot);
662 // Add a plugin to the list of plugins.
665 General_options::add_plugin(const char* filename)
667 if (this->plugins_ == NULL)
668 this->plugins_ = new Plugin_manager(*this);
669 this->plugins_->add_plugin(filename);
672 // Add a plugin option to a plugin.
675 General_options::add_plugin_option(const char* arg)
677 if (this->plugins_ == NULL)
678 gold_fatal("--plugin-opt requires --plugin.");
679 this->plugins_->add_plugin_option(arg);
682 // Set up variables and other state that isn't set up automatically by
683 // the parse routine, and ensure options don't contradict each other
684 // and are otherwise kosher.
687 General_options::finalize()
689 // Normalize the strip modifiers. They have a total order:
690 // strip_all > strip_debug > strip_non_line > strip_debug_gdb.
691 // If one is true, set all beneath it to true as well.
692 if (this->strip_all())
693 this->set_strip_debug(true);
694 if (this->strip_debug())
695 this->set_strip_debug_non_line(true);
696 if (this->strip_debug_non_line())
697 this->set_strip_debug_gdb(true);
699 if (this->Bshareable())
700 this->set_shared(true);
702 // If the user specifies both -s and -r, convert the -s to -S.
703 // -r requires us to keep externally visible symbols!
704 if (this->strip_all() && this->relocatable())
706 this->set_strip_all(false);
707 gold_assert(this->strip_debug());
710 // For us, -dc and -dp are synonyms for --define-common.
712 this->set_define_common(true);
714 this->set_define_common(true);
716 // We also set --define-common if we're not relocatable, as long as
717 // the user didn't explicitly ask for something different.
718 if (!this->user_set_define_common())
719 this->set_define_common(!this->relocatable());
721 // execstack_status_ is a three-state variable; update it based on
723 if (this->execstack())
724 this->set_execstack_status(EXECSTACK_YES);
725 else if (this->noexecstack())
726 this->set_execstack_status(EXECSTACK_NO);
728 // Handle the optional argument for --demangle.
729 if (this->user_set_demangle())
731 this->set_do_demangle(true);
732 const char* style = this->demangle();
735 enum demangling_styles style_code;
737 style_code = cplus_demangle_name_to_style(style);
738 if (style_code == unknown_demangling)
739 gold_fatal("unknown demangling style '%s'", style);
740 cplus_demangle_set_style(style_code);
743 else if (this->user_set_no_demangle())
744 this->set_do_demangle(false);
747 // Testing COLLECT_NO_DEMANGLE makes our default demangling
748 // behaviour identical to that of gcc's linker wrapper.
749 this->set_do_demangle(getenv("COLLECT_NO_DEMANGLE") == NULL);
752 // -M is equivalent to "-Map -".
753 if (this->print_map() && !this->user_set_Map())
756 this->set_user_set_Map();
759 // Using -n or -N implies -static.
760 if (this->nmagic() || this->omagic())
761 this->set_static(true);
763 // If --thread_count is specified, it applies to
764 // --thread-count-{initial,middle,final}, though it doesn't override
766 if (this->thread_count() > 0 && this->thread_count_initial() == 0)
767 this->set_thread_count_initial(this->thread_count());
768 if (this->thread_count() > 0 && this->thread_count_middle() == 0)
769 this->set_thread_count_middle(this->thread_count());
770 if (this->thread_count() > 0 && this->thread_count_final() == 0)
771 this->set_thread_count_final(this->thread_count());
773 // Let's warn if you set the thread-count but we're going to ignore it.
774 #ifndef ENABLE_THREADS
777 gold_warning(_("ignoring --threads: "
778 "%s was compiled without thread support"),
780 this->set_threads(false);
782 if (this->thread_count() > 0 || this->thread_count_initial() > 0
783 || this->thread_count_middle() > 0 || this->thread_count_final() > 0)
784 gold_warning(_("ignoring --thread-count: "
785 "%s was compiled without thread support"),
789 if (this->user_set_Y())
791 std::string s = this->Y();
792 if (s.compare(0, 2, "P,") == 0)
799 next_pos = s.find(':', pos);
800 size_t len = (next_pos == std::string::npos
804 this->add_to_library_path_with_sysroot(s.substr(pos, len).c_str());
807 while (next_pos != std::string::npos);
811 // Even if they don't specify it, we add -L /lib and -L /usr/lib.
812 // FIXME: We should only do this when configured in native mode.
813 this->add_to_library_path_with_sysroot("/lib");
814 this->add_to_library_path_with_sysroot("/usr/lib");
817 if (this->shared() && !this->user_set_allow_shlib_undefined())
818 this->set_allow_shlib_undefined(true);
820 // Normalize library_path() by adding the sysroot to all directories
821 // in the path, as appropriate.
824 // Now that we've normalized the options, check for contradictory ones.
825 if (this->shared() && this->is_static())
826 gold_fatal(_("-shared and -static are incompatible"));
828 if (this->shared() && this->relocatable())
829 gold_fatal(_("-shared and -r are incompatible"));
831 if (this->oformat_enum() != General_options::OBJECT_FORMAT_ELF
832 && (this->shared() || this->relocatable()))
833 gold_fatal(_("binary output format not compatible with -shared or -r"));
835 if (this->user_set_hash_bucket_empty_fraction()
836 && (this->hash_bucket_empty_fraction() < 0.0
837 || this->hash_bucket_empty_fraction() >= 1.0))
838 gold_fatal(_("--hash-bucket-empty-fraction value %g out of range "
840 this->hash_bucket_empty_fraction());
842 // FIXME: we can/should be doing a lot more sanity checking here.
845 // Search_directory methods.
847 // This is called if we have a sysroot. Apply the sysroot if
848 // appropriate. Record whether the directory is in the sysroot.
851 Search_directory::add_sysroot(const char* sysroot,
852 const char* canonical_sysroot)
854 gold_assert(*sysroot != '\0');
855 if (this->put_in_sysroot_)
857 if (!IS_DIR_SEPARATOR(this->name_[0])
858 && !IS_DIR_SEPARATOR(sysroot[strlen(sysroot) - 1]))
859 this->name_ = '/' + this->name_;
860 this->name_ = sysroot + this->name_;
861 this->is_in_sysroot_ = true;
865 // Check whether this entry is in the sysroot. To do this
866 // correctly, we need to use canonical names. Otherwise we will
867 // get confused by the ../../.. paths that gcc tends to use.
868 char* canonical_name = lrealpath(this->name_.c_str());
869 int canonical_name_len = strlen(canonical_name);
870 int canonical_sysroot_len = strlen(canonical_sysroot);
871 if (canonical_name_len > canonical_sysroot_len
872 && IS_DIR_SEPARATOR(canonical_name[canonical_sysroot_len]))
874 canonical_name[canonical_sysroot_len] = '\0';
875 if (FILENAME_CMP(canonical_name, canonical_sysroot) == 0)
876 this->is_in_sysroot_ = true;
878 free(canonical_name);
882 // Input_arguments methods.
884 // Add a file to the list.
887 Input_arguments::add_file(const Input_file_argument& file)
889 if (!this->in_group_)
890 this->input_argument_list_.push_back(Input_argument(file));
893 gold_assert(!this->input_argument_list_.empty());
894 gold_assert(this->input_argument_list_.back().is_group());
895 this->input_argument_list_.back().group()->add_file(file);
902 Input_arguments::start_group()
905 gold_fatal(_("May not nest groups"));
906 Input_file_group* group = new Input_file_group();
907 this->input_argument_list_.push_back(Input_argument(group));
908 this->in_group_ = true;
914 Input_arguments::end_group()
916 if (!this->in_group_)
917 gold_fatal(_("Group end without group start"));
918 this->in_group_ = false;
921 // Command_line options.
923 Command_line::Command_line()
927 // Process the command line options. For process_one_option, i is the
928 // index of argv to process next, and must be an option (that is,
929 // start with a dash). The return value is the index of the next
930 // option to process (i+1 or i+2, or argc to indicate processing is
931 // done). no_more_options is set to true if (and when) "--" is seen
935 Command_line::process_one_option(int argc, const char** argv, int i,
936 bool* no_more_options)
938 gold_assert(argv[i][0] == '-' && !(*no_more_options));
940 // If we are reading "--", then just set no_more_options and return.
941 if (argv[i][1] == '-' && argv[i][2] == '\0')
943 *no_more_options = true;
948 options::One_option* option = NULL;
949 const char* arg = NULL;
951 // First, try to process argv as a long option.
952 option = parse_long_option(argc, argv, false, &arg, &new_i);
955 option->reader->parse_to_value(argv[i], arg, this, &this->options_);
959 // Now, try to process argv as a short option. Since several short
960 // options can be combined in one argv, we may have to parse a lot
961 // until we're done reading this argv.
962 int pos_in_argv_i = 1;
965 option = parse_short_option(argc, argv, pos_in_argv_i, &arg, &new_i);
968 option->reader->parse_to_value(argv[i], arg, this, &this->options_);
974 // I guess it's neither a long option nor a short option.
975 usage(_("unknown option"), argv[i]);
981 Command_line::process(int argc, const char** argv)
983 bool no_more_options = false;
987 this->position_options_.copy_from_options(this->options());
988 if (no_more_options || argv[i][0] != '-')
990 Input_file_argument file(argv[i], false, "", false,
991 this->position_options_);
992 this->inputs_.add_file(file);
996 i = process_one_option(argc, argv, i, &no_more_options);
999 if (this->inputs_.in_group())
1001 fprintf(stderr, _("%s: missing group end\n"), program_name);
1005 // Normalize the options and ensure they don't contradict each other.
1006 this->options_.finalize();
1009 } // End namespace gold.