aarch64: add armv9-a architecture to -march
[binutils-gdb.git] / gas / doc / c-msp430.texi
index 86305155474be13fc57d2d2e090a2fdf6ec3e308..69231e4ca735f59288adcf860d39114733eab268 100644 (file)
@@ -1,4 +1,4 @@
-@c Copyright (C) 2002-2017 Free Software Foundation, Inc.
+@c Copyright (C) 2002-2021 Free Software Foundation, Inc.
 @c This is part of the GAS manual.
 @c For copying conditions, see the file as.texinfo.
 @ifset GENERIC
@@ -83,7 +83,7 @@ changes the interrupt state (@code{EINT}, @code{DINT}, @code{BIC #8,
 SR}, @code{BIS #8, SR} or @code{MOV.W <>, SR}) must be 
 followed by a NOP instruction in order to ensure the correct
 processing of interrupts.  By default it is up to the programmer to
-supply these NOP instructions, but this command line option enables
+supply these NOP instructions, but this command-line option enables
 the automatic insertion by the assembler, if they are missing.
 
 @item -mN
@@ -93,7 +93,7 @@ default behaviour.
 
 @item -my
 tells the assembler to generate a warning message if a NOP does not
-immediately forllow an instruction that enables or disables
+immediately follow an instruction that enables or disables
 interrupts.  This is the default.
 
 Note that this option can be stacked with the @option{-mn} option so
@@ -107,6 +107,19 @@ disables warnings about missing NOP instructions.
 mark the object file as one that requires data to copied from ROM to
 RAM at execution startup.  Disabled by default.
 
+@item -mdata-region=@var{region}
+Select the region data will be placed in.
+Region placement is performed by the compiler and linker.  The only effect this
+option will have on the assembler is that if @var{upper} or @var{either} is
+selected, then the symbols to initialise high data and bss will be defined.
+Valid @var{region} values are:
+@table @code
+@item none
+@item lower
+@item upper
+@item either
+@end table
+
 @end table
 
 @node MSP430 Syntax
@@ -289,12 +302,12 @@ MSP 430 assemblers.
 @cindex @code{arch} directive, MSP 430
 @item .arch
 Sets the target microcontroller in the same way as the @option{-mmcu}
-command line option.
+command-line option.
 
 @cindex @code{cpu} directive, MSP 430
 @item .cpu
 Sets the target architecture in the same way as the @option{-mcpu}
-command line option.
+command-line option.
 
 @cindex @code{profiler} directive, MSP 430
 @item .profiler
@@ -309,6 +322,18 @@ exist purely for pulling in object files from archives.  Note that
 this reloc is not sufficient to prevent garbage collection; use a
 KEEP() directive in the linker file to preserve such objects.
 
+@cindex @code{mspabi_attribute} directive, MSP430
+@item .mspabi_attribute
+This directive tells the assembler what the MSPABI build attributes for this
+file are.  This is used for validating the command line options passed to
+the assembler against the options the original source file was compiled with.
+The expected format is:
+@samp{.mspabi_attribute tag_name, tag_value}
+For example, to set the tag @code{OFBA_MSPABI_Tag_ISA} to @code{MSP430X}:
+@samp{.mspabi_attribute 4, 2}
+
+See the @cite{MSP430 EABI, document slaa534} for the details on tag names and
+values.
 @end table
 
 @node MSP430 Opcodes