Using as

The GNU Assembler

January 1994

• Overview
  • Structure of this Manual
  • The GNU Assembler
  • Object File Formats
  • Command Line
  • Input Files
  • Output (Object) File
  • Error and Warning Messages
• Command-Line Options
  • Enable Listings: -a[cdhlns]
  • -D
  • Work Faster: -f
  • .include search path: -I path
  • Difference Tables: -K
  • Include Local Labels: -L
  • Assemble in MRI Compatibility Mode: -M
  • Dependency tracking: --MD
  • Name the Object File: -o
  • Join Data and Text Sections: -R
  • Display Assembly Statistics: --statistics
  • Compatible output: --traditional-format
  • Announce Version: -v
  • Suppress Warnings: -W
  • Generate Object File in Spite of Errors: -Z
• Syntax
  • Preprocessing
  • Whitespace
  • Comments
  • Symbols
  • Statements
  • Constants
    • Character Constants
      • Strings
      • Characters
    • Number Constants
      • Integers
      • Bignums
      • Flonums
• Sections and Relocation
  • Background
  • Linker Sections
  • Assembler Internal Sections
  • Sub-Sections
  • bss Section
• Symbols
  • Labels
  • Giving Symbols Other Values
  • Symbol Names
  • The Special Dot Symbol
  • Symbol Attributes
    • Value
    • Type
    • Symbol Attributes: a.out
      • Descriptor
      • Other
    • Symbol Attributes for COFF
      • Primary Attributes
      • Auxiliary Attributes
    • Symbol Attributes for SOM
• Expressions
  • Empty Expressions
  • Integer Expressions
    • Arguments
    • Operators
    • Prefix Operator
    • Infix Operators
• Assembler Directives
  • .abort
  • .ABORT
  • .align abs-expr, abs-expr, abs-expr
  • .app-file string
  • .ascii "string"...
  • .asciz "string"...
  • .balign[wl] abs-expr, abs-expr, abs-expr
  • .byte expressions
  • .comm symbol , length
  • .data subsection
  • .def name
  • .desc symbol, abs-expression
  • .dim
  • .double flonums
  • .eject
  • .else
  • .endef
  • .endif
  • .equ symbol, expression
  • .equiv symbol, expression
  • .err
  • .extern
  • .file string
  • .fill repeat , size , value
  • .float flonums
  • .global symbol, .globl symbol
  • .hword expressions
  • .ident
  • .if absolute expression
  • .include "file"
  • .int expressions
  • .irp symbol,values...
  • .irpc symbol,values...
  • .lcomm symbol , length
  • .lflags
  • .line line-number
  • .linkonce [type]
  • .ln line-number
  • .mri val
  • .list
  • .long expressions
  • .macro
  • .nolist
  • .octa bignums
  • .org new-lc , fill
  • .p2align[wl] abs-expr, abs-expr, abs-expr
  • .psize lines , columns
  • .quad bignums
  • .rept count
  • .sbttl "subheading"
  • .scl class
  • .section name
  • .set symbol, expression
  • .short expressions
  • .single flonums
  • .size
  • .sleb128 expressions
  • .skip size , fill
  • .space size , fill
  • .stabd, .stabn, .stabs
  • .string "str"
  • .symver
  • .tag structname
  • .text subsection
  • .title "heading"
  • .type int
  • .val addr
  • .uleb128 expressions
  • .word expressions
  • Deprecated Directives
• Machine Dependent Features
• ARC Dependent Features
  • Options
  • Floating Point
  • ARC Machine Directives
• AMD 29K Dependent Features
  • Options
  • Syntax
    • Macros
    • Special Characters
    • Register Names
  • Floating Point
  • AMD 29K Machine Directives
  • Opcodes
• ARM Dependent Features
  • Options
  • Syntax
    • Special Characters
    • Register Names
  • Floating Point
  • ARM Machine Directives
  • Opcodes
• D10V Dependent Features
  • D10V Options
  • Syntax
    • Size Modifiers
    • Sub-Instructions
    • Special Characters
    • Register Names
    • Addressing Modes
    • @WORD Modifier
  • Floating Point
  • Opcodes
• H8/300 Dependent Features
  • Options
  • Syntax
    • Special Characters
    • Register Names
    • Addressing Modes
  • Floating Point
  • H8/300 Machine Directives
  • Opcodes
• H8/500 Dependent Features
  • Options
  • Syntax
    • Special Characters
    • Register Names
    • Addressing Modes
  • Floating Point
  • H8/500 Machine Directives
  • Opcodes
• HPPA Dependent Features
  • Notes
  • Options
  • Syntax
  • Floating Point
  • HPPA Assembler Directives
  • Opcodes
• 80386 Dependent Features
  • Options
  • AT&T Syntax versus Intel Syntax
  • Opcode Naming
  • Register Naming
  • Opcode Prefixes
  • Memory References
  • Handling of Jump Instructions
  • Floating Point
  • Writing 16-bit Code
  • Notes
• Intel 80960 Dependent Features
  • i960 Command-line Options
  • Floating Point
  • i960 Machine Directives
  • i960 Opcodes
    • callj
    • Compare-and-Branch
• M680x0 Dependent Features
  • M680x0 Options
  • Syntax
  • Motorola Syntax
  • Floating Point
  • 680x0 Machine Directives
  • Opcodes
    • Branch Improvement
    • Special Characters
• MIPS Dependent Features
  • Assembler options
  • MIPS ECOFF object code
  • Directives for debugging information
  • Directives to override the ISA level
  • Directives for extending MIPS 16 bit instructions
  • Directive to mark data as an instruction
  • Directives to save and restore options
• Hitachi SH Dependent Features
  • Options
  • Syntax
    • Special Characters
    • Register Names
    • Addressing Modes
  • Floating Point
  • SH Machine Directives
  • Opcodes
• SPARC Dependent Features
  • Options
  • Enforcing aligned data
  • Floating Point
  • Sparc Machine Directives
• Z8000 Dependent Features
  • Options
  • Syntax
    • Special Characters
    • Register Names
    • Addressing Modes
  • Assembler Directives for the Z8000
  • Opcodes
• VAX Dependent Features
  • VAX Command-Line Options
  • VAX Floating Point
  • Vax Machine Directives
  • VAX Opcodes
  • VAX Branch Improvement
  • VAX Operands
  • Not Supported on VAX
• v850 Dependent Features
  • Options
  • Syntax
    • Special Characters
    • Register Names
  • Floating Point
  • V850 Machine Directives
  • Opcodes
• Reporting Bugs
  • Have you found a bug?
  • How to report bugs
• Acknowledgements
• Index

This document was generated on 24 April 1999 using the texi2html translator version 1.52.