diff options
Diffstat (limited to 'gas/doc')
65 files changed, 370 insertions, 523 deletions
diff --git a/gas/doc/all.texi b/gas/doc/all.texi index 815909c..2d4d4e6 100644 --- a/gas/doc/all.texi +++ b/gas/doc/all.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1992-2024 Free Software Foundation, Inc. +@c Copyright (C) 1992-2025 Free Software Foundation, Inc. @c This file is part of the documentation for the GAS manual @c Configuration settings for all-inclusive version of manual @@ -57,7 +57,6 @@ @set MMIX @set MS1 @set MSP430 -@set NIOSII @set NDS32 @set NS32K @set OPENRISC diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 33169a5..afe1737 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -1,5 +1,5 @@ \input texinfo @c -*-Texinfo-*- -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c UPDATE!! On future updates-- @c (1) check for new machine-dep cmdline options in @c md_parse_option definitions in config/tc-*.c @@ -100,7 +100,7 @@ This file documents the GNU Assembler "@value{AS}". @c man begin COPYRIGHT -Copyright @copyright{} 1991-2024 Free Software Foundation, Inc. +Copyright @copyright{} 1991-2025 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 @@ -149,7 +149,7 @@ done. @end tex @vskip 0pt plus 1filll -Copyright @copyright{} 1991-2024 Free Software Foundation, Inc. +Copyright @copyright{} 1991-2025 Free Software Foundation, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 @@ -243,6 +243,7 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. [@b{--gsframe}] [@b{--hash-size}=@var{N}] [@b{--help}] [@b{--target-help}] + [@b{--info}] [@b{--no-info}] [@b{-I} @var{dir}] [@b{-J}] [@b{-K}] @@ -260,7 +261,8 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. [@b{--size-check=[error|warning]}] [@b{--statistics}] [@b{-v}] [@b{-version}] [@b{--version}] - [@b{-W}] [@b{--warn}] [@b{--fatal-warnings}] [@b{-w}] [@b{-x}] + [@b{-W}] [@b{--no-warn}] [@b{--warn}] [@b{--fatal-warnings}] + [@b{-w}] [@b{-x}] [@b{-Z}] [@b{@@@var{FILE}}] [@var{target-options}] [@b{--}|@var{files} @dots{}] @@ -495,12 +497,6 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. [@b{--no-expand}] [@b{--no-merge-gregs}] [@b{-x}] [@b{--linker-allocated-gregs}] @end ifset -@ifset NIOSII - -@emph{Target Nios II options:} - [@b{-relax-all}] [@b{-relax-section}] [@b{-no-relax}] - [@b{-EB}] [@b{-EL}] -@end ifset @ifset NDS32 @emph{Target NDS32 options:} @@ -872,6 +868,12 @@ Print a summary of the command-line options and exit. @item --target-help Print a summary of all target specific options and exit. +@item --info +Don't suppress informational messages. + +@item --no-info +Suppress informational messages. + @item -I @var{dir} Add directory @var{dir} to the search list for @code{.include} directives. @@ -983,12 +985,12 @@ Print the @command{as} version and exit. @itemx --no-warn Suppress warning messages. -@item --fatal-warnings -Treat warnings as errors. - @item --warn Don't suppress warning messages or treat them as errors. +@item --fatal-warnings +Treat warnings as errors. + @item -w Ignored. @@ -1327,24 +1329,6 @@ unit coprocessor. The default is to assume an MMU for 68020 and up. @end table @end ifset -@ifset NIOSII - -@ifclear man -@xref{Nios II Options}, for the options available when @value{AS} is configured -for an Altera Nios II processor. -@end ifclear - -@ifset man -@c man begin OPTIONS -The following options are available when @value{AS} is configured for an -Altera Nios II processor. -@c man end -@c man begin INCLUDE -@include c-nios2.texi -@c ended inside the included file -@end ifset -@end ifset - @ifset PDP11 For details about the PDP-11 machine dependent features options, @@ -1960,7 +1944,7 @@ Specify which s390 processor variant is the target, @samp{g5} (or @samp{arch6}), @samp{z9-109}, @samp{z9-ec} (or @samp{arch7}), @samp{z10} (or @samp{arch8}), @samp{z196} (or @samp{arch9}), @samp{zEC12} (or @samp{arch10}), @samp{z13} (or @samp{arch11}), @samp{z14} (or @samp{arch12}), @samp{z15} -(or @samp{arch13}), or @samp{z16} (or @samp{arch14}). +(or @samp{arch13}), @samp{z16} (or @samp{arch14}), or @samp{arch15}. @item -mregnames @itemx -mno-regnames Allow or disallow symbolic names for registers. @@ -2445,6 +2429,7 @@ assembler.) * alternate:: --alternate enable alternate macro syntax * D:: -D for compatibility and debugging * f:: -f to work faster +* info:: --info, --no-info to control informational messages * I:: -I for .include search path @ifclear DIFF-TBL-KLUGE * K:: -K for compatibility @@ -2557,6 +2542,32 @@ preprocessed (if they contain comments, for example), @command{@value{AS}} does not work correctly. @end quotation +@node info +@section Control Informational Messages: @option{--info}, @option{--no-info} + +In some cases, @command{@value{AS}} might give additional informational messages +associated to a context that generated a warning or error message when assembling. +The informational message provides additional details about an earlier diagnostic +message, usually in the form of some context (such as when the earlier diagnostic +was within a macro). +All such information are directed to the standard error file. +This flag only affects the informational messages, it does not change any particular +of how @command{@value{AS}} assembles your file. + +@kindex --info +@cindex diagnostic information, switching on (default behavior) +The option @option{--info} is enabled by default, and enables printing of additional +diagnostic information. + +@kindex --no-info +@cindex diagnostic informations, switching off +You can switch the option @option{--info} off by specifying @option{--no-info}, +which disables printing of additional information in the context of an earlier +diagnostic. + +Specifying @option{--info} after @option{--no-info} will turn on again printing +of additional diagnostic information. + @node I @section @code{.include} Search Path: @option{-I} @var{path} @@ -2863,7 +2874,7 @@ option @samp{-v} (which you can also spell as @samp{-version}) on the command line. @node W -@section Control Warnings: @option{-W}, @option{--warn}, @option{--no-warn}, @option{--fatal-warnings} +@section Control Warnings: @option{-W}, @option{--no-warn}, @option{--warn}, @option{--fatal-warnings} @command{@value{AS}} should never give a warning or error message when assembling compiler output. But programs written by people often @@ -2874,22 +2885,24 @@ made. All such warnings are directed to the standard error file. @kindex --no-warn @cindex suppressing warnings @cindex warnings, suppressing -If you use the @option{-W} and @option{--no-warn} options, no warnings are issued. +If you use the @option{-W} or @option{--no-warn} option, no warnings are issued. This only affects the warning messages: it does not change any particular of how @command{@value{AS}} assembles your file. Errors, which stop the assembly, are still reported. +@kindex --warn +@cindex outputing warnings +@cindex warnings, switching on +Warnings are switched on by default. They can be switched off with @option{-W} or +@option{--no-warn}. Specifying the @option{--warn} again later on the command line +will switch on warnings again, and cause them to be output as usual. + @kindex --fatal-warnings @cindex errors, caused by warnings @cindex warnings, causing error If you use the @option{--fatal-warnings} option, @command{@value{AS}} considers files that generate warnings to be in error. -@kindex --warn -@cindex warnings, switching on -You can switch these options off again by specifying @option{--warn}, which -causes warnings to be output as usual. - @node Z @section Generate Object File in Spite of Errors: @option{-Z} @cindex object file, after errors @@ -2987,11 +3000,11 @@ as exactly one space. @section Comments @cindex comments -There are two ways of rendering comments to @command{@value{AS}}. In both -cases the comment is equivalent to one space. +There are two ways of rendering comments to @command{@value{AS}}. Anything from @samp{/*} through the next @samp{*/} is a comment. -This means you may not nest these comments. +This means you may not nest these comments. Such a comment is equivalent to +one space, plus bumping the line counter accordingly. @smallexample /* @@ -4497,6 +4510,7 @@ Some machine configurations provide additional directives. * Asciz:: @code{.asciz "@var{string}"}@dots{} * Attach_to_group:: @code{.attach_to_group @var{name}} * Balign:: @code{.balign [@var{abs-expr}[, @var{abs-expr}]]} +* Base64:: @code{.base64 "@var{string}"[, @dots{}]} @ifset ELF * Bss:: @code{.bss @var{subsection}} @end ifset @@ -4784,7 +4798,7 @@ and use the result as a string. @item No passing arguments to macros based upon keyword assignment. In altmacro mode arguments cannot be passed to macros by keyword assignment. -See @xref{altmacro-keyword-arguments} for more details +See @xref{altmacro-keyword-arguments}. @end ftable @node Ascii @@ -4851,6 +4865,24 @@ filled in with the value 0x368d (the exact placement of the bytes depends upon the endianness of the processor). If it skips 1 or 3 bytes, the fill value is undefined. +@node Base64 +@section @code{.base64 "@var{string}"[, @dots{}]} +Allows binary data to be entered into a section encoded as a base64 string. +There is no maximum length to the strings, but they must be a multiple of four +bytes long. If necessary the ends of the strings can be padded with @code{=} +characters. Line breaks, control characters and escaped characters are not +allowed in the strings. The strings must be enclosed between double quote +characters. Multiple strings are allowed, but they must be separated by +commas. + +As an example of how to create a base64 encoded string, see the +@command{base64} program (with its @option{-w0} option to disable line breaks). + +Note: for targets where the size of a byte is larger than the size of an octet +the @code{.base64} directive will, if necessary, pad the end of the @emph{last} +string so that the total number of octets generated are a multiple the number +of octets in a byte. + @ifset ELF @node Bss @section @code{.bss @var{subsection}} @@ -6852,7 +6884,7 @@ This is one of the ELF section stack manipulation directives. The others are For ELF targets, the @code{.section} directive is used like this: @smallexample -.section @var{name} [, "@var{flags}"[, @@@var{type}[,@var{flag_specific_arguments}]]] +.section @var{name} [, "@var{flags}"[, @@@var{type}][,@var{flag_specific_arguments}]] @end smallexample @anchor{Section Name Substitutions} @@ -6979,22 +7011,31 @@ Note - some sections, eg @code{.text} and @code{.data} are considered to be special and have fixed types. Any attempt to declare them with a different type will generate an error from the assembler. -If @var{flags} contains the @code{M} symbol then the @var{type} argument must -be specified as well as an extra argument---@var{entsize}---like this: +If @var{flags} contains the @code{S} flag then the section contains +zero-terminated strings. The size of each character in the string is specified +in octets by the entity size, @var{entsize}, which defaults to @code{1}, but +can be set using the syntax + +@smallexample +.section @var{name}, "@var{flags}"S[, @@@var{type}] [, @var{entsize}] +@end smallexample + +If @var{flags} contains the @code{M} flag then the @var{type} +argument must be specified as well as an extra argument---@var{entsize}---like +this: @smallexample .section @var{name} , "@var{flags}"M, @@@var{type}, @var{entsize} @end smallexample -Sections with the @code{M} flag but not @code{S} flag must contain fixed size -constants, each @var{entsize} octets long. Sections with both @code{M} and -@code{S} must contain zero terminated strings where each character is -@var{entsize} bytes long. The linker may remove duplicates within sections with -the same name, same entity size and same flags. @var{entsize} must be an -absolute expression. For sections with both @code{M} and @code{S}, a string -which is a suffix of a larger string is considered a duplicate. Thus -@code{"def"} will be merged with @code{"abcdef"}; A reference to the first -@code{"def"} will be changed to a reference to @code{"abcdef"+3}. +Sections with the @code{M} flag but not the @code{S} flag must contain fixed +size constants, each @var{entsize} octets long. For @code{M} sections the +linker may remove duplicates within sections with the same name, same entity +size and same flags. @var{entsize} must be an absolute expression. For +sections with both @code{M} and @code{S}, a string which is a suffix of a +larger string is considered a duplicate. Thus @code{"def"} will be merged with +@code{"abcdef"}; A reference to the first @code{"def"} will be changed to a +reference to @code{"abcdef"+3}. If @var{flags} contains the @code{o} flag, then the @var{type} argument must be present along with an additional field like this: @@ -7009,8 +7050,8 @@ is not generally a good idea as section indices are rarely known at assembly time, but the facility is provided for testing purposes. An index of zero is allowed. It indicates that the linked-to section has already been discarded. -Note: If both the @var{M} and @var{o} flags are present, then the fields -for the Merge flag should come first, like this: +Note: If both one of @var{M} or @var{S} and @var{o} flags are present, then the +fields for the Merge/String flag should come first, like this: @smallexample .section @var{name},"@var{flags}"Mo,@@@var{type},@var{entsize},@var{SymbolName} @@ -7033,8 +7074,8 @@ indicates that only one copy of this section should be retained an alias for comdat @end table -Note: if both the @var{M} and @var{G} flags are present then the fields for -the Merge flag should come first, like this: +Note: Uf both one of @var{M} or @var{S} and @var{G} flags are present then the +fields for the Merge/String flag should come first, like this: @smallexample .section @var{name} , "@var{flags}"MG, @@@var{type}, @var{entsize}, @var{GroupName}[, @var{linkage}] @@ -7785,7 +7826,7 @@ section, using the endian model of the target. If an expression will not fit in two bytes, a warning message is displayed and the least significant two bytes of the expression's value are used. If an expression cannot be evaluated at assembly time then relocations will be generated in order to compute the -value at link time. +value at link time. This directive does not apply any alignment before or after inserting the values. As a result of this, if relocations are generated, they may be @@ -8150,9 +8191,6 @@ subject, see the hardware manufacturer's manual. @ifset NDS32 * NDS32-Dependent:: Andes NDS32 Dependent Features @end ifset -@ifset NIOSII -* NiosII-Dependent:: Altera Nios II Dependent Features -@end ifset @ifset NS32K * NS32K-Dependent:: NS32K Dependent Features @end ifset @@ -8390,10 +8428,6 @@ family. @include c-nds32.texi @end ifset -@ifset NIOSII -@include c-nios2.texi -@end ifset - @ifset NS32K @include c-ns32k.texi @end ifset diff --git a/gas/doc/c-aarch64.texi b/gas/doc/c-aarch64.texi index 2126304..10888d1 100644 --- a/gas/doc/c-aarch64.texi +++ b/gas/doc/c-aarch64.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2009-2024 Free Software Foundation, Inc. +@c Copyright (C) 2009-2025 Free Software Foundation, Inc. @c Contributed by ARM Ltd. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @@ -161,8 +161,6 @@ automatically cause those extensions to be disabled. @headitem Extension @tab Depends upon @tab Description @item @code{aes} @tab @code{simd} @tab Enable the AES and PMULL cryptographic extensions. -@item @code{b16b16} @tab @code{sve2} - @tab Enable BFloat16 to BFloat16 arithmetic for SVE2 and SME2. @item @code{bf16} @tab @code{fp} @tab Enable BFloat16 extension. @item @code{brbe} @tab @@ -197,9 +195,9 @@ automatically cause those extensions to be disabled. @tab Enable floating-point extensions. @item @code{fp8} @tab @tab Enable the Floating Point 8 (FP8) extension. -@item @code{fp8dot2} @tab @code{fp8dot4} +@item @code{fp8dot2} @tab @code{fp8} @tab Enable the FP8 2-way dot product instructions. -@item @code{fp8dot4} @tab @code{fp8fma} +@item @code{fp8dot4} @tab @code{fp8} @tab Enable the FP8 4-way dot product instructions. @item @code{fp8fma} @tab @code{fp8} @tab Enable the FP8 FMA instructions. @@ -207,7 +205,7 @@ automatically cause those extensions to be disabled. @tab Enable Armv8.2 16-bit floating-point multiplication variant support. @item @code{fp16} @tab @code{fp} @tab Enable Armv8.2 16-bit floating-point support. -@item @code{frintts} @tab @code{simd} +@item @code{frintts} @tab @code{fp} @tab Enable floating-point round to integral value instructions. @item @code{gcs} @tab @tab Enable the Guarded Control Stack Extension. @@ -269,9 +267,11 @@ automatically cause those extensions to be disabled. @tab Enable Advanced SIMD extensions. @item @code{sm4} @tab @code{simd} @tab Enable the SM3 and SM4 cryptographic extensions. -@item @code{sme} @tab @code{sve2}, @code{bf16} - @tab Enable the Scalable Matrix Extension. -@item @code{sme-f8f16} @tab @code{sme-f8f32} +@item @code{sme} @tab @code{bf16}, @code{fp16}, @code{fcma} + @tab Enable the Scalable Matrix Extension. This will also enable @code{sve2}, but disabling @code{sve2} does not disable @code{sme}. +@item @code{sme-b16b16} @tab @code{sme2}, @code{sve-b16b16} + @tab Enable SME ZA-targeting non-widening BFloat16 instructions. +@item @code{sme-f8f16} @tab @code{sme2}, @code{fp8} @tab Enable the SME F8F16 Extension. @item @code{sme-f8f32} @tab @code{sme2}, @code{fp8} @tab Enable the SME F8F32 Extension. @@ -287,14 +287,16 @@ automatically cause those extensions to be disabled. @tab Enable SME2.1. @item @code{ssbs} @tab @tab Enable Speculative Store Bypassing Safe state read and write. -@item @code{ssve-fp8dot2} @tab @code{ssve-fp8dot4} - @tab Enable the Streaming SVE FP8 2-way dot product instructions. These can also be enabled using @code{+fp8dot2+sme2}. -@item @code{ssve-fp8dot4} @tab @code{ssve-fp8fma} - @tab Enable the Streaming SVE FP8 4-way dot product instructions. These can also be enabled using @code{+fp8dot4+sme2}. +@item @code{ssve-fp8dot2} @tab @code{sme2}, @code{fp8} + @tab Enable the Streaming SVE FP8 2-way dot product instructions. +@item @code{ssve-fp8dot4} @tab @code{sme2}, @code{fp8} + @tab Enable the Streaming SVE FP8 4-way dot product instructions. @item @code{ssve-fp8fma} @tab @code{sme2}, @code{fp8} - @tab Enable the Streaming SVE FP8 FMA instructions. These can also be enabled using @code{+fp8fma+sme2}. + @tab Enable the Streaming SVE FP8 FMA instructions. @item @code{sve} @tab @code{fcma} @tab Enable the Scalable Vector Extension. +@item @code{sve-b16b16} @tab +@tab Enable the SVE B16B16 extension. These instructions also require either @code{+sve2} or @code{+sme2}. @item @code{sve2} @tab @code{sve} @tab Enable SVE2. @item @code{sve2-aes} @tab @code{sve2}, @code{aes} @@ -315,6 +317,8 @@ automatically cause those extensions to be disabled. @tab Enable @code{wfet} and @code{wfit} instructions. @item @code{xs} @tab @tab Enable the XS memory attribute extension. +@item @code{sme-f16f16} @tab + @tab Enable the SME2 F16F16 Extension. @end multitable @multitable @columnfractions .20 .80 @@ -370,9 +374,9 @@ The @samp{#} can be optionally used to indicate immediate operands. @cindex AArch64 register names @cindex register names, AArch64 -Please refer to the section @samp{4.4 Register Names} of -@samp{ARMv8 Instruction Set Overview}, which is available at -@uref{http://infocenter.arm.com}. +Please refer to the section @samp{Register names} of @samp{Arm +Architecture Reference Manual for A-profile architecture}, which +is available at @uref{https://developer.arm.com/}. @node AArch64-Relocations @subsection Relocations @@ -622,8 +626,8 @@ already there) and a PC-relative LDR instruction will be generated. @end table For more information on the AArch64 instruction set and assembly language -notation, see @samp{ARMv8 Instruction Set Overview} available at -@uref{http://infocenter.arm.com}. +notation, see @samp{Arm Architecture Reference Manual for A-profile +architecture} available at @uref{https://developer.arm.com/}. @node AArch64 Mapping Symbols diff --git a/gas/doc/c-alpha.texi b/gas/doc/c-alpha.texi index 13dcc49..83b255d 100644 --- a/gas/doc/c-alpha.texi +++ b/gas/doc/c-alpha.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2002-2024 Free Software Foundation, Inc. +@c Copyright (C) 2002-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-arc.texi b/gas/doc/c-arc.texi index 077aa3a..2121654 100644 --- a/gas/doc/c-arc.texi +++ b/gas/doc/c-arc.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2000-2024 Free Software Foundation, Inc. +@c Copyright (C) 2000-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-arm.texi b/gas/doc/c-arm.texi index 8135f01..3a38d07 100644 --- a/gas/doc/c-arm.texi +++ b/gas/doc/c-arm.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1996-2024 Free Software Foundation, Inc. +@c Copyright (C) 1996-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @@ -1530,5 +1530,6 @@ The pseudo ops described above are sufficient for writing assembly code that calls functions which may throw exceptions. If you need to know more about the object-file format used to represent unwind information, you may consult the @cite{Exception Handling ABI for the -ARM Architecture} available from @uref{http://infocenter.arm.com}. +Arm Architecture} available from +@uref{https://github.com/ARM-software/abi-aa/blob/main/ehabi32/ehabi32.rst}. diff --git a/gas/doc/c-avr.texi b/gas/doc/c-avr.texi index 9f2e1f7..fdedc9d 100644 --- a/gas/doc/c-avr.texi +++ b/gas/doc/c-avr.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2006-2024 Free Software Foundation, Inc. +@c Copyright (C) 2006-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-bfin.texi b/gas/doc/c-bfin.texi index 031c6fc..bc07851 100644 --- a/gas/doc/c-bfin.texi +++ b/gas/doc/c-bfin.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2005-2024 Free Software Foundation, Inc. +@c Copyright (C) 2005-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-bpf.texi b/gas/doc/c-bpf.texi index d99538f..003cb92 100644 --- a/gas/doc/c-bpf.texi +++ b/gas/doc/c-bpf.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2019-2024 Free Software Foundation, Inc. +@c Copyright (C) 2019-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-cr16.texi b/gas/doc/c-cr16.texi index 4c44172..c35839c 100644 --- a/gas/doc/c-cr16.texi +++ b/gas/doc/c-cr16.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2007-2024 Free Software Foundation, Inc. +@c Copyright (C) 2007-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-cris.texi b/gas/doc/c-cris.texi index 68bba8b..fd05046 100644 --- a/gas/doc/c-cris.texi +++ b/gas/doc/c-cris.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2002-2024 Free Software Foundation, Inc. +@c Copyright (C) 2002-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c CRIS description contributed by Axis Communications. diff --git a/gas/doc/c-csky.texi b/gas/doc/c-csky.texi index b260f3c..5a6c514 100644 --- a/gas/doc/c-csky.texi +++ b/gas/doc/c-csky.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2012-2024 Free Software Foundation, Inc. +@c Copyright (C) 2012-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-d10v.texi b/gas/doc/c-d10v.texi index 8d8adea..eb6352c 100644 --- a/gas/doc/c-d10v.texi +++ b/gas/doc/c-d10v.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1996-2024 Free Software Foundation, Inc. +@c Copyright (C) 1996-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-d30v.texi b/gas/doc/c-d30v.texi index 87fb993..941b192 100644 --- a/gas/doc/c-d30v.texi +++ b/gas/doc/c-d30v.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1997-2024 Free Software Foundation, Inc. +@c Copyright (C) 1997-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-epiphany.texi b/gas/doc/c-epiphany.texi index 41f005b..5cc41b1 100644 --- a/gas/doc/c-epiphany.texi +++ b/gas/doc/c-epiphany.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1999-2024 Free Software Foundation, Inc. +@c Copyright (C) 1999-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-h8300.texi b/gas/doc/c-h8300.texi index 3eeb6aa..2de3f58 100644 --- a/gas/doc/c-h8300.texi +++ b/gas/doc/c-h8300.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-hppa.texi b/gas/doc/c-hppa.texi index bae9aad..66527dc 100644 --- a/gas/doc/c-hppa.texi +++ b/gas/doc/c-hppa.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @page diff --git a/gas/doc/c-i386.texi b/gas/doc/c-i386.texi index 36ba825..4d59958 100644 --- a/gas/doc/c-i386.texi +++ b/gas/doc/c-i386.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end @@ -218,11 +218,22 @@ accept various extension mnemonics. For example, @code{avx10.1/256}, @code{avx10.1/128}, @code{user_msr}, +@code{msr_imm}, @code{apx_f}, +@code{avx10.2}, +@code{avx10.2/512}, +@code{avx10.2/256}, +@code{avx10.2/128}, +@code{movrs}, @code{amx_int8}, @code{amx_bf16}, @code{amx_fp16}, @code{amx_complex}, +@code{amx_transpose}, +@code{amx_tf32}, +@code{amx_fp8} +@code{amx_movrs}, +@code{amx_avx512}, @code{amx_tile}, @code{vmx}, @code{vmfunc}, @@ -270,7 +281,14 @@ accept various extension mnemonics. For example, @code{snp}, @code{invlpgb}, @code{tlbsync}, -@code{svme} and +@code{rmpquery}, +@code{rmpread}, +@code{svme}, +@code{gmism2}, +@code{gmiccs}, +@code{padlockrng2}, +@code{padlockphe2}, +@code{padlockxmodx} and @code{padlock}. Note that these extension mnemonics can be prefixed with @code{no} to revoke the respective (and any dependent) functionality. Note further that the @@ -463,6 +481,16 @@ R_X86_64_REX_GOTPCRELX, in 64-bit mode. relocations. The default can be controlled by a configure option @option{--enable-x86-relax-relocations}. +@cindex @samp{-mtls-check=} option, i386 +@cindex @samp{-mtls-check=} option, x86-64 +@item -mtls-check=@var{no} +@itemx -mtls-check=@var{yes} +These options control whether the assembler check tls relocation. +@option{-mtls-check=@var{yes}} will check tls relocation. +@option{-mtls-check=@var{no}} will not check tls relocation +The default can be controlled by a configure option +@option{--enable-x86-tls-check}. + @cindex @samp{-malign-branch-boundary=} option, i386 @cindex @samp{-malign-branch-boundary=} option, x86-64 @item -malign-branch-boundary=@var{NUM} @@ -674,7 +702,7 @@ operand, as long as there is one. syntax tries to resemble that used in documentation: @itemize @bullet @item @code{VEX}[@code{.@var{len}}][@code{.@var{prefix}}][@code{.@var{space}}][@code{.@var{w}}] -@item @code{EVEX}[@code{.@var{len}}][@code{.@var{prefix}}][@code{.@var{space}}][@code{.@var{w}}] +@item @code{EVEX}[@code{.@var{len}}][@code{.@var{prefix}}][@code{.@var{space}}][@code{.@var{w}}][@code{.@var{opt}}] @item @code{XOP}@var{space}[@code{.@var{len}}][@code{.@var{prefix}}][@code{.@var{w}}] @end itemize @@ -689,10 +717,11 @@ only) @code{512} as well as @code{L0} / @code{L1} for VEX / XOP and @item @code{0f}, @code{0f38}, @code{0f3a}, or @code{M0}...@code{M31} for VEX @item @code{08}...@code{1f} for XOP -@item @code{0f}, @code{0f38}, @code{0f3a}, or @code{M0}...@code{M15} +@item @code{0f}, @code{0f38}, @code{0f3a}, or @code{M0}...@code{M7} for EVEX @end itemize @item @var{w} can be @code{WIG}, @code{W0}, or @code{W1} +@item @var{opt} can be @code{ND} or @code{ZU} @end itemize Defaults: @@ -780,6 +809,12 @@ be suffixed by @code{@{:d@var{n}@}} to specify the size (in bytes). This can be combined with an embedded broadcast specifier: @samp{8(%eax)@{1to8:d8@}}. +For SCC EVEX the @code{@{dfv=@}} specifier used by ordinary insns is +extended and immediately follows the opcode specifier. The extension +is that the SCC value needs to be specified and goes first, as in +@code{@{scc=@var{n},dfv=...@}}. Unlike for ordinary insns @code{dfv=} +may be omitted for brevity. + @cindex @code{noopt} directive @item .noopt Disable instruction size optimization. @@ -1679,19 +1714,25 @@ supported on the CPU specified. The choices for @var{cpu_type} are: @item @samp{.cmpccxadd} @tab @samp{.wrmsrns} @tab @samp{.msrlist} @item @samp{.avx_ne_convert} @tab @samp{.rao_int} @tab @samp{.fred} @tab @samp{.lkgs} @item @samp{.avx_vnni_int16} @tab @samp{.sha512} @tab @samp{.sm3} @tab @samp{.sm4} -@item @samp{.pbndkb} @tab @samp{.user_msr} +@item @samp{.pbndkb} @tab @samp{.user_msr} @tab @samp{.msr_imm} @tab @samp{.avx10.2} +@item @samp{.movrs} @item @samp{.wbnoinvd} @tab @samp{.pconfig} @tab @samp{.waitpkg} @tab @samp{.cldemote} @item @samp{.shstk} @tab @samp{.gfni} @tab @samp{.vaes} @tab @samp{.vpclmulqdq} @item @samp{.movdiri} @tab @samp{.movdir64b} @tab @samp{.enqcmd} @tab @samp{.tsxldtrk} @item @samp{.amx_int8} @tab @samp{.amx_bf16} @tab @samp{.amx_fp16} -@item @samp{.amx_complex} @tab @samp{.amx_tile} +@item @samp{.amx_complex} @tab @samp{.amx_transpose} @tab @samp{.amx_tf32} +@item @samp{.amx_fp8} @tab @samp{.amx_movrs} @tab @samp{.amx_avx512} +@item @samp{.amx_tile} @item @samp{.kl} @tab @samp{.widekl} @tab @samp{.uintr} @tab @samp{.hreset} @item @samp{.3dnow} @tab @samp{.3dnowa} @tab @samp{.sse4a} @tab @samp{.sse5} @item @samp{.syscall} @tab @samp{.rdtscp} @tab @samp{.svme} @item @samp{.lwp} @tab @samp{.fma4} @tab @samp{.xop} @tab @samp{.cx16} @item @samp{.padlock} @tab @samp{.clzero} @tab @samp{.mwaitx} @tab @samp{.rdpru} @item @samp{.mcommit} @tab @samp{.sev_es} @tab @samp{.snp} @tab @samp{.invlpgb} -@item @samp{.tlbsync} @tab @samp{.apx_f} +@item @samp{.tlbsync} @tab @samp{.rmpquery} @tab @samp{.rmpread} @tab @samp{.apx_f} +@item @samp{.gmism2} @tab @samp{.gmiccs} @tab @samp{.padlockrng2} @tab @samp{.padlockphe2} +@item @samp{.padlockxmodx} + @end multitable Apart from the warning, there are only two other effects on diff --git a/gas/doc/c-ia64.texi b/gas/doc/c-ia64.texi index 1f18553..54f7d81 100644 --- a/gas/doc/c-ia64.texi +++ b/gas/doc/c-ia64.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2002-2024 Free Software Foundation, Inc. +@c Copyright (C) 2002-2025 Free Software Foundation, Inc. @c Contributed by David Mosberger-Tang <davidm@hpl.hp.com> @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-ip2k.texi b/gas/doc/c-ip2k.texi index fb95a81..6a923d3 100644 --- a/gas/doc/c-ip2k.texi +++ b/gas/doc/c-ip2k.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2002-2024 Free Software Foundation, Inc. +@c Copyright (C) 2002-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-kvx.texi b/gas/doc/c-kvx.texi index 5baec01..228c8d3 100644 --- a/gas/doc/c-kvx.texi +++ b/gas/doc/c-kvx.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2023-2024 Free Software Foundation, Inc. +@c Copyright (C) 2023-2025 Free Software Foundation, Inc. @c Contributed by Kalray SA. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-lm32.texi b/gas/doc/c-lm32.texi index a863a48..8caf936 100644 --- a/gas/doc/c-lm32.texi +++ b/gas/doc/c-lm32.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2008-2024 Free Software Foundation, Inc. +@c Copyright (C) 2008-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-loongarch.texi b/gas/doc/c-loongarch.texi index da8d5c9..61ad348d 100644 --- a/gas/doc/c-loongarch.texi +++ b/gas/doc/c-loongarch.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2021-2024 Free Software Foundation, Inc. +@c Copyright (C) 2021-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo @c man end diff --git a/gas/doc/c-m32c.texi b/gas/doc/c-m32c.texi index 06a547e..da9d58f 100644 --- a/gas/doc/c-m32c.texi +++ b/gas/doc/c-m32c.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2005-2024 Free Software Foundation, Inc. +@c Copyright (C) 2005-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-m32r.texi b/gas/doc/c-m32r.texi index 0302220..a271135 100644 --- a/gas/doc/c-m32r.texi +++ b/gas/doc/c-m32r.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-m68hc11.texi b/gas/doc/c-m68hc11.texi index 32501e6..c149424 100644 --- a/gas/doc/c-m68hc11.texi +++ b/gas/doc/c-m68hc11.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-m68k.texi b/gas/doc/c-m68k.texi index ff72475..4a4fc8a 100644 --- a/gas/doc/c-m68k.texi +++ b/gas/doc/c-m68k.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-metag.texi b/gas/doc/c-metag.texi index 2ab42d4..4cae23e 100644 --- a/gas/doc/c-metag.texi +++ b/gas/doc/c-metag.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2013-2024 Free Software Foundation, Inc. +@c Copyright (C) 2013-2025 Free Software Foundation, Inc. @c Contributed by Imagination Technologies Ltd. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-microblaze.texi b/gas/doc/c-microblaze.texi index 4f84499..973294e 100644 --- a/gas/doc/c-microblaze.texi +++ b/gas/doc/c-microblaze.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2009-2024 Free Software Foundation, Inc. +@c Copyright (C) 2009-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-mips.texi b/gas/doc/c-mips.texi index f3c1f66..f4a2270 100644 --- a/gas/doc/c-mips.texi +++ b/gas/doc/c-mips.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC @@ -588,10 +588,12 @@ directive to the beginning of the source file. @xref{MIPS NaN Encodings}. @c FIXME! (1) reflect these options (next item too) in option summaries; @c (2) stop teasing, say _which_ instructions expanded _how_. @code{@value{AS}} automatically macro expands certain division and -multiplication instructions to check for overflow and division by zero. This -option causes @code{@value{AS}} to generate code to take a trap exception -rather than a break exception when an error is detected. The trap instructions -are only supported at Instruction Set Architecture level 2 and higher. +multiplication instructions to check for overflow and division by zero. +This option causes @code{@value{AS}} to generate code to take a trap +exception rather than a break exception when an error is detected and the +ISA selected for assembly at the originating place in source code permits +the use of trap instructions. The trap instructions are only supported at +Instruction Set Architecture level 2 and higher. @item --break @itemx --no-trap diff --git a/gas/doc/c-mmix.texi b/gas/doc/c-mmix.texi index 644e49d..0b7e670 100644 --- a/gas/doc/c-mmix.texi +++ b/gas/doc/c-mmix.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2001-2024 Free Software Foundation, Inc. +@c Copyright (C) 2001-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c MMIX description by Hans-Peter Nilsson, hp@bitrange.com diff --git a/gas/doc/c-msp430.texi b/gas/doc/c-msp430.texi index 0de40b5..ef911e3 100644 --- a/gas/doc/c-msp430.texi +++ b/gas/doc/c-msp430.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2002-2024 Free Software Foundation, Inc. +@c Copyright (C) 2002-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-mt.texi b/gas/doc/c-mt.texi index 3ffd520..4d509a5 100644 --- a/gas/doc/c-mt.texi +++ b/gas/doc/c-mt.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1996-2024 Free Software Foundation, Inc. +@c Copyright (C) 1996-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-nds32.texi b/gas/doc/c-nds32.texi index 36657bb..b8f9f60 100644 --- a/gas/doc/c-nds32.texi +++ b/gas/doc/c-nds32.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2013-2024 Free Software Foundation, Inc. +@c Copyright (C) 2013-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-nios2.texi b/gas/doc/c-nios2.texi deleted file mode 100644 index abdd561..0000000 --- a/gas/doc/c-nios2.texi +++ /dev/null @@ -1,267 +0,0 @@ -@c Copyright (C) 2012-2024 Free Software Foundation, Inc. -@c This is part of the GAS manual. -@c For copying conditions, see the file as.texinfo. -@c man end -@ifset GENERIC -@page -@node NiosII-Dependent -@chapter Nios II Dependent Features -@end ifset -@ifclear GENERIC -@node Machine Dependencies -@chapter Nios II Dependent Features -@end ifclear - -@cindex Altera Nios II support -@cindex Nios support -@cindex Nios II support -@menu -* Nios II Options:: Options -* Nios II Syntax:: Syntax -* Nios II Relocations:: Relocations -* Nios II Directives:: Nios II Machine Directives -* Nios II Opcodes:: Opcodes -@end menu - -@node Nios II Options -@section Options -@cindex Nios II options -@cindex options for Nios II - -@c man begin OPTIONS -@table @gcctabopt - -@cindex @code{relax-section} command-line option, Nios II -@item -relax-section -Replace identified out-of-range branches with PC-relative @code{jmp} -sequences when possible. The generated code sequences are suitable -for use in position-independent code, but there is a practical limit -on the extended branch range because of the length of the sequences. -This option is the default. - -@cindex @code{relax-all} command-line option, Nios II -@item -relax-all -Replace branch instructions not determinable to be in range -and all call instructions with @code{jmp} and @code{callr} sequences -(respectively). This option generates absolute relocations against the -target symbols and is not appropriate for position-independent code. - -@cindex @code{no-relax} command-line option, Nios II -@item -no-relax -Do not replace any branches or calls. - -@cindex @code{EB} command-line option, Nios II -@item -EB -Generate big-endian output. - -@cindex @code{EL} command-line option, Nios II -@item -EL -Generate little-endian output. This is the default. - -@cindex @code{march} command-line option, Nios II -@item -march=@var{architecture} -This option specifies the target architecture. The assembler issues -an error message if an attempt is made to assemble an instruction which -will not execute on the target architecture. The following architecture -names are recognized: -@code{r1}, -@code{r2}. -The default is @code{r1}. - -@end table -@c man end - -@node Nios II Syntax -@section Syntax -@menu -* Nios II Chars:: Special Characters -@end menu - - -@node Nios II Chars -@subsection Special Characters - -@cindex line comment character, Nios II -@cindex Nios II line comment character -@cindex line separator character, Nios II -@cindex Nios II line separator character -@samp{#} is the line comment character. -@samp{;} is the line separator character. - - -@node Nios II Relocations -@section Nios II Machine Relocations - -@cindex machine relocations, Nios II -@cindex Nios II machine relocations - -@table @code -@cindex @code{hiadj} directive, Nios II -@item %hiadj(@var{expression}) -Extract the upper 16 bits of @var{expression} and add -one if the 15th bit is set. - -The value of @code{%hiadj(@var{expression})} is: -@smallexample -((@var{expression} >> 16) & 0xffff) + ((@var{expression} >> 15) & 0x01) -@end smallexample - -The @code{%hiadj} relocation is intended to be used with -the @code{addi}, @code{ld} or @code{st} instructions -along with a @code{%lo}, in order to load a 32-bit constant. - -@smallexample -movhi r2, %hiadj(symbol) -addi r2, r2, %lo(symbol) -@end smallexample - -@cindex @code{hi} directive, Nios II -@item %hi(@var{expression}) -Extract the upper 16 bits of @var{expression}. - -@cindex @code{lo} directive, Nios II -@item %lo(@var{expression}) -Extract the lower 16 bits of @var{expression}. - -@cindex @code{gprel} directive, Nios II -@item %gprel(@var{expression}) -Subtract the value of the symbol @code{_gp} from -@var{expression}. - -The intention of the @code{%gprel} relocation is -to have a fast small area of memory which only -takes a 16-bit immediate to access. - -@smallexample - .section .sdata -fastint: - .int 123 - .section .text - ldw r4, %gprel(fastint)(gp) -@end smallexample - -@cindex @code{call} directive, Nios II -@cindex @code{call_lo} directive, Nios II -@cindex @code{call_hiadj} directive, Nios II -@cindex @code{got} directive, Nios II -@cindex @code{got_lo} directive, Nios II -@cindex @code{got_hiadj} directive, Nios II -@cindex @code{gotoff} directive, Nios II -@cindex @code{gotoff_lo} directive, Nios II -@cindex @code{gotoff_hiadj} directive, Nios II -@cindex @code{tls_gd} directive, Nios II -@cindex @code{tls_ie} directive, Nios II -@cindex @code{tls_le} directive, Nios II -@cindex @code{tls_ldm} directive, Nios II -@cindex @code{tls_ldo} directive, Nios II -@item %call(@var{expression}) -@item %call_lo(@var{expression}) -@item %call_hiadj(@var{expression}) -@itemx %got(@var{expression}) -@itemx %got_lo(@var{expression}) -@itemx %got_hiadj(@var{expression}) -@itemx %gotoff(@var{expression}) -@itemx %gotoff_lo(@var{expression}) -@itemx %gotoff_hiadj(@var{expression}) -@itemx %tls_gd(@var{expression}) -@itemx %tls_ie(@var{expression}) -@itemx %tls_le(@var{expression}) -@itemx %tls_ldm(@var{expression}) -@itemx %tls_ldo(@var{expression}) - -These relocations support the ABI for Linux Systems documented in the -@cite{Nios II Processor Reference Handbook}. -@end table - - -@node Nios II Directives -@section Nios II Machine Directives - -@cindex machine directives, Nios II -@cindex Nios II machine directives - -@table @code - -@cindex @code{align} directive, Nios II -@item .align @var{expression} [, @var{expression}] -This is the generic @code{.align} directive, however -this aligns to a power of two. - -@cindex @code{half} directive, Nios II -@item .half @var{expression} -Create an aligned constant 2 bytes in size. - -@cindex @code{word} directive, Nios II -@item .word @var{expression} -Create an aligned constant 4 bytes in size. - -@cindex @code{dword} directive, Nios II -@item .dword @var{expression} -Create an aligned constant 8 bytes in size. - -@cindex @code{2byte} directive, Nios II -@item .2byte @var{expression} -Create an unaligned constant 2 bytes in size. - -@cindex @code{4byte} directive, Nios II -@item .4byte @var{expression} -Create an unaligned constant 4 bytes in size. - -@cindex @code{8byte} directive, Nios II -@item .8byte @var{expression} -Create an unaligned constant 8 bytes in size. - -@cindex @code{16byte} directive, Nios II -@item .16byte @var{expression} -Create an unaligned constant 16 bytes in size. - -@cindex @code{set noat} directive, Nios II -@item .set noat -Allows assembly code to use @code{at} register without -warning. Macro or relaxation expansions -generate warnings. - -@cindex @code{set at} directive, Nios II -@item .set at -Assembly code using @code{at} register generates -warnings, and macro expansion and relaxation are -enabled. - -@cindex @code{set nobreak} directive, Nios II -@item .set nobreak -Allows assembly code to use @code{ba} and @code{bt} -registers without warning. - -@cindex @code{set break} directive, Nios II -@item .set break -Turns warnings back on for using @code{ba} and @code{bt} -registers. - -@cindex @code{set norelax} directive, Nios II -@item .set norelax -Do not replace any branches or calls. - -@cindex @code{set relaxsection} directive, Nios II -@item .set relaxsection -Replace identified out-of-range branches with -@code{jmp} sequences (default). - -@cindex @code{set relaxall} directive, Nios II -@item .set relaxsection -Replace all branch and call instructions with -@code{jmp} and @code{callr} sequences. - -@cindex @code{set} directive, Nios II -@item .set @dots{} -All other @code{.set} are the normal use. - -@end table - -@node Nios II Opcodes -@section Opcodes - -@cindex Nios II opcodes -@cindex opcodes for Nios II -@code{@value{AS}} implements all the standard Nios II opcodes documented in the -@cite{Nios II Processor Reference Handbook}, including the assembler -pseudo-instructions. diff --git a/gas/doc/c-ns32k.texi b/gas/doc/c-ns32k.texi index 33954b5..6a6380f 100644 --- a/gas/doc/c-ns32k.texi +++ b/gas/doc/c-ns32k.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-or1k.texi b/gas/doc/c-or1k.texi index 1babfe9..f910ef8 100644 --- a/gas/doc/c-or1k.texi +++ b/gas/doc/c-or1k.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-pdp11.texi b/gas/doc/c-pdp11.texi index 3ce32d7..2658ad2 100644 --- a/gas/doc/c-pdp11.texi +++ b/gas/doc/c-pdp11.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2001-2024 Free Software Foundation, Inc. +@c Copyright (C) 2001-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-pj.texi b/gas/doc/c-pj.texi index ef6b8ae..7d8fbb1 100644 --- a/gas/doc/c-pj.texi +++ b/gas/doc/c-pj.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1999-2024 Free Software Foundation, Inc. +@c Copyright (C) 1999-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @page diff --git a/gas/doc/c-ppc.texi b/gas/doc/c-ppc.texi index c8cabde..fabc594 100644 --- a/gas/doc/c-ppc.texi +++ b/gas/doc/c-ppc.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2001-2024 Free Software Foundation, Inc. +@c Copyright (C) 2001-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-pru.texi b/gas/doc/c-pru.texi index e77d5cc..48454cc 100644 --- a/gas/doc/c-pru.texi +++ b/gas/doc/c-pru.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2015-2024 Free Software Foundation, Inc. +@c Copyright (C) 2015-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-riscv.texi b/gas/doc/c-riscv.texi index d396669..86cea38 100644 --- a/gas/doc/c-riscv.texi +++ b/gas/doc/c-riscv.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2016-2024 Free Software Foundation, Inc. +@c Copyright (C) 2016-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo @c man end @@ -139,12 +139,13 @@ meant to be used by the compiler in shared libraries for DWARF debug info for thread local variables. @cindex LEB128 directives -@item .uleb128 @var{value} -@itemx .sleb128 @var{value} -Emits a signed or unsigned LEB128 value at the current position. This only +@item .uleb128 @var{values} +@itemx .sleb128 @var{values} +Emits signed or unsigned LEB128 values at the current position. This only accepts constant expressions, because symbol addresses can change with relaxation, and we don't support relocations to modify LEB128 values at link -time. +time. An exception are differences between symbols, which may be used with +@code{.uleb128}. @cindex Option directive @cindex @code{option} directive @@ -178,7 +179,12 @@ instead of just It's not expected that options are changed in this manner during regular use, but there are a handful of esoteric cases like the one above where users need to disable particular features of the assembler for particular code sequences. -The complete list of option arguments is shown below: +However, it's also useful to enable/disable the extensions for some specific +code regions by @samp{.option arch, +-}. This is very common in the ifunc +libraries. We can support functions which are implemented by different +extensions in the same library, but these should not affect any file-level +settings, like the elf architecture attribute. The complete list of option +arguments is shown below: @table @code @item push @@ -250,6 +256,16 @@ The @var{tag} is either an attribute number, or one of the following: @code{Tag_RISCV_unaligned_access}, @code{Tag_RISCV_priv_spec}, @code{Tag_RISCV_priv_spec_minor}, @code{Tag_RISCV_priv_spec_revision}. +@cindex @code{.bfloat16} directive, RISC-V +@item .bfloat16 @var{value} +Floating point constructors for the bfloat16 type, example usage: + +@smallexample + .bfloat16 12.0 + .bfloat16 NaN + .bfloat16 0b:ffc1 +@end smallexample + @end table @node RISC-V-Modifiers @@ -437,11 +453,11 @@ instruction formats: @multitable @columnfractions .15 .40 @item opcode7 @tab Unsigned immediate or opcode name for 7-bits opcode. @item opcode2 @tab Unsigned immediate or opcode name for 2-bits opcode. -@item func7 @tab Unsigned immediate for 7-bits function code. -@item func6 @tab Unsigned immediate for 6-bits function code. -@item func4 @tab Unsigned immediate for 4-bits function code. -@item func3 @tab Unsigned immediate for 3-bits function code. -@item func2 @tab Unsigned immediate for 2-bits function code. +@item funct7 @tab Unsigned immediate for 7-bits function code. +@item funct6 @tab Unsigned immediate for 6-bits function code. +@item funct4 @tab Unsigned immediate for 4-bits function code. +@item funct3 @tab Unsigned immediate for 3-bits function code. +@item funct2 @tab Unsigned immediate for 2-bits function code. @item rd @tab Destination register number for operand x, can be GPR or FPR. @item rd' @tab Destination register number for operand x, only accept s0-s1, a0-a5, fs0-fs1 and fa0-fa5. @@ -532,6 +548,12 @@ Opcode space for misc instructions. @item SYSTEM Opcode space for system instructions. +@item OP_V +Opcode space for vector instructions. + +@item OP_VE +Opcode space for crypto vector instructions. + @item CUSTOM_0 @item CUSTOM_1 @item CUSTOM_2 @@ -549,47 +571,47 @@ The following table lists the RISC-V instruction formats that are available with the @samp{.insn} pseudo directive: @table @code -@item R type: .insn r opcode7, func3, func7, rd, rs1, rs2 +@item R type: .insn r opcode7, funct3, funct7, rd, rs1, rs2 @verbatim -+-------+-----+-----+-------+----+---------+ -| func7 | rs2 | rs1 | func3 | rd | opcode7 | -+-------+-----+-----+-------+----+---------+ -31 25 20 15 12 7 0 ++--------+-----+-----+--------+----+---------+ +| funct7 | rs2 | rs1 | funct3 | rd | opcode7 | ++--------+-----+-----+--------+----+---------+ +31 25 20 15 12 7 0 @end verbatim -@item R type with 4 register operands: .insn r opcode7, func3, func2, rd, rs1, rs2, rs3 -@itemx R4 type: .insn r4 opcode7, func3, func2, rd, rs1, rs2, rs3 +@item R type with 4 register operands: .insn r opcode7, funct3, funct2, rd, rs1, rs2, rs3 +@itemx R4 type: .insn r4 opcode7, funct3, funct2, rd, rs1, rs2, rs3 @verbatim -+-----+-------+-----+-----+-------+----+---------+ -| rs3 | func2 | rs2 | rs1 | func3 | rd | opcode7 | -+-----+-------+-----+-----+-------+----+---------+ -31 27 25 20 15 12 7 0 ++-----+--------+-----+-----+--------+----+---------+ +| rs3 | funct2 | rs2 | rs1 | funct3 | rd | opcode7 | ++-----+--------+-----+-----+--------+----+---------+ +31 27 25 20 15 12 7 0 @end verbatim -@item I type: .insn i opcode7, func3, rd, rs1, simm12 -@itemx I type: .insn i opcode7, func3, rd, simm12(rs1) +@item I type: .insn i opcode7, funct3, rd, rs1, simm12 +@itemx I type: .insn i opcode7, funct3, rd, simm12(rs1) @verbatim -+--------------+-----+-------+----+---------+ -| simm12[11:0] | rs1 | func3 | rd | opcode7 | -+--------------+-----+-------+----+---------+ -31 20 15 12 7 0 ++--------------+-----+--------+----+---------+ +| simm12[11:0] | rs1 | funct3 | rd | opcode7 | ++--------------+-----+--------+----+---------+ +31 20 15 12 7 0 @end verbatim -@item S type: .insn s opcode7, func3, rs2, simm12(rs1) +@item S type: .insn s opcode7, funct3, rs2, simm12(rs1) @verbatim -+--------------+-----+-----+-------+-------------+---------+ -| simm12[11:5] | rs2 | rs1 | func3 | simm12[4:0] | opcode7 | -+--------------+-----+-----+-------+-------------+---------+ -31 25 20 15 12 7 0 ++--------------+-----+-----+--------+-------------+---------+ +| simm12[11:5] | rs2 | rs1 | funct3 | simm12[4:0] | opcode7 | ++--------------+-----+-----+--------+-------------+---------+ +31 25 20 15 12 7 0 @end verbatim -@item B type: .insn s opcode7, func3, rs1, rs2, symbol -@itemx SB type: .insn sb opcode7, func3, rs1, rs2, symbol +@item B type: .insn s opcode7, funct3, rs1, rs2, symbol +@itemx SB type: .insn sb opcode7, funct3, rs1, rs2, symbol @verbatim -+-----------------+-----+-----+-------+----------------+---------+ -| simm12[12|10:5] | rs2 | rs1 | func3 | simm12[4:1|11] | opcode7 | -+-----------------+-----+-----+-------+----------------+---------+ -31 25 20 15 12 7 0 ++-----------------+-----+-----+--------+----------------+---------+ +| simm12[12|10:5] | rs2 | rs1 | funct3 | simm12[4:1|11] | opcode7 | ++-----------------+-----+-----+--------+----------------+---------+ +31 25 20 15 12 7 0 @end verbatim @item U type: .insn u opcode7, rd, simm20 @@ -609,76 +631,76 @@ with the @samp{.insn} pseudo directive: 31 30 21 20 12 7 0 @end verbatim -@item CR type: .insn cr opcode2, func4, rd, rs2 +@item CR type: .insn cr opcode2, funct4, rd, rs2 @verbatim -+-------+--------+-----+---------+ -| func4 | rd/rs1 | rs2 | opcode2 | -+-------+--------+-----+---------+ -15 12 7 2 0 ++--------+--------+-----+---------+ +| funct4 | rd/rs1 | rs2 | opcode2 | ++--------+--------+-----+---------+ +15 12 7 2 0 @end verbatim -@item CI type: .insn ci opcode2, func3, rd, simm6 +@item CI type: .insn ci opcode2, funct3, rd, simm6 @verbatim -+-------+----------+--------+------------+---------+ -| func3 | simm6[5] | rd/rs1 | simm6[4:0] | opcode2 | -+-------+----------+--------+------------+---------+ -15 13 12 7 2 0 ++--------+----------+--------+------------+---------+ +| funct3 | simm6[5] | rd/rs1 | simm6[4:0] | opcode2 | ++--------+----------+--------+------------+---------+ +15 13 12 7 2 0 @end verbatim -@item CIW type: .insn ciw opcode2, func3, rd', uimm8 +@item CIW type: .insn ciw opcode2, funct3, rd', uimm8 @verbatim -+-------+------------+-----+---------+ -| func3 | uimm8[7:0] | rd' | opcode2 | -+-------+-------- ---+-----+---------+ -15 13 5 2 0 ++--------+------------+-----+---------+ +| funct3 | uimm8[7:0] | rd' | opcode2 | ++--------+-------- ---+-----+---------+ +15 13 5 2 0 @end verbatim -@item CSS type: .insn css opcode2, func3, rd, uimm6 +@item CSS type: .insn css opcode2, funct3, rd, uimm6 @verbatim -+-------+------------+----+---------+ -| func3 | uimm6[5:0] | rd | opcode2 | -+-------+------------+----+---------+ -15 13 7 2 0 ++--------+------------+----+---------+ +| funct3 | uimm6[5:0] | rd | opcode2 | ++--------+------------+----+---------+ +15 13 7 2 0 @end verbatim -@item CL type: .insn cl opcode2, func3, rd', uimm5(rs1') +@item CL type: .insn cl opcode2, funct3, rd', uimm5(rs1') @verbatim -+-------+------------+------+------------+------+---------+ -| func3 | uimm5[4:2] | rs1' | uimm5[1:0] | rd' | opcode2 | -+-------+------------+------+------------+------+---------+ -15 13 10 7 5 2 0 ++--------+------------+------+------------+------+---------+ +| funct3 | uimm5[4:2] | rs1' | uimm5[1:0] | rd' | opcode2 | ++--------+------------+------+------------+------+---------+ +15 13 10 7 5 2 0 @end verbatim -@item CS type: .insn cs opcode2, func3, rs2', uimm5(rs1') +@item CS type: .insn cs opcode2, funct3, rs2', uimm5(rs1') @verbatim -+-------+------------+------+------------+------+---------+ -| func3 | uimm5[4:2] | rs1' | uimm5[1:0] | rs2' | opcode2 | -+-------+------------+------+------------+------+---------+ -15 13 10 7 5 2 0 ++--------+------------+------+------------+------+---------+ +| funct3 | uimm5[4:2] | rs1' | uimm5[1:0] | rs2' | opcode2 | ++--------+------------+------+------------+------+---------+ +15 13 10 7 5 2 0 @end verbatim -@item CA type: .insn ca opcode2, func6, func2, rd', rs2' +@item CA type: .insn ca opcode2, funct6, funct2, rd', rs2' @verbatim -+-- ----+----------+-------+------+---------+ -| func6 | rd'/rs1' | func2 | rs2' | opcode2 | -+-------+----------+-------+------+---------+ -15 10 7 5 2 0 ++--------+----------+--------+------+---------+ +| funct6 | rd'/rs1' | funct2 | rs2' | opcode2 | ++--------+----------+--------+------+---------+ +15 10 7 5 2 0 @end verbatim -@item CB type: .insn cb opcode2, func3, rs1', symbol +@item CB type: .insn cb opcode2, funct3, rs1', symbol @verbatim -+-------+--------------+------+------------------+---------+ -| func3 | simm8[8|4:3] | rs1' | simm8[7:6|2:1|5] | opcode2 | -+-------+--------------+------+------------------+---------+ -15 13 10 7 2 0 ++--------+--------------+------+------------------+---------+ +| funct3 | simm8[8|4:3] | rs1' | simm8[7:6|2:1|5] | opcode2 | ++--------+--------------+------+------------------+---------+ +15 13 10 7 2 0 @end verbatim -@item CJ type: .insn cj opcode2, func3, symbol +@item CJ type: .insn cj opcode2, funct3, symbol @verbatim -+-------+-------------------------------+---------+ -| func3 | simm11[11|4|9:8|10|6|7|3:1|5] | opcode2 | -+-------+-------------------------------+---------+ -15 13 2 0 ++--------+-------------------------------+---------+ +| funct3 | simm11[11|4|9:8|10|6|7|3:1|5] | opcode2 | ++--------+-------------------------------+---------+ +15 13 2 0 @end verbatim @@ -740,13 +762,18 @@ extensions supported and provides the location of their publicly-released documentation: @table @r -@item XCvMac -The XCvMac extension provides instructions for multiply-accumulate operations. +@item XCvAlu +The XCvAlu extension provides instructions for general ALU operations. It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} -@item XCvAlu -The XCvAlu extension provides instructions for general ALU operations. +@item XCvBi +The XCvBi extension provides instructions for branch immediate operations. + +It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} + +@item XCvBitmanip +The XCvBitmanip extension provides instructions for bitmanip operations. It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} @@ -755,8 +782,8 @@ The XCvElw extension provides instructions for event load word operations. It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} -@item XCvBi -The XCvBi extension provides instructions for branch immediate operations. +@item XCvMac +The XCvMac extension provides instructions for multiply-accumulate operations. It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} @@ -765,6 +792,11 @@ The XCvMem extension provides instructions for post inc load/store operations. It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} +@item XcvSimd +The XcvSimd extension provides instructions for SIMD operations. + +It is documented in @url{https://docs.openhwgroup.org/projects/cv32e40p-user-manual/en/latest/instruction_set_extensions.html} + @item XTheadBa The XTheadBa extension provides instructions for address calculations. diff --git a/gas/doc/c-rl78.texi b/gas/doc/c-rl78.texi index 015786b..94c1caf 100644 --- a/gas/doc/c-rl78.texi +++ b/gas/doc/c-rl78.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2011-2024 Free Software Foundation, Inc. +@c Copyright (C) 2011-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-rx.texi b/gas/doc/c-rx.texi index 71eccb3..39613f5 100644 --- a/gas/doc/c-rx.texi +++ b/gas/doc/c-rx.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2008-2024 Free Software Foundation, Inc. +@c Copyright (C) 2008-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-s12z.texi b/gas/doc/c-s12z.texi index 82e163f..1b76eeb 100644 --- a/gas/doc/c-s12z.texi +++ b/gas/doc/c-s12z.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2018-2024 Free Software Foundation, Inc. +@c Copyright (C) 2018-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-s390.texi b/gas/doc/c-s390.texi index f73dfde..f1a5483 100644 --- a/gas/doc/c-s390.texi +++ b/gas/doc/c-s390.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2009-2024 Free Software Foundation, Inc. +@c Copyright (C) 2009-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC @@ -18,7 +18,7 @@ and eleven chip levels. The architecture modes are the Enterprise System Architecture (ESA) and the newer z/Architecture mode. The chip levels are g5 (or arch3), g6, z900 (or arch5), z990 (or arch6), z9-109, z9-ec (or arch7), z10 (or arch8), z196 (or arch9), zEC12 (or arch10), z13 -(or arch11), z14 (or arch12), z15 (or arch13), or z16 (or arch14). +(or arch11), z14 (or arch12), z15 (or arch13), z16 (or arch14), or arch15. @menu * s390 Options:: Command-line Options. @@ -71,8 +71,9 @@ are recognized: @code{zEC12} (or @code{arch10}), @code{z13} (or @code{arch11}), @code{z14} (or @code{arch12}), -@code{z15} (or @code{arch13}), and -@code{z16} (or @code{arch14}). +@code{z15} (or @code{arch13}), +@code{z16} (or @code{arch14}), and +@code{arch15}. Assembling an instruction that is not supported on the target processor results in an error message. @@ -300,10 +301,11 @@ field. The notation changes as follows: @display @multitable @columnfractions 0.30 0.30 @headitem full notation @tab short notation -@item Dn(0,Bn) @tab Dn(Bn) +@item Dn(Xn,0) @tab Dn(Xn,) +@item Dn(0,Bn) @tab Dn(,Bn) or Dn(Bn) @item Dn(0,0) @tab Dn @item Dn(0) @tab Dn -@item Dn(Ln,0) @tab Dn(Ln) +@item Dn(Ln,0) @tab Dn(Ln,) or Dn(Ln) @end multitable @end display diff --git a/gas/doc/c-score.texi b/gas/doc/c-score.texi index d4a8877..bba6b27 100644 --- a/gas/doc/c-score.texi +++ b/gas/doc/c-score.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2009-2024 Free Software Foundation, Inc. +@c Copyright (C) 2009-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-sh.texi b/gas/doc/c-sh.texi index 9a33450..3785e39 100644 --- a/gas/doc/c-sh.texi +++ b/gas/doc/c-sh.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @page diff --git a/gas/doc/c-sparc.texi b/gas/doc/c-sparc.texi index df3cc36..700d7fa 100644 --- a/gas/doc/c-sparc.texi +++ b/gas/doc/c-sparc.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-tic54x.texi b/gas/doc/c-tic54x.texi index 255fb11..c1f65a6 100644 --- a/gas/doc/c-tic54x.texi +++ b/gas/doc/c-tic54x.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2000-2024 Free Software Foundation, Inc. +@c Copyright (C) 2000-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c TI TMS320C54X description by Timothy Wall, twall@cygnus.com diff --git a/gas/doc/c-tic6x.texi b/gas/doc/c-tic6x.texi index 7897094..045777f 100644 --- a/gas/doc/c-tic6x.texi +++ b/gas/doc/c-tic6x.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2010-2024 Free Software Foundation, Inc. +@c Copyright (C) 2010-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-tilegx.texi b/gas/doc/c-tilegx.texi index 704f106..aa3db33 100644 --- a/gas/doc/c-tilegx.texi +++ b/gas/doc/c-tilegx.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2011-2024 Free Software Foundation, Inc. +@c Copyright (C) 2011-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-tilepro.texi b/gas/doc/c-tilepro.texi index 648b718..afec578 100644 --- a/gas/doc/c-tilepro.texi +++ b/gas/doc/c-tilepro.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2011-2024 Free Software Foundation, Inc. +@c Copyright (C) 2011-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-v850.texi b/gas/doc/c-v850.texi index 18accc5..af6293a 100644 --- a/gas/doc/c-v850.texi +++ b/gas/doc/c-v850.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1997-2024 Free Software Foundation, Inc. +@c Copyright (C) 1997-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-vax.texi b/gas/doc/c-vax.texi index 3e54dbd..187f67d 100644 --- a/gas/doc/c-vax.texi +++ b/gas/doc/c-vax.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c VAX/VMS description enhanced and corrected by Klaus K"aempf, kkaempf@progis.de diff --git a/gas/doc/c-visium.texi b/gas/doc/c-visium.texi index c29db28..e00d9f8 100644 --- a/gas/doc/c-visium.texi +++ b/gas/doc/c-visium.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2014-2024 Free Software Foundation, Inc. +@c Copyright (C) 2014-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-wasm32.texi b/gas/doc/c-wasm32.texi index f5787b1..aaf71e4 100644 --- a/gas/doc/c-wasm32.texi +++ b/gas/doc/c-wasm32.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2017-2024 Free Software Foundation, Inc. +@c Copyright (C) 2017-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c man end diff --git a/gas/doc/c-xgate.texi b/gas/doc/c-xgate.texi index 006e971..ba7c666 100644 --- a/gas/doc/c-xgate.texi +++ b/gas/doc/c-xgate.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2012-2024 Free Software Foundation, Inc. +@c Copyright (C) 2012-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/c-xstormy16.texi b/gas/doc/c-xstormy16.texi index 402f03f..5c9660e 100644 --- a/gas/doc/c-xstormy16.texi +++ b/gas/doc/c-xstormy16.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2010-2024 Free Software Foundation, Inc. +@c Copyright (C) 2010-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-xtensa.texi b/gas/doc/c-xtensa.texi index b75ec1f..5e312b3 100644 --- a/gas/doc/c-xtensa.texi +++ b/gas/doc/c-xtensa.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2002-2024 Free Software Foundation, Inc. +@c Copyright (C) 2002-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @c diff --git a/gas/doc/c-z80.texi b/gas/doc/c-z80.texi index a1bd0d9..5225302 100644 --- a/gas/doc/c-z80.texi +++ b/gas/doc/c-z80.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2011-2024 Free Software Foundation, Inc. +@c Copyright (C) 2011-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/c-z8k.texi b/gas/doc/c-z8k.texi index 5ad3cd9..c202bb4 100644 --- a/gas/doc/c-z8k.texi +++ b/gas/doc/c-z8k.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. @ifset GENERIC diff --git a/gas/doc/h8.texi b/gas/doc/h8.texi index d43352c..07960bd 100644 --- a/gas/doc/h8.texi +++ b/gas/doc/h8.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2012-2024 Free Software Foundation, Inc. +@c Copyright (C) 2012-2025 Free Software Foundation, Inc. @c This is part of the GAS manual. @c For copying conditions, see the file as.texinfo. diff --git a/gas/doc/internals.texi b/gas/doc/internals.texi index e59d676..f5db1ed 100644 --- a/gas/doc/internals.texi +++ b/gas/doc/internals.texi @@ -1,5 +1,5 @@ \input texinfo -@c Copyright (C) 1991-2024 Free Software Foundation, Inc. +@c Copyright (C) 1991-2025 Free Software Foundation, Inc. @setfilename internals.info @node Top @top Assembler Internals @@ -814,7 +814,7 @@ zero if the target is little endian. @cindex md_show_usage @cindex md_after_parse_args GAS uses these variables and functions during option processing. -@code{md_shortopts} is a @code{const char *} which GAS adds to the machine +@code{md_shortopts} is a @code{const char []} which GAS adds to the machine independent string passed to @code{getopt}. @code{md_longopts} is a @code{struct option []} which GAS adds to the machine independent long options passed to @code{getopt}; you may use @code{OPTION_MD_BASE}, defined in diff --git a/gas/doc/local.mk b/gas/doc/local.mk index c83b98a..731b122 100644 --- a/gas/doc/local.mk +++ b/gas/doc/local.mk @@ -1,6 +1,6 @@ ## Process this file with automake to generate Makefile.in # -# Copyright (C) 2012-2024 Free Software Foundation, Inc. +# Copyright (C) 2012-2025 Free Software Foundation, Inc. # # This file is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by @@ -74,7 +74,6 @@ CPU_DOCS = \ %D%/c-mmix.texi \ %D%/c-mt.texi \ %D%/c-msp430.texi \ - %D%/c-nios2.texi \ %D%/c-nds32.texi \ %D%/c-ns32k.texi \ %D%/c-or1k.texi \ |