diff options
Diffstat (limited to 'gas/doc/as.texi')
| -rw-r--r-- | gas/doc/as.texi | 53 |
1 files changed, 50 insertions, 3 deletions
diff --git a/gas/doc/as.texi b/gas/doc/as.texi index 40d45f7..70c2540 100644 --- a/gas/doc/as.texi +++ b/gas/doc/as.texi @@ -260,7 +260,8 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. [@b{--sectname-subst}] [@b{--size-check=[error|warning]}] [@b{--statistics}] - [@b{-v}] [@b{-version}] [@b{--version}] + [@b{-v}] [@b{--verbose}] + [@b{-version}] [@b{--version}] [@b{-W}] [@b{--no-warn}] [@b{--warn}] [@b{--fatal-warnings}] [@b{-w}] [@b{-x}] [@b{-Z}] [@b{@@@var{FILE}}] @@ -552,7 +553,7 @@ gcc(1), ld(1), and the Info entries for @file{binutils} and @file{ld}. @emph{Target RISC-V options:} [@b{-fpic}|@b{-fPIC}|@b{-fno-pic}] - [@b{-march}=@var{ISA}] + [@b{-march}=@var{ISA}|@var{Profiles}|@var{Profiles_ISA}] [@b{-mabi}=@var{ABI}] [@b{-mlittle-endian}|@b{-mbig-endian}] @end ifset @@ -778,6 +779,10 @@ symbols with the @code{STT_COMMON} type. The default can be controlled by a configure option @option{--enable-elf-stt-common}. @end ifset +@item --emit-local-absolute +Emit even pre-defined (local) absolute symbols to the outgoing symbol table. +Note that this isn't the exact opposite of @samp{--strip-local-absolute}. + @item --emulation=@var{name} If the assembler is configured to support multiple different target configurations then this option can be used to select the desired form. @@ -975,10 +980,11 @@ assembly. Remove local absolute symbols from the outgoing symbol table. @item -v -@itemx -version +@itemx --verbose Print the @command{as} version. @item --version +@itemx -version Print the @command{as} version and exit. @item -W @@ -3907,6 +3913,7 @@ the same order they were declared. This may break some debuggers. * Symbol Names:: Symbol Names * Dot:: The Special Dot Symbol * Symbol Attributes:: Symbol Attributes +* Predefined Symbols:: Predefined Symbols @end menu @node Labels @@ -4248,6 +4255,30 @@ Language Reference Manual} (HP 92432-90001) under the @code{IMPORT} and @code{EXPORT} assembler directive documentation. @end ifset +@node Predefined Symbols +@section Predefined Symbols + +Certain pre-defined symbols will be made available for use, and possibly also +inserted in the symbol table. Because of the use of parentheses, access to +these symbols will require quotation. + +Independent of the specific target, the following symbols will (perhaps +conditionally; see each individual item) be made available: +@itemize @bullet + +@item @code{GAS(version)} +The version of the assembler, expressed as @samp{major} @code{*} 100000000 +@code{+} @samp{minor} @code{*} 1000000 @code{+} @samp{rev} @code{*} 10000. + +@item @code{GAS(date)} +The date of the assembler sources (which may not be the date the assembler was +built). This is added only for non-release versions of gas. The specific +value probably better isn't checked for, just its defined-ness. + +@end itemize + +All symbols of the form @code{GAS(...)} are reserved for use by GNU @value{AS}. + @node Expressions @chapter Expressions @@ -4551,6 +4582,7 @@ Some machine configurations provide additional directives. * Equiv:: @code{.equiv @var{symbol}, @var{expression}} * Eqv:: @code{.eqv @var{symbol}, @var{expression}} * Err:: @code{.err} +* Errif:: @code{.errif @var{expression}} * Error:: @code{.error @var{string}} * Exitm:: @code{.exitm} * Extern:: @code{.extern} @@ -4683,6 +4715,7 @@ Some machine configurations provide additional directives. * VTableInherit:: @code{.vtable_inherit @var{child}, @var{parent}} @end ifset +* Warnif:: @code{.warnif @var{expression}} * Warning:: @code{.warning @var{string}} * Weak:: @code{.weak @var{names}} * Weakref:: @code{.weakref @var{alias}, @var{symbol}} @@ -5526,6 +5559,13 @@ If @command{@value{AS}} assembles a @code{.err} directive, it will print an erro message and, unless the @option{-Z} option was used, it will not generate an object file. This can be used to signal an error in conditionally compiled code. +@node Errif +@section @code{.errif "@var{expression}"} +@cindex errif directive + +Record @var{expression} for evaluation at the end of assembly. Raise an error +if the expression evaluates to non-zero. + @node Error @section @code{.error "@var{string}"} @cindex error directive @@ -7719,6 +7759,13 @@ parent whose addend is the value of the child symbol. As a special case the parent name of @code{0} is treated as referring to the @code{*ABS*} section. @end ifset +@node Warnif +@section @code{.warnif "@var{expression}"} +@cindex errif directive + +Record @var{expression} for evaluation at the end of assembly. Raise a +warning if the expression evaluates to non-zero. + @node Warning @section @code{.warning "@var{string}"} @cindex warning directive |