nasm的安装方法和使用

 1.1在dos和 Windows 下安装NASM  

 

如果你拿到了 NASM 的 DOS 安装包,'nasmXXX.zip'(这里.'XXX'表示该安装包的 NASM 版 

本号)，把它解压到它自己的目录下(比如：‘c:\nasm')  

 

该包中会包含有四个可执行文件：NASM 可拟行文件'nasm.exe'和'nasmw.exe',还有 

NDISASM 可执行文件'ndisasm.exe'和'ndisasmw.exe'。文件名以'w'结尾的是'Win32' 

可执行格式。是运行在'Windows 95'或'Windows NT'的 Intel处理器上的，另外的是 

16 位的'DOS'可执行文件。  

 

NASM 运行时需要的唯一文件就是它自己的可执行文件，所以可以拷贝'nasm.exe' 

和'nasmw.exe'的其中一个到你自己的路径下，或者可以编写一个'autoexec.bat'把 

nasm 的路径加到你的'PATH'环境变量中去。(如果你只安装了 Win32 版本的，你可能 

希望把文件名改成'nasm.exe'。)  

就这样，NASM 装好了。你不需要为了运行 nasm 而让'nasm'目录一直存在(除非你把它 

加到了你的'PATH'中,所以如果你需要节省空间，你可删掉它,但是，你可能需要保留 

文档或测试程序。  

 

如果你下载了 DOS 版的源码包，'nasmXXXs.zip',那'nasm'目录还会包含完整的 NASM源 

代码，你可以选择一个 Makefiles 来重新构造你的 NASM 版本。  

 

注意源文件`insnsa.c', `insnsd.c', `insnsi.h'和`insnsn.c'是由'standard.mac'中 

的指令自动生成的，尽管 NASM0.98发布版中包含了这些产生的文件，你如果改动了 

insns.dat,standard.mac或者文件，可能需要重新构造他们，在将来的源码发布中有 

可能将不再包含这些文件，多平台兼容的 Perl可以从 www.cpan.org 上得到。 

 

  1.2 在unix 下安装NASM  

 

如果你得到了 Unix 下的NASM 源码包'nasm-x.xx.tar.gz'(这里x.xx 表示该源码包中的 

nasm 的版本号),把它解压压到一个目录，比如'/usr/local/src'。包被解压后会创建 

自己的子目录'nasm-x.xx'  

 

NASM 是一个自动配置的安装包:一旦你解压了它，'cd'到它的目录下，输入'./configuer', 

该脚本会找到最好的 C编译器来构造 NASM，并据此建立 Makefiles。  

 

一旦 NASM 被自动配置好后，你可以输入'make'来构造'nasm'和'ndisasm'二进制文件， 

然后输入'make install'把它们安装到'/usr/local/bin',并把 man 页安装到 

'/usr/local/man/man1'下的'nasm.1和'ndisasm.1'或者你可以给配置脚本一个 

'--prefix'选项来指定安装目录，或者也可以自己来安装。  

 

NASM 还附带一套处理'RDOFF'目标文件格式的实用程序，它们在'rdoff'子目录下， 

你可以用'make rdf'来构造它们，并使用'make rdf_install'来安装。如果你需 

要的话。  

 

如果 NASM 在自动配置的时候失败了，你还是可以使用文件'Makefile.unx'来编译它们， 

把这个文件改名为'Makefile',然后输入'make'。在'rdoff'子目录下同样有一个 

Makefile.unx 文件。  

 

运行 NASM 

 

  2.1 NASM命令行语法  

 

要汇编一个文件，你可以以下面的格式执行一个命令：  

 

nasm -f <format> <filename> [-o <output>]  

 

比如,  

 

nasm -f elf myfile.asm  

 

会把文件'myfile.asm'汇编成'ELF'格式 的文件'myfile.o'.还有：  

 

nasm -f bin myfile.asm -o myfile.com  

 

会把文件'myfile.asm'汇编成纯二进制格式的文件'myfile.com'。  

 

想要以十六进制代码的形式产生列表文件输出，并让代码显示在源代码的左侧， 

使用'-l'选项并给出列表文件名，比如：  

 

nasm -f coff myfile.asm -l myfile.lst  

 

想要获取更多的关于 NASM 的使用信息，请输入：  

 

nasm -h  

 

它同时还会输出可以使用的输出文件格式， 

如果你使用 Linux 并且不清楚你的系统是'a.out'还是'ELF'，请输入：  

 

file nasm  

 

(在 nasm 二进制文件的安装目录下使用),如果系统输出类似下面的信息：  

 

nasm: ELF 32-bit LSB executable i386 (386 and up) Version 1  

 

那么你的系统就是'ELF'格式的，然后你就应该在产生 Linux 目标文件时使用选 

项'-f elf',如果系统输入类似下面的信息：  

 

nasm: Linux/i386 demand-paged executable (QMAGIC)  

 

或者与此相似的，你的系统是'a.out'的，那你应该使用'-f aout'(Linux 的'a.out' 

系统很久以前就过时了，现在已非常少见。) 

 

就像其他的 Unix 编译器与汇编器，NASM 在碰到错误以前是不输出任何信息的，所 

以除了出错信息你看不到任何其他信息。  

 

  2.1.1 '-o'选项：指定输出文件的文件名。  

 

NASM 会为你的输出文件选择一个文件名；具体如何做取决于目标文件的格式，对 

于微软的目标文件格式('obj'和'win32'),它会去掉你的源文件名的'.asm'扩展 

名(或者其他任何你喜欢使用的扩展名，NASM 并不关心具体是什么)，并替换上 

'obj'。对于Unix 的目标文件格式('aout','coff','elf'和'as86')它会替换成 

'.o', 对于'rdf',它会使用'.rdf',还有为'bin'格式，它会简单地去掉扩展名，所以 

'myfile.asm'会产生的一个输出文件'myfile'。  

 

如果输出文件已经存在，NASM 会覆盖它，除非它的文件名与输入文件同名，在这种 

情况下，它会给出一个警告信息，并使用'nasm.out'作为输出文件的文件名。  

 

在某些情况下，上述行为是不能接受的，所以，NASM 提供了'-o'选项，它能让你指定 

你的输出文件的文件名，你使用'-o'后面紧跟你为输出文件取的名字，中间可以加 

空格也可以不加。比如：  

 

nasm -f bin program.asm -o program.com  

nasm -f bin driver.asm -odriver.sys  

 

请注意这是一个小写的 o，跟大写字母 O 是不同的，大写的是用来指定需要传递的选 

项的数目，请参阅 2.1.15  

 

  2.1.2 `-f'选项：指定输出文件的格式。  

 

如果你没有对 NASM 使用'-f'选项，它会自己为你选择一个输出文件格式。在发布的 

NASM 版本中，缺省的输出格式总是'bin';如果你自己编译你的 NASM,你可以在编译的 

时候重定义'OF_DEFAULT'来选择你需要的缺省格式。  

 

就象'-o','-f'与输出文件格式之间的空格也是可选的，所以'-f elf'和'-felf'都是 

合法的。  

 

所有可使用的输出文件格式的列表可以通过运行命令'nasm -hf'得到。  

 

  2.1.3 `-l' 选项: 产生列表文件  

 

如果你对 NASM 使用了'-l'选项，后面跟一个文件名，NASM 会为你产生一个源文件的列表 

文件,在里面，地址和产生的代码列在左边，实际的源代码(包括宏扩展，除了那些指定 

不需要在列表中扩展的宏，参阅 4.3.9)列在右边，比如：  

 

nasm -f elf myfile.asm -l myfile.lst  

 

  2.1.4 `-M'选项: 产生Makefile 依赖关系.  

 

该选项可以用来向标准输出产生 makefile 依赖关系，可以把这些信息重定向到一个文件 

中以待进一步处理，比如： 

       

NASM -M myfile.asm > myfile.dep  

 

  2.1.5 `-F'选项: 选择一个调试格式  

 

该选项可以用来为输出文件选择一个调试格式，语法跟-f选项相册，唯一不同的是它产 

生的输出文件是调试格式的。  

 

一个具体文件格式的完整的可使用调试文件格式的列表可通过命令'nasm -f <format> -y' 

来得到。  

 

这个选项在缺省状态下没有被构建时 NASM。如何使用该选项的信息请参阅 6.10  

 

  2.1.6 `-g' 选项:使调试信息有效。  

 

该选项可用来在指定格式的输出文件中产生调试信息。 

更多的信息请参阅 2.1.5  

 

  2.1.7 `-E' 选项: 把错误信息输入到文件。 

   

  在'MS-DOS'下，尽管有办法，但要把程序的标准错误输出重定向到一个文件还是非常困 

难的。因为 NASM 常把它的警告和错误信息输出到标准错误设备，这将导致你在文本编 

辑器里面很难捕捉到它们。  

 

因此 NASM 提供了一个'-E'选项，带有一个文件名参数，它可以把错误信息输出到指定的 

文件而不是标准错误设备。所以你可以输入下面这样的命令来把错误重定向到文件：  

 

nasm -E myfile.err -f obj myfile.asm  

 

  2.1.8 `-s' 选项: 把错误信息输出到'stdout'  

 

'-s'选项可以把错误信息重定向到'stdout'而不是'stderr'，它可以在'MS-DOS'下进行 

重定向。想要在汇编文件'myfile.asm'时把它的输出用管道输出给'more'程序，可以这样： 

       

nasm -s -f obj myfile.asm | more  

 

请参考 2.1.7 的'-E'选项.  

 

  2.1.9 `-i'选项: 包含文件搜索路径  

 

当 NASM 在源文件中看到'%include'操作符时(参阅4.6)，它不仅仅会在当前目录下搜索给 

出的文件，还会搜索'-i'选项在命令行中指定的所有路径。所以你可以从宏定义库中 

包含进一个文件，比如，输入：  

 

nasm -ic:\macrolib\ -f obj myfile.asm  

 

(通常，在 '-i'与路径名之间的空格是允许的，并且可选的。)  

 

NASM 更多的关注源代码级上的完全可移植性，所以并不理解正运行的操作系统对文件的 

命名习惯；你提供给'-i'作为参数的的字符串会被一字不差地加在包含文件的文件名前。 

所以，上例中最后面的一个反斜杠是必要的，在 Unix 下，一个尾部的正斜线也同样是必要

的。  

 

(当然，如果你确实需要，你也可以不正规地使用它，比如，选项'-ifoo'会导致 

'%incldue "bar.i'去搜索文件'foobar.i'...)  

 

如果你希望定义一个标准的搜索路径，比如像 Unix 系统下的'/usr/include'，你可以在环

境 

变量 NASMENV 中放置一个或多个'-i'(参阅 2.1.19)  

 

为了与绝大多数 C 编译器的 Makefile 保持兼容，该选项也可以被写成'-I'。  

 

  2.1.10 `-p' 选项: 预包含一个文件  

 

NASM 允许你通过'-p'选项来指定一个文件预包含进你的源文件。所以，如果运行：  

 

nasm myfile.asm -p myinc.inc  

 

跟在源文件开头写上'%include "myinc.inc"然后运行'nasm myfile.asm'是等效的。  

 

为和'-I','-D','-U'选项操持一致性，该选项也可以被写成'-P'  

 

2.1.11 `-d'选项: 预定义一个宏。  

 

就像'-p'选项给出了在文件头放置'%include'的另一种实现，'-d'选项给出了在文 

件中写'%define'的另一种实现，你可以写：  

 

nasm myfile.asm -dFOO=100  

 

     作为在文件中写下面一行语句的一种替代实现：  

 

      %define FOO 100  

 

      在文件的开始，你可以取消一个宏定义，同样，选项'-dFOO'等同于代码'%define 

FOO'。 

这种形式的操作符在选择编译时操作中非常有用，它们可以用'%ifdef'来进行测试， 

比如'-dDEBUG'。 

       

      为了与绝大多数 C 编译器的Makefile 保持兼容，该选项也可以被写成'-D'。  

 

  2.1.12 `-u' 选项: 取消一个宏定义。 

   

  '-u'选项可以用来取消一个由'-p'或'-d'选项先前在命令行上定义的一个宏定义。  

 

比如，下面的命令语句：  

 

      nasm myfile.asm -dFOO=100 -uFOO  

 

会导致'FOO'不是一个在程序中预定义的宏。这在 Makefile中不同位置重载一个操 

作时很有用。  

 

为了与绝大多数 C 编译器的 Makefile 保持兼容，该选项也可以被写成'-U'。  

 

  2.1.13 `-e'选项: 仅预处理。 

   

  NASM 允许预处理器独立运行。使用'-e'选项(不需要参数)会导致 NASM预处理输入 

文件，展开所有的宏，去掉所有的注释和预处理操作符，然后把结果文件打印在标 

准输出上(如果'-o'选项也被指定的话，会被存入一个文件)。  

 

该选项不能被用在那些需要预处理器去计算与符号相关的表达式的程序中，所以 

如下面的代码：  

 

      %assign tablesize ($-tablestart)  

 

会在仅预处理模式中会出错。  

 

  2.1.14 `-a' 选项: 不需要预处理。 

   

  如果NASM被用作编译器的后台，那么假设编译器已经作完了预处理，并禁止 NASM 的预 

处理功能显然是可以节约时间，加快编译速度。'-a'选项(不需要参数)，会让 NASM把 

它强大的预处理器换成另一个什么也不做的预处理器。 

   

  2.1.15 `-On'选项: 指定多遍优化。 

   

  NASM 在缺省状态下是一个两遍的汇编器。这意味着如果你有一个复杂的源文件需要 

多于两遍的汇编。你必须告诉它。  

 

      使用'-O'选项，你可以告诉 NASM 执行多遍汇编。语法如下：  

 

      (*)'-O0'严格执行两遍优化，JMP 和 Jcc 的处理和 0.98 版类似，除了向后跳的 JMP

是短跳 

转，如果可能，立即数在它们的短格式没有被指定的情况下使用长格式。  

 

      (*)'-O1'严格执行两遍优化，但前向分支被汇编成保证能够到达的代码；可能产生比 

'-O0'更大的代码，但在分支中的偏移地址没有指定的情况下汇编成功的机率更大，  

 

      (*)'-On' 多编优化，最小化分支的偏移，最小化带符号的立即数，当'strict'关键

字 

没有用的时候重载指定的大小(参阅3.7)，如果2<=n<=3，会有 5*n 遍,而不是 n 遍。  

 

注意这是一个大写的 O，和小写的 o是不同的，小写的 o 是指定输出文件的格式，可参阅 

2.1.1  

 

  2.1.16 `-t'选项: 使用 TASM 兼容模式。 

   

  NASM 有一个与 Borlands 的TASM 之间的受限的兼容格式。如果使用了 NASM 的'-t'选项， 

就会产生下列变化：  

 

      (*)本地符号的前缀由'.'改为'@@'  

       

      (*)TASM 风格的以'@'开头的应答文件可以由命令行指定。这和 NASM 支持的'-@resp' 

风格是不同的。  

 

      (*)扩号中的尺寸替换被支持。在 TASM 兼容模式中，方括号中的尺寸替换改变了操作 

数的尺寸大小，方括号不再支持 NASM 语法的操作数地址。比如，'mov eax,[DWORD VAL]' 

在 TASM 兼容语法中是合法的。但注意你失去了为指令替换缺省地址类型的能力。 

         

      (*)'%arg'预处理操作符被支持，它同 TASM 的ARG 操作符相似。  

 

      (*) `%local'预处理操作符。  

 

      (*) `%stacksize'预处理操作符。  

 

      (*) 某些操作符的无前缀形式被支持。  (`arg', `elif',`else', `endif', `if', 

       `ifdef', `ifdifi', `ifndef', `include',`local')  

 

      (*) 还有很多...  

 

需要更多的关于操作符的信息，请参阅 4.9 的TASM 兼容预处理操作符指令。  

 

  2.1.17 `-w'选项: 使汇编警告信息有效或无效。 

   

  NASM 可以在汇编过程中监视很多的情况，其中很多是值得反馈给用户的，但这些情况 

还不足以构成严重错误以使 NASM 停止产生输出文件。这些情况被以类似错误的形式 

报告给用户，但在报告信息的前面加上'warning'字样。警告信息不会阻止 NASM 产生 

输出文件并向操作系统返回成功信息。 

   

  有些情况甚至还要宽松：他们仅仅是一些值得提供给用户的信息。所以，NASM支持'-w' 

命令行选项。它以使特定类型的汇编警告信息输出有效或无效。这样的警告类型是 

以命名来描述的，比如，'orphan-labels'，你可以以下列的命令行选项让此类警告信息 

得以输出：'-w+orphan-labels'，或者以'-w-orphan-labels'让此类信息不能输出。 

   

  可禁止的警告信息类型有下列一些： 

   

      (*)`macro-params'包括以错误的参数个数调用多行的宏定义的警告。这类警告信息 

缺省情况下是输出的，至于为什么你可能需要禁止它，请参阅 4.3.1。  

 

      (*)`orphan-labels'包含源文件行中没有指令却定义了一个没有结尾分号的 label

的 

警告。缺省状况下，NASM 不输出此类警告。如果你需要它，请参阅 3.1的例子。  

 

      (*) 'number-overflow'包含那些数值常数不符合 32 位格式警告信息（比如，你很容

易打 

      了很多的 F，错误产生了'0x7fffffffffff'）。这种警告信息缺省状况下是打开的。 

           

  2.1.18 `-v'选项: 打印版本信息。  

 

   输入'NASM -v'会显示你正使用的 NASM 的版本号，还有它被编译的时间。  

 

如果你要提交 bug 报告，你可能需要版本号。