This manual documents NASM, the Netwide Assembler: an assembler targetting the Intel x86 series of processors, with portable source.
Chapter 1: Introduction
Section 1.1: What Is NASM?
Section 1.1.1: Why Yet Another Assembler?
Section 1.1.2: Licence Conditions
Section 1.2: Contact Information
Section 1.3: Installation
Section 1.3.1: Installing NASM under MS-DOS or Windows
Section 1.3.2: Installing NASM under Unix
Chapter 2: Running NASM
Section 2.1: NASM Command-Line Syntax
Section 2.1.1: The
Section 2.1.2: The
Section 2.1.3: The
Section 2.1.4: The
Section 2.1.5: The
Section 2.1.6: The
Section 2.1.7: The
Section 2.1.8: The
Section 2.1.9: The
Section 2.1.10: The
Section 2.1.11: The
Section 2.1.12: The
Section 2.1.13: The
Section 2.1.14: The
Section 2.1.15: The
Section 2.1.16: The
Section 2.1.17: The
Section 2.1.18: The
Section 2.1.19: The
Section 2.1.20: The
Section 2.1.21: The
Section 2.1.22: The
Section 2.2: Quick Start for MASM Users
Section 2.2.1: NASM Is Case-Sensitive
Section 2.2.2: NASM Requires Square Brackets For Memory References
Section 2.2.3: NASM Doesn't Store Variable Types
Section 2.2.4: NASM Doesn't
Section 2.2.5: NASM Doesn't Support Memory Models
Section 2.2.6: Floating-Point Differences
Section 2.2.7: Other Differences
Chapter 3: The NASM Language
Section 3.1: Layout of a NASM Source Line
Section 3.2: Pseudo-Instructions
Section 3.2.1:
Section 3.2.2:
Section 3.2.3:
Section 3.2.4:
Section 3.2.5:
Section 3.3: Effective Addresses
Section 3.4: Constants
Section 3.4.1: Numeric Constants
Section 3.4.2: Character Constants
Section 3.4.3: String Constants
Section 3.4.4: Floating-Point Constants
Section 3.5: Expressions
Section 3.5.1:
Section 3.5.2:
Section 3.5.3:
Section 3.5.4:
Section 3.5.5:
Section 3.5.6:
Section 3.5.7: Unary Operators:
Section 3.6:
Section 3.7:
Section 3.8: Critical Expressions
Section 3.9: Local Labels
Chapter 4: The NASM Preprocessor
Section 4.1: Single-Line Macros
Section 4.1.1: The Normal Way:
Section 4.1.2: Enhancing %define:
Section 4.1.3: Concatenating Single Line Macro Tokens:
Section 4.1.4: Undefining macros:
Section 4.1.5: Preprocessor Variables:
Section 4.2: String Handling in Macros:
Section 4.2.1: String Length:
Section 4.2.2: Sub-strings:
Section 4.3: Multi-Line Macros:
Section 4.3.1: Overloading Multi-Line Macros
Section 4.3.2: Macro-Local Labels
Section 4.3.3: Greedy Macro Parameters
Section 4.3.4: Default Macro Parameters
Section 4.3.5:
Section 4.3.6:
Section 4.3.7: Concatenating Macro Parameters
Section 4.3.8: Condition Codes as Macro Parameters
Section 4.3.9: Disabling Listing Expansion
Section 4.4: Conditional Assembly
Section 4.4.1:
Section 4.4.2:
Section 4.4.3:
Section 4.4.4:
Section 4.4.5:
Section 4.4.6:
Section 4.4.7:
Section 4.5: Preprocessor Loops:
Section 4.6: Including Other Files
Section 4.7: The Context Stack
Section 4.7.1:
Section 4.7.2: Context-Local Labels
Section 4.7.3: Context-Local Single-Line Macros
Section 4.7.4:
Section 4.7.5: Example Use of the Context Stack: Block IFs
Section 4.8: Standard Macros
Section 4.8.1:
Section 4.8.2:
Section 4.8.3:
Section 4.8.4:
Section 4.8.5:
Section 4.8.6:
Section 4.8.7:
Section 4.9: TASM Compatible Preprocessor Directives
Section 4.9.1:
Section 4.9.2:
Section 4.9.3:
Section 4.10: Other Preprocessor Directives
Section 4.10.1:
Section 4.10.2:
Chapter 5: Assembler Directives
Section 5.1:
Section 5.1.1:
Section 5.2:
Section 5.2.1: The
Section 5.3:
Section 5.4:
Section 5.5:
Section 5.6:
Section 5.7:
Chapter 6: Output Formats
Section 6.1:
Section 6.1.1:
Section 6.1.2:
Section 6.1.3:
Section 6.1.4: Map files
Section 6.2:
Section 6.2.1:
Section 6.2.2:
Section 6.2.3:
Section 6.2.4:
Section 6.2.5:
Section 6.2.6:
Section 6.2.7:
Section 6.2.8:
Section 6.3:
Section 6.3.1:
Section 6.4:
Section 6.5:
Section 6.5.1:
Section 6.5.2: Position-Independent Code:
Section 6.5.3:
Section 6.5.4:
Section 6.5.5: 16-bit code and ELF
Section 6.6:
Section 6.7:
Section 6.8:
Section 6.9:
Section 6.9.1: Requiring a Library: The
Section 6.9.2: Specifying a Module Name: The
Section 6.9.3:
Section 6.10:
Chapter 7: Writing 16-bit Code (DOS, Windows 3/3.1)
Section 7.1: Producing
Section 7.1.1: Using the
Section 7.1.2: Using the
Section 7.2: Producing
Section 7.2.1: Using the
Section 7.2.2: Using the
Section 7.3: Producing
Section 7.4: Interfacing to 16-bit C Programs
Section 7.4.1: External Symbol Names
Section 7.4.2: Memory Models
Section 7.4.3: Function Definitions and Function Calls
Section 7.4.4: Accessing Data Items
Section 7.4.5:
Section 7.5: Interfacing to Borland Pascal Programs
Section 7.5.1: The Pascal Calling Convention
Section 7.5.2: Borland Pascal Segment Name Restrictions
Section 7.5.3: Using
Chapter 8: Writing 32-bit Code (Unix, Win32, DJGPP)
Section 8.1: Interfacing to 32-bit C Programs
Section 8.1.1: External Symbol Names
Section 8.1.2: Function Definitions and Function Calls
Section 8.1.3: Accessing Data Items
Section 8.1.4:
Section 8.2: Writing NetBSD/FreeBSD/OpenBSD and Linux/ELF Shared Libraries
Section 8.2.1: Obtaining the Address of the GOT
Section 8.2.2: Finding Your Local Data Items
Section 8.2.3: Finding External and Common Data Items
Section 8.2.4: Exporting Symbols to the Library User
Section 8.2.5: Calling Procedures Outside the Library
Section 8.2.6: Generating the Library File
Chapter 9: Mixing 16 and 32 Bit Code
Section 9.1: Mixed-Size Jumps
Section 9.2: Addressing Between Different-Size Segments
Section 9.3: Other Mixed-Size Instructions
Chapter 10: Troubleshooting
Section 10.1: Common Problems
Section 10.1.1: NASM Generates Inefficient Code
Section 10.1.2: My Jumps are Out of Range
Section 10.1.3:
Section 10.1.4:
Section 10.2: Bugs
Appendix A: Ndisasm
Section A.1: Introduction
Section A.2: Getting Started: Installation
Section A.3: Running NDISASM
Section A.3.1: COM Files: Specifying an Origin
Section A.3.2: Code Following Data: Synchronisation
Section A.3.3: Mixed Code and Data: Automatic (Intelligent) Synchronisation
Section A.3.4: Other Options
Section A.4: Bugs and Improvements
Appendix B: x86 Instruction Reference
Section B.1: Key to Operand Specifications
Section B.2: Key to Opcode Descriptions
Section B.2.1: Register Values
Section B.2.2: Condition Codes
Section B.2.3: SSE Condition Predicates
Section B.2.4: Status Flags
Section B.2.5: Effective Address Encoding: ModR/M and SIB
Section B.3: Key to Instruction Flags
Section B.4: x86 Instruction Set
Section B.4.1:
Section B.4.2:
Section B.4.3:
Section B.4.4:
Section B.4.5:
Section B.4.6:
Section B.4.7:
Section B.4.8:
Section B.4.9:
Section B.4.10:
Section B.4.11:
Section B.4.12:
Section B.4.13:
Section B.4.14:
Section B.4.15:
Section B.4.16:
Section B.4.17:
Section B.4.18:
Section B.4.19:
Section B.4.20:
Section B.4.21:
Section B.4.22:
Section B.4.23:
Section B.4.24:
Section B.4.25:
Section B.4.26:
Section B.4.27:
Section B.4.28:
Section B.4.29:
Section B.4.30:
Section B.4.31:
Section B.4.32:
Section B.4.33:
Section B.4.34:
Section B.4.35:
Section B.4.36:
Section B.4.37:
Section B.4.38:
Section B.4.39:
Section B.4.40:
Section B.4.41:
Section B.4.42:
Section B.4.43:
Section B.4.44:
Section B.4.45:
Section B.4.46:
Section B.4.47:
Section B.4.48:
Section B.4.49:
Section B.4.50:
Section B.4.51:
Section B.4.52:
Section B.4.53:
Section B.4.54:
Section B.4.55:
Section B.4.56:
Section B.4.57:
Section B.4.58:
Section B.4.59:
Section B.4.60:
Section B.4.61:
Section B.4.62:
Section B.4.63:
Section B.4.64:
Section B.4.65:
Section B.4.66:
Section B.4.67:
Section B.4.68:
Section B.4.69:
Section B.4.70:
Section B.4.71:
Section B.4.72:
Section B.4.73:
Section B.4.74:
Section B.4.75:
Section B.4.76:
Section B.4.77:
Section B.4.78:
Section B.4.79:
Section B.4.80:
Section B.4.81:
Section B.4.82:
Section B.4.83:
Section B.4.84:
Section B.4.85:
Section B.4.86:
Section B.4.87:
Section B.4.88:
Section B.4.89:
Section B.4.90:
Section B.4.91:
Section B.4.92:
Section B.4.93:
Section B.4.94:
Section B.4.95:
Section B.4.96:
Section B.4.97:
Section B.4.98:
Section B.4.99:
Section B.4.100:
Section B.4.101:
Section B.4.102:
Section B.4.103:
Section B.4.104:
Section B.4.105:
Section B.4.106:
Section B.4.107:
Section B.4.108:
Section B.4.109:
Section B.4.110:
Section B.4.111:
Section B.4.112:
Section B.4.113:
Section B.4.114:
Section B.4.115:
Section B.4.116:
Section B.4.117:
Section B.4.118:
Section B.4.119:
Section B.4.120:
Section B.4.121:
Section B.4.122:
Section B.4.123:
Section B.4.124:
Section B.4.125:
Section B.4.126:
Section B.4.127:
Section B.4.128:
Section B.4.129:
Section B.4.130:
Section B.4.131:
Section B.4.132:
Section B.4.133:
Section B.4.134:
Section B.4.135:
Section B.4.136:
Section B.4.137:
Section B.4.138:
Section B.4.139:
Section B.4.140:
Section B.4.141:
Section B.4.142:
Section B.4.143:
Section B.4.144:
Section B.4.145:
Section B.4.146:
Section B.4.147:
Section B.4.148:
Section B.4.149:
Section B.4.150:
Section B.4.151:
Section B.4.152:
Section B.4.153:
Section B.4.154:
Section B.4.155:
Section B.4.156:
Section B.4.157:
Section B.4.158:
Section B.4.159:
Section B.4.160:
Section B.4.161:
Section B.4.162:
Section B.4.163:
Section B.4.164:
Section B.4.165:
Section B.4.166:
Section B.4.167:
Section B.4.168:
Section B.4.169:
Section B.4.170:
Section B.4.171:
Section B.4.172:
Section B.4.173:
Section B.4.174:
Section B.4.175:
Section B.4.176:
Section B.4.177:
Section B.4.178:
Section B.4.179:
Section B.4.180:
Section B.4.181:
Section B.4.182:
Section B.4.183:
Section B.4.184:
Section B.4.185:
Section B.4.186:
Section B.4.187:
Section B.4.188:
Section B.4.189:
Section B.4.190:
Section B.4.191:
Section B.4.192:
Section B.4.193:
Section B.4.194:
Section B.4.195:
Section B.4.196:
Section B.4.197:
Section B.4.198:
Section B.4.199:
Section B.4.200:
Section B.4.201:
Section B.4.202:
Section B.4.203:
Section B.4.204:
Section B.4.205:
Section B.4.206:
Section B.4.207:
Section B.4.208:
Section B.4.209:
Section B.4.210:
Section B.4.211:
Section B.4.212:
Section B.4.213:
Section B.4.214:
Section B.4.215:
Section B.4.216:
Section B.4.217:
Section B.4.218:
Section B.4.219:
Section B.4.220:
Section B.4.221:
Section B.4.222:
Section B.4.223:
Section B.4.224:
Section B.4.225:
Section B.4.226:
Section B.4.227:
Section B.4.228:
Section B.4.229:
Section B.4.230:
Section B.4.231:
Section B.4.232:
Section B.4.233:
Section B.4.234:
Section B.4.235:
Section B.4.236:
Section B.4.237:
Section B.4.238:
Section B.4.239:
Section B.4.240:
Section B.4.241:
Section B.4.242:
Section B.4.243:
Section B.4.244:
Section B.4.245:
Section B.4.246:
Section B.4.247:
Section B.4.248:
Section B.4.249:
Section B.4.250:
Section B.4.251:
Section B.4.252:
Section B.4.253:
Section B.4.254:
Section B.4.255:
Section B.4.256:
Section B.4.257:
Section B.4.258:
Section B.4.259:
Section B.4.260:
Section B.4.261:
Section B.4.262:
Section B.4.263:
Section B.4.264:
Section B.4.265:
Section B.4.266:
Section B.4.267:
Section B.4.268:
Section B.4.269:
Section B.4.270:
Section B.4.271:
Section B.4.272:
Section B.4.273:
Section B.4.274:
Section B.4.275:
Section B.4.276:
Section B.4.277:
Section B.4.278:
Section B.4.279:
Section B.4.280:
Section B.4.281:
Section B.4.282:
Section B.4.283:
Section B.4.284:
Section B.4.285:
Section B.4.286:
Section B.4.287:
Section B.4.288:
Section B.4.289:
Section B.4.290:
Section B.4.291:
Section B.4.292:
Section B.4.293:
Section B.4.294:
Section B.4.295:
Section B.4.296:
Section B.4.297:
Section B.4.298:
Section B.4.299:
Section B.4.300:
Section B.4.301:
Section B.4.302:
Section B.4.303:
Section B.4.304:
Section B.4.305:
Section B.4.306:
Section B.4.307:
Section B.4.308:
Section B.4.309:
Section B.4.310:
Section B.4.311:
Section B.4.312:
Section B.4.313:
Section B.4.314:
Section B.4.315:
Section B.4.316:
Section B.4.317:
Section B.4.318:
Section B.4.319:
Section B.4.320:
Section B.4.321:
Section B.4.322:
Section B.4.323:
Section B.4.324:
Section B.4.325:
Section B.4.326:
Section B.4.327:
Section B.4.328:
Section B.4.329:
Section B.4.330:
Section B.4.331:
Section B.4.332:
Section B.4.333:
Section B.4.334:
Section B.4.335:
Section B.4.336:
Section B.4.337: