Lines Matching refs:var
229 @value{AS} [@b{-a}[@b{cdghlns}][=@var{file}]] [@b{--alternate}] [@b{-D}]
231 [@b{--debug-prefix-map} @var{old}=@var{new}]
232 [@b{--defsym} @var{sym}=@var{val}] [@b{-f}] [@b{-g}] [@b{--gstabs}]
234 [@b{--help}] [@b{-I} @var{dir}] [@b{-J}]
235 [@b{-K}] [@b{-L}] [@b{--listing-lhs-width}=@var{NUM}]
236 [@b{--listing-lhs-width2}=@var{NUM}] [@b{--listing-rhs-width}=@var{NUM}]
237 [@b{--listing-cont-lines}=@var{NUM}] [@b{--keep-locals}] [@b{-o}
238 @var{objfile}] [@b{-R}] [@b{--reduce-memory-overheads}] [@b{--statistics}]
240 [@b{--fatal-warnings}] [@b{-w}] [@b{-x}] [@b{-Z}] [@b{@@@var{FILE}}]
242 [@b{--target-help}] [@var{target-options}]
243 [@b{--}|@var{files} @dots{}]
251 [@b{-mabi}=@var{ABI}]
256 [@b{-m@var{cpu}}]
259 [@b{-relax}] [@b{-g}] [@b{-G@var{size}}]
272 [@b{-mcpu}=@var{processor}[+@var{extension}@dots{}]]
273 [@b{-march}=@var{architecture}[+@var{extension}@dots{}]]
274 [@b{-mfpu}=@var{floating-point-format}]
275 [@b{-mfloat-abi}=@var{abi}]
276 [@b{-meabi}=@var{ver}]
286 [@b{-mcpu}=@var{processor}[-@var{sirevision}]]
328 [@b{-march}=@var{CPU}[+@var{EXTENSION}@dots{}]] [@b{-mtune}=@var{CPU}]
389 [@b{-mcpu=@var{cpu}}] [@b{-mfpu=@var{cpu}}] [@b{-mdsp=@var{cpu}}]
398 [@b{-nocpp}] [@b{-EL}] [@b{-EB}] [@b{-O}[@var{optimization level}]]
399 [@b{-g}[@var{debug level}]] [@b{-G} @var{num}] [@b{-KPIC}] [@b{-call_shared}]
401 [@b{-mabi}=@var{ABI}] [@b{-32}] [@b{-n32}] [@b{-64}] [@b{-mfp32}] [@b{-mgp32}]
404 [@b{-march}=@var{CPU}] [@b{-mtune}=@var{CPU}] [@b{-mips1}] [@b{-mips2}]
409 [@b{-mnan=@var{encoding}}]
448 [@b{-EL}] [@b{-EB}] [@b{-O}] [@b{-Os}] [@b{-mcpu=@var{cpu}}]
449 [@b{-misa=@var{isa}}] [@b{-mabi=@var{abi}}] [@b{-mall-ext}]
453 [@b{-m[no-]fpu-fma}] [@b{-mfpu-freg=@var{FREG}}] [@b{-mreduced-regs}]
461 [@b{-m}@var{extension}|@b{-mno-}@var{extension}]
462 [@b{-m}@var{cpu}] [@b{-m}@var{machine}]
483 [@b{-nops=@var{count}}]
500 [@b{-mint-register=@var{number}}]
506 [@b{-m31}|@b{-m64}] [@b{-mesa}|@b{-mzarch}] [@b{-march}=@var{CPU}]
516 [@b{-USE_R1}][@b{-KPIC}][@b{-O0}][@b{-G} @var{num}][@b{-V}]
531 [@b{-merrors-to-file} @var{<filename>}|@b{-me} @var{<filename>}]
537 [@b{-march=@var{arch}}] [@b{-mbig-endian}|@b{-mlittle-endian}]
556 [@b{--rename-section} @var{oldname}=@var{newname}]
638 @item --debug-prefix-map @var{old}=@var{new}
639 When assembling files in directory @file{@var{old}}, record debugging
640 information describing them as in @file{@var{new}} instead.
642 @item --defsym @var{sym}=@var{value}
643 Define the symbol @var{sym} to be @var{value} before assembling the input file.
644 @var{value} must be an integer constant. As in C, a leading @samp{0x}
677 .debug_line.@var{foo} sections where @var{foo} is the name of the
678 corresponding code section. For example a code section called @var{.text.func}
680 @var{.debug_line.text.func}. If the code section is just called @var{.text}
681 then debug line section will still be called just @var{.debug_line} without any
694 @item -I @var{dir}
695 Add directory @var{dir} to the search list for @code{.include} directives.
717 @item --listing-lhs-width=@var{number}
719 listing to @var{number}.
721 @item --listing-lhs-width2=@var{number}
723 lines in an assembler listing to @var{number}.
725 @item --listing-rhs-width=@var{number}
727 @var{number} bytes.
729 @item --listing-cont-lines=@var{number}
731 to @var{number} + 1.
733 @item -o @var{objfile}
734 Name the object-file output from @command{@value{AS}} @var{objfile}.
739 @kindex --hash-size=@var{number}
741 @var{number}. Increasing this value can reduce the length of time it takes the
784 @item -- | @var{files} @dots{}
846 @item -mcpu=@var{processor}[+@var{extension}@dots{}]
848 @item -march=@var{architecture}[+@var{extension}@dots{}]
850 @item -mfpu=@var{floating-point-format}
852 @item -mfloat-abi=@var{abi}
1126 @item -m@var{extension} | -mno-@var{extension}
1129 @item -m@var{cpu}
1133 @item -m@var{machine}
1243 @item -mcpu=@var{CPU_VERSION}
1245 @item -merrors-to-file @var{FILENAME}
1256 @item -G @var{num}
1298 @item -march=@var{cpu}
1301 @item -mtune=@var{cpu}
1447 @item -mnan=@var{encoding}
1452 @item --emulation=@var{name}
1596 @item -march=@var{processor}
2165 @section @code{.include} Search Path: @option{-I} @var{path}
2167 @kindex -I @var{path}
2171 Use this option to add a @var{path} to the list of directories
2196 form @samp{.word @var{sym1}-@var{sym2}}. @xref{Word,,@code{.word}}.
2536 writes an object file after a final warning message of the form @samp{@var{n}
2537 errors, @var{m} warnings, generating bad object file.}
2856 @c @item \x @var{digit} @var{digit} @var{digit}
2859 @cindex @code{\@var{ddd}} (octal character code)
2860 @cindex octal character code (@code{\@var{ddd}})
2861 @item \ @var{digit} @var{digit} @var{digit}
2866 @cindex @code{\@var{xd...}} (hex character code)
2867 @cindex hex character code (@code{\@var{xd...}})
2868 @item \@code{x} @var{hex-digits...}
2889 @item \ @var{anything-else}
3099 @var{mask}:@var{value}
3102 @command{@value{AS}} applies a bitwise @sc{and} between @var{mask} and
3103 @var{value}.
3220 (@var{address}) @minus{} (@var{start-address of section})?
3230 (@var{section}) + (@var{offset into section})
3240 In this manual we use the notation @{@var{secname} @var{N}@} to mean ``offset
3241 @var{N} into section @var{secname}.''
3255 rendered @{undefined @var{U}@}---where @var{U} is filled in later.
3474 @var{expression}} or a @samp{.data @var{expression}} statement.
3483 argument with arbitrary named sections: @samp{.section @var{name},
3484 @var{expression}}.
3494 to specify a subsection: @samp{.subsection @var{expression}}.
3496 @var{Expression} should be an absolute expression
3709 @item @var{number}
3990 Symbols are evaluated to yield @{@var{section} @var{NNN}@} where
3991 @var{section} is one of text, data, bss, absolute,
3992 or undefined. @var{NNN} is a signed, 2's complement 32 bit
4186 * Align:: @code{.align @var{abs-expr} , @var{abs-expr}}
4188 * Ascii:: @code{.ascii "@var{string}"}@dots{}
4189 * Asciz:: @code{.asciz "@var{string}"}@dots{}
4190 * Balign:: @code{.balign @var{abs-expr} , @var{abs-expr}}
4191 * Bundle directives:: @code{.bundle_align_mode @var{abs-expr}}, @code{.bundle_lock}, @cod…
4192 * Byte:: @code{.byte @var{expressions}}
4194 * Comm:: @code{.comm @var{symbol} , @var{length} }
4195 * Data:: @code{.data @var{subsection}}
4197 * Def:: @code{.def @var{name}}
4200 * Desc:: @code{.desc @var{symbol}, @var{abs-expression}}
4206 * Double:: @code{.double @var{flonums}}
4217 * Equ:: @code{.equ @var{symbol}, @var{expression}}
4218 * Equiv:: @code{.equiv @var{symbol}, @var{expression}}
4219 * Eqv:: @code{.eqv @var{symbol}, @var{expression}}
4221 * Error:: @code{.error @var{string}}
4226 * Fill:: @code{.fill @var{repeat} , @var{size} , @var{value}}
4227 * Float:: @code{.float @var{flonums}}
4229 * Global:: @code{.global @var{symbol}}, @code{.globl @var{symbol}}
4231 * Gnu_attribute:: @code{.gnu_attribute @var{tag},@var{value}}
4232 * Hidden:: @code{.hidden @var{names}}
4235 * hword:: @code{.hword @var{expressions}}
4237 * If:: @code{.if @var{absolute expression}}
4238 * Incbin:: @code{.incbin "@var{file}"[,@var{skip}[,@var{count}]]}
4239 * Include:: @code{.include "@var{file}"}
4240 * Int:: @code{.int @var{expressions}}
4242 * Internal:: @code{.internal @var{names}}
4245 * Irp:: @code{.irp @var{symbol},@var{values}}@dots{}
4246 * Irpc:: @code{.irpc @var{symbol},@var{values}}@dots{}
4247 * Lcomm:: @code{.lcomm @var{symbol} , @var{length}}
4250 * Line:: @code{.line @var{line-number}}
4253 * Linkonce:: @code{.linkonce [@var{type}]}
4255 * Ln:: @code{.ln @var{line-number}}
4256 * Loc:: @code{.loc @var{fileno} @var{lineno}}
4257 * Loc_mark_labels:: @code{.loc_mark_labels @var{enable}}
4259 * Local:: @code{.local @var{names}}
4262 * Long:: @code{.long @var{expressions}}
4264 * Lsym:: @code{.lsym @var{symbol}, @var{expression}}
4267 * Macro:: @code{.macro @var{name} @var{args}}@dots{}
4268 * MRI:: @code{.mri @var{val}}
4271 * Octa:: @code{.octa @var{bignums}}
4272 * Offset:: @code{.offset @var{loc}}
4273 * Org:: @code{.org @var{new-lc}, @var{fill}}
4274 * P2align:: @code{.p2align @var{abs-expr}, @var{abs-expr}, @var{abs-expr}}
4280 * Print:: @code{.print @var{string}}
4282 * Protected:: @code{.protected @var{names}}
4285 * Psize:: @code{.psize @var{lines}, @var{columns}}
4286 * Purgem:: @code{.purgem @var{name}}
4288 * PushSection:: @code{.pushsection @var{name}}
4291 * Quad:: @code{.quad @var{bignums}}
4292 * Reloc:: @code{.reloc @var{offset}, @var{reloc_name}[, @var{expression}]}
4293 * Rept:: @code{.rept @var{count}}
4294 * Sbttl:: @code{.sbttl "@var{subheading}"}
4296 * Scl:: @code{.scl @var{class}}
4299 * Section:: @code{.section @var{name}[, @var{flags}]}
4302 * Set:: @code{.set @var{symbol}, @var{expression}}
4303 * Short:: @code{.short @var{expressions}}
4304 * Single:: @code{.single @var{flonums}}
4306 * Size:: @code{.size [@var{name} , @var{expression}]}
4309 * Skip:: @code{.skip @var{size} , @var{fill}}
4312 * Sleb128:: @code{.sleb128 @var{expressions}}
4314 * Space:: @code{.space @var{size} , @var{fill}}
4320 …code{.string "@var{str}"}, @code{.string8 "@var{str}"}, @code{.string16 "@var{str}"}, @code{.strin…
4321 * Struct:: @code{.struct @var{expression}}
4324 * Symver:: @code{.symver @var{name},@var{name2@@nodename}}
4328 * Tag:: @code{.tag @var{structname}}
4331 * Text:: @code{.text @var{subsection}}
4332 * Title:: @code{.title "@var{heading}"}
4334 * Type:: @code{.type <@var{int} | @var{name} , @var{type description}>}
4337 * Uleb128:: @code{.uleb128 @var{expressions}}
4339 * Val:: @code{.val @var{addr}}
4343 * Version:: @code{.version "@var{string}"}
4344 * VTableEntry:: @code{.vtable_entry @var{table}, @var{offset}}
4345 * VTableInherit:: @code{.vtable_inherit @var{child}, @var{parent}}
4348 * Warning:: @code{.warning @var{string}}
4349 * Weak:: @code{.weak @var{names}}
4350 * Weakref:: @code{.weakref @var{alias}, @var{symbol}}
4351 * Word:: @code{.word @var{expressions}}
4381 @section @code{.align @var{abs-expr}, @var{abs-expr}, @var{abs-expr}}
4429 @item LOCAL @var{name} [ , @dots{} ]
4431 generate a string replacement for each of the @var{name} arguments, and
4432 replace any instances of @var{name} in each macro expansion. The
4439 @code{"@var{string}"}:
4442 @item '@var{string}'
4445 @item <@var{string}>
4456 You can write @samp{%@var{expr}} to evaluate the expression @var{expr}
4461 @section @code{.ascii "@var{string}"}@dots{}
4470 @section @code{.asciz "@var{string}"}@dots{}
4479 @section @code{.balign[wl] @var{abs-expr}, @var{abs-expr}, @var{abs-expr}}
4515 @section @code{.bundle_align_mode @var{abs-expr}}
4530 @var{abs-expr} is @code{5} then the bundle size is 32, so each aligned
4571 @section @code{.byte @var{expressions}}
4579 @section @code{.cfi_sections @var{section_list}}
4583 If @var{section_list} is @code{.eh_frame}, @code{.eh_frame} is emitted,
4584 if @var{section_list} is @code{.debug_frame}, @code{.debug_frame} is emitted.
4604 @section @code{.cfi_personality @var{encoding} [, @var{exp}]}
4606 @var{encoding} must be a constant determining how the personality
4615 @section @code{.cfi_lsda @var{encoding} [, @var{exp}]}
4617 @var{encoding} must be a constant determining how the LSDA
4623 @section @code{.cfi_def_cfa @var{register}, @var{offset}}
4625 address from @var{register} and add @var{offset} to it}.
4627 @section @code{.cfi_def_cfa_register @var{register}}
4629 now on @var{register} will be used instead of the old one. Offset
4632 @section @code{.cfi_def_cfa_offset @var{offset}}
4634 remains the same, but @var{offset} is new. Note that it is the
4638 @section @code{.cfi_adjust_cfa_offset @var{offset}}
4639 Same as @code{.cfi_def_cfa_offset} but @var{offset} is a relative
4642 @section @code{.cfi_offset @var{register}, @var{offset}}
4643 Previous value of @var{register} is saved at offset @var{offset} from
4646 @section @code{.cfi_rel_offset @var{register}, @var{offset}}
4647 Previous value of @var{register} is saved at offset @var{offset} from
4653 @section @code{.cfi_register @var{register1}, @var{register2}}
4654 Previous value of @var{register1} is saved in register @var{register2}.
4656 @section @code{.cfi_restore @var{register}}
4657 @code{.cfi_restore} says that the rule for @var{register} is now the
4661 @section @code{.cfi_undefined @var{register}}
4662 From now on the previous value of @var{register} can't be restored anymore.
4664 @section @code{.cfi_same_value @var{register}}
4665 Current value of @var{register} is the same like in the previous frame,
4674 @section @code{.cfi_return_column @var{register}}
4675 Change return column @var{register}, i.e. the return address is either
4676 directly in @var{register} or can be accessed by rules for @var{register}.
4684 @section @code{.cfi_escape} @var{expression}[, @dots{}]
4689 @section @code{.cfi_val_encoded_addr @var{register}, @var{encoding}, @var{label}}
4690 The current value of @var{register} is @var{label}. The value of @var{label}
4691 will be encoded in the output file according to @var{encoding}; see the
4701 @section @code{.comm @var{symbol} , @var{length} }
4705 @code{.comm} declares a common symbol named @var{symbol}. When linking, a
4709 allocate @var{length} bytes of uninitialized memory. @var{length} must be an
4735 @samp{@var{symbol} .comm, @var{length}}; @var{symbol} is optional.
4739 @section @code{.data @var{subsection}}
4743 end of the data subsection numbered @var{subsection} (which is an
4744 absolute expression). If @var{subsection} is omitted, it defaults
4749 @section @code{.def @var{name}}
4754 Begin defining debugging information for a symbol @var{name}; the
4766 @section @code{.desc @var{symbol}, @var{abs-expression}}
4801 @section @code{.double @var{flonums}}
4880 @section @code{.equ @var{symbol}, @var{expression}}
4885 This directive sets the value of @var{symbol} to @var{expression}.
4890 @samp{@var{symbol} .equ @var{expression}}.
4895 @samp{@var{symbol} equ @var{expression}}.
4896 On the Z80 it is an eror if @var{symbol} is already defined,
4902 @section @code{.equiv @var{symbol}, @var{expression}}
4905 the assembler will signal an error if @var{symbol} is already defined. Note a
4919 @section @code{.eqv @var{symbol}, @var{expression}}
4934 @section @code{.error "@var{string}"}
4959 @section @code{.fail @var{expression}}
4962 Generates an error or a warning. If the value of the @var{expression} is 500
4965 include the value of @var{expression}. This can occasionally be useful inside
4985 .file @var{string}
4988 @var{string} is the new file name. In general, the filename is
5001 .file @var{fileno} @var{filename}
5004 The @var{fileno} operand should be a unique positive integer to use as the
5005 index of the entry in the table. The @var{filename} operand is a C string
5014 @section @code{.fill @var{repeat} , @var{size} , @var{value}}
5019 @var{repeat}, @var{size} and @var{value} are absolute expressions.
5020 This emits @var{repeat} copies of @var{size} bytes. @var{Repeat}
5021 may be zero or more. @var{Size} may be zero or more, but if it is
5023 other people's assemblers. The contents of each @var{repeat} bytes
5025 zero. The lowest order 4 bytes are @var{value} rendered in the
5027 Each @var{size} bytes in a repetition is taken from the lowest order
5028 @var{size} bytes of this number. Again, this bizarre behavior is
5031 @var{size} and @var{value} are optional.
5032 If the second comma and @var{value} are absent, @var{value} is
5034 @var{size} is assumed to be 1.
5037 @section @code{.float @var{flonums}}
5056 @section @code{.func @var{name}[,@var{label}]}
5058 @code{.func} emits debugging information to denote function @var{name}, and
5061 @var{label} is the entry point of the function and if omitted @var{name}
5068 @section @code{.global @var{symbol}}, @code{.globl @var{symbol}}
5073 @var{symbol} in your partial program, its value is made available to
5075 @var{symbol} takes its attributes from a symbol of the same name
5089 @section @code{.gnu_attribute @var{tag},@var{value}}
5093 @section @code{.hidden @var{names}}
5108 @section @code{.hword @var{expressions}}
5114 This expects zero or more @var{expressions}, and emits
5144 @section @code{.if @var{absolute expression}}
5150 (which must be an @var{absolute expression}) is non-zero. The end of
5160 @item .ifdef @var{symbol}
5161 Assembles the following section of code if the specified @var{symbol}
5166 @item .ifb @var{text}
5170 @item .ifc @var{string1},@var{string2}
5178 @item .ifeq @var{absolute expression}
5182 @item .ifeqs @var{string1},@var{string2}
5186 @item .ifge @var{absolute expression}
5191 @item .ifgt @var{absolute expression}
5195 @item .ifle @var{absolute expression}
5200 @item .iflt @var{absolute expression}
5204 @item .ifnb @var{text}
5209 @item .ifnc @var{string1},@var{string2}.
5215 @item .ifndef @var{symbol}
5216 @itemx .ifnotdef @var{symbol}
5217 Assembles the following section of code if the specified @var{symbol}
5222 @item .ifne @var{absolute expression}
5227 @item .ifnes @var{string1},@var{string2}
5233 @section @code{.incbin "@var{file}"[,@var{skip}[,@var{count}]]}
5239 The @code{incbin} directive includes @var{file} verbatim at the current
5242 around @var{file}.
5244 The @var{skip} argument skips a number of bytes from the start of the
5245 @var{file}. The @var{count} argument indicates the maximum number of bytes to
5251 @section @code{.include "@var{file}"}
5257 points in your source program. The code from @var{file} is assembled as
5262 around @var{file}.
5265 @section @code{.int @var{expressions}}
5269 Expect zero or more @var{expressions}, of any section, separated by commas.
5284 @section @code{.internal @var{names}}
5300 @section @code{.irp @var{symbol},@var{values}}@dots{}
5303 Evaluate a sequence of statements assigning different values to @var{symbol}.
5305 terminated by an @code{.endr} directive. For each @var{value}, @var{symbol} is
5306 set to @var{value}, and the sequence of statements is assembled. If no
5307 @var{value} is listed, the sequence of statements is assembled once, with
5308 @var{symbol} set to the null string. To refer to @var{symbol} within the
5309 sequence of statements, use @var{\symbol}.
5327 For some caveats with the spelling of @var{symbol}, see also @ref{Macro}.
5330 @section @code{.irpc @var{symbol},@var{values}}@dots{}
5333 Evaluate a sequence of statements assigning different values to @var{symbol}.
5335 terminated by an @code{.endr} directive. For each character in @var{value},
5336 @var{symbol} is set to the character, and the sequence of statements is
5337 assembled. If no @var{value} is listed, the sequence of statements is
5338 assembled once, with @var{symbol} set to the null string. To refer to
5339 @var{symbol} within the sequence of statements, use @var{\symbol}.
5357 For some caveats with the spelling of @var{symbol}, see also the discussion
5361 @section @code{.lcomm @var{symbol} , @var{length}}
5366 Reserve @var{length} (an absolute expression) bytes for a local common
5367 denoted by @var{symbol}. The section and value of @var{symbol} are
5369 section, so that at run-time the bytes start off zeroed. @var{Symbol}
5380 @samp{@var{symbol} .lcomm, @var{length}}; @var{symbol} is optional.
5392 @section @code{.line @var{line-number}}
5397 Change the logical line number. @var{line-number} must be an absolute
5400 reported as on logical line number @var{line-number} @minus{} 1. One day
5417 @section @code{.linkonce [@var{type}]}
5432 The @var{type} argument is optional. If specified, it must be one of the
5469 @section @code{.ln @var{line-number}}
5476 Tell @command{@value{AS}} to change the logical line number. @var{line-number}
5480 line number @var{line-number} @minus{} 1.
5490 @section @code{.loc @var{fileno} @var{lineno} [@var{column}] [@var{options}]}
5495 instruction. The @var{fileno}, @var{lineno}, and optional @var{column}
5499 The @var{options} are a sequence of the following tokens in any order:
5514 @item is_stmt @var{value}
5519 @item isa @var{value}
5521 state machine to @var{value}, which must be an unsigned integer.
5523 @item discriminator @var{value}
5525 state machine to @var{value}, which must be an unsigned integer.
5530 @section @code{.loc_mark_labels @var{enable}}
5536 The @var{enable} argument should be either 1 or 0, to enable or disable
5541 @section @code{.local @var{names}}
5556 @section @code{.long @var{expressions}}
5565 @section @code{.lsym @var{symbol}, @var{expression}}
5569 @code{.lsym} creates a new symbol named @var{symbol}, but does not put it in
5574 @var{other} = @var{descriptor} = 0
5575 @var{type} = @r{(section of @var{expression})}
5576 @var{value} = @var{expression}
5612 @item .macro @var{macname}
5613 @itemx .macro @var{macname} @var{macargs} @dots{}
5615 Begin the definition of a macro called @var{macname}. If your macro
5621 macro argument by following the name with @samp{=@var{deflt}}. You
5622 cannot define two macros with the same @var{macname} unless it has been
5641 @samp{reserve_str @var{a},@var{b}} (with @samp{\p1} evaluating to
5642 @var{a} and @samp{\p2} evaluating to @var{b}), or as @samp{reserve_str
5643 ,@var{b}} (with @samp{\p1} evaluating as the default, in this case
5644 @samp{0}, and @samp{\p2} evaluating to @var{b}).
5658 Note that since each of the @var{macargs} can be an identifier exactly
5750 @item LOCAL @var{name} [ , @dots{} ]
5757 @section @code{.mri @var{val}}
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
5782 @section @code{.octa @var{bignums}}
5795 @section @code{.offset @var{loc}}
5798 Set the location counter to @var{loc} in the absolute section. @var{loc} must
5804 @section @code{.org @var{new-lc} , @var{fill}}
5811 @var{new-lc}. @var{new-lc} is either an absolute expression or an
5813 you can't use @code{.org} to cross sections: if @var{new-lc} has the
5815 with former assemblers, if the section of @var{new-lc} is absolute,
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}
5835 intervening bytes are filled with @var{fill} which should be an
5836 absolute expression. If the comma and @var{fill} are omitted,
5837 @var{fill} defaults to zero.
5840 @section @code{.p2align[wl] @var{abs-expr}, @var{abs-expr}, @var{abs-expr}}
5946 @section @code{.print @var{string}}
5949 @command{@value{AS}} will print @var{string} on the standard output during
5950 assembly. You must put @var{string} in double quotes.
5954 @section @code{.protected @var{names}}
5970 @section @code{.psize @var{lines} , @var{columns}}
5979 of 60. You may omit the comma and @var{columns} specification; the
5986 If you specify @var{lines} as @code{0}, no formfeeds are generated save
5990 @section @code{.purgem @var{name}}
5993 Undefine the macro @var{name}, so that later uses of the string will not be
5998 @section @code{.pushsection @var{name} [, @var{subsection}] [, "@var{flags}"[, @@@var{type}[,@var{a…
6015 @section @code{.quad @var{bignums}}
6037 @section @code{.reloc @var{offset}, @var{reloc_name}[, @var{expression}]}
6040 Generate a relocation at @var{offset} of type @var{reloc_name} with value
6041 @var{expression}. If @var{offset} is a number, the relocation is generated in
6042 the current section. If @var{offset} is an expression that resolves to a
6044 @var{expression}, if present, must resolve to a symbol plus addend or to an
6051 @section @code{.rept @var{count}}
6055 @code{.endr} directive @var{count} times.
6074 @section @code{.sbttl "@var{subheading}"}
6079 Use @var{subheading} as the title (third line, immediately after the
6087 @section @code{.scl @var{class}}
6106 @section @code{.section @var{name}}
6110 named @var{name}.
6127 .section @var{name}[, "@var{flags}"]
6128 .section @var{name}[, @var{subsection}]
6184 .section @var{name} [, "@var{flags}"[, @@@var{type}[,@var{flag_specific_arguments}]]]
6187 The optional @var{flags} argument is a quoted string which may contain any
6210 The optional @var{type} argument may contain one of the following constants:
6232 If @var{flags} contains the @code{M} symbol then the @var{type} argument must
6233 be specified as well as an extra argument---@var{entsize}---like this:
6236 .section @var{name} , "@var{flags}"M, @@@var{type}, @var{entsize}
6240 constants, each @var{entsize} octets long. Sections with both @code{M} and
6242 @var{entsize} bytes long. The linker may remove duplicates within sections with
6243 the same name, same entity size and same flags. @var{entsize} must be an
6249 If @var{flags} contains the @code{G} symbol then the @var{type} argument must
6253 .section @var{name} , "@var{flags}"G, @@@var{type}, @var{GroupName}[, @var{linkage}]
6256 The @var{GroupName} field specifies the name of the section group to which this
6265 Note: if both the @var{M} and @var{G} flags are present then the fields for
6269 .section @var{name} , "@var{flags}"MG, @@@var{type}, @var{entsize}, @var{GroupName}[, @var{linkage}]
6272 If @var{flags} contains the @code{?} symbol then it may not also contain the
6273 @code{G} symbol and the @var{GroupName} or @var{linkage} fields should not be
6276 @code{G} with those same @var{GroupName} and @var{linkage} fields implicitly.
6288 .section "@var{name}"[, @var{flags}...]
6314 @section @code{.set @var{symbol}, @var{expression}}
6318 Set the value of @var{symbol} to @var{expression}. This
6319 changes @var{symbol}'s value and type to conform to
6320 @var{expression}. If @var{symbol} was flagged as external, it remains
6330 @samp{@var{symbol} defl @var{expression}} instead.
6334 @section @code{.short @var{expressions}}
6349 This expects zero or more @var{expressions}, and emits
6355 @section @code{.single @var{flonums}}
6389 .size @var{expression}
6409 .size @var{name} , @var{expression}
6412 This directive sets the size associated with a symbol @var{name}.
6413 The size in bytes is computed from @var{expression} which can make use of label
6421 @section @code{.skip @var{size} , @var{fill}}
6425 This directive emits @var{size} bytes, each of value @var{fill}. Both
6426 @var{size} and @var{fill} are absolute expressions. If the comma and
6427 @var{fill} are omitted, @var{fill} is assumed to be zero. This is the same as
6432 @section @code{.sleb128 @var{expressions}}
6435 @var{sleb128} stands for ``signed little endian base 128.'' This is a
6441 @section @code{.space @var{size} , @var{fill}}
6445 This directive emits @var{size} bytes, each of value @var{fill}. Both
6446 @var{size} and @var{fill} are absolute expressions. If the comma
6447 and @var{fill} are omitted, @var{fill} is assumed to be zero. This is the same
6466 @cindex @code{stab@var{x}} directives
6473 @table @var
6504 @item .stabd @var{type} , @var{other} , @var{desc}
6517 @item .stabn @var{type} , @var{other} , @var{desc} , @var{value}
6521 @item .stabs @var{string} , @var{type} , @var{other} , @var{desc} , @var{value}
6528 @section @code{.string} "@var{str}", @code{.string8} "@var{str}", @code{.string16}
6529 "@var{str}", @code{.string32} "@var{str}", @code{.string64} "@var{str}"
6542 Copy the characters in @var{str} to the object file. You may specify more than
6548 the @code{string} pseudo opcode in that each 8-bit character from @var{str} is
6562 @section @code{.struct @var{expression}}
6565 Switch to the absolute section, and set the section offset to @var{expression},
6583 @section @code{.subsection @var{name}}
6612 .symver @var{name}, @var{name2@@nodename}
6614 If the symbol @var{name} is defined within the file
6616 alias with the name @var{name2@@nodename}, and in fact the main reason that we
6617 just don't try and create a regular alias is that the @var{@@} character isn't
6618 permitted in symbol names. The @var{name2} part of the name is the actual name
6619 of the symbol by which it will be externally referenced. The name @var{name}
6623 function is being mentioned. The @var{nodename} portion of the alias should be
6626 symbol from a shared library, then @var{nodename} should correspond to the
6629 If the symbol @var{name} is not defined within the file being assembled, all
6630 references to @var{name} will be changed to @var{name2@@nodename}. If no
6631 reference to @var{name} is made, @var{name2@@nodename} will be removed from the
6636 .symver @var{name}, @var{name2@@@@nodename}
6638 In this case, the symbol @var{name} must exist and be defined within
6639 the file being assembled. It is similar to @var{name2@@nodename}. The
6640 difference is @var{name2@@@@nodename} will also be used to resolve
6641 references to @var{name2} by the linker.
6645 .symver @var{name}, @var{name2@@@@@@nodename}
6647 When @var{name} is not defined within the
6648 file being assembled, it is treated as @var{name2@@nodename}. When
6649 @var{name} is defined within the file being assembled, the symbol
6650 name, @var{name}, will be changed to @var{name2@@@@nodename}.
6655 @section @code{.tag @var{structname}}
6673 @section @code{.text @var{subsection}}
6677 the text subsection numbered @var{subsection}, which is an absolute
6678 expression. If @var{subsection} is omitted, subsection number zero
6682 @section @code{.title "@var{heading}"}
6686 Use @var{heading} as the title (second line, immediately after the
6711 .type @var{int}
6714 This records the integer @var{int} as the type attribute of a symbol table
6736 .type @var{name} , @var{type description}
6739 This sets the type of symbol @var{name} to be either a
6741 supported for the @var{type description} field, in order to provide
6803 @section @code{.uleb128 @var{expressions}}
6806 @var{uleb128} stands for ``unsigned little endian base 128.'' This is a
6812 @section @code{.val @var{addr}}
6818 records the address @var{addr} as the value attribute of a symbol table
6829 @section @code{.version "@var{string}"}
6838 @section @code{.vtable_entry @var{table}, @var{offset}}
6845 @section @code{.vtable_inherit @var{child}, @var{parent}}
6855 @section @code{.warning "@var{string}"}
6858 (@pxref{Error,,@code{.error "@var{string}"}}), but just emits a warning.
6861 @section @code{.weak @var{names}}
6876 @section @code{.weakref @var{alias}, @var{target}}
6895 @section @code{.word @var{expressions}}
6898 This directive expects zero or more @var{expressions}, of any section,
7015 an integer value if the tag number is even. The second bit (@code{@var{tag} &