https://sourceware.org/bugzilla/show_bug.cgi?id=29623
Bug ID: 29623
Summary: The help document of as misses so many options
Product: binutils
Version: 2.39
Status: UNCONFIRMED
Severity: normal
Priority: P2
Component: gas
Assignee: unassigned at sourceware dot org
Reporter: mengda2020 at iscas dot ac.cn
Target Milestone: ---
The "--help" option of as misses the option "al", "dump-config", "emulation",
"gdwarf-cie-version", "hash-size", "itbl", "reduce-memory-overheads",
"multibyte-handling", "mbig-obj", "O".
1） For the option "al", the following code appears during option parsing and
modifies the listing and listing_filename in gas/as.c:1017-1021 for version
2.39.
case OPTION_AL:
listing |= LISTING_LISTING;
if (optarg)
listing_filename = xstrdup (optarg);
break;
2) For the option "dump-config", the following code appears during option
parsing and prints some supplementary information in gas/as.c:728-738 for
version 2.39.
case OPTION_DUMPCONFIG:
fprintf (stderr, _("alias = %s\n"), TARGET_ALIAS);
fprintf (stderr, _("canonical = %s\n"), TARGET_CANONICAL);
fprintf (stderr, _("cpu-type = %s\n"), TARGET_CPU);
#ifdef TARGET_OBJ_FORMAT
fprintf (stderr, _("format = %s\n"), TARGET_OBJ_FORMAT);
#endif
#ifdef TARGET_FORMAT
fprintf (stderr, _("bfd-target = %s\n"), TARGET_FORMAT);
#endif
exit (EXIT_SUCCESS);
3） For the option "emulation", the following code appears during option parsing
and may print some error information in gas/as.c:719-726 for version 2.39.
case OPTION_EMULATION:
#ifdef USE_EMULATIONS
if (strcmp (optarg, this_emulation->name))
as_fatal (_("multiple emulation names specified"));
#else
as_fatal (_("emulations not handled in this configuration"));
#endif
break;
4） For the option "gdwarf-cie-version", the following code appears during
option parsing and prints some error information and modifies the
flag_dwarf_cie_version and dwarf_level in gas/as.c:884-907 for version 2.39.
case OPTION_GDWARF_CIE_VERSION:
flag_dwarf_cie_version = atoi (optarg);
/* The available CIE versions are 1 (DWARF 2), 3 (DWARF 3), and 4
(DWARF 4 and 5). */
if (flag_dwarf_cie_version < 1
|| flag_dwarf_cie_version == 2
|| flag_dwarf_cie_version > 4)
as_fatal (_("Invalid --gdwarf-cie-version `%s'"), optarg);
switch (flag_dwarf_cie_version)
{
case 1:
if (dwarf_level < 2)
dwarf_level = 2;
break;
case 3:
if (dwarf_level < 3)
dwarf_level = 3;
break;
default:
if (dwarf_level < 4)
dwarf_level = 4;
break;
}
break;
5） For the option "hash-size", the following code appears during option parsing
in gas/as.c:1120-1121 for version 2.39.
case OPTION_HASH_TABLE_SIZE:
break;
Although it has no actual function, it is still possible forget to modify the
help document after adding the function in a subsequent update.
6) For the option "itbl", the following code appears during option parsing and
may modify the itbl_files in gas/as.c:792-820 for version 2.39.
#ifdef HAVE_ITBL_CPU
case 't':
{
/* optarg is the name of the file containing the instruction
formats, opcodes, register names, etc. */
struct itbl_file_list *n;
if (optarg == NULL)
{
as_warn (_("no file name following -t option"));
break;
}
n = XNEW (struct itbl_file_list);
n->next = itbl_files;
n->name = optarg;
itbl_files = n;
/* Parse the file and add the new instructions to our internal
table. If multiple instruction tables are specified, the
information from this table gets appended onto the existing
internal table. */
itbl_files->name = xstrdup (optarg);
if (itbl_parse (itbl_files->name) != 0)
as_fatal (_("failed to read instruction table %s\n"),
itbl_files->name);
}
break;
#endif
7） For the option "reduce-memory-overheads", the following code appears during
option parsing in gas/as.c:1117-1118 for version 2.39.
case OPTION_REDUCE_MEMORY_OVERHEADS:
break;
Although it has no actual function, it is still possible forget to modify the
help document after adding the function in a subsequent update.
8) For the option "multibyte-handling", the following code appears during
option parsing and modifies the multibyte_handling in gas/as.c:688-699 for
version 2.39.
case OPTION_MULTIBYTE_HANDLING:
if (strcmp (optarg, "allow") == 0)
multibyte_handling = multibyte_allow;
else if (strcmp (optarg, "warn") == 0)
multibyte_handling = multibyte_warn;
else if (strcmp (optarg, "warn-sym-only") == 0)
multibyte_handling = multibyte_warn_syms;
else if (strcmp (optarg, "warn_sym_only") == 0)
multibyte_handling = multibyte_warn_syms;
else
as_fatal (_("unexpected argument to --multibyte-input-option:
'%s'"), optarg);
break;
9) For the option "mbig-obj", the following code appears during option parsing
and may modify the use_big_obj in gas/config/tc-i386.c:13505-13508 for version
2.39.
# if defined (TE_PE) || defined (TE_PEP)
case OPTION_MBIG_OBJ:
use_big_obj = 1;
break;
#endif
10) For the option "O", the following code appears during option parsing and
modifies the optimize and optiomize_for_space in
gas/config/tc-i386.c:13669-13687 for version 2.39.
if (arg == NULL)
{
optimize = 1;
/* Turn off -Os. */
optimize_for_space = 0;
}
else if (*arg == 's')
{
optimize_for_space = 1;
/* Turn on all encoding optimizations. */
optimize = INT_MAX;
}
else
{
optimize = atoi (arg);
/* Turn off -Os. */
optimize_for_space = 0;
}
break;
But they do not appear in the document provided by "help".
It may prevent users from using the relevant function.
--
You are receiving this mail because:
You are on the CC list for the bug.
