NASM - The Netwide Assembler

version 3.01

Table of Contents

Chapters

  1. Chapter 1: Introduction
    1. Section 1.1: What Is NASM?
      1. Section 1.1.1: License
  2. Chapter 2: Running NASM
    1. Section 2.1: NASM Command-Line Syntax
      1. Section 2.1.1: The -o Option: Output File Name
      2. Section 2.1.2: The -f Option: Output File Format
      3. Section 2.1.3: The -l Option: Generating a Listing File
      4. Section 2.1.4: The -L Option: Additional or Modified Listing Info
      5. Section 2.1.5: The -M Option: Generate Makefile Dependencies
      6. Section 2.1.6: The -MG Option: Generate Makefile Dependencies
      7. Section 2.1.7: The -MF Option: Set Makefile Dependency File
      8. Section 2.1.8: The -MD Option: Assemble and Generate Dependencies
      9. Section 2.1.9: The -MT Option: Dependency Target Name
      10. Section 2.1.10: The -MQ Option: Dependency Target Name (Quoted)
      11. Section 2.1.11: The -MP Option: Emit Phony Makefile Targets
      12. Section 2.1.12: The -MW Option: Watcom make quoting style
      13. Section 2.1.13: The -F Option: Debug Information Format
      14. Section 2.1.14: The -g Option: Enabling Debug Information.
      15. Section 2.1.15: The -X Option: Selecting an Error Reporting Format
      16. Section 2.1.16: The -Z Option: Send Errors to a File
      17. Section 2.1.17: The -s Option: Send Errors to stdout
      18. Section 2.1.18: The -i Option: Include File Search Directories
      19. Section 2.1.19: The -p Option: Pre-Include a File
      20. Section 2.1.20: The -d Option: Pre-Define a Macro
      21. Section 2.1.21: The -u Option: Undefine a Macro
      22. Section 2.1.22: The -E Option: Preprocess Only
      23. Section 2.1.23: The -a Option: Suppress Preprocessing
      24. Section 2.1.24: The -O Option: Multipass Optimization
      25. Section 2.1.25: The -t Option: TASM Compatibility Mode
      26. Section 2.1.26: The -w and -W Options: Enable or Disable Assembly Warnings
      27. Section 2.1.27: The -v Option: Display Version Info
      28. Section 2.1.28: The --[gl]prefix and --[gl]postfix Options
      29. Section 2.1.29: The --pragma Option
      30. Section 2.1.30: The --before Option
      31. Section 2.1.31: The --bits Option
      32. Section 2.1.32: The --limit- Options
      33. Section 2.1.33: The --keep-all Option
      34. Section 2.1.34: The --no-line Option
      35. Section 2.1.35: The --reproducible Option
      36. Section 2.1.36: The NASMENV Environment Variable
    2. Section 2.2: Quick Start for MASM Users
      1. Section 2.2.1: NASM Is Case-Sensitive
      2. Section 2.2.2: NASM Requires Square Brackets For Memory References
      3. Section 2.2.3: NASM Doesn't Store Variable Types
      4. Section 2.2.4: NASM Doesn't ASSUME
      5. Section 2.2.5: NASM Doesn't Support Memory Models
      6. Section 2.2.6: Floating-Point Differences
      7. Section 2.2.7: Other Differences
      8. Section 2.2.8: MASM compatibility package
  3. Chapter 3: The NASM Language
    1. Section 3.1: Layout of a NASM Source Line
    2. Section 3.2: Pseudo-Instructions
      1. Section 3.2.1: Dx: Declaring Initialized Data
      2. Section 3.2.2: RESB and Friends: Declaring Uninitialized Data
      3. Section 3.2.3: INCBIN: Including External Binary Files
      4. Section 3.2.4: EQU: Defining Constants
      5. Section 3.2.5: TIMES: Repeating Instructions or Data
    3. Section 3.3: Effective Addresses
    4. Section 3.4: Constants
      1. Section 3.4.1: Numeric Constants
      2. Section 3.4.2: Character Strings
      3. Section 3.4.3: Character Constants
      4. Section 3.4.4: String Constants
      5. Section 3.4.5: Unicode Strings
      6. Section 3.4.6: Floating-Point Constants
      7. Section 3.4.7: Packed BCD Constants
    5. Section 3.5: Expressions
      1. Section 3.5.1: ? ... :: Conditional Operator
      2. Section 3.5.2: : ||: Boolean OR Operator
      3. Section 3.5.3: : ^^: Boolean XOR Operator
      4. Section 3.5.4: : &&: Boolean AND Operator
      5. Section 3.5.5: : Comparison Operators
      6. Section 3.5.6: |: Bitwise OR Operator
      7. Section 3.5.7: ^: Bitwise XOR Operator
      8. Section 3.5.8: &: Bitwise AND Operator
      9. Section 3.5.9: Bit Shift Operators
      10. Section 3.5.10: + and -: Addition and Subtraction Operators
      11. Section 3.5.11: Multiplication, Division and Modulo
      12. Section 3.5.12: Unary Operators
    6. Section 3.6: SEG and WRT
    7. Section 3.7: STRICT: Inhibiting Optimization
    8. Section 3.8: Critical Expressions
    9. Section 3.9: Local Labels
  4. Chapter 4: Syntax Quirks and Summaries
    1. Section 4.1: Summary of the JMP and CALL Syntax
      1. Section 4.1.1: Near Jumps
      2. Section 4.1.2: Infinite Loop Trick
      3. Section 4.1.3: Jumps and Mixed Sizes
      4. Section 4.1.4: Calling Procedures Outside of a Shared Library
      5. Section 4.1.5: FAR Calls and Jumps
      6. Section 4.1.6: 64-bit absolute jump (JMPABS)
    2. Section 4.2: Compact NDS/NDD Operands
    3. Section 4.3: 64-bit moffs
    4. Section 4.4: Split EA Addressing Syntax
    5. Section 4.5: No Syntax for Ternary Logic Instruction
    6. Section 4.6: APX Instruction Syntax
      1. Section 4.6.1: Extended General Purpose Registers (EGPRs)
      2. Section 4.6.2: New Data Destination (NDD)
      3. Section 4.6.3: Suppress Modifying Flags (NF)
      4. Section 4.6.4: Zero Upper (ZU)
      5. Section 4.6.5: Source Condition Code (Scc) and Default Flags Value (DFV)
      6. Section 4.6.6: PUSH and POP Extensions
      7. Section 4.6.7: APX and the NASM optimizer
      8. Section 4.6.8: Force APX Encoding
  5. Chapter 5: The NASM Preprocessor
    1. Section 5.1: Preprocessor Expansions
      1. Section 5.1.1: Continuation Line Collapsing
      2. Section 5.1.2: Comment Removal
      3. Section 5.1.3: %line directives
      4. Section 5.1.4: Conditionals, Loops and Multi-Line Macro Definitions
      5. Section 5.1.5: Directives processing
      6. Section 5.1.6: Inline expansions and other directives
      7. Section 5.1.7: Multi-Line Macro Expansion
      8. Section 5.1.8: Detokenization
    2. Section 5.2: Single-Line Macros
      1. Section 5.2.1: The Normal Way: %define
      2. Section 5.2.2: Resolving %define: %xdefine
      3. Section 5.2.3: Macro Indirection: %[...]
      4. Section 5.2.4: Concatenating Single Line Macro Tokens: %+
      5. Section 5.2.5: The Macro Name Itself: %? and %??
      6. Section 5.2.6: The Single-Line Macro Name: %*? and %*??
      7. Section 5.2.7: Undefining Single-Line Macros: %undef
      8. Section 5.2.8: Preprocessor Variables: %assign
      9. Section 5.2.9: Defining Strings: %defstr
      10. Section 5.2.10: Defining Tokens: %deftok
      11. Section 5.2.11: Defining Aliases: %defalias
      12. Section 5.2.12: Conditional Comma Operator: %,
    3. Section 5.3: String Manipulation in Macros
      1. Section 5.3.1: Concatenating Strings: %strcat
      2. Section 5.3.2: String Length: %strlen
      3. Section 5.3.3: Extracting Substrings: %substr
    4. Section 5.4: Preprocessor Functions
      1. Section 5.4.1: %abs() Function
      2. Section 5.4.2: %b2hs() Function
      3. Section 5.4.3: %chr() Function
      4. Section 5.4.4: %cond() Function
      5. Section 5.4.5: %count() Function
      6. Section 5.4.6: %depend() Function
      7. Section 5.4.7: %eval() Function
      8. Section 5.4.8: %find() and %findi() Functions
      9. Section 5.4.9: %hex() Function
      10. Section 5.4.10: %hs2b() Function
      11. Section 5.4.11: %is() Family Functions
      12. Section 5.4.12: %map() Function
      13. Section 5.4.13: %null() Function
      14. Section 5.4.14: %num() Function
      15. Section 5.4.15: %ord() Function
      16. Section 5.4.16: %pathsearch() Function
      17. Section 5.4.17: %realpath() Function
      18. Section 5.4.18: %sel() Function
      19. Section 5.4.19: %selbits() Function
      20. Section 5.4.20: %str() Function
      21. Section 5.4.21: %strcat() Function
      22. Section 5.4.22: %strlen() Function
      23. Section 5.4.23: %substr() Function
      24. Section 5.4.24: %tok() function
    5. Section 5.5: Multi-Line Macros: %macro
      1. Section 5.5.1: Overloading Multi-Line Macros
      2. Section 5.5.2: Macro-Local Labels
      3. Section 5.5.3: Greedy Macro Parameters
      4. Section 5.5.4: Macro Parameters Range
      5. Section 5.5.5: Default Macro Parameters
      6. Section 5.5.6: %0: Macro Parameter Counter
      7. Section 5.5.7: %00: Label Preceding Macro
      8. Section 5.5.8: %rotate: Rotating Macro Parameters
      9. Section 5.5.9: Concatenating Macro Parameters
      10. Section 5.5.10: Condition Codes as Macro Parameters
      11. Section 5.5.11: Disabling Listing Expansion
      12. Section 5.5.12: Undefining Multi-Line Macros: %unmacro, %unimacro
      13. Section 5.5.13: %exitmacro: Stop Expanding a Multi-Line Macro
    6. Section 5.6: Conditional Assembly
      1. Section 5.6.1: %if: Testing Arbitrary Numeric Expressions
      2. Section 5.6.2: %ifdef: Testing Single-Line Macro Existence
      3. Section 5.6.3: %ifdefalias: Testing Single-Line Macro Alias Existence
      4. Section 5.6.4: %ifmacro: Testing Multi-Line Macro Existence
      5. Section 5.6.5: %ifctx: Testing the Context Stack
      6. Section 5.6.6: %ifidn and %ifidni: Testing Exact Text Identity
      7. Section 5.6.7: %ifid, %ifnum, %ifstr: Testing Token Types
      8. Section 5.6.8: %iftoken: Test for a Single Token
      9. Section 5.6.9: %ifempty: Test for Empty Expansion
      10. Section 5.6.10: %ifdirective: Test If a Directive Is Supported
      11. Section 5.6.11: %ifusable and %ifusing: Test For Standard Macro Packages
      12. Section 5.6.12: %iffile: Test If a File Exists
      13. Section 5.6.13: %ifenv: Test If Environment Variable Exists
      14. Section 5.6.14: Backwards Compatibility Caveat
    7. Section 5.7: Preprocessor Loops: %rep
    8. Section 5.8: Source Files and Dependencies
      1. Section 5.8.1: %include: Including Other Files
      2. Section 5.8.2: %pathsearch: Search the Include Path
      3. Section 5.8.3: %depend: Add Dependent Files
      4. Section 5.8.4: %use: Include Standard Macro Package
    9. Section 5.9: The Context Stack
      1. Section 5.9.1: %push and %pop: Creating and Removing Contexts
      2. Section 5.9.2: Context-Local Labels
      3. Section 5.9.3: Context-Local Single-Line Macros
      4. Section 5.9.4: Context Fall-Through Lookup (deprecated)
      5. Section 5.9.5: %repl: Renaming a Context
      6. Section 5.9.6: Example Use of the Context Stack: Block IFs
    10. Section 5.10: Stack Relative Preprocessor Directives
      1. Section 5.10.1: %arg Directive
      2. Section 5.10.2: %stacksize Directive
      3. Section 5.10.3: %local Directive
    11. Section 5.11: Reporting User-generated Diagnostics: %error, %warning, %fatal, %note
    12. Section 5.12: %pragma: Setting Options
      1. Section 5.12.1: Preprocessor Pragmas
    13. Section 5.13: Other Preprocessor Directives
      1. Section 5.13.1: %line Directive
      2. Section 5.13.2: %!variable: Read an Environment Variable.
      3. Section 5.13.3: %clear: Clear All Macro Definitions
  6. Chapter 6: Standard Macros
    1. Section 6.1: NASM Version Macros
      1. Section 6.1.1: __?NASM_VERSION_ID?__: NASM Version ID
      2. Section 6.1.2: __?NASM_VER?__: NASM Version String
    2. Section 6.2: __?FILE?__ and __?LINE?__: File Name and Line Number
    3. Section 6.3: __?BITS?__: Current Code Generation Mode
    4. Section 6.4: __?DEFAULT?__: DEFAULT directive settings
    5. Section 6.5: __?OUTPUT_FORMAT?__: Current Output Format
    6. Section 6.6: __?DEBUG_FORMAT?__: Current Debug Format
    7. Section 6.7: Assembly Date and Time Macros
    8. Section 6.8: __?NASM_HAS_IFDIRECTIVE?__: Directive Probing Support
    9. Section 6.9: __?USE_package?__: Package Include Test
    10. Section 6.10: __?PASS?__: Assembly Pass
    11. Section 6.11: Structure Data Types
      1. Section 6.11.1: STRUC and ENDSTRUC: Declaring Structure Data Types
      2. Section 6.11.2: ISTRUC, AT and IEND: Declaring Instances of Structures
    12. Section 6.12: Alignment Control
      1. Section 6.12.1: ALIGN and ALIGNB: Code and Data Alignment
      2. Section 6.12.2: SECTALIGN: Section Alignment
  7. Chapter 7: Standard Macro Packages
    1. Section 7.1: altreg: Alternate Register Names
    2. Section 7.2: smartalign: Smart ALIGN Macro
    3. Section 7.3: fp: Floating-point macros
    4. Section 7.4: ifunc: Integer functions
      1. Section 7.4.1: Integer logarithms
    5. Section 7.5: masm: MASM compatibility
    6. Section 7.6: vtern: Ternary Logic Assist
  8. Chapter 8: Assembler Directives
    1. Section 8.1: BITS: Target Processor Mode
      1. Section 8.1.1: USE16 & USE32: Aliases for BITS
    2. Section 8.2: DEFAULT: Change the assembler defaults
      1. Section 8.2.1: REL, ABS: RIP-relative addressing
      2. Section 8.2.2: BND, NOBND: BND prefix
    3. Section 8.3: SECTION or SEGMENT: Changing and Defining Sections
      1. Section 8.3.1: The __?SECT?__ Macro
    4. Section 8.4: ABSOLUTE: Defining Absolute Labels
    5. Section 8.5: EXTERN: Importing Symbols from Other Modules
    6. Section 8.6: REQUIRED: Unconditionally Importing Symbols from Other Modules
    7. Section 8.7: GLOBAL: Exporting Symbols to Other Modules
    8. Section 8.8: COMMON: Defining Common Data Areas
    9. Section 8.9: STATIC: Local Symbols within Modules
    10. Section 8.10: [[GL]PREFIX], [[GL]SUFFIX]: Mangling Symbols
    11. Section 8.11: CPU: Defining CPU Dependencies
    12. Section 8.12: [DOLLARHEX]: Enable or disable $ hexadecimal syntax
    13. Section 8.13: FLOAT: Handling of floating-point constants
    14. Section 8.14: [WARNING]: Enable or disable warnings
    15. Section 8.15: [LIST]: Locally disable list file output
  9. Chapter 9: Output Formats
    1. Section 9.1: bin: Flat-Form Binary Output
      1. Section 9.1.1: ORG: Binary File Program Origin
      2. Section 9.1.2: bin Extensions to the SECTION Directive
      3. Section 9.1.3: Multisection Support for the bin Format
      4. Section 9.1.4: Map Files
    2. Section 9.2: ith: Intel Hex Output
    3. Section 9.3: srec: Motorola S-Records Output
    4. Section 9.4: obj: Microsoft OMF Object Files
      1. Section 9.4.1: obj Extensions to the SEGMENT Directive
      2. Section 9.4.2: GROUP: Defining Groups of Segments
      3. Section 9.4.3: UPPERCASE: Disabling Case Sensitivity in Output
      4. Section 9.4.4: IMPORT: Importing DLL Symbols
      5. Section 9.4.5: EXPORT: Exporting DLL Symbols
      6. Section 9.4.6: ..start: Defining the Program Entry Point
      7. Section 9.4.7: obj Extensions to the EXTERN Directive
      8. Section 9.4.8: obj Extensions to the COMMON Directive
      9. Section 9.4.9: Embedded File Dependency Information
    5. Section 9.5: obj2: OS/2 32-bit OMF Object Files
    6. Section 9.6: win32: Microsoft Win32 Object Files
      1. Section 9.6.1: win32 Extensions to the SECTION Directive
      2. Section 9.6.2: win32: Safe Structured Exception Handling
      3. Section 9.6.3: Debugging formats for Windows
    7. Section 9.7: win64: Microsoft Win64 Object Files
      1. Section 9.7.1: win64: Writing Position-Independent Code
      2. Section 9.7.2: win64: Structured Exception Handling
    8. Section 9.8: coff: Common Object File Format
    9. Section 9.9: macho32 and macho64: Mach Object File Format
      1. Section 9.9.1: macho extensions to the SECTION Directive
      2. Section 9.9.2: Thread Local Storage in Mach-O: macho special symbols and WRT
      3. Section 9.9.3: macho specific directive subsections_via_symbols
      4. Section 9.9.4: macho specific directive no_dead_strip
      5. Section 9.9.5: macho specific extensions to the GLOBAL Directive: private_extern
      6. Section 9.9.6: macho specific directive build_version
    10. Section 9.10: elf32, elf64, elfx32: Executable and Linkable Format Object Files
      1. Section 9.10.1: ELF specific directive osabi
      2. Section 9.10.2: ELF extensions to the SECTION Directive
      3. Section 9.10.3: Position-Independent Code: ELF Special Symbols and WRT
      4. Section 9.10.4: Thread Local Storage in ELF: elf Special Symbols and WRT
      5. Section 9.10.5: elf Extensions to the GLOBAL Directive
      6. Section 9.10.6: elf Extensions to the EXTERN Directive
      7. Section 9.10.7: elf Extensions to the COMMON Directive
      8. Section 9.10.8: 16-bit code and ELF
      9. Section 9.10.9: Debug formats and ELF
    11. Section 9.11: aout: Linux a.out Object Files
    12. Section 9.12: aoutb: NetBSD/FreeBSD/OpenBSD a.out Object Files
    13. Section 9.13: as86: Minix/Linux as86 Object Files
    14. Section 9.14: dbg: Debugging Format
  10. Chapter 10: Writing 16-bit Code (DOS, Windows 3/3.1)
    1. Section 10.1: Producing .EXE Files
      1. Section 10.1.1: Using the obj Format To Generate .EXE Files
      2. Section 10.1.2: Using the bin Format To Generate .EXE Files
    2. Section 10.2: Producing .COM Files
      1. Section 10.2.1: Using the bin Format To Generate .COM Files
      2. Section 10.2.2: Using the obj Format To Generate .COM Files
    3. Section 10.3: Producing .SYS Files
    4. Section 10.4: Interfacing to 16-bit C Programs
      1. Section 10.4.1: External Symbol Names
      2. Section 10.4.2: Memory Models
      3. Section 10.4.3: Function Definitions and Function Calls
      4. Section 10.4.4: Accessing Data Items
      5. Section 10.4.5: c16.mac: Helper Macros for the 16-bit C Interface
    5. Section 10.5: Interfacing to Borland Pascal Programs
      1. Section 10.5.1: The Pascal Calling Convention
      2. Section 10.5.2: Borland Pascal Segment Name Restrictions
      3. Section 10.5.3: Using c16.mac With Pascal Programs
  11. Chapter 11: Writing 32-bit Code (Unix, Win32, DJGPP)
    1. Section 11.1: Interfacing to 32-bit C Programs
      1. Section 11.1.1: External Symbol Names
      2. Section 11.1.2: Function Definitions and Function Calls
      3. Section 11.1.3: Accessing Data Items
      4. Section 11.1.4: c32.mac: Helper Macros for the 32-bit C Interface
    2. Section 11.2: Writing NetBSD/FreeBSD/OpenBSD and Linux/ELF Shared Libraries
      1. Section 11.2.1: Obtaining the Address of the GOT
      2. Section 11.2.2: Finding Your Local Data Items
      3. Section 11.2.3: Finding External and Common Data Items
      4. Section 11.2.4: Exporting Symbols to the Library User
      5. Section 11.2.5: Calling Procedures Outside the Library
      6. Section 11.2.6: Generating the Library File
  12. Chapter 12: Mixing 16- and 32-bit Code
    1. Section 12.1: Mixed-Size Jumps
    2. Section 12.2: Addressing Between Different-Size Segments
    3. Section 12.3: Other Mixed-Size Instructions
  13. Chapter 13: Writing 64-bit Code (Unix, Win64)
    1. Section 13.1: Register Names in 64-bit Mode
    2. Section 13.2: Immediates and Displacements in 64-bit Mode
      1. Section 13.2.1: Immediate 64-bit Operands
      2. Section 13.2.2: 64-bit Displacements
    3. Section 13.3: Interfacing to 64-bit C Programs (Unix)
    4. Section 13.4: Interfacing to 64-bit C Programs (Win64)
  14. Chapter 14: Troubleshooting
    1. Section 14.1: Common Problems
      1. Section 14.1.1: NASM Generates Inefficient Code
      2. Section 14.1.2: My Jumps are Out of Range
      3. Section 14.1.3: ORG Doesn't Work
      4. Section 14.1.4: TIMES Doesn't Work

Appendices

  1. Appendix A: List of Warning Classes
    1. Section A.1: Warning Classes
      1. Section A.1.1: Enabled by default
      2. Section A.1.2: Enabled and promoted to error by default
      3. Section A.1.3: Disabled by default
    2. Section A.2: Warning Class Groups
    3. Section A.3: Warning Class Aliases for Backward Compatiblity
  2. Appendix B: Ndisasm
    1. Section B.1: Introduction
    2. Section B.2: Running NDISASM
      1. Section B.2.1: Specifying the Input Origin
      2. Section B.2.2: Code Following Data: Synchronization
      3. Section B.2.3: Mixed Code and Data: Automatic (Intelligent) Synchronization
      4. Section B.2.4: Other Options
  3. Appendix C: NASM Version History
    1. Section C.1: NASM 3 Series
      1. Section C.1.1: Version 3.01
      2. Section C.1.2: Version 3.00
    2. Section C.2: NASM 2 Series
      1. Section C.2.1: Version 2.16.03
      2. Section C.2.2: Version 2.16.02
      3. Section C.2.3: Version 2.16.01
      4. Section C.2.4: Version 2.16
      5. Section C.2.5: Version 2.15.05
      6. Section C.2.6: Version 2.15.04
      7. Section C.2.7: Version 2.15.03
      8. Section C.2.8: Version 2.15.02
      9. Section C.2.9: Version 2.15.01
      10. Section C.2.10: Version 2.15
      11. Section C.2.11: Version 2.14.03
      12. Section C.2.12: Version 2.14.02
      13. Section C.2.13: Version 2.14.01
      14. Section C.2.14: Version 2.14
      15. Section C.2.15: Version 2.13.03
      16. Section C.2.16: Version 2.13.02
      17. Section C.2.17: Version 2.13.01
      18. Section C.2.18: Version 2.13
      19. Section C.2.19: Version 2.12.02
      20. Section C.2.20: Version 2.12.01
      21. Section C.2.21: Version 2.12
      22. Section C.2.22: Version 2.11.09
      23. Section C.2.23: Version 2.11.08
      24. Section C.2.24: Version 2.11.07
      25. Section C.2.25: Version 2.11.06
      26. Section C.2.26: Version 2.11.05
      27. Section C.2.27: Version 2.11.04
      28. Section C.2.28: Version 2.11.03
      29. Section C.2.29: Version 2.11.02
      30. Section C.2.30: Version 2.11.01
      31. Section C.2.31: Version 2.11
      32. Section C.2.32: Version 2.10.09
      33. Section C.2.33: Version 2.10.08
      34. Section C.2.34: Version 2.10.07
      35. Section C.2.35: Version 2.10.06
      36. Section C.2.36: Version 2.10.05
      37. Section C.2.37: Version 2.10.04
      38. Section C.2.38: Version 2.10.03
      39. Section C.2.39: Version 2.10.02
      40. Section C.2.40: Version 2.10.01
      41. Section C.2.41: Version 2.10
      42. Section C.2.42: Version 2.09.10
      43. Section C.2.43: Version 2.09.09
      44. Section C.2.44: Version 2.09.08
      45. Section C.2.45: Version 2.09.07
      46. Section C.2.46: Version 2.09.06
      47. Section C.2.47: Version 2.09.05
      48. Section C.2.48: Version 2.09.04
      49. Section C.2.49: Version 2.09.03
      50. Section C.2.50: Version 2.09.02
      51. Section C.2.51: Version 2.09.01
      52. Section C.2.52: Version 2.09
      53. Section C.2.53: Version 2.08.02
      54. Section C.2.54: Version 2.08.01
      55. Section C.2.55: Version 2.08
      56. Section C.2.56: Version 2.07
      57. Section C.2.57: Version 2.06
      58. Section C.2.58: Version 2.05.01
      59. Section C.2.59: Version 2.05
      60. Section C.2.60: Version 2.04
      61. Section C.2.61: Version 2.03.01
      62. Section C.2.62: Version 2.03
      63. Section C.2.63: Version 2.02
      64. Section C.2.64: Version 2.01
      65. Section C.2.65: Version 2.00
    3. Section C.3: NASM 0.98 Series
      1. Section C.3.1: Version 0.98.39
      2. Section C.3.2: Version 0.98.38
      3. Section C.3.3: Version 0.98.37
      4. Section C.3.4: Version 0.98.36
      5. Section C.3.5: Version 0.98.35
      6. Section C.3.6: Version 0.98.34
      7. Section C.3.7: Version 0.98.33
      8. Section C.3.8: Version 0.98.32
      9. Section C.3.9: Version 0.98.31
      10. Section C.3.10: Version 0.98.30
      11. Section C.3.11: Version 0.98.28
      12. Section C.3.12: Version 0.98.26
      13. Section C.3.13: Version 0.98.25alt
      14. Section C.3.14: Version 0.98.25
      15. Section C.3.15: Version 0.98.24p1
      16. Section C.3.16: Version 0.98.24
      17. Section C.3.17: Version 0.98.23
      18. Section C.3.18: Version 0.98.22
      19. Section C.3.19: Version 0.98.21
      20. Section C.3.20: Version 0.98.20
      21. Section C.3.21: Version 0.98.19
      22. Section C.3.22: Version 0.98.18
      23. Section C.3.23: Version 0.98.17
      24. Section C.3.24: Version 0.98.16
      25. Section C.3.25: Version 0.98.15
      26. Section C.3.26: Version 0.98.14
      27. Section C.3.27: Version 0.98.13
      28. Section C.3.28: Version 0.98.12
      29. Section C.3.29: Version 0.98.11
      30. Section C.3.30: Version 0.98.10
      31. Section C.3.31: Version 0.98.09
      32. Section C.3.32: Version 0.98.08
      33. Section C.3.33: Version 0.98.09b with John Coffman patches released 28-Oct-2001
      34. Section C.3.34: Version 0.98.07 released 01/28/01
      35. Section C.3.35: Version 0.98.06f released 01/18/01
      36. Section C.3.36: Version 0.98.06e released 01/09/01
      37. Section C.3.37: Version 0.98p1
      38. Section C.3.38: Version 0.98bf (bug-fixed)
      39. Section C.3.39: Version 0.98.03 with John Coffman's changes released 27-Jul-2000
      40. Section C.3.40: Version 0.98.03
      41. Section C.3.41: Version 0.98
      42. Section C.3.42: Version 0.98p9
      43. Section C.3.43: Version 0.98p8
      44. Section C.3.44: Version 0.98p7
      45. Section C.3.45: Version 0.98p6
      46. Section C.3.46: Version 0.98p3.7
      47. Section C.3.47: Version 0.98p3.6
      48. Section C.3.48: Version 0.98p3.5
      49. Section C.3.49: Version 0.98p3.4
      50. Section C.3.50: Version 0.98p3.3
      51. Section C.3.51: Version 0.98p3.2
      52. Section C.3.52: Version 0.98p3-hpa
      53. Section C.3.53: Version 0.98 pre-release 3
      54. Section C.3.54: Version 0.98 pre-release 2
      55. Section C.3.55: Version 0.98 pre-release 1
    4. Section C.4: NASM 0.90-0.97
      1. Section C.4.1: Version 0.97 released December 1997
      2. Section C.4.2: Version 0.96 released November 1997
      3. Section C.4.3: Version 0.95 released July 1997
      4. Section C.4.4: Version 0.94 released April 1997
      5. Section C.4.5: Version 0.93 released January 1997
      6. Section C.4.6: Version 0.92 released January 1997
      7. Section C.4.7: Version 0.91 released November 1996
      8. Section C.4.8: Version 0.90 released October 1996
  4. Appendix D: Building NASM from Source
    1. Section D.1: Building from a Source Archive
    2. Section D.2: Optional Build Tools
    3. Section D.3: Building Optional Components
    4. Section D.4: Building from the git Repository
    5. Section D.5: Modifying the Sources
  5. Appendix E: Contact Information
    1. Section E.1: Website
      1. Section E.1.1: User Forums
      2. Section E.1.2: Development Community
    2. Section E.2: Reporting Bugs
  6. Appendix F: Instruction List
    1. Section F.1: Introduction
      1. Section F.1.1: Special instructions (pseudo-ops)
      2. Section F.1.2: No operation
      3. Section F.1.3: Integer data move instructions
      4. Section F.1.4: Load effective address
      5. Section F.1.5: The basic 8 arithmetic operations
      6. Section F.1.6: Bitwise testing
      7. Section F.1.7: The basic shift and rotate operations
      8. Section F.1.8: APX EVEX versions
      9. Section F.1.9: Other basic integer arithmetic
      10. Section F.1.10: Interleaved flags arithmetic
      11. Section F.1.11: Double width shift
      12. Section F.1.12: Bit operations
      13. Section F.1.13: BMI1 and BMI2 bit operations
      14. Section F.1.14: AMD XOP bit operations
      15. Section F.1.15: Decimal arithmetic
      16. Section F.1.16: Endianness handling
      17. Section F.1.17: Sign and zero extension
      18. Section F.1.18: Atomic operations
      19. Section F.1.19: Jumps
      20. Section F.1.20: Call and return
      21. Section F.1.21: Interrupts, system calls, and returns
      22. Section F.1.22: Flag register instructions
      23. Section F.1.23: String instructions
      24. Section F.1.24: Synchronization and fencing
      25. Section F.1.25: Memory management and control
      26. Section F.1.26: Special reads: timestamp, CPU number, performance counters, randomness
      27. Section F.1.27: Machine control and management instructions
      28. Section F.1.28: System management mode
      29. Section F.1.29: Power management
      30. Section F.1.30: I/O instructions
      31. Section F.1.31: Segment handling instructions
      32. Section F.1.32: x87 floating point
      33. Section F.1.33: MMX (SIMD using the x87 register file)
      34. Section F.1.34: Stack operations
      35. Section F.1.35: MMX instructions
      36. Section F.1.36: Permanently undefined instructions
      37. Section F.1.37: Conditional instructions
      38. Section F.1.38: Katmai Streaming SIMD instructions (SSE –– a.k.a. KNI, XMM, MMX2)
      39. Section F.1.39: Introduced in Deschutes but necessary for SSE support
      40. Section F.1.40: XSAVE group (AVX and extended state)
      41. Section F.1.41: Generic memory operations
      42. Section F.1.42: New MMX instructions introduced in Katmai
      43. Section F.1.43: AMD Enhanced 3DNow! (Athlon) instructions
      44. Section F.1.44: Willamette SSE2 Cacheability Instructions
      45. Section F.1.45: Willamette MMX instructions (SSE2 SIMD Integer Instructions)
      46. Section F.1.46: Willamette Streaming SIMD instructions (SSE2)
      47. Section F.1.47: Prescott New Instructions (SSE3)
      48. Section F.1.48: VMX/SVM Instructions
      49. Section F.1.49: Extended Page Tables VMX instructions
      50. Section F.1.50: SEV-SNP AMD instructions
      51. Section F.1.51: Tejas New Instructions (SSSE3)
      52. Section F.1.52: AMD SSE4A
      53. Section F.1.53: New instructions in Barcelona
      54. Section F.1.54: Penryn New Instructions (SSE4.1)
      55. Section F.1.55: Nehalem New Instructions (SSE4.2)
      56. Section F.1.56: Intel SMX
      57. Section F.1.57: Geode (Cyrix) 3DNow! additions
      58. Section F.1.58: Intel new instructions in ???
      59. Section F.1.59: Intel AES instructions
      60. Section F.1.60: Intel AVX AES instructions
      61. Section F.1.61: Intel AES Key Locker
      62. Section F.1.62: Intel instruction extension based on pub number 319433-030 dated October 2017
      63. Section F.1.63: Intel AVX instructions
      64. Section F.1.64: Intel Carry-Less Multiplication instructions (CLMUL)
      65. Section F.1.65: Intel AVX Carry-Less Multiplication instructions (CLMUL)
      66. Section F.1.66: Intel Fused Multiply-Add instructions (FMA)
      67. Section F.1.67: Intel post-32 nm processor instructions
      68. Section F.1.68: Supervisor Mode Access Prevention (SMAP)
      69. Section F.1.69: VIA (Centaur) security instructions
      70. Section F.1.70: AMD Lightweight Profiling (LWP) instructions
      71. Section F.1.71: AMD XOP and FMA4 instructions (SSE5)
      72. Section F.1.72: Intel AVX2 instructions
      73. Section F.1.73: Intel Transactional Synchronization Extensions (TSX)
      74. Section F.1.74: Intel Memory Protection Extensions (MPX)
      75. Section F.1.75: Intel SHA acceleration instructions
      76. Section F.1.76: S3M hash instructions
      77. Section F.1.77: SM4 hash instructions
      78. Section F.1.78: AVX no exception conversions
      79. Section F.1.79: AVX Vector Neural Network Instructions
      80. Section F.1.80: AVX Vector Neural Network Instructions INT8
      81. Section F.1.81: AVX Vector Neural Network Instructions INT16
      82. Section F.1.82: AVX Integer Fused Multiply-Add
      83. Section F.1.83: AVX-512 mask register instructions
      84. Section F.1.84: AVX-512 instructions
      85. Section F.1.85: Intel memory protection keys for userspace (PKU aka PKEYs)
      86. Section F.1.86: Read Processor ID
      87. Section F.1.87: Processor trace write
      88. Section F.1.88: Instructions from the Intel Instruction Set Extensions,
      89. Section F.1.89: doc 319433-034 May 2018
      90. Section F.1.90: doc 319433-058 June 2025
      91. Section F.1.91: Galois field operations (GFNI)
      92. Section F.1.92: AVX512 Vector Bit Manipulation Instructions 2
      93. Section F.1.93: AVX512 VNNI
      94. Section F.1.94: AVX512 Bit Algorithms
      95. Section F.1.95: AVX512 4-iteration Multiply-Add
      96. Section F.1.96: AVX512 4-iteration Dot Product
      97. Section F.1.97: Intel Software Guard Extensions (SGX)
      98. Section F.1.98: Intel Control-Flow Enforcement Technology (CET)
      99. Section F.1.99: Instructions from ISE doc 319433-040, June 2020
      100. Section F.1.100: AVX512 Bfloat16 instructions
      101. Section F.1.101: AVX512 mask intersect instructions
      102. Section F.1.102: Intel Advanced Matrix Extensions (AMX)
      103. Section F.1.103: Intel AVX512-FP16 instructions
      104. Section F.1.104: RAO-INT weakly ordered atomic operations
      105. Section F.1.105: User interrupts
      106. Section F.1.106: Flexible Return and Exception Delivery
      107. Section F.1.107: History reset
      108. Section F.1.108: AVX10.2 BF16 instructions
      109. Section F.1.109: AVX10.2 Compare scalar fp with enhanced eflags instructions
      110. Section F.1.110: AVX10.2 Convert instructions
      111. Section F.1.111: AVX10.2 Integer and FP16 VNNI, media new instructions
      112. Section F.1.112: AVX10.2 MINMAX instructions
      113. Section F.1.113: AVX10.2 Saturating convert instructions
      114. Section F.1.114: AVX10.2 Zero-extending partial vector copy instructions
      115. Section F.1.115: Systematic names for the hinting nop instructions