1 /* as.c - GAS main program.
2 Copyright (C) 1987-2023 Free Software Foundation, Inc.
4 This file is part of GAS, the GNU Assembler.
6 GAS is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 3, or (at your option)
11 GAS is distributed in the hope that it will be useful, but WITHOUT
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
13 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
14 License for more details.
16 You should have received a copy of the GNU General Public License
17 along with GAS; see the file COPYING. If not, write to the Free
18 Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
21 /* Main program for AS; a 32-bit assembler of GNU.
22 Understands command arguments.
23 Has a few routines that don't fit in other modules because they
29 Since no-one else says they will support them in future: I
30 don't support them now. */
34 /* Disable code to set FAKE_LABEL_NAME in obj-multi.h, to avoid circular
36 #define INITIALIZING_EMULS
40 #include "output-file.h"
43 #include "dwarf2dbg.h"
44 #include "dw2gencfi.h"
56 /* Perform any cgen specific initialisation for gas. */
57 extern void gas_cgen_begin (void);
60 /* We build a list of defsyms as we read the options, and then define
61 them after we have initialized everything. */
64 struct defsym_list
*next
;
70 /* True if a listing is wanted. */
73 /* Type of debugging to generate. */
74 enum debug_info_type debug_type
= DEBUG_UNSPECIFIED
;
75 int use_gnu_debug_info_extensions
= 0;
77 #ifndef MD_DEBUG_FORMAT_SELECTOR
78 #define MD_DEBUG_FORMAT_SELECTOR NULL
80 static enum debug_info_type (*md_debug_format_selector
) (int *) = MD_DEBUG_FORMAT_SELECTOR
;
82 /* Maximum level of macro nesting. */
83 int max_macro_nest
= 100;
88 /* The default obstack chunk size. If we set this to zero, the
89 obstack code will use whatever will fit in a 4096 byte block. */
92 /* To monitor memory allocation more effectively, make this non-zero.
93 Then the chunk sizes for gas and bfd will be reduced. */
96 /* Enable verbose mode. */
99 /* Which version of DWARF CIE to produce. This default value of -1
100 indicates that this value has not been set yet, a default value is
101 provided in dwarf2_init. A different value can also be supplied by the
102 command line flag --gdwarf-cie-version, or by a target in
103 MD_AFTER_PARSE_ARGS. */
104 int flag_dwarf_cie_version
= -1;
106 /* The maximum level of DWARF DEBUG information we should manufacture.
107 This defaults to 3 unless overridden by a command line option. */
108 unsigned int dwarf_level
= 3;
110 #if defined OBJ_ELF || defined OBJ_MAYBE_ELF
111 int flag_use_elf_stt_common
= DEFAULT_GENERATE_ELF_STT_COMMON
;
112 bool flag_generate_build_notes
= DEFAULT_GENERATE_BUILD_NOTES
;
121 /* Name of listing file. */
122 static char *listing_filename
= NULL
;
124 static struct defsym_list
*defsyms
;
126 static long start_time
;
128 static int flag_macro_alternate
;
131 #ifdef USE_EMULATIONS
132 #define EMULATION_ENVIRON "AS_EMULATION"
134 extern struct emulation mipsbelf
, mipslelf
, mipself
;
135 extern struct emulation i386coff
, i386elf
, i386aout
;
136 extern struct emulation crisaout
, criself
;
138 static struct emulation
*const emulations
[] = { EMULATIONS
};
139 static const int n_emulations
= sizeof (emulations
) / sizeof (emulations
[0]);
142 select_emulation_mode (int argc
, char **argv
)
146 const char *em
= NULL
;
148 for (i
= 1; i
< argc
; i
++)
149 if (startswith (argv
[i
], "--em"))
155 p
= strchr (argv
[i
], '=');
162 as_fatal (_("missing emulation mode name"));
167 em
= getenv (EMULATION_ENVIRON
);
169 em
= DEFAULT_EMULATION
;
173 for (i
= 0; i
< n_emulations
; i
++)
174 if (!strcmp (emulations
[i
]->name
, em
))
176 if (i
== n_emulations
)
177 as_fatal (_("unrecognized emulation name `%s'"), em
);
178 this_emulation
= emulations
[i
];
181 this_emulation
= emulations
[0];
183 this_emulation
->init ();
187 default_emul_bfd_name (void)
194 common_emul_init (void)
196 this_format
= this_emulation
->format
;
198 if (this_emulation
->leading_underscore
== 2)
199 this_emulation
->leading_underscore
= this_format
->dfl_leading_underscore
;
201 if (this_emulation
->default_endian
!= 2)
202 target_big_endian
= this_emulation
->default_endian
;
204 if (this_emulation
->fake_label_name
== 0)
206 if (this_emulation
->leading_underscore
)
207 this_emulation
->fake_label_name
= FAKE_LABEL_NAME
;
209 /* What other parameters should we test? */
210 this_emulation
->fake_label_name
= "." FAKE_LABEL_NAME
;
216 print_version_id (void)
224 fprintf (stderr
, _("GNU assembler version %s (%s) using BFD version %s\n"),
225 VERSION
, TARGET_ALIAS
, BFD_VERSION_STRING
);
228 #ifdef DEFAULT_FLAG_COMPRESS_DEBUG
229 enum compressed_debug_section_type flag_compress_debug
230 = DEFAULT_COMPRESSED_DEBUG_ALGORITHM
;
234 show_usage (FILE * stream
)
236 fprintf (stream
, _("Usage: %s [option...] [asmfile...]\n"), myname
);
238 fprintf (stream
, _("\
240 -a[sub-option...] turn on listings\n\
241 Sub-options [default hls]:\n\
242 c omit false conditionals\n\
243 d omit debugging directives\n\
244 g include general info\n\
245 h include high-level source\n\
246 l include assembly\n\
247 m include macro expansions\n\
248 n omit forms processing\n\
250 =FILE list to FILE (must be last sub-option)\n"));
252 fprintf (stream
, _("\
253 --alternate initially turn on alternate macro syntax\n"));
254 fprintf (stream
, _("\
255 --compress-debug-sections[={none|zlib|zlib-gnu|zlib-gabi|zstd}]\n\
256 compress DWARF debug sections\n")),
257 fprintf (stream
, _("\
259 bfd_get_compression_algorithm_name (flag_compress_debug
));
261 fprintf (stream
, _("\
262 --nocompress-debug-sections\n\
263 don't compress DWARF debug sections\n"));
264 fprintf (stream
, _("\
265 -D produce assembler debugging messages\n"));
266 fprintf (stream
, _("\
267 --dump-config display how the assembler is configured and then exit\n"));
268 fprintf (stream
, _("\
269 --debug-prefix-map OLD=NEW\n\
270 map OLD to NEW in debug information\n"));
271 fprintf (stream
, _("\
272 --defsym SYM=VAL define symbol SYM to given value\n"));
273 #ifdef USE_EMULATIONS
280 for (i
= 0; i
< n_emulations
- 1; i
++)
281 fprintf (stream
, "%s | ", emulations
[i
]->name
);
282 fprintf (stream
, "%s]\n", emulations
[i
]->name
);
284 def_em
= getenv (EMULATION_ENVIRON
);
286 def_em
= DEFAULT_EMULATION
;
287 fprintf (stream
, _("\
288 emulate output (default %s)\n"), def_em
);
291 #if defined OBJ_ELF || defined OBJ_MAYBE_ELF
292 fprintf (stream
, _("\
293 --execstack require executable stack for this object\n"));
294 fprintf (stream
, _("\
295 --noexecstack don't require executable stack for this object\n"));
296 fprintf (stream
, _("\
297 --size-check=[error|warning]\n\
298 ELF .size directive check (default --size-check=error)\n"));
299 fprintf (stream
, _("\
300 --elf-stt-common=[no|yes] "));
301 if (DEFAULT_GENERATE_ELF_STT_COMMON
)
302 fprintf (stream
, _("(default: yes)\n"));
304 fprintf (stream
, _("(default: no)\n"));
305 fprintf (stream
, _("\
306 generate ELF common symbols with STT_COMMON type\n"));
307 fprintf (stream
, _("\
308 --sectname-subst enable section name substitution sequences\n"));
310 fprintf (stream
, _("\
311 --generate-missing-build-notes=[no|yes] "));
312 #if DEFAULT_GENERATE_BUILD_NOTES
313 fprintf (stream
, _("(default: yes)\n"));
315 fprintf (stream
, _("(default: no)\n"));
317 fprintf (stream
, _("\
318 generate GNU Build notes if none are present in the input\n"));
319 fprintf (stream
, _("\
320 --gsframe generate SFrame stack trace information\n"));
323 fprintf (stream
, _("\
324 -f skip whitespace and comment preprocessing\n"));
325 fprintf (stream
, _("\
326 -g --gen-debug generate debugging information\n"));
327 fprintf (stream
, _("\
328 --gstabs generate STABS debugging information\n"));
329 fprintf (stream
, _("\
330 --gstabs+ generate STABS debug info with GNU extensions\n"));
331 fprintf (stream
, _("\
332 --gdwarf-<N> generate DWARF<N> debugging information. 2 <= <N> <= 5\n"));
333 fprintf (stream
, _("\
334 --gdwarf-cie-version=<N> generate version 1, 3 or 4 DWARF CIEs\n"));
335 fprintf (stream
, _("\
336 --gdwarf-sections generate per-function section names for DWARF line information\n"));
337 #if defined (TE_PE) && defined (O_secrel)
338 fprintf (stream
, _("\
339 --gcodeview generate CodeView debugging information\n"));
341 fprintf (stream
, _("\
342 --hash-size=<N> ignored\n"));
343 fprintf (stream
, _("\
344 --help show all assembler options\n"));
345 fprintf (stream
, _("\
346 --target-help show target specific options\n"));
347 fprintf (stream
, _("\
348 -I DIR add DIR to search list for .include directives\n"));
349 fprintf (stream
, _("\
350 -J don't warn about signed overflow\n"));
351 fprintf (stream
, _("\
352 -K warn when differences altered for long displacements\n"));
353 fprintf (stream
, _("\
354 -L,--keep-locals keep local symbols (e.g. starting with `L')\n"));
355 fprintf (stream
, _("\
356 -M,--mri assemble in MRI compatibility mode\n"));
357 fprintf (stream
, _("\
358 --MD FILE write dependency information in FILE (default none)\n"));
359 fprintf (stream
, _("\
360 --multibyte-handling=<method>\n\
361 what to do with multibyte characters encountered in the input\n"));
362 fprintf (stream
, _("\
364 fprintf (stream
, _("\
365 -no-pad-sections do not pad the end of sections to alignment boundaries\n"));
366 fprintf (stream
, _("\
367 -o OBJFILE name the object-file output OBJFILE (default a.out)\n"));
368 fprintf (stream
, _("\
369 -R fold data section into text section\n"));
370 fprintf (stream
, _("\
371 --reduce-memory-overheads ignored\n"));
372 fprintf (stream
, _("\
373 --statistics print various measured statistics from execution\n"));
374 fprintf (stream
, _("\
375 --strip-local-absolute strip local absolute symbols\n"));
376 fprintf (stream
, _("\
377 --traditional-format Use same format as native assembler when possible\n"));
378 fprintf (stream
, _("\
379 --version print assembler version number and exit\n"));
380 fprintf (stream
, _("\
381 -W --no-warn suppress warnings\n"));
382 fprintf (stream
, _("\
383 --warn don't suppress warnings\n"));
384 fprintf (stream
, _("\
385 --fatal-warnings treat warnings as errors\n"));
387 fprintf (stream
, _("\
388 --itbl INSTTBL extend instruction set to include instructions\n\
389 matching the specifications defined in file INSTTBL\n"));
391 fprintf (stream
, _("\
393 fprintf (stream
, _("\
395 fprintf (stream
, _("\
396 -Z generate object file even after errors\n"));
397 fprintf (stream
, _("\
398 --listing-lhs-width set the width in words of the output data column of\n\
400 fprintf (stream
, _("\
401 --listing-lhs-width2 set the width in words of the continuation lines\n\
402 of the output data column; ignored if smaller than\n\
403 the width of the first line\n"));
404 fprintf (stream
, _("\
405 --listing-rhs-width set the max width in characters of the lines from\n\
406 the source file\n"));
407 fprintf (stream
, _("\
408 --listing-cont-lines set the maximum number of continuation lines used\n\
409 for the output data column of the listing\n"));
410 fprintf (stream
, _("\
411 @FILE read options from FILE\n"));
413 md_show_usage (stream
);
415 fputc ('\n', stream
);
417 if (REPORT_BUGS_TO
[0] && stream
== stdout
)
418 fprintf (stream
, _("Report bugs to %s\n"), REPORT_BUGS_TO
);
421 /* Since it is easy to do here we interpret the special arg "-"
422 to mean "use stdin" and we set that argv[] pointing to "".
423 After we have munged argv[], the only things left are source file
424 name(s) and ""(s) denoting stdin. These file names are used
425 (perhaps more than once) later.
427 check for new machine-dep cmdline options in
428 md_parse_option definitions in config/tc-*.c. */
431 parse_args (int * pargc
, char *** pargv
)
437 /* Starting the short option string with '-' is for programs that
438 expect options and other ARGV-elements in any order and that care about
439 the ordering of the two. We describe each non-option ARGV-element
440 as if it were the argument of an option with character code 1. */
442 extern const char *md_shortopts
;
443 static const char std_shortopts
[] =
446 #ifndef WORKING_DOT_WORD
447 /* -K is not meaningful if .word is not being hacked. */
450 'L', 'M', 'R', 'W', 'Z', 'a', ':', ':', 'D', 'f', 'g', ':',':', 'I', ':', 'o', ':',
452 /* -v takes an argument on VMS, so we don't make it a generic
458 /* New option for extending instruction set (see also --itbl below). */
463 struct option
*longopts
;
464 extern struct option md_longopts
[];
465 extern size_t md_longopts_size
;
466 /* Codes used for the long options with no short synonyms. */
469 OPTION_HELP
= OPTION_STD_BASE
,
476 OPTION_DEBUG_PREFIX_MAP
,
478 OPTION_LISTING_LHS_WIDTH
,
479 OPTION_LISTING_LHS_WIDTH2
, /* = STD_BASE + 10 */
480 OPTION_LISTING_RHS_WIDTH
,
481 OPTION_LISTING_CONT_LINES
,
489 OPTION_GDWARF_SECTIONS
, /* = STD_BASE + 20 */
490 OPTION_GDWARF_CIE_VERSION
,
492 OPTION_STRIP_LOCAL_ABSOLUTE
,
493 OPTION_TRADITIONAL_FORMAT
,
499 OPTION_ELF_STT_COMMON
,
500 OPTION_ELF_BUILD_NOTES
, /* = STD_BASE + 30 */
501 OPTION_SECTNAME_SUBST
,
504 OPTION_HASH_TABLE_SIZE
,
505 OPTION_REDUCE_MEMORY_OVERHEADS
,
507 OPTION_COMPRESS_DEBUG
,
508 OPTION_NOCOMPRESS_DEBUG
,
509 OPTION_NO_PAD_SECTIONS
,
510 OPTION_MULTIBYTE_HANDLING
, /* = STD_BASE + 40 */
512 /* When you add options here, check that they do
513 not collide with OPTION_MD_BASE. See as.h. */
516 static const struct option std_longopts
[] =
518 /* Note: commas are placed at the start of the line rather than
519 the end of the preceding line so that it is simpler to
520 selectively add and remove lines from this list. */
521 {"alternate", no_argument
, NULL
, OPTION_ALTERNATE
}
522 /* The entry for "a" is here to prevent getopt_long_only() from
523 considering that -a is an abbreviation for --alternate. This is
524 necessary because -a=<FILE> is a valid switch but getopt would
525 normally reject it since --alternate does not take an argument. */
526 ,{"a", optional_argument
, NULL
, 'a'}
527 /* Handle -al=<FILE>. */
528 ,{"al", optional_argument
, NULL
, OPTION_AL
}
529 ,{"compress-debug-sections", optional_argument
, NULL
, OPTION_COMPRESS_DEBUG
}
530 ,{"nocompress-debug-sections", no_argument
, NULL
, OPTION_NOCOMPRESS_DEBUG
}
531 ,{"debug-prefix-map", required_argument
, NULL
, OPTION_DEBUG_PREFIX_MAP
}
532 ,{"defsym", required_argument
, NULL
, OPTION_DEFSYM
}
533 ,{"dump-config", no_argument
, NULL
, OPTION_DUMPCONFIG
}
534 ,{"emulation", required_argument
, NULL
, OPTION_EMULATION
}
535 #if defined OBJ_ELF || defined OBJ_MAYBE_ELF
536 ,{"execstack", no_argument
, NULL
, OPTION_EXECSTACK
}
537 ,{"noexecstack", no_argument
, NULL
, OPTION_NOEXECSTACK
}
538 ,{"size-check", required_argument
, NULL
, OPTION_SIZE_CHECK
}
539 ,{"elf-stt-common", required_argument
, NULL
, OPTION_ELF_STT_COMMON
}
540 ,{"sectname-subst", no_argument
, NULL
, OPTION_SECTNAME_SUBST
}
541 ,{"generate-missing-build-notes", required_argument
, NULL
, OPTION_ELF_BUILD_NOTES
}
542 ,{"gsframe", no_argument
, NULL
, OPTION_SFRAME
}
544 ,{"fatal-warnings", no_argument
, NULL
, OPTION_WARN_FATAL
}
545 ,{"gdwarf-2", no_argument
, NULL
, OPTION_GDWARF_2
}
546 ,{"gdwarf-3", no_argument
, NULL
, OPTION_GDWARF_3
}
547 ,{"gdwarf-4", no_argument
, NULL
, OPTION_GDWARF_4
}
548 ,{"gdwarf-5", no_argument
, NULL
, OPTION_GDWARF_5
}
549 /* GCC uses --gdwarf-2 but GAS used to to use --gdwarf2,
550 so we keep it here for backwards compatibility. */
551 ,{"gdwarf2", no_argument
, NULL
, OPTION_GDWARF_2
}
552 ,{"gdwarf-sections", no_argument
, NULL
, OPTION_GDWARF_SECTIONS
}
553 ,{"gdwarf-cie-version", required_argument
, NULL
, OPTION_GDWARF_CIE_VERSION
}
554 #if defined (TE_PE) && defined (O_secrel)
555 ,{"gcodeview", no_argument
, NULL
, OPTION_GCODEVIEW
}
557 ,{"gen-debug", no_argument
, NULL
, 'g'}
558 ,{"gstabs", no_argument
, NULL
, OPTION_GSTABS
}
559 ,{"gstabs+", no_argument
, NULL
, OPTION_GSTABS_PLUS
}
560 ,{"hash-size", required_argument
, NULL
, OPTION_HASH_TABLE_SIZE
}
561 ,{"help", no_argument
, NULL
, OPTION_HELP
}
563 /* New option for extending instruction set (see also -t above).
564 The "-t file" or "--itbl file" option extends the basic set of
565 valid instructions by reading "file", a text file containing a
566 list of instruction formats. The additional opcodes and their
567 formats are added to the built-in set of instructions, and
568 mnemonics for new registers may also be defined. */
569 ,{"itbl", required_argument
, NULL
, 't'}
571 /* getopt allows abbreviations, so we do this to stop it from
572 treating -k as an abbreviation for --keep-locals. Some
573 ports use -k to enable PIC assembly. */
574 ,{"keep-locals", no_argument
, NULL
, 'L'}
575 ,{"keep-locals", no_argument
, NULL
, 'L'}
576 ,{"listing-lhs-width", required_argument
, NULL
, OPTION_LISTING_LHS_WIDTH
}
577 ,{"listing-lhs-width2", required_argument
, NULL
, OPTION_LISTING_LHS_WIDTH2
}
578 ,{"listing-rhs-width", required_argument
, NULL
, OPTION_LISTING_RHS_WIDTH
}
579 ,{"listing-cont-lines", required_argument
, NULL
, OPTION_LISTING_CONT_LINES
}
580 ,{"MD", required_argument
, NULL
, OPTION_DEPFILE
}
581 ,{"mri", no_argument
, NULL
, 'M'}
582 ,{"nocpp", no_argument
, NULL
, OPTION_NOCPP
}
583 ,{"no-pad-sections", no_argument
, NULL
, OPTION_NO_PAD_SECTIONS
}
584 ,{"no-warn", no_argument
, NULL
, 'W'}
585 ,{"reduce-memory-overheads", no_argument
, NULL
, OPTION_REDUCE_MEMORY_OVERHEADS
}
586 ,{"statistics", no_argument
, NULL
, OPTION_STATISTICS
}
587 ,{"strip-local-absolute", no_argument
, NULL
, OPTION_STRIP_LOCAL_ABSOLUTE
}
588 ,{"version", no_argument
, NULL
, OPTION_VERSION
}
589 ,{"verbose", no_argument
, NULL
, OPTION_VERBOSE
}
590 ,{"target-help", no_argument
, NULL
, OPTION_TARGET_HELP
}
591 ,{"traditional-format", no_argument
, NULL
, OPTION_TRADITIONAL_FORMAT
}
592 ,{"warn", no_argument
, NULL
, OPTION_WARN
}
593 ,{"multibyte-handling", required_argument
, NULL
, OPTION_MULTIBYTE_HANDLING
}
596 /* Construct the option lists from the standard list and the target
597 dependent list. Include space for an extra NULL option and
598 always NULL terminate. */
599 shortopts
= concat (std_shortopts
, md_shortopts
, (char *) NULL
);
600 longopts
= (struct option
*) xmalloc (sizeof (std_longopts
)
601 + md_longopts_size
+ sizeof (struct option
));
602 memcpy (longopts
, std_longopts
, sizeof (std_longopts
));
603 memcpy (((char *) longopts
) + sizeof (std_longopts
), md_longopts
, md_longopts_size
);
604 memset (((char *) longopts
) + sizeof (std_longopts
) + md_longopts_size
,
605 0, sizeof (struct option
));
607 /* Make a local copy of the old argv. */
611 /* Initialize a new argv that contains no options. */
612 new_argv
= notes_alloc (sizeof (char *) * (old_argc
+ 1));
613 new_argv
[0] = old_argv
[0];
615 new_argv
[new_argc
] = NULL
;
619 /* getopt_long_only is like getopt_long, but '-' as well as '--' can
620 indicate a long option. */
622 int optc
= getopt_long_only (old_argc
, old_argv
, shortopts
, longopts
,
631 /* md_parse_option should return 1 if it recognizes optc,
633 if (md_parse_option (optc
, optarg
) != 0)
635 /* `-v' isn't included in the general short_opts list, so check for
636 it explicitly here before deciding we've gotten a bad argument. */
640 /* Telling getopt to treat -v's value as optional can result
641 in it picking up a following filename argument here. The
642 VMS code in md_parse_option can return 0 in that case,
643 but it has no way of pushing the filename argument back. */
644 if (optarg
&& *optarg
)
645 new_argv
[new_argc
++] = optarg
, new_argv
[new_argc
] = NULL
;
656 as_bad (_("unrecognized option -%c%s"), optc
, optarg
? optarg
: "");
662 case 1: /* File name. */
663 if (!strcmp (optarg
, "-"))
664 optarg
= (char *) "";
665 new_argv
[new_argc
++] = optarg
;
666 new_argv
[new_argc
] = NULL
;
669 case OPTION_TARGET_HELP
:
670 md_show_usage (stdout
);
680 case OPTION_NO_PAD_SECTIONS
:
681 do_not_pad_sections_to_alignment
= 1;
684 case OPTION_STATISTICS
:
685 flag_print_statistics
= 1;
688 case OPTION_STRIP_LOCAL_ABSOLUTE
:
689 flag_strip_local_absolute
= 1;
692 case OPTION_TRADITIONAL_FORMAT
:
693 flag_traditional_format
= 1;
696 case OPTION_MULTIBYTE_HANDLING
:
697 if (strcmp (optarg
, "allow") == 0)
698 multibyte_handling
= multibyte_allow
;
699 else if (strcmp (optarg
, "warn") == 0)
700 multibyte_handling
= multibyte_warn
;
701 else if (strcmp (optarg
, "warn-sym-only") == 0)
702 multibyte_handling
= multibyte_warn_syms
;
703 else if (strcmp (optarg
, "warn_sym_only") == 0)
704 multibyte_handling
= multibyte_warn_syms
;
706 as_fatal (_("unexpected argument to --multibyte-input-option: '%s'"), optarg
);
710 /* This output is intended to follow the GNU standards document. */
711 printf (_("GNU assembler %s\n"), BFD_VERSION_STRING
);
712 printf (_("Copyright (C) 2023 Free Software Foundation, Inc.\n"));
714 This program is free software; you may redistribute it under the terms of\n\
715 the GNU General Public License version 3 or later.\n\
716 This program has absolutely no warranty.\n"));
717 #ifdef TARGET_WITH_CPU
718 printf (_("This assembler was configured for a target of `%s' "
719 "and default,\ncpu type `%s'.\n"),
720 TARGET_ALIAS
, TARGET_WITH_CPU
);
722 printf (_("This assembler was configured for a target of `%s'.\n"),
727 case OPTION_EMULATION
:
728 #ifdef USE_EMULATIONS
729 if (strcmp (optarg
, this_emulation
->name
))
730 as_fatal (_("multiple emulation names specified"));
732 as_fatal (_("emulations not handled in this configuration"));
736 case OPTION_DUMPCONFIG
:
737 fprintf (stderr
, _("alias = %s\n"), TARGET_ALIAS
);
738 fprintf (stderr
, _("canonical = %s\n"), TARGET_CANONICAL
);
739 fprintf (stderr
, _("cpu-type = %s\n"), TARGET_CPU
);
740 #ifdef TARGET_OBJ_FORMAT
741 fprintf (stderr
, _("format = %s\n"), TARGET_OBJ_FORMAT
);
744 fprintf (stderr
, _("bfd-target = %s\n"), TARGET_FORMAT
);
748 case OPTION_COMPRESS_DEBUG
:
751 #if defined OBJ_ELF || defined OBJ_MAYBE_ELF
752 flag_compress_debug
= bfd_get_compression_algorithm (optarg
);
754 if (flag_compress_debug
== COMPRESS_DEBUG_ZSTD
)
755 as_fatal (_ ("--compress-debug-sections=zstd: gas is not "
756 "built with zstd support"));
758 if (flag_compress_debug
== COMPRESS_UNKNOWN
)
759 as_fatal (_("Invalid --compress-debug-sections option: `%s'"),
762 as_fatal (_("--compress-debug-sections=%s is unsupported"),
767 flag_compress_debug
= COMPRESS_DEBUG_GABI_ZLIB
;
770 case OPTION_NOCOMPRESS_DEBUG
:
771 flag_compress_debug
= COMPRESS_DEBUG_NONE
;
774 case OPTION_DEBUG_PREFIX_MAP
:
775 add_debug_prefix_map (optarg
);
782 struct defsym_list
*n
;
784 for (s
= optarg
; *s
!= '\0' && *s
!= '='; s
++)
787 as_fatal (_("bad defsym; format is --defsym name=value"));
789 i
= bfd_scan_vma (s
, (const char **) NULL
, 0);
790 n
= XNEW (struct defsym_list
);
801 /* optarg is the name of the file containing the instruction
802 formats, opcodes, register names, etc. */
805 as_warn (_("no file name following -t option"));
809 /* Parse the file and add the new instructions to our internal
810 table. If multiple instruction tables are specified, the
811 information from this table gets appended onto the existing
813 if (itbl_parse (optarg
) != 0)
814 as_fatal (_("failed to read instruction table %s\n"),
821 start_dependencies (optarg
);
825 /* Some backends, eg Alpha and Mips, use the -g switch for their
826 own purposes. So we check here for an explicit -g and allow
827 the backend to decide if it wants to process it. */
828 if ( old_argv
[optind
- 1][1] == 'g'
829 && md_parse_option (optc
, optarg
))
832 /* We end up here for any -gsomething-not-already-a-long-option.
833 give some useful feedback on not (yet) supported -gdwarfxxx
834 versions/sections/options. */
835 if (startswith (old_argv
[optind
- 1], "-gdwarf"))
836 as_fatal (_("unknown DWARF option %s\n"), old_argv
[optind
- 1]);
837 else if (old_argv
[optind
- 1][1] == 'g' && optarg
!= NULL
)
838 as_fatal (_("unknown option `%s'"), old_argv
[optind
- 1]);
840 if (md_debug_format_selector
)
841 debug_type
= md_debug_format_selector (& use_gnu_debug_info_extensions
);
844 debug_type
= DEBUG_DWARF2
;
848 debug_type
= DEBUG_STABS
;
851 case OPTION_GSTABS_PLUS
:
852 use_gnu_debug_info_extensions
= 1;
855 debug_type
= DEBUG_STABS
;
858 case OPTION_GDWARF_2
:
859 debug_type
= DEBUG_DWARF2
;
863 case OPTION_GDWARF_3
:
864 debug_type
= DEBUG_DWARF2
;
868 case OPTION_GDWARF_4
:
869 debug_type
= DEBUG_DWARF2
;
873 case OPTION_GDWARF_5
:
874 debug_type
= DEBUG_DWARF2
;
878 case OPTION_GDWARF_SECTIONS
:
879 flag_dwarf_sections
= true;
882 #if defined (TE_PE) && defined (O_secrel)
883 case OPTION_GCODEVIEW
:
884 debug_type
= DEBUG_CODEVIEW
;
888 case OPTION_GDWARF_CIE_VERSION
:
889 flag_dwarf_cie_version
= atoi (optarg
);
890 /* The available CIE versions are 1 (DWARF 2), 3 (DWARF 3), and 4
892 if (flag_dwarf_cie_version
< 1
893 || flag_dwarf_cie_version
== 2
894 || flag_dwarf_cie_version
> 4)
895 as_fatal (_("Invalid --gdwarf-cie-version `%s'"), optarg
);
896 switch (flag_dwarf_cie_version
)
914 flag_signed_overflow_ok
= 1;
917 #ifndef WORKING_DOT_WORD
919 flag_warn_displacement
= 1;
923 flag_keep_locals
= 1;
926 case OPTION_LISTING_LHS_WIDTH
:
927 listing_lhs_width
= atoi (optarg
);
928 if (listing_lhs_width_second
< listing_lhs_width
)
929 listing_lhs_width_second
= listing_lhs_width
;
931 case OPTION_LISTING_LHS_WIDTH2
:
933 int tmp
= atoi (optarg
);
935 if (tmp
> listing_lhs_width
)
936 listing_lhs_width_second
= tmp
;
939 case OPTION_LISTING_RHS_WIDTH
:
940 listing_rhs_width
= atoi (optarg
);
942 case OPTION_LISTING_CONT_LINES
:
943 listing_lhs_cont_lines
= atoi (optarg
);
954 flag_readonly_data_in_text
= 1;
958 flag_no_warnings
= 1;
962 flag_no_warnings
= 0;
963 flag_fatal_warnings
= 0;
966 case OPTION_WARN_FATAL
:
967 flag_no_warnings
= 0;
968 flag_fatal_warnings
= 1;
971 #if defined OBJ_ELF || defined OBJ_MAYBE_ELF
972 case OPTION_EXECSTACK
:
974 flag_noexecstack
= 0;
977 case OPTION_NOEXECSTACK
:
978 flag_noexecstack
= 1;
982 case OPTION_SIZE_CHECK
:
983 if (strcasecmp (optarg
, "error") == 0)
984 flag_allow_nonconst_size
= false;
985 else if (strcasecmp (optarg
, "warning") == 0)
986 flag_allow_nonconst_size
= true;
988 as_fatal (_("Invalid --size-check= option: `%s'"), optarg
);
991 case OPTION_ELF_STT_COMMON
:
992 if (strcasecmp (optarg
, "no") == 0)
993 flag_use_elf_stt_common
= 0;
994 else if (strcasecmp (optarg
, "yes") == 0)
995 flag_use_elf_stt_common
= 1;
997 as_fatal (_("Invalid --elf-stt-common= option: `%s'"),
1001 case OPTION_SECTNAME_SUBST
:
1002 flag_sectname_subst
= 1;
1005 case OPTION_ELF_BUILD_NOTES
:
1006 if (strcasecmp (optarg
, "no") == 0)
1007 flag_generate_build_notes
= false;
1008 else if (strcasecmp (optarg
, "yes") == 0)
1009 flag_generate_build_notes
= true;
1011 as_fatal (_("Invalid --generate-missing-build-notes option: `%s'"),
1016 flag_gen_sframe
= 1;
1019 #endif /* OBJ_ELF */
1022 flag_always_generate_output
= 1;
1026 listing
|= LISTING_LISTING
;
1028 listing_filename
= notes_strdup (optarg
);
1031 case OPTION_ALTERNATE
:
1032 optarg
= old_argv
[optind
- 1];
1033 while (* optarg
== '-')
1036 if (strcmp (optarg
, "alternate") == 0)
1038 flag_macro_alternate
= 1;
1047 if (optarg
!= old_argv
[optind
] && optarg
[-1] == '=')
1050 if (md_parse_option (optc
, optarg
) != 0)
1058 listing
|= LISTING_NOCOND
;
1061 listing
|= LISTING_NODEBUG
;
1064 listing
|= LISTING_GENERAL
;
1067 listing
|= LISTING_HLL
;
1070 listing
|= LISTING_LISTING
;
1073 listing
|= LISTING_MACEXP
;
1076 listing
|= LISTING_NOFORM
;
1079 listing
|= LISTING_SYMBOLS
;
1082 listing_filename
= notes_strdup (optarg
+ 1);
1083 optarg
+= strlen (listing_filename
);
1086 as_fatal (_("invalid listing option `%c'"), *optarg
);
1093 listing
= LISTING_DEFAULT
;
1097 /* DEBUG is implemented: it debugs different
1098 things from other people's assemblers. */
1103 flag_no_comments
= 1;
1107 { /* Include file directory. */
1108 char *temp
= notes_strdup (optarg
);
1110 add_include_dir (temp
);
1115 out_file_name
= notes_strdup (optarg
);
1122 /* -X means treat warnings as errors. */
1125 case OPTION_REDUCE_MEMORY_OVERHEADS
:
1128 case OPTION_HASH_TABLE_SIZE
:
1139 #ifdef md_after_parse_args
1140 md_after_parse_args ();
1145 dump_statistics (void)
1147 long run_time
= get_run_time () - start_time
;
1149 fprintf (stderr
, _("%s: total time in assembly: %ld.%06ld\n"),
1150 myname
, run_time
/ 1000000, run_time
% 1000000);
1152 subsegs_print_statistics (stderr
);
1153 write_print_statistics (stderr
);
1154 symbol_print_statistics (stderr
);
1155 read_print_statistics (stderr
);
1157 #ifdef tc_print_statistics
1158 tc_print_statistics (stderr
);
1161 #ifdef obj_print_statistics
1162 obj_print_statistics (stderr
);
1166 /* The interface between the macro code and gas expression handling. */
1169 macro_expr (const char *emsg
, size_t idx
, sb
*in
, offsetT
*val
)
1175 temp_ilp (in
->ptr
+ idx
);
1176 expression_and_evaluate (&ex
);
1177 idx
= input_line_pointer
- in
->ptr
;
1180 if (ex
.X_op
!= O_constant
)
1181 as_bad ("%s", emsg
);
1183 *val
= ex
.X_add_number
;
1188 /* Here to attempt 1 pass over each input file.
1189 We scan argv[*] looking for filenames or exactly "" which is
1190 shorthand for stdin. Any argv that is NULL is not a file-name.
1191 We set need_pass_2 TRUE if, after this, we still have unresolved
1192 expressions of the form (unknown value)+-(unknown value).
1194 Note the un*x semantics: there is only 1 logical input file, but it
1195 may be a catenation of many 'physical' input files. */
1198 perform_an_assembly_pass (int argc
, char ** argv
)
1202 flagword applicable
;
1208 /* Create the standard sections, and those the assembler uses
1210 text_section
= subseg_new (TEXT_SECTION_NAME
, 0);
1211 data_section
= subseg_new (DATA_SECTION_NAME
, 0);
1212 bss_section
= subseg_new (BSS_SECTION_NAME
, 0);
1213 /* @@ FIXME -- we're setting the RELOC flag so that sections are assumed
1214 to have relocs, otherwise we don't find out in time. */
1215 applicable
= bfd_applicable_section_flags (stdoutput
);
1216 bfd_set_section_flags (text_section
,
1217 applicable
& (SEC_ALLOC
| SEC_LOAD
| SEC_RELOC
1218 | SEC_CODE
| SEC_READONLY
));
1219 bfd_set_section_flags (data_section
,
1220 applicable
& (SEC_ALLOC
| SEC_LOAD
| SEC_RELOC
1222 bfd_set_section_flags (bss_section
, applicable
& SEC_ALLOC
);
1223 seg_info (bss_section
)->bss
= 1;
1225 subseg_new (BFD_ABS_SECTION_NAME
, 0);
1226 subseg_new (BFD_UND_SECTION_NAME
, 0);
1227 reg_section
= subseg_new ("*GAS `reg' section*", 0);
1228 expr_section
= subseg_new ("*GAS `expr' section*", 0);
1231 subseg_set (text_section
, 0);
1234 /* This may add symbol table entries, which requires having an open BFD,
1235 and sections already created. */
1252 { /* Is it a file-name argument? */
1254 /* argv->"" if stdin desired, else->filename. */
1255 read_a_source_file (*argv
);
1257 argv
++; /* Completed that argv. */
1260 read_a_source_file ("");
1266 _obstack_free (¬es
, NULL
);
1269 /* Early initialisation, before gas prints messages. */
1272 gas_early_init (int *argcp
, char ***argvp
)
1274 start_time
= get_run_time ();
1277 #ifdef HAVE_LC_MESSAGES
1278 setlocale (LC_MESSAGES
, "");
1280 setlocale (LC_CTYPE
, "");
1281 bindtextdomain (PACKAGE
, LOCALEDIR
);
1282 textdomain (PACKAGE
);
1287 #ifndef OBJ_DEFAULT_OUTPUT_FILE_NAME
1288 #define OBJ_DEFAULT_OUTPUT_FILE_NAME "a.out"
1291 out_file_name
= OBJ_DEFAULT_OUTPUT_FILE_NAME
;
1294 if (bfd_init () != BFD_INIT_MAGIC
)
1295 as_fatal (_("libbfd ABI mismatch"));
1297 obstack_begin (¬es
, chunksize
);
1298 xatexit (free_notes
);
1301 xmalloc_set_program_name (myname
);
1302 bfd_set_error_program_name (myname
);
1304 expandargv (argcp
, argvp
);
1306 #ifdef HOST_SPECIAL_INIT
1307 HOST_SPECIAL_INIT (*argcp
, *argvp
);
1310 #ifdef USE_EMULATIONS
1311 select_emulation_mode (*argcp
, *argvp
);
1315 /* The bulk of gas initialisation. This is after args are parsed. */
1324 input_scrub_begin ();
1327 int macro_strip_at
= 0;
1329 macro_strip_at
= flag_mri
;
1331 macro_init (flag_macro_alternate
, flag_mri
, macro_strip_at
, macro_expr
);
1335 local_symbol_make (".gasversion.", absolute_section
,
1336 &predefined_address_frag
, BFD_VERSION
/ 10000UL);
1338 /* Note: Put new initialisation calls that don't depend on stdoutput
1339 being open above this point. stdoutput must be open for anything
1340 that might use stdoutput objalloc memory, eg. calling bfd_alloc
1341 or creating global symbols (via bfd_make_empty_symbol). */
1342 xatexit (output_file_close
);
1343 output_file_create (out_file_name
);
1344 gas_assert (stdoutput
!= 0);
1346 /* Must be called before output_file_close. xexit calls the xatexit
1347 list in reverse order. */
1348 if (flag_print_statistics
)
1349 xatexit (dump_statistics
);
1353 #ifdef tc_init_after_args
1354 tc_init_after_args ();
1359 /* Now that we have fully initialized, and have created the output
1360 file, define any symbols requested by --defsym command line
1362 while (defsyms
!= NULL
)
1365 struct defsym_list
*next
;
1367 sym
= symbol_new (defsyms
->name
, absolute_section
,
1368 &zero_address_frag
, defsyms
->value
);
1369 /* Make symbols defined on the command line volatile, so that they
1370 can be redefined inside a source file. This makes this assembler's
1371 behaviour compatible with earlier versions, but it may not be
1372 completely intuitive. */
1373 S_SET_VOLATILE (sym
);
1374 symbol_table_insert (sym
);
1375 next
= defsyms
->next
;
1382 main (int argc
, char ** argv
)
1384 char ** argv_orig
= argv
;
1387 gas_early_init (&argc
, &argv
);
1389 /* Call parse_args before gas_init so that switches like
1390 --hash-size can be honored. */
1391 parse_args (&argc
, &argv
);
1393 if (argc
> 1 && stat (out_file_name
, &sob
) == 0)
1397 for (i
= 1; i
< argc
; ++i
)
1401 /* Check that the input file and output file are different. */
1402 if (stat (argv
[i
], &sib
) == 0
1403 && sib
.st_ino
== sob
.st_ino
1404 /* POSIX emulating systems may support stat() but if the
1405 underlying file system does not support a file serial number
1406 of some kind then they will return 0 for the inode. So
1407 two files with an inode of 0 may not actually be the same.
1408 On real POSIX systems no ordinary file will ever have an
1411 /* Different files may have the same inode number if they
1412 reside on different devices, so check the st_dev field as
1414 && sib
.st_dev
== sob
.st_dev
1415 /* PR 25572: Only check regular files. Devices, sockets and so
1416 on might actually work as both input and output. Plus there
1417 is a use case for using /dev/null as both input and output
1418 when checking for command line option support in a script:
1419 as --foo /dev/null -o /dev/null; if $? then ... */
1420 && S_ISREG (sib
.st_mode
))
1422 const char *saved_out_file_name
= out_file_name
;
1424 /* Don't let as_fatal remove the output file! */
1425 out_file_name
= NULL
;
1426 as_fatal (_("The input '%s' and output '%s' files are the same"),
1427 argv
[i
], saved_out_file_name
);
1435 perform_an_assembly_pass (argc
, argv
);
1437 cond_finish_check (-1);
1443 #if defined OBJ_ELF || defined OBJ_MAYBE_ELF
1444 if ((flag_execstack
|| flag_noexecstack
)
1445 && OUTPUT_FLAVOR
== bfd_target_elf_flavour
)
1449 gnustack
= subseg_new (".note.GNU-stack", 0);
1450 bfd_set_section_flags (gnustack
,
1451 SEC_READONLY
| (flag_execstack
? SEC_CODE
: 0));
1458 /* If we've been collecting dwarf2 .debug_line info, either for
1459 assembly debugging or on behalf of the compiler, emit it now. */
1462 /* If we constructed dwarf2 .eh_frame info, either via .cfi
1463 directives from the user or by the backend, emit it now. */
1467 if (seen_at_least_1_file ())
1469 int n_warns
, n_errs
;
1473 write_object_file ();
1475 n_warns
= had_warnings ();
1476 n_errs
= had_errors ();
1479 ngettext ("%d warning", "%d warnings", n_warns
), n_warns
);
1481 ngettext ("%d error", "%d errors", n_errs
), n_errs
);
1482 if (flag_fatal_warnings
&& n_warns
!= 0)
1485 as_bad (_("%s, treating warnings as errors"), warn_msg
);
1491 else if (flag_always_generate_output
)
1493 /* The -Z flag indicates that an object file should be generated,
1494 regardless of warnings and errors. */
1496 fprintf (stderr
, _("%s, %s, generating bad object file\n"),
1504 listing_print (listing_filename
, argv_orig
);
1509 /* Use xexit instead of return, because under VMS environments they
1510 may not place the same interpretation on the value given. */
1511 if (had_errors () != 0)
1512 xexit (EXIT_FAILURE
);
1514 /* Only generate dependency file if assembler was successful. */
1515 print_dependencies ();
1517 xexit (EXIT_SUCCESS
);