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.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: Critical Expressions
Section 3.8: Local Labels
Chapter 4: The NASM Preprocessor
Section 4.1: Single-Line Macros
Section 4.1.1: The Normal Way:
Section 4.1.2: Undefining macros:
Section 4.1.3: 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.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.9: TASM Compatible Preprocessor Directives
Section 4.9.1:
Section 4.9.2:
Section 4.9.3:
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.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.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: Intel 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:
Section B.5:
Section B.6:
Section B.7:
Section B.8:
Section B.9:
Section B.10:
Section B.11:
Section B.12:
Section B.13:
Section B.14:
Section B.15:
Section B.16:
Section B.17:
Section B.18:
Section B.19:
Section B.20:
Section B.21:
Section B.22:
Section B.23:
Section B.24:
Section B.25:
Section B.26:
Section B.27:
Section B.28:
Section B.29:
Section B.30:
Section B.31:
Section B.32:
Section B.33:
Section B.34:
Section B.35:
Section B.36:
Section B.37:
Section B.38:
Section B.39:
Section B.40:
Section B.41:
Section B.42:
Section B.43:
Section B.44:
Section B.45:
Section B.46:
Section B.47:
Section B.48:
Section B.49:
Section B.50:
Section B.51:
Section B.52:
Section B.53:
Section B.54:
Section B.55:
Section B.56:
Section B.57:
Section B.58:
Section B.59:
Section B.60:
Section B.61:
Section B.62:
Section B.63:
Section B.64:
Section B.65:
Section B.66:
Section B.67:
Section B.68:
Section B.69:
Section B.70:
Section B.71:
Section B.72:
Section B.73:
Section B.74:
Section B.75:
Section B.76:
Section B.77:
Section B.78:
Section B.79:
Section B.80:
Section B.81:
Section B.82:
Section B.83:
Section B.84:
Section B.85:
Section B.86:
Section B.87:
Section B.88:
Section B.89:
Section B.90:
Section B.91:
Section B.92:
Section B.93:
Section B.94:
Section B.95:
Section B.96:
Section B.97:
Section B.98:
Section B.99:
Section B.100:
Section B.101:
Section B.102:
Section B.103:
Section B.104:
Section B.105:
Section B.106:
Section B.107:
Section B.108:
Section B.109:
Section B.110:
Section B.111:
Section B.112:
Section B.113:
Section B.114:
Section B.115:
Section B.116:
Section B.117:
Section B.118:
Section B.119:
Section B.120:
Section B.121:
Section B.122:
Section B.123:
Section B.124:
Section B.125:
Section B.126:
Section B.127:
Section B.128:
Section B.129:
Section B.130:
Section B.131:
Section B.132:
Section B.133:
Section B.134:
Section B.135:
Section B.136:
Section B.137:
Section B.138:
Section B.139:
Section B.140:
Section B.141:
Section B.142:
Section B.143:
Section B.144:
Section B.145:
Section B.146:
Section B.147:
Section B.148:
Section B.149:
Section B.150:
Section B.151:
Section B.152:
Section B.153:
Section B.154:
Section B.155:
Section B.156:
Section B.157:
Section B.158:
Section B.159:
Section B.160:
Section B.161:
Section B.162:
Section B.163:
Section B.164:
Section B.165:
Section B.166:
Section B.167:
Section B.168:
Section B.169:
Section B.170:
Section B.171:
Section B.172:
Section B.173:
Section B.174:
Section B.175:
Section B.176:
Section B.177:
Section B.178:
Section B.179:
Section B.180:
Section B.181:
Section B.182:
Section B.183:
Section B.184:
Section B.185:
Section B.186:
Section B.187:
Section B.188:
Section B.189:
Section B.190:
Section B.191:
Section B.192:
Section B.193:
Section B.194:
Section B.195:
Section B.196:
Section B.197:
Section B.198:
Section B.199:
Section B.200:
Section B.201:
Section B.202:
Section B.203:
Section B.204:
Section B.205:
Section B.206:
Section B.207:
Section B.208:
Section B.209:
Section B.210:
Section B.211:
Section B.212:
Section B.213:
Section B.214:
Section B.215:
Section B.216:
Section B.217:
Section B.218:
Section B.219:
Section B.220:
Section B.221:
Section B.222:
Section B.223:
Section B.224:
Section B.225:
Section B.226:
Section B.227:
Section B.228:
Section B.229:
Section B.230:
Section B.231:
Section B.232:
Section B.233:
Section B.234:
Section B.235:
Section B.236:
Section B.237:
Section B.238:
Section B.239:
Section B.240:
Section B.241:
Section B.242:
Section B.243:
Section B.244:
Section B.245:
Section B.246:
Section B.247:
Section B.248:
Section B.249:
Section B.250:
Section B.251:
Section B.252:
Section B.253:
Section B.254:
Section B.255:
Section B.256:
Section B.257:
Section B.258:
Section B.259:
Section B.260:
Section B.261:
Section B.262:
Section B.263:
Section B.264:
Section B.265:
Section B.266:
Section B.267:
Section B.268:
Section B.269:
Section B.270:
Section B.271:
Section B.272:
Section B.273:
Section B.274:
Section B.275:
Section B.276:
Section B.277:
Section B.278:
Section B.279:
Section B.280:
Section B.281:
Section B.282:
Section B.283:
Section B.284:
Section B.285:
Section B.286:
Section B.287:
Section B.288:
Section B.289:
Section B.290:
Section B.291:
Section B.292:
Section B.293:
Section B.294:
Section B.295:
Section B.296:
Section B.297:
Section B.298:
Section B.299:
Section B.300:
Section B.301:
Section B.302:
Section B.303:
Section B.304:
Section B.305:
Section B.306:
Section B.307:
Section B.308:
Section B.309:
Section B.310:
Section B.311:
Section B.312:
Section B.313:
Section B.314:
Section B.315:
Section B.316:
Section B.317:
Section B.318:
Section B.319:
Section B.320:
Section B.321:
Section B.322:
Section B.323:
Section B.324:
Section B.325:
Section B.326:
Section B.327:
Section B.328:
Section B.329:
Section B.330:
Section B.331:
Section B.332:
Section B.333:
Section B.334:
Section B.335:
Section B.336:
Section B.337:
Section B.338:
Section B.339:
Section B.340: