Lines Matching refs:AS
57 @settitle Using @value{AS}
60 @settitle Using @value{AS} (@value{TARGET})
100 This file documents the GNU Assembler "@value{AS}".
116 @title Using @value{AS}
140 \hfill {\it Using {\tt @value{AS}}}\par
166 @top Using @value{AS}
168 This file is a user guide to the @sc{gnu} assembler @command{@value{AS}}
174 This version of the file describes @command{@value{AS}} configured to generate
197 * AS Index:: AS Index
204 This manual is a user guide to the @sc{gnu} assembler @command{@value{AS}}.
206 This version of the manual describes @command{@value{AS}} configured to generate
214 Here is a brief summary of how to invoke @command{@value{AS}}. For details,
217 @c man title AS the portable GNU assembler.
229 @value{AS} [@b{-a}[@b{cdghlns}][=@var{file}]] [@b{--alternate}] [@b{-D}]
595 include general information, like @value{AS} version and options passed
734 Name the object-file output from @command{@value{AS}} @var{objfile}.
793 @xref{AArch64 Options}, for the options available when @value{AS} is configured
799 The following options are available when @value{AS} is configured for the
812 @xref{Alpha Options}, for the options available when @value{AS} is configured
818 The following options are available when @value{AS} is configured for an Alpha
830 The following options are available when @value{AS} is configured for
842 The following options are available when @value{AS} is configured for the ARM
874 @xref{Blackfin Options}, for the options available when @value{AS} is
880 The following options are available when @value{AS} is configured for
896 The following options are available when @value{AS} is configured for
907 The following options are available when @value{AS} is configured for a D30V
927 The following options are available when @value{AS} is configured for the
931 @xref{Epiphany Options}, for the options available when @value{AS} is
937 The following options are available when @value{AS} is configured for
950 @xref{H8/300 Options}, for the options available when @value{AS} is configured
956 The following options are available when @value{AS} is configured for an H8/300
969 @xref{i386-Options}, for the options available when @value{AS} is
975 The following options are available when @value{AS} is configured for
987 The following options are available when @value{AS} is configured for the
1005 The following options are available when @value{AS} is configured for the
1021 The following options are available when @value{AS} is configured for the
1042 The following options are available when @value{AS} is configured for the
1063 The following options are available when @value{AS} is configured for the
1094 @xref{Nios II Options}, for the options available when @value{AS} is configured
1100 The following options are available when @value{AS} is configured for an
1141 The following options are available when @value{AS} is configured for
1160 The following options are available when @value{AS} is configured for the
1206 This option is only useful for testing @command{@value{AS}}.
1212 The following options are available when @command{@value{AS}} is configured
1236 The following options are available when @value{AS} is configured for the 'c54x
1252 The following options are available when @value{AS} is configured for
1465 @command{@value{AS}} ignores this option. It is accepted for compatibility with
1479 When this option is used, @command{@value{AS}} will issue a warning every
1485 The following options are available when @value{AS} is configured for
1519 @xref{Meta Options}, for the options available when @value{AS} is configured
1525 The following options are available when @value{AS} is configured for a
1543 @xref{NDS32 Options}, for the options available when @value{AS} is configured
1551 The following options are available when @value{AS} is configured for a
1563 @xref{PowerPC-Opts}, for the options available when @value{AS} is configured
1569 The following options are available when @value{AS} is configured for a
1585 The following options are available when @value{AS} is configured for the s390
1613 @xref{TIC6X Options}, for the options available when @value{AS} is configured
1619 The following options are available when @value{AS} is configured for a
1632 @xref{TILE-Gx Options}, for the options available when @value{AS} is configured
1638 The following options are available when @value{AS} is configured for a TILE-Gx
1651 @xref{Xtensa Options}, for the options available when @value{AS} is configured
1657 The following options are available when @value{AS} is configured for an
1670 The following options are available when @value{AS} is configured for
1715 @sc{gnu} @command{@value{AS}}. We cover the syntax expected in source files, including
1717 @command{@value{AS}} understands; and of course how to invoke @command{@value{AS}}.
1721 configuration of @command{@value{AS}}, including assembler directives.
1765 @command{@value{AS}} is part of a team of programs that turn a high-level
1768 @command{@value{AS}} are used for different kinds of computer.
1787 This manual describes @command{@value{AS}}, a member of that family which is
1797 @command{@value{AS}} is primarily intended to assemble the output of the
1799 @code{@value{LD}}. Nevertheless, we've tried to make @command{@value{AS}}
1808 This doesn't mean @command{@value{AS}} always uses the same syntax as another
1815 Unlike older assemblers, @command{@value{AS}} is designed to assemble a source
1830 For the @value{TARGET} target, @command{@value{AS}} is configured to produce
1835 On the @value{TARGET}, @command{@value{AS}} can be configured to produce either
1839 On the @value{TARGET}, @command{@value{AS}} can be configured to produce either
1849 After the program name @command{@value{AS}}, the command line may contain
1857 explicitly, as one of the files for @command{@value{AS}} to assemble.
1862 @command{@value{AS}}. No option changes the way another option works. An
1872 @value{AS} -o my-object-file.o mumble.s
1873 @value{AS} -omy-object-file.o mumble.s
1883 describe the program input to one run of @command{@value{AS}}. The program may
1893 Each time you run @command{@value{AS}} it assembles exactly one source
1897 You give @command{@value{AS}} a command line that has zero or more input file
1902 If you give @command{@value{AS}} no file names it attempts to read one input file
1903 from the @command{@value{AS}} standard input, which is normally your terminal. You
1904 may have to type @key{ctl-D} to tell @command{@value{AS}} there is no more program
1910 If the source is empty, @command{@value{AS}} produces a small, empty object
1925 to @command{@value{AS}}.
1929 error messages reflect the original source file, when @command{@value{AS}} source
1930 is itself synthesized from other files. @command{@value{AS}} understands the
1941 Every time you run @command{@value{AS}} it produces an output file, which is
1951 @code{b.out} when @command{@value{AS}} is configured for the Intel 80960.
1977 @command{@value{AS}} may write warnings and error messages to the standard error
1979 runs @command{@value{AS}} automatically. Warnings report an assumption made so
1980 that @command{@value{AS}} could keep assembling a flawed program; errors report a
2030 If you are invoking @command{@value{AS}} via the @sc{gnu} C compiler,
2103 information, like @value{AS} version, switches passed, or time stamp.
2144 @command{@value{AS}}.
2160 preprocessed (if they contain comments, for example), @command{@value{AS}} does
2172 @command{@value{AS}} searches for files specified in @code{.include}
2175 working directory is always searched first; after that, @command{@value{AS}}
2195 @command{@value{AS}} sometimes alters the code emitted for directives of the
2211 notice. Normally both @command{@value{AS}} and @code{@value{LD}} discard
2214 This option tells @command{@value{AS}} to retain those local symbols
2265 changes the syntax and pseudo-op handling of @command{@value{AS}} to make it
2271 assembling existing MRI assembler code using @command{@value{AS}}.
2282 Other object file formats do not support this. @command{@value{AS}} handles
2308 address. This differs from the usual @command{@value{AS}} @code{.org} pseudo-op,
2315 @command{@value{AS}}, typically either because they are difficult or because they
2340 @code{BRL}, and @code{BRW}---are ignored. @command{@value{AS}} automatically
2397 @command{@value{AS}} can generate a dependency file for the file it creates. This
2411 There is always one object file output when you run @command{@value{AS}}. By
2432 Whatever the object file is called, @command{@value{AS}} overwrites any
2443 @option{-R} tells @command{@value{AS}} to write the object file as if all
2453 older versions of @command{@value{AS}}. In future, @option{-R} may work this way.
2456 When @command{@value{AS}} is configured for COFF or ELF output,
2463 @option{-R} generates a warning from @command{@value{AS}}.
2474 @command{@value{AS}}: the maximum amount of space allocated during the assembly
2482 For some targets, the output of @command{@value{AS}} is different in some ways
2484 @command{@value{AS}} to use the traditional format instead.
2487 @command{@value{AS}} normally does by default on @code{@value{GCC}} output.
2503 @command{@value{AS}} should never give a warning or error message when
2505 cause @command{@value{AS}} to give a warning that a particular assumption was
2514 how @command{@value{AS}} assembles your file. Errors, which stop the assembly,
2520 If you use the @option{--fatal-warnings} option, @command{@value{AS}} considers
2532 After an error message, @command{@value{AS}} normally produces no output. If for
2534 @command{@value{AS}} gives an error message on your program, use the @samp{-Z}
2535 option. If there are any errors, @command{@value{AS}} continues anyways, and
2545 source file. @command{@value{AS}} syntax is similar to what many other
2551 assembler, except that @command{@value{AS}} does not assemble Vax bit-fields.
2567 The @command{@value{AS}} internal preprocessor:
2624 There are two ways of rendering comments to @command{@value{AS}}. In both
2671 of @command{@value{AS}}.
2738 Different versions of @command{@value{AS}} for different computers
2809 @command{@value{AS}} to interpret the second character literally as a backslash
2810 (which prevents @command{@value{AS}} from recognizing the second @code{\} as an
2893 interpretation of the following character. However @command{@value{AS}} has no
2894 other interpretation, so @command{@value{AS}} knows it is giving you the wrong
2930 that character. @command{@value{AS}} assumes your character code is ASCII:
2938 @command{@value{AS}} distinguishes three kinds of numbers according to how they
3003 @command{@value{AS}} to a generic binary floating point number of more than
3006 portion of @command{@value{AS}} specialized to that computer.
3017 A letter, to tell @command{@value{AS}} the rest of the number is a flonum.
3082 @command{@value{AS}} does all processing using integers. Flonums are computed
3084 @command{@value{AS}}.
3102 @command{@value{AS}} applies a bitwise @sc{and} between @var{mask} and
3144 combines their contents to form a runnable program. When @command{@value{AS}}
3148 oversimplification, but it suffices to explain how @command{@value{AS}} uses
3160 @command{@value{AS}} pads sections if needed to
3165 An object file written by @command{@value{AS}} has at least three sections, any
3173 @command{@value{AS}} can also generate whatever other named sections you specify
3181 When @command{@value{AS}} generates SOM or ELF output for the HPPA,
3183 @command{@value{AS}} can also generate whatever other named sections you
3190 Additionally, @command{@value{AS}} uses different names for the standard
3207 relocated, and how to change that data, @command{@value{AS}} also writes to the
3228 In fact, every address @command{@value{AS}} ever uses is expressed as
3233 Further, most expressions @command{@value{AS}} computes have this section-relative
3269 use of @command{@value{AS}} and have no meaning except during assembly.
3288 These sections hold your program. @command{@value{AS}} and @code{@value{LD}} treat them as
3381 These sections are meant only for the internal use of @command{@value{AS}}. They
3383 sections for most purposes; but they can be mentioned in @command{@value{AS}}
3385 meanings to @command{@value{AS}}. These sections are used to permit the
3431 are not contiguous in the assembler source. @command{@value{AS}} allows you to
3447 of @command{@value{AS}}.)
3515 restricted to @command{@value{AS}} there is no concept of a subsection location
3556 @emph{Warning:} @command{@value{AS}} does not place symbols in the object file in
3582 a single line. To work around this, the HPPA version of @command{@value{AS}} also
3702 Normally both @command{@value{AS}} and @code{@value{LD}} forget symbols
3705 @samp{-L} option then @command{@value{AS}} retains these symbols in the
3730 @code{@value{AS}} also supports an even more local form of local labels called
3754 @command{@value{AS}} is assembling into. Thus, the expression @samp{melvin:
3775 If you use a symbol without defining it, @command{@value{AS}} assumes zero for
3847 These symbol attributes appear only when @command{@value{AS}} is configured for
3881 @command{@value{AS}}.
3887 This is an arbitrary 8-bit value. It means nothing to @command{@value{AS}}.
3910 The @command{@value{AS}} directives @code{.dim}, @code{.line}, @code{.scl},
3941 enough information when @command{@value{AS}} sees the expression to know its
3944 @command{@value{AS}} aborts with an error message in this situation.
3958 expression, and @command{@value{AS}} assumes a value of (absolute) 0. This
3998 that only the low order 32 bits are used, and @command{@value{AS}} pretends
4023 @command{@value{AS}} has the following @dfn{prefix operators}. They each take
4363 of the source quit, it could use this directive tells @command{@value{AS}} to
4371 When producing COFF output, @command{@value{AS}} accepts this directive as a
4375 When producing @code{b.out} output, @command{@value{AS}} accepts this directive,
4723 alignment is specified, @command{@value{AS}} will set the alignment to the
4742 @code{.data} tells @command{@value{AS}} to assemble the following statements onto the
4758 This directive is only observed when @command{@value{AS}} is configured for COFF
4775 The @samp{.desc} directive is not available when @command{@value{AS}} is
4777 object format. For the sake of compatibility, @command{@value{AS}} accepts
4795 @command{@value{AS}} is generating @code{b.out}, it accepts this directive but
4809 @command{@value{AS}} is configured. @xref{Machine Dependencies}.
4831 @code{.else} is part of the @command{@value{AS}} support for conditional
4840 @code{.elseif} is part of the @command{@value{AS}} support for conditional
4848 @code{.end} marks the end of the assembly file. @command{@value{AS}} does not
4861 @command{@value{AS}} is configured to generate @code{b.out}, it accepts this
4875 @code{.endif} is part of the @command{@value{AS}} support for conditional assembly;
4929 If @command{@value{AS}} assembles a @code{.err} directive, it will print an error
4955 with other assemblers---but it is ignored. @command{@value{AS}} treats
4963 or more, @command{@value{AS}} will print a warning message. If the value is less
4964 than 500, @command{@value{AS}} will print an error message. The message will
4981 This version of the @code{.file} directive tells @command{@value{AS}} that we
4992 old @command{@value{AS}} programs.
5026 byte-order of an integer on the computer @command{@value{AS}} is assembling for.
5045 @command{@value{AS}} is configured.
5137 a.out object file format, @command{@value{AS}} simply accepts the directive for
5387 @command{@value{AS}} accepts this directive, for compatibility with other
5401 @command{@value{AS}} will no longer support this directive: it is recognized only
5406 @code{b.out} object-code formats, @command{@value{AS}} still recognizes it
5476 Tell @command{@value{AS}} to change the logical line number. @var{line-number}
5483 This directive is accepted, but ignored, when @command{@value{AS}} is
5746 @command{@value{AS}} maintains a counter of how many macros it has
5761 If @var{val} is non-zero, this tells @command{@value{AS}} to enter MRI mode. If
5762 @var{val} is zero, this tells @command{@value{AS}} to exit MRI mode. This change
5816 @command{@value{AS}} issues a warning, then pretends the section of @var{new-lc}
5826 Because @command{@value{AS}} tries to assemble programs in one pass, @var{new-lc}
5949 @command{@value{AS}} will print @var{string} on the standard output during
5982 @command{@value{AS}} generates formfeeds whenever the specified number of
6099 configured to generate @code{b.out} output format, @command{@value{AS}}
6363 @command{@value{AS}} is configured. @xref{Machine Dependencies}.
6394 @command{@value{AS}} is generating @code{b.out}, it accepts this directive but
6469 The symbols are not entered in the @command{@value{AS}} hash table: they
6667 @command{@value{AS}} is generating @code{b.out}, it accepts this directive but
6676 Tells @command{@value{AS}} to assemble the following statements onto the end of
6719 @command{@value{AS}} is configured for @code{b.out} output, it accepts this
6822 @samp{.val} is used only for COFF output; when @command{@value{AS}} is
6902 For each expression, @command{@value{AS}} emits a 32-bit number.
6905 For each expression, @command{@value{AS}} emits a 16-bit number.
6931 @command{@value{AS}} occasionally does strange things to @samp{.word} directives.
6933 compilers as part of jump tables. Therefore, when @command{@value{AS}} assembles a
6935 @code{sym1} and @code{sym2} does not fit in 16 bits, @command{@value{AS}}
6953 @emph{This feature may be disabled by compiling @command{@value{AS}} with the
6977 @command{@value{AS}} assembles source files written for a specific architecture
7129 each machine where @command{@value{AS}} runs. Floating point representations
7130 vary as well, and @command{@value{AS}} often supports a few additional
7133 @command{@value{AS}} support special pseudo-instructions for branch
7350 chapter describes the specific @command{@value{AS}} features for each
7548 Your bug reports play an essential role in making @command{@value{AS}} reliable.
7552 entire community by making the next version of @command{@value{AS}} work better.
7553 Bug reports are your contribution to the maintenance of @command{@value{AS}}.
7575 @command{@value{AS}} bug. Reliable assemblers never crash.
7579 If @command{@value{AS}} produces an error message for valid input, that is a bug.
7583 If @command{@value{AS}} does not produce an error message for invalid input, that
7589 of @command{@value{AS}} are welcome in any case.
7598 you obtained @command{@value{AS}} from a support organization, we recommend you
7606 In any event, we also recommend that you send bug reports for @command{@value{AS}}
7637 The version of @command{@value{AS}}. @command{@value{AS}} announces it if you start
7641 the bug in the current version of @command{@value{AS}}.
7644 Any patches you may have applied to the @command{@value{AS}} source.
7651 What compiler (and its version) was used to compile @command{@value{AS}}---e.g.
7669 @command{@value{AS}} is being run.
7675 Of course, if the bug is that @command{@value{AS}} gets a fatal signal, then we
7682 @command{@value{AS}} is out of sync, or you have encountered a bug in the C
7690 If you wish to suggest changes to the @command{@value{AS}} source, send us context
7693 discuss something in the @command{@value{AS}} source, refer to it by context, not
7731 Sometimes with a program as complicated as @command{@value{AS}} it is very hard to
7851 @node AS Index
7852 @unnumbered AS Index