Chapter 35. Assembler Directives

Table of Contents
35.1. .abort
35.2. .ABORT
35.3. .align abs-expr, abs-expr, abs-expr
35.4. .app-file string
35.5. .ascii "string"...
35.6. .asciz "string"...
35.7. .balign[wl] abs-expr, abs-expr, abs-expr
35.8. .byte expressions
35.9. .comm symbol, length
35.10. .data subsection
35.11. .def name
35.12. .dim
35.13. .double flonums
35.14. .eject
35.15. .else
35.16. .endef
35.17. .endif
35.18. .equ symbol, expression
35.19. .equiv symbol, expression
35.20. .err
35.21. .extern
35.22. .file string
35.23. .fill repeat, size, value
35.24. .float flonums
35.25. .global symbol, .globl symbol
35.26. .hword expressions
35.27. .ident
35.28. .if absolute expression
35.29. .include "file"
35.30. .int expressions
35.31. .irp symbol, values...
35.32. .irpc symbol,values...
35.33. .lcomm symbol, length
35.34. .lflags
35.35. .line line-number
35.36. .linkonce [type]
35.37. .ln line-number
35.38. .list
35.39. .long expressions
35.40. .macro
35.41. .nolist
35.42. .octa bignums
35.43. .org new-lc, fill
35.44. .p2align[wl] abs-expr, abs-expr, abs-expr
35.45. .psize lines, columns
35.46. .quad bignums
35.47. .rept count
35.48. .sbttl "sub heading"
35.49. .scl class
35.50. .section name, subsection
35.51. .set symbol, expression
35.52. .short expressions
35.53. .single flonums
35.54. .size
35.55. .skip size, fill
35.56. .space size, fill
35.57. .stabd, .stabn, .stabs
35.58. .string "str"
35.59. .tag structname
35.60. .text subsection
35.61. .title "heading"
35.62. .type int
35.63. .val addr
35.64. .word expressions
35.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 36.

35.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.