---

7 Assembler Directives

All assembler directives have names that begin with a period (‘.’). The names are case insensitive for most targets, and usually written in lower case.

This chapter discusses directives that are available regardless of the target machine configuration for the GNU assembler. Some machine configurations provide additional directives. See Machine Dependent Features.

• .abort
• .ABORT (COFF)
• .align [abs-expr[, abs-expr[, abs-expr]]]
• .altmacro
• .ascii "string"…
• .asciz "string"…
• .attach_to_group name
• .balign[wl] [abs-expr[, abs-expr[, abs-expr]]]
• .base64 "string"[, …]
• .bss subsection
• Bundle directives
• .byte expressions
• CFI directives
• .comm symbol , length
• .data subsection
• .dc[size] expressions
• .dcb[size] number [,fill]
• .ds[size] number [,fill]
• .def name
• .desc symbol, abs-expression
• .dim
• .double flonums
• .eject
• .else
• .elseif
• .end
• .endef
• .endfunc
• .endif
• .equ symbol, expression
• .equiv symbol, expression
• .eqv symbol, expression
• .err
• .error "string"
• .exitm
• .extern
• .fail expression
• .file
• .fill repeat , size , value
• .float flonums
• .func name[,label]
• .global symbol, .globl symbol
• .gnu_attribute tag,value
• .hidden names
• .hword expressions
• .ident
• .if absolute expression
• .incbin "file"[,skip[,count]]
• .include "file"
• .int expressions
• .internal names
• .irp symbol,value…
• .irpc symbol,values…
• .lcomm symbol , length
• .lflags
• .line line-number
• .linkonce [type]
• .list
• .ln line-number
• .loc fileno lineno [column] [options]
• .loc_mark_labels enable
• .local names
• .long expressions
• .macro
• .mri val
• .noaltmacro
• .nolist
• .nop [size]
• .nops size[, control]
• .octa bignums
• .offset loc
• .org new-lc , fill
• .p2align[wl] [abs-expr[, abs-expr[, abs-expr]]]
• .popsection
• .previous
• .print string
• .protected names
• .psize lines , columns
• .purgem name
• .pushsection name [, subsection] [, "flags"[, @type[,arguments]]]
• .quad expressions
• .reloc offset, reloc_name[, expression]
• .rept count
• .sbttl "subheading"
• .scl class
• .section name
• .set symbol, expression
• .short expressions
• .single flonums
• .size
• .skip size [,fill]
• .sleb128 expressions
• .space size [,fill]
• .stabd, .stabn, .stabs
• .string "str", .string8 "str", .string16
• .struct expression
• .subsection name
• .symver
• .tag structname
• .text subsection
• .title "heading"
• .tls_common symbol, length[, alignment]
• .type
• .uleb128 expressions
• .val addr
• .version "string"
• .vtable_entry table, offset
• .vtable_inherit child, parent
• .warning "string"
• .weak names
• .weakref alias, target
• .word expressions
• .zero size
• .2byte expression [, expression]*
• .4byte expression [, expression]*
• .8byte expression [, expression]*
• Deprecated Directives