binutils-gdb/gas
Victor Do Nascimento a4822788d7 aarch64: Improve naming conventions for A and R-profile architecture
Historically, flags and variables relating to architectural revisions
for the A-profile architecture omitted the trailing `A' such that, for
example, assembling for `-march=armv8.4-a' set the `AARCH64_ARCH_V8_4'
flag in the assembler.

This leads to some ambiguity, since Binutils also targets the
R-profile Arm architecture.  Therefore, it seems prudent to have
everything associated with the A-profile cores end in `A' and likewise
`R' for the R-profile.  Referring back to the example above, the flag
set for `-march=armv8.4-a' is better characterized if labeled
`AARCH64_ARCH_V8_4A'.

The only exception to the rule of appending `A' to variables is found
in the handling of the `AARCH64_FEATURE_V8' macro, as it is the
baseline from which ALL processors derive and should therefore be left
unchanged.

In reflecting the `ARM' architectural nomenclature choices, where we
have `ARM_ARCH_V8A' and `ARM_ARCH_V8R', the choice is made to not have
an underscore separating the numerical revision number and the
A/R-profile indicator suffix.  This has meant that renaming of
R-profile related flags and variables was warranted, thus going from
`.*_[vV]8_[rR]' to `.*_[vV]8[rR]'.

Finally, this is more in line with conventions within GCC and adds consistency
across the toolchain.

gas/ChangeLog:
	* gas/config/tc-aarch64.c:
	(aarch64_cpus): Reference to arch feature macros updated.
	(aarch64_archs): Likewise.

include/ChangeLog:
	* include/opcode/aarch64.h:
	(AARCH64_FEATURE_V8A): Updated name: V8_A -> V8A.
	(AARCH64_FEATURE_V8_1A): A-suffix added.
	(AARCH64_FEATURE_V8_2A): Likewise.
	(AARCH64_FEATURE_V8_3A): Likewise.
	(AARCH64_FEATURE_V8_4A): Likewise.
	(AARCH64_FEATURE_V8_5A): Likewise.
	(AARCH64_FEATURE_V8_6A): Likewise.
	(AARCH64_FEATURE_V8_7A): Likewise.
	(AARCH64_FEATURE_V8_8A):Likewise.
	(AARCH64_FEATURE_V9A): Likewise.
	(AARCH64_FEATURE_V8R): Updated name: V8_R -> V8R.
	(AARCH64_ARCH_V8A_FEATURES): Updated name: V8_A -> V8A.
	(AARCH64_ARCH_V8_1A_FEATURES): A-suffix added.
	(AARCH64_ARCH_V8_2A_FEATURES): Likewise.
	(AARCH64_ARCH_V8_3A_FEATURES): Likewise.
	(AARCH64_ARCH_V8_4A_FEATURES): Likewise.
	(AARCH64_ARCH_V8_5A_FEATURES): Likewise.
	(AARCH64_ARCH_V8_6A_FEATURES): Likewise.
	(AARCH64_ARCH_V8_7A_FEATURES): Likewise.
	(AARCH64_ARCH_V8_8A_FEATURES): Likewise.
	(AARCH64_ARCH_V9A_FEATURES): Likewise.
	(AARCH64_ARCH_V9_1A_FEATURES): Likewise.
	(AARCH64_ARCH_V9_2A_FEATURES): Likewise.
	(AARCH64_ARCH_V9_3A_FEATURES): Likewise.
	(AARCH64_ARCH_V8A): Updated name: V8_A -> V8A.
	(AARCH64_ARCH_V8_1A): A-suffix added.
	(AARCH64_ARCH_V8_2A): Likewise.
	(AARCH64_ARCH_V8_3A): Likewise.
	(AARCH64_ARCH_V8_4A): Likewise.
	(AARCH64_ARCH_V8_5A): Likewise.
	(AARCH64_ARCH_V8_6A): Likewise.
	(AARCH64_ARCH_V8_7A): Likewise.
	(AARCH64_ARCH_V8_8A): Likewise.
	(AARCH64_ARCH_V9A): Likewise.
	(AARCH64_ARCH_V9_1A): Likewise.
	(AARCH64_ARCH_V9_2A): Likewise.
	(AARCH64_ARCH_V9_3A): Likewise.
	(AARCH64_ARCH_V8_R): Updated name: V8_R -> V8R.

opcodes/ChangeLog:
	* opcodes/aarch64-opc.c (SR_V8A): Updated name: V8_A -> V8A.
	(SR_V8_1A): A-suffix added.
	(SR_V8_2A): Likewise.
	(SR_V8_3A): Likewise.
	(SR_V8_4A): Likewise.
	(SR_V8_6A): Likewise.
	(SR_V8_7A): Likewise.
	(SR_V8_8A): Likewise.
	(aarch64_sys_regs): Reference to arch feature macros updated.
	(aarch64_pstatefields): Reference to arch feature macros updated.
	(aarch64_sys_ins_reg_supported_p): Reference to arch feature macros
	updated.
	* opcodes/aarch64-tbl.h:
	(aarch64_feature_v8_2a): a-suffix added.
	(aarch64_feature_v8_3a): Likewise.
	(aarch64_feature_fp_v8_3a): Likewise.
	(aarch64_feature_v8_4a): Likewise.
	(aarch64_feature_fp_16_v8_2a): Likewise.
	(aarch64_feature_v8_5a): Likewise.
	(aarch64_feature_v8_6a): Likewise.
	(aarch64_feature_v8_7a): Likewise.
	(aarch64_feature_v8r): Updated name: v8_r-> v8r.
	(ARMV8R): Updated name: V8_R-> V8R.
	(ARMV8_2A): A-suffix added.
	(ARMV8_3A): Likewise.
	(FP_V8_3A): Likewise.
	(ARMV8_4A): Likewise.
	(FP_F16_V8_2A): Likewise.
	(ARMV8_5): Likewise.
	(ARMV8_6A): Likewise.
	(ARMV8_6A_SVE): Likewise.
	(ARMV8_7A): Likewise.
	(V8_2A_INSN): `A' added to macro symbol.
	(V8_3A_INSN): Likewise.
	(V8_4A_INSN): Likewise.
	(FP16_V8_2A_INSN): Likewise.
	(V8_5A_INSN): Likewise.
	(V8_6A_INSN): Likewise.
	(V8_7A_INSN): Likewise.
	(V8R_INSN): Updated name: V8_R-> V8R.
2023-08-22 16:46:33 +01:00
..
config aarch64: Improve naming conventions for A and R-profile architecture 2023-08-22 16:46:33 +01:00
doc bpf: correct neg and neg32 instruction encoding 2023-08-21 10:07:25 -07:00
po generated bfd files, and kvx regen 2023-08-17 21:44:04 +09:30
testsuite bpf: correct neg and neg32 instruction encoding 2023-08-21 10:07:25 -07:00
.gitignore
acinclude.m4 Impport libiberty commit: 885b6660c17f from gcc mainline. Fix gas's acinclude.m4 to stop a potwntial configure time warning message. 2022-11-24 12:31:46 +00:00
aclocal.m4 binutils, gdb: support zstd compressed debug sections 2022-09-26 19:50:13 -07:00
app.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
as.c gas: expose flag_macro_alternate globally 2023-03-17 10:06:18 +01:00
as.h gas: expose flag_macro_alternate globally 2023-03-17 10:06:18 +01:00
asintl.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
atof-generic.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
bignum.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
bit_fix.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
cgen.c gas: equates of registers 2023-05-12 08:55:48 +02:00
cgen.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ChangeLog bpf: gas: consolidate handling of immediate overflows 2023-08-17 09:41:43 +02:00
ChangeLog-0001
ChangeLog-0203
ChangeLog-2004
ChangeLog-2005
ChangeLog-2006
ChangeLog-2007
ChangeLog-2008
ChangeLog-2009
ChangeLog-2010
ChangeLog-2011
ChangeLog-2012
ChangeLog-2013
ChangeLog-2014
ChangeLog-2015
ChangeLog-2016
ChangeLog-2017
ChangeLog-2018
ChangeLog-2019
ChangeLog-2020
ChangeLog-9295
ChangeLog-9697
ChangeLog-9899
codeview.c gas: Add CodeView constant for aarch64 2023-01-27 04:03:15 +00:00
codeview.h gas: Add CodeView constant for aarch64 2023-01-27 04:03:15 +00:00
compress-debug.c gcc-4.5 build fixes 2023-05-17 11:21:43 +09:30
compress-debug.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
cond.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
config.in add --enable-default-compressed-debug-sections-algorithm configure option 2022-10-11 14:15:04 +02:00
configure generated bfd files, and kvx regen 2023-08-17 21:44:04 +09:30
configure.ac kvx: New port. 2023-08-16 14:22:54 +01:00
configure.com Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
configure.tgt kvx: New port. 2023-08-16 14:22:54 +01:00
CONTRIBUTORS Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
COPYING
debug.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
dep-in.sed
depend.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
dw2gencfi.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
dw2gencfi.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
dwarf2dbg.c gas/dwarf2dbg.c init more statics 2023-03-14 12:11:16 +10:30
dwarf2dbg.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ecoff.c gas/ecoff.c: don't use zero struct copies to init 2023-03-14 11:20:21 +10:30
ecoff.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
ehopt.c eh static data 2023-03-10 14:20:54 +10:30
emul-target.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
emul.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
expr.c gas: invoke md_optimize_expr() also for unary expressions 2023-05-19 09:16:29 +02:00
expr.h gas: equates of registers 2023-05-12 08:55:48 +02:00
flonum-copy.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
flonum-konst.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
flonum-mult.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
flonum.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
frags.c gas: allow frag address wrapping in absolute section 2023-03-09 22:47:51 +10:30
frags.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
gdbinit.in
gen-sframe.c sframe: bfd: gas: ld: format bump to SFrame version 2 2023-06-29 16:31:58 -07:00
gen-sframe.h gas: use "stack trace" instead of "unwind" for SFrame 2023-02-02 00:49:07 -08:00
hash.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
hash.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
input-file.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
input-file.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
input-scrub.c Reinitialise macro_nest 2023-01-19 18:40:30 +10:30
itbl-lex-wrapper.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
itbl-lex.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
itbl-lex.l Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
itbl-ops.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
itbl-ops.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
itbl-parse.y Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
listing.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
listing.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
literal.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
macro.c gas: expand_irp memory leaks 2023-03-22 08:52:11 +10:30
macro.h gas: expose flag_macro_alternate globally 2023-03-17 10:06:18 +01:00
MAINTAINERS Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
Makefile.am kvx: New port. 2023-08-16 14:22:54 +01:00
Makefile.in generated bfd files, and kvx regen 2023-08-17 21:44:04 +09:30
makefile.vms Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
messages.c Recursion in as_info_where 2023-02-01 17:12:14 +10:30
NEWS kvx: New port. 2023-08-16 14:22:54 +01:00
obj.h Generated docs and include files 2023-05-03 15:00:05 +09:30
output-file.c gas obj_end 2023-02-02 08:48:29 +10:30
output-file.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
read.c gas: amend X_unsigned uses 2023-07-28 12:34:30 +02:00
read.h gas .include and .incbin 2023-03-14 12:14:32 +10:30
README Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
remap.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
sb.c Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
sb.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
sframe-opt.c sframe: fix the defined SFRAME_FRE_TYPE_*_LIMIT constants 2023-01-06 09:30:56 -08:00
stabs.c stabs.c static state 2023-02-13 21:04:09 +10:30
subsegs.c Tidy some global bfd state used by gas 2023-01-11 19:05:26 +10:30
subsegs.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
symbols.c gas: make S_IS_LOCAL() and S_IS_EXTERNAL() exclusive of one another 2023-08-18 08:57:34 +02:00
symbols.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
tc.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30
write.c Avoid another -Werror=dangling-pointer 2023-04-26 10:32:07 +09:30
write.h Update year range in copyright notice of binutils files 2023-01-01 21:50:11 +10:30

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

		README for GAS

A number of things have changed since version 1 and the wonderful
world of gas looks very different.  There's still a lot of irrelevant
garbage lying around that will be cleaned up in time.  Documentation
is scarce, as are logs of the changes made since the last gas release.
My apologies, and I'll try to get something useful.

Unpacking and Installation - Summary
====================================

See ../binutils/README.

To build just the assembler, make the target all-gas.

Documentation
=============

The GAS release includes texinfo source for its manual, which can be processed
into `info' or `dvi' forms.

The DVI form is suitable for printing or displaying; the commands for doing
this vary from system to system.  On many systems, `lpr -d' will print a DVI
file.  On others, you may need to run a program such as `dvips' to convert the
DVI file into a form your system can print.

If you wish to build the DVI file, you will need to have TeX installed on your
system.  You can rebuild it by typing:

	cd gas/doc
	make as.dvi

The Info form is viewable with the GNU Emacs `info' subsystem, or the
stand-alone `info' program, available as part of the GNU Texinfo distribution.
To build the info files, you will need the `makeinfo' program.  Type:

	cd gas/doc
	make info

Specifying names for hosts and targets
======================================

   The specifications used for hosts and targets in the `configure'
script are based on a three-part naming scheme, but some short
predefined aliases are also supported.  The full naming scheme encodes
three pieces of information in the following pattern:

     ARCHITECTURE-VENDOR-OS

   For example, you can use the alias `sun4' as a HOST argument or in a
`--target=TARGET' option.  The equivalent full name is
`sparc-sun-sunos4'.

   The `configure' script accompanying GAS does not provide any query
facility to list all supported host and target names or aliases.
`configure' calls the Bourne shell script `config.sub' to map
abbreviations to full names; you can read the script, if you wish, or
you can use it to test your guesses on abbreviations--for example:

     % sh config.sub i386v
     i386-unknown-sysv
     % sh config.sub i786v
     Invalid configuration `i786v': machine `i786v' not recognized


`configure' options
===================

   Here is a summary of the `configure' options and arguments that are
most often useful for building GAS.  `configure' also has several other
options not listed here.

     configure [--help]
               [--prefix=DIR]
               [--srcdir=PATH]
               [--host=HOST]
               [--target=TARGET]
               [--with-OPTION]
               [--enable-OPTION]

You may introduce options with a single `-' rather than `--' if you
prefer; but you may abbreviate option names if you use `--'.

`--help'
     Print a summary of the options to `configure', and exit.

`-prefix=DIR'
     Configure the source to install programs and files under directory
     `DIR'.

`--srcdir=PATH'
     Look for the package's source code in directory DIR.  Usually
     `configure' can determine that directory automatically.

`--host=HOST'
     Configure GAS to run on the specified HOST.  Normally the
     configure script can figure this out automatically.

     There is no convenient way to generate a list of all available
     hosts.

`--target=TARGET'
     Configure GAS for cross-assembling programs for the specified
     TARGET.  Without this option, GAS is configured to assemble .o files
     that run on the same machine (HOST) as GAS itself.

     There is no convenient way to generate a list of all available
     targets.

`--enable-OPTION'
     These flags tell the program or library being configured to
     configure itself differently from the default for the specified
     host/target combination.  See below for a list of `--enable'
     options recognized in the gas distribution.

`configure' accepts other options, for compatibility with configuring
other GNU tools recursively; but these are the only options that affect
GAS or its supporting libraries.

The `--enable' options recognized by software in the gas distribution are:

`--enable-targets=...'
     This causes one or more specified configurations to be added to those for
     which BFD support is compiled.  Currently gas cannot use any format other
     than its compiled-in default, so this option is not very useful.

`--enable-bfd-assembler'
     This causes the assembler to use the new code being merged into it to use
     BFD data structures internally, and use BFD for writing object files.
     For most targets, this isn't supported yet.  For most targets where it has
     been done, it's already the default.  So generally you won't need to use
     this option.

Compiler Support Hacks
======================

On a few targets, the assembler has been modified to support a feature
that is potentially useful when assembling compiler output, but which
may confuse assembly language programmers.  If assembler encounters a
.word pseudo-op of the form symbol1-symbol2 (the difference of two
symbols), and the difference of those two symbols will not fit in 16
bits, the assembler will create a branch around a long jump to
symbol1, and insert this into the output directly before the next
label: The .word will (instead of containing garbage, or giving an
error message) contain (the address of the long jump)-symbol2.  This
allows the assembler to assemble jump tables that jump to locations
very far away into code that works properly.  If the next label is
more than 32K away from the .word, you lose (silently); RMS claims
this will never happen.  If the -K option is given, you will get a
warning message when this happens.


REPORTING BUGS IN GAS
=====================

Bugs in gas should be reported to:

   https://sourceware.org/bugzilla/

See ../binutils/README for what we need in a bug report.

Copyright (C) 2012-2023 Free Software Foundation, Inc.

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.