Table of Contents

1.1 Structure of this Manual

1.2 The GNU Assembler

1.3 Object File Formats

1.4 Command Line

1.5 Input Files

1.6 Output (Object) File

1.7 Error and Warning Messages

2. Command-Line Options

2.1 Enable Listings: `-a[cdhlns]'

2.3 Work Faster: `-f'

2.4 .include Search Path: `-I' path

2.5 Difference Tables: `-K'

2.6 Include Local Labels: `-L'

2.7 Configuring listing output: `--listing'

2.8 Assemble in MRI Compatibility Mode: `-M'

2.9 Dependency Tracking: `--MD'

2.10 Name the Object File: `-o'

2.11 Join Data and Text Sections: `-R'

2.12 Display Assembly Statistics: `--statistics'

2.13 Compatible Output: `--traditional-format'

2.14 Announce Version: `-v'

2.15 Control Warnings: `-W', `--warn', `--no-warn', `--fatal-warnings'

2.16 Generate Object File in Spite of Errors: `-Z'

3.1 Preprocessing

3.6.1 Character Constants

3.6.1.1 Strings

3.6.1.2 Characters

3.6.2 Number Constants

3.6.2.1 Integers

3.6.2.2 Bignums

3.6.2.3 Flonums

4. Sections and Relocation

4.2 Linker Sections

4.3 Assembler Internal Sections

4.4 Sub-Sections

4.5 bss Section

5.2 Giving Symbols Other Values

5.3 Symbol Names

5.4 The Special Dot Symbol

5.5 Symbol Attributes

5.5.3 Symbol Attributes: a.out

5.5.3.1 Descriptor

5.5.4 Symbol Attributes for COFF

5.5.4.1 Primary Attributes

5.5.4.2 Auxiliary Attributes

5.5.5 Symbol Attributes for SOM

6.1 Empty Expressions

6.2 Integer Expressions

6.2.1 Arguments

6.2.2 Operators

6.2.3 Prefix Operator

6.2.4 Infix Operators

7. Assembler Directives

7.3 .align abs-expr, abs-expr, abs-expr

7.4 .ascii "string"...

7.5 .asciz "string"...

7.6 .balign[wl] abs-expr, abs-expr, abs-expr

7.7 .byte expressions

7.8 .comm symbol , length

7.9 .cfi_startproc

7.10 .cfi_endproc

7.11 .cfi_def_cfa register, offset

7.12 .cfi_def_cfa_register register

7.13 .cfi_def_cfa_offset offset

7.14 .cfi_adjust_cfa_offset offset

7.15 .cfi_offset register, offset

7.16 .cfi_rel_offset register, offset

7.17 .cfi_window_save

7.18 .cfi_escape expression[, ...]

7.19 .data subsection

7.20 .def name

7.21 .desc symbol, abs-expression

7.23 .double flonums

7.29 .endfunc

7.31 .equ symbol, expression

7.32 .equiv symbol, expression

7.36 .fail expression

7.37 .file string

7.38 .fill repeat , size , value

7.39 .float flonums

7.40 .func name[,label]

7.41 .global symbol, .globl symbol

7.42 .hidden names

7.43 .hword expressions

7.45 .if absolute expression

7.46 .incbin "file"[,skip[,count]]

7.47 .include "file"

7.48 .int expressions

7.49 .internal names

7.50 .irp symbol,values...

7.51 .irpc symbol,values...

7.52 .lcomm symbol , length

7.54 .line line-number

7.55 .linkonce [type]

7.56 .ln line-number

7.57 .mri val

7.59 .long expressions

7.62 .octa bignums

7.63 .org new-lc , fill

7.64 .p2align[wl] abs-expr, abs-expr, abs-expr

7.65 .previous

7.66 .popsection

7.67 .print string

7.68 .protected names

7.69 .psize lines , columns

7.70 .purgem name

7.71 .pushsection name , subsection

7.72 .quad bignums

7.73 .rept count

7.74 .sbttl "subheading"

7.75 .scl class

7.76 .section name

7.77 .set symbol, expression

7.78 .short expressions

7.79 .single flonums

7.81 .sleb128 expressions

7.82 .skip size , fill

7.83 .space size , fill

7.84 .stabd, .stabn, .stabs

7.85 .string "str"

7.86 .struct expression

7.87 .subsection name

7.89 .tag structname

7.90 .text subsection

7.91 .title "heading"

7.93 .uleb128 expressions

7.94 .val addr

7.95 .version "string"

7.96 .vtable_entry table, offset

7.97 .vtable_inherit child, parent

7.98 .weak names

7.99 .word expressions

7.100 Deprecated Directives

8. Machine Dependent Features

8.1 AMD 29K Dependent Features

8.1.2.2 Special Characters

8.1.2.3 Register Names

8.1.3 Floating Point

8.1.4 AMD 29K Machine Directives

8.2 Alpha Dependent Features

8.2.3.1 Special Characters

8.2.3.2 Register Names

8.2.3.3 Relocations

8.2.4 Floating Point

8.2.5 Alpha Assembler Directives

8.3 ARC Dependent Features

8.3.2.1 Special Characters

8.3.2.2 Register Names

8.3.3 Floating Point

8.3.4 ARC Machine Directives

8.4 ARM Dependent Features

8.4.2.1 Special Characters

8.4.2.2 Register Names

8.4.3 Floating Point

8.4.4 ARM Machine Directives

8.4.6 Mapping Symbols

8.5 CRIS Dependent Features

8.5.1 Command-line Options

8.5.2 Instruction expansion

8.5.3.1 Special Characters

8.5.3.2 Symbols in position-independent code

8.5.3.3 Register names

8.5.3.4 Assembler Directives

8.6 D10V Dependent Features

8.6.1 D10V Options

8.6.2.1 Size Modifiers

8.6.2.2 Sub-Instructions

8.6.2.3 Special Characters

8.6.2.4 Register Names

8.6.2.5 Addressing Modes

8.6.2.6 @WORD Modifier

8.6.3 Floating Point

8.7 D30V Dependent Features

8.7.1 D30V Options

8.7.2.1 Size Modifiers

8.7.2.2 Sub-Instructions

8.7.2.3 Special Characters

8.7.2.4 Guarded Execution

8.7.2.5 Register Names

8.7.2.6 Addressing Modes

8.7.3 Floating Point

8.8 H8/300 Dependent Features

8.8.2.1 Special Characters

8.8.2.2 Register Names

8.8.2.3 Addressing Modes

8.8.3 Floating Point

8.8.4 H8/300 Machine Directives

8.9 H8/500 Dependent Features

8.9.2.1 Special Characters

8.9.2.2 Register Names

8.9.2.3 Addressing Modes

8.9.3 Floating Point

8.9.4 H8/500 Machine Directives

8.10 HPPA Dependent Features

8.10.4 Floating Point

8.10.5 HPPA Assembler Directives

8.11 ESA/390 Dependent Features

8.11.4 Floating Point

8.11.5 ESA/390 Assembler Directives

8.12 80386 Dependent Features

8.12.2 AT&T Syntax versus Intel Syntax

8.12.3 Instruction Naming

8.12.4 Register Naming

8.12.5 Instruction Prefixes

8.12.6 Memory References

8.12.7 Handling of Jump Instructions

8.12.8 Floating Point

8.12.9 Intel's MMX and AMD's 3DNow! SIMD Operations

8.12.10 Writing 16-bit Code

8.12.11 AT&T Syntax bugs

8.12.12 Specifying CPU Architecture

8.13 Intel i860 Dependent Features

8.13.1 i860 Notes

8.13.2 i860 Command-line Options

8.13.2.1 SVR4 compatibility options

8.13.2.2 Other options

8.13.3 i860 Machine Directives

8.13.4 i860 Opcodes

8.13.4.1 Other instruction support (pseudo-instructions)

8.14 Intel 80960 Dependent Features

8.14.1 i960 Command-line Options

8.14.2 Floating Point

8.14.3 i960 Machine Directives

8.14.4 i960 Opcodes

8.14.4.1 callj

8.14.4.2 Compare-and-Branch

8.15 IP2K Dependent Features

8.15.1 IP2K Options

8.16 M32R Dependent Features

8.16.1 M32R Options

8.16.2 M32R Directives

8.16.3 M32R Warnings

8.17 M680x0 Dependent Features

8.17.1 M680x0 Options

8.17.3 Motorola Syntax

8.17.4 Floating Point

8.17.5 680x0 Machine Directives

8.17.6.1 Branch Improvement

8.17.6.2 Special Characters

8.18 M68HC11 and M68HC12 Dependent Features

8.18.1 M68HC11 and M68HC12 Options

8.18.3 Symbolic Operand Modifiers

8.18.4 Assembler Directives

8.18.5 Floating Point

8.18.6.1 Branch Improvement

8.19 Motorola M88K Dependent Features

8.19.1 M88K Machine Directives

8.20 MIPS Dependent Features

8.20.1 Assembler options

8.20.2 MIPS ECOFF object code

8.20.3 Directives for debugging information

8.20.4 Directives to override the ISA level

8.20.5 Directives for extending MIPS 16 bit instructions

8.20.6 Directive to mark data as an instruction

8.20.7 Directives to save and restore options

8.20.8 Directives to control generation of MIPS ASE instructions

8.21 MMIX Dependent Features

8.21.1 Command-line Options

8.21.2 Instruction expansion

8.21.3.1 Special Characters

8.21.3.2 Symbols

8.21.3.3 Register names

8.21.3.4 Assembler Directives

8.21.4 Differences to mmixal

8.22 MSP 430 Dependent Features

8.22.2.1 Macros

8.22.2.2 Special Characters

8.22.2.3 Register Names

8.22.2.4 Assembler Extensions

8.22.3 Floating Point

8.22.4 MSP 430 Machine Directives

8.23 PDP-11 Dependent Features

8.23.1.1 Code Generation Options

8.23.1.2 Instruction Set Extension Options

8.23.1.3 CPU Model Options

8.23.1.4 Machine Model Options

8.23.2 Assembler Directives

8.23.3 PDP-11 Assembly Language Syntax

8.23.4 Instruction Naming

8.23.5 Synthetic Instructions

8.24 picoJava Dependent Features

8.25 PowerPC Dependent Features

8.25.2 PowerPC Assembler Directives

8.26 Renesas / SuperH SH Dependent Features

8.26.2.1 Special Characters

8.26.2.2 Register Names

8.26.2.3 Addressing Modes

8.26.3 Floating Point

8.26.4 SH Machine Directives

8.27 SuperH SH64 Dependent Features

8.27.2.1 Special Characters

8.27.2.2 Register Names

8.27.2.3 Addressing Modes

8.27.3 SH64 Machine Directives

8.28 SPARC Dependent Features

8.28.2 Enforcing aligned data

8.28.3 Floating Point

8.28.4 Sparc Machine Directives

8.29 TIC54X Dependent Features

8.29.2 Blocking

8.29.3 Environment Settings

8.29.4 Constants Syntax

8.29.5 String Substitution

8.29.6 Local Labels

8.29.7 Math Builtins

8.29.8 Extended Addressing

8.29.9 Directives

8.29.11 Memory-mapped Registers

8.30 Z8000 Dependent Features

8.30.2.1 Special Characters

8.30.2.2 Register Names

8.30.2.3 Addressing Modes

8.30.3 Assembler Directives for the Z8000

8.31 VAX Dependent Features

8.31.1 VAX Command-Line Options

8.31.2 VAX Floating Point

8.31.3 Vax Machine Directives

8.31.4 VAX Opcodes

8.31.5 VAX Branch Improvement

8.31.6 VAX Operands

8.31.7 Not Supported on VAX

8.32 v850 Dependent Features

8.32.2.1 Special Characters

8.32.2.2 Register Names

8.32.3 Floating Point

8.32.4 V850 Machine Directives

8.33 Xtensa Dependent Features

8.33.1 Command Line Options

8.33.2 Assembler Syntax

8.33.2.1 Opcode Names

8.33.2.2 Register Names

8.33.3 Xtensa Optimizations

8.33.3.1 Using Density Instructions

8.33.3.2 Automatic Instruction Alignment

8.33.4 Xtensa Relaxation

8.33.4.1 Conditional Branch Relaxation

8.33.4.2 Function Call Relaxation

8.33.4.3 Other Immediate Field Relaxation

8.33.5 Directives

8.33.5.1 density

8.33.5.3 longcalls

8.33.5.4 generics

8.33.5.5 literal

8.33.5.6 literal_position

8.33.5.7 literal_prefix

8.33.5.8 freeregs

9. Reporting Bugs

9.1 Have You Found a Bug?

9.2 How to Report Bugs

10. Acknowledgements

A. GNU Free Documentation License

ADDENDUM: How to use this License for your documents

This document was generated by Stephane Carrez on May, 15 2005 using texi2html>