Chapter 29. Assembler Directives

Table of Contents
29.1. .abort
29.2. .ABORT
29.3. .align abs-expr, abs-expr, abs-expr
29.4. .app-file string
29.5. .ascii "string"...
29.6. .asciz "string"...
29.7. .balign[wl] abs-expr, abs-expr, abs-expr
29.8. .byte expressions
29.9. .comm symbol, length
29.10. .data subsection
29.11. .def name
29.12. .dim
29.13. .double flonums
29.14. .eject
29.15. .else
29.16. .endef
29.17. .endif
29.18. .equ symbol, expression
29.19. .equiv symbol, expression
29.20. .err
29.21. .extern
29.22. .file string
29.23. .fill repeat, size, value
29.24. .float flonums
29.25. .global symbol, .globl symbol
29.26. .hword expressions
29.27. .ident
29.28. .if absolute expression
29.29. .include "file"
29.30. .int expressions
29.31. .irp symbol, values...
29.32. .irpc symbol,values...
29.33. .lcomm symbol, length
29.34. .lflags
29.35. .line line-number
29.36. .linkonce [type]
29.37. .ln line-number
29.38. .list
29.39. .long expressions
29.40. .macro
29.41. .nolist
29.42. .octa bignums
29.43. .org new-lc, fill
29.44. .p2align[wl] abs-expr, abs-expr, abs-expr
29.45. .psize lines, columns
29.46. .quad bignums
29.47. .rept count
29.48. .sbttl "sub heading"
29.49. .scl class
29.50. .section name, subsection
29.51. .set symbol, expression
29.52. .short expressions
29.53. .single flonums
29.54. .size
29.55. .skip size, fill
29.56. .space size, fill
29.57. .stabd, .stabn, .stabs
29.58. .string "str"
29.59. .tag structname
29.60. .text subsection
29.61. .title "heading"
29.62. .type int
29.63. .val addr
29.64. .word expressions
29.65. Deprecated Directives

All assembler directives have names that begin with a period (“.”). The rest of the name is letters, usually 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 Chapter 30.

29.1. .abort

This directive stops the assembly immediately. It is for compatibility with other assemblers. The original idea was that the assembly language source would be piped into the assembler. If the sender of the source quit, it could use this directive tells the assembler to quit also. One day .abort will not be supported.