Skip to content

m1013923728/NASM-Tutorial-CN

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Nasm指南中文 (NASM Tutorial)

英文原文链接:http://cs.lmu.edu/~ray/notes/nasmtutorial/

NASM 是一个绝赞的汇编器。现在让我们通过一些例子来学习 NASM。 然而这里的笔记仅仅只是蜻蜓点水般地涉及了一些皮毛,所以当你看完这个页面后,你需要查看 官方的 NASM 文档

因原文写的时间应该比较早,翻译该文章是在2020年2月2日,一些链接已经不能再打开,有的示例代码在我的MAC OSX Catalina 10.15.3上也无法正常编译通过,笔者上述问题进行了修正(Linux下未进行验证)。

img

教程范围

本教程将向您展示如何在 x86-64 体系结构上编写汇编语言程序。您将同时学会编写:

  1. 独立运行的汇编程序
  2. 与 C 集成的程序

请注意:教程会涉及Windows/MacOSX/Linux三个系统的使用方法,请确保在其中一个平台下已经安装好 nasm 和 gcc。

第一个程序

在学习 nasm 之前,请确保您可以键入并运行程序。

确保同时安装了 nasm 和 gcc。将以下程序之一另存为hello.asm,具体取决于您的计算机平台。然后根据给定的说明运行程序。

如果您使用的是基于 Linux 的操作系统:

hello.asm

; ----------------------------------------------------------------------------------------
; 仅使用syscall将"Hello,World"写入控制台。仅在64位Linux上运行。
; 使用 Linux 下的 1 号系统调用来输出一条信息和 60 号系统调用来退出程序。
; 编译汇编代码并运行:
;
; nasm -felf64 hello.asm && ld hello.o && ./a.out
; ----------------------------------------------------------------------------------------

          global    _start

          section   .text
_start:   
         ; write(1, message, 13)
          mov       rax,1                  ; 1 号系统调用是写操作
          mov       rdi,1                  ; 1 号文件系统调用是标准输出stdout
          mov       rsi,message            ; 输出字符串的地址
          mov       rdx,13                 ; 字节数(输出字符串的长度)
          syscall                           ; 调用操作系统进行写入
          
          ; exit(0)
          mov       rax,60                 ; 60号系统调用是退出
          xor       rdi,rdi                ; 退出代码 0
          syscall                           ; 调用操作系统退出

          section   .data
message:  db        "Hello,World",10      ; 注意最后的换行符
$ nasm -felf64 hello.asm && ld hello.o && ./a.out
Hello,World

如果您使用的是 macOS:

hello.asm

; ----------------------------------------------------------------------------------------
; 仅使用syscall将" Hello,World"写入控制台。仅在64位macOS上运行。
;
; 显示nasm支持的输出格式
; nasm -hf  
;
; 编译汇编代码并运行:
; nasm -fmacho64 hello.asm && ld -o hello -e _main -lSystem hello.o && ./hello
; 也可以如下方式运行:
; nasm -fmacho64 hello.asm && gcc -o hello hello.o && ./hello
;
; ----------------------------------------------------------------------------------------

section .data
  msg: db "Hello, World!",10,0   ; 注意最后的换行符
  len: equ $-msg


section .text
global _main

; kernel:
;     syscall
;     ret

_main:
    ; write(1, msg, 13)
    mov rax,0x02000004      ; 系统调用
    mov rdi,1               ; 文件句柄号1是stdout
    mov rsi,msg             ; 要输出的字符串地址
    mov rdx,len             ; 15字节数
    ; exit(0)
    syscall                 ; 调用操作系统进行写入
    ; call kernel

    mov rax,0x02000001      ; syscall退出
    xor rdi,rdi             ; 退出代码0
    syscall                 ; 调用操作系统退出
    ; call kernel


$ nasm -fmacho64 hello.asm && gcc hello.o && ./a.out
Hello, World

练习:确定两个程序之间的差异。

NASM 程序的结构

NASM 是基于行的。大多数程序由指令后跟一个或多个部分组成。行可以具有可选标签。大多数行都有一条指令,后跟零个或多个操作数。

nasmstructure.png

通常,您将代码放在的部分中,.text并将常量数据放在的部分中.data

细节

NASM 是一个很棒的汇编器,但是汇编语言很复杂。您不仅需要教程。您需要详细信息。很多细节。准备咨询:

从掌握如下汇编指令开始

有数百条指令。您无法一次全部学习它们。从这些 start:

mov x,y xy
and x,y xx and y
or x,y xx or y
xor x,y xx xor y
add x,y xx + y
sub x,y xxy
inc x xx + 1
dec x xx – 1
syscall 调用操作系统例程
db 一个伪指令 声明字节,这将是在内存中的程序运行时

三种操作数

寄存器操作数

在本教程中,我们只关心整数寄存器和 xmm 寄存器。您应该已经知道什么是寄存器,但是这里是一个快速的回顾。16 个整数寄存器为 64 位宽,称为:

R0 R1 R2 R3 R4 R5 R6 R7 R8 R9 R10 R11 R12 R13 R14 R15
RAX RCX RDX RBX RSP RBP RSI RDI

(请注意,其中的最后 8 个寄存器具有备用名称)您可以将每个寄存器的最低 32 位视为寄存器本身,但可以使用以下名称:

R0D R1D R2D R3D R4D R5D R6D R7D R8D R9D R10D R11D R12D R13D R14D R15D
EAX ECX EDX EBX ESP EBP ESI EDI

您可以使用以下名称将每个寄存器的最低 16 位看作一个寄存器:

R0W R1W R2W R3W R4W R5W R6W R7W R8W R9W R10W R11W R12W R13W R14W R15W
AX CX DX BX SP BP SI DI

您可以使用以下名称将每个寄存器的最低 8 位看作一个寄存器:

R0B R1B R2B R3B R4B R5B R6B R7B R8B R9B R10B R11B R12B R13B R14B R15B
AL CL DL BL SPL BPL SIL DIL

由于历史原因,R0...R3的第 15 至 8 位被命名为:

AH CH DH BH

最后,有 16 个 XMM 寄存器,每个 128 位宽,名为:

XMM0 ... XMM15

研究这张照片;希望它可以帮助:

rdx.png

内存操作数

这些是寻址的基本形式:

  • [ number ]
  • [ reg ]
  • [ reg + reg*scale ] 小数位数只能是 1、2、4 或 8
  • [ reg + number ]
  • [ reg + reg*scale + number ]

这个数字叫做位移 ; 普通寄存器称为 ; 带有刻度的寄存器称为索引

例子:

[750]               ; 仅位移
[rbp]               ; 仅基址寄存器
[rcx + rsi*4]       ; 基数+指数*比例
[rbp + rdx]         ; scale is 1
[rbx-8]             ; 位移-8
[rax + rdi*8 + 500] ; 所有四个组成部分
[rbx + counter]     ; 使用变量"counter"地址作为偏移

直接操作数

这些可以用多种方式编写。以下是官方文档中的一些示例。

200         ; 十进制数
0200        ; 仍然是十进制-前导0不会使其变为八进制
0200d       ; 显式十进制-d后缀
0d200       ; 也十进制-0d prefex
0c8h        ; 十六进制-h后缀,但是前导0是必需的,因为c8h看起来像var
0xc8        ; hex-经典的0x前缀
0hc8        ; 十六进制-由于某些原因,NASM偏爱0h写法
310q        ; 八进制-q后缀
0q310       ; 八进制-0q前缀
11001000b   ; 二进制-b后缀
0b1100_1000 ; 二进制-0b前缀,顺便说一下,允许使用下划线

具有两个内存操作数的指令非常少见

实际上,在本教程中我们将看不到任何此类说明。大多数基本说明只有以下几种形式:

add reg, reg
add reg,mem
add reg, imm
add mem,reg
add mem, imm

定义数据并保留空间

这些示例来自 docs 的第 3 章。要将数据放入内存中:

      db 0x55               ; 只是字节0x55
      db 0x55,0x56,0x57     ; 连续三个字节
      db 'a',0x55           ; 字符常量可以
      db 'hello',13,10,'$'  ; 字符串常量也是如此
      dw 0x1234             ; 0x34 0x12
      dw 'a'                ; 0x61 0x00(只是一个数字)
      dw 'ab'               ; 0x61 0x62(字符常量)
      dw 'abc'              ; 0x61 0x62 0x63 0x00(字符串)
      dd 0x12345678         ; 0x78 0x56 0x34 0x12
      dd 1.234567e20        ; 浮点常数
      dq 0x123456789abcdef0 ; 八字节常量
      dq 1.234567e20        ; 双精度浮点
      dt 1.234567e20        ; 扩展精度浮点

还有其他形式。请稍候自行查阅 NASM 文档。

要保留空间(无需初始化),可以使用以下伪指令。它们应该放在一个称为.bss的小节中(如果您试图在一个.text小节中使用它们,将会出现错误):

buffer:         resb    64              ; 保留64个字节
wordvar:        resw    1               ; 保留一个字
realarray:      resq    10              ; 十个实数的数组

另一个例子

这是一个要研究的 macOS 程序:

triangle.asm

; ----------------------------------------------------------------------------------------
; 这是一个OSX控制台程序,将星号的小三角形写成标准
; 输出。仅在macOS上运行。
;
; nasm -fmacho64 triangle.asm && gcc hola.o && ./a.out
; ----------------------------------------------------------------------------------------

          global    _main
          default  rel

          section   .text
_main:
          push      rbx                     ; OSX必须,保存栈,Linux下删除该行
          mov       rdx, output             ; rdx holds address of next byte to write
          mov       r8, 1                   ; initial line length
          mov       r9, 0                   ; number of stars written on line so far
line:
          mov       byte [rdx], '*'         ; write single star
          inc       rdx                     ; advance pointer to next cell to write
          inc       r9                      ; "count" number so far on line
          cmp       r9, r8                  ; did we reach the number of stars for this line?
          jne       line                    ; not yet, keep writing on this line
lineDone:
          mov       byte [rdx], 10          ; write a new line char
          inc       rdx                     ; and move pointer to where next char goes
          inc       r8                      ; next line will be one char longer
          mov       r9, 0                   ; reset count of stars written on this line
          cmp       r8, maxlines            ; wait, did we already finish the last line?
          jng       line                    ; if not, begin writing this line
done:
          mov       rax, 0x02000004         ; system call for write
          mov       rdi, 1                  ; file handle 1 is stdout
          mov       rsi, output             ; address of string to output
          mov       rdx, dataSize           ; number of bytes
          syscall                           ; invoke operating system to do the write

          ;exit(0)
          pop rbx                           ; OSX必须,弹出开头保存的栈,Linux下删除该行
          ;mov       rax, 0x02000001         ; system call for exit
          ;xor       rdi, rdi                ; exit code 0
          ;syscall                           ; invoke operating system to exit
          ret

          section   .bss
maxlines  equ       8
dataSize  equ       44
output:   resb      dataSize

$ nasm -fmacho64 triangle.asm && ld triangle.o && ./a.out
*
**
***
****
*****
******
*******
********

此示例中的新内容:

  • cmp 做比较
  • je如果先前的比较相等则跳转。
  • jne(如果不等于则跳转)
  • jl(如果不等于则跳转)
  • jnl(如果不小于则跳转)
  • jg(如果大于则跳转)
  • jng(如果不大于则跳转)
  • jle(如果小于或等于则跳转)
  • jnle(如果不小于或等于则跳转)
  • jge(如果大于或等于则跳转)
  • jnge(如果不大于或等于则跳转)
  • equ实际上不是真正的指令。它只是定义了供汇编程序本身使用的缩写。(这是一个意义深远的想法)
  • .bss节适用于可写数据。

使用 C 库

仅使用 syscall 编写独立程序就已经很酷了,但很少见。我们想使用 C 库中的好东西。

为何在 C语言程序中,看上去都是从 main函数开始执行?这是因为 C library的内部有_start标签!_start开始处的代码会做一些初始化的工作,然后调用main函数中的代码,最后执行清理工作,最终执行60号系统调用以退出。因此,您只需要实现main函数即可,我们可以在汇编语言中实现这么做:

如果您有 Linux,请尝试以下操作:

hola.asm

; ----------------------------------------------------------------------------------------
; 使用C库将" Hola,mundo"写入控制台。程序运行在 Linux 或者其他在 C 语言库中不使用下划线的操作系统上。
; 如何编译执行:
; nasm -felf64 hola.asm && gcc hola.o && ./a.out
; ----------------------------------------------------------------------------------------        
global    main
          extern    puts

          section   .text
main:                                       ; 这里被 C library初始化代码所调用
          mov       rdi, message            ; rdi中的第一个整数(或指针)参数
          call      puts                    ; puts(message)
          ret                               ; 由 main 函数返回 C 语言库例程 
message:
          db        "Hola, mundo", 0        ; 注意字符串必须在C中以0结尾
$ nasm -felf64 hola.asm && gcc hola.o && ./a.out
Hola, mundo

在 macOS 下,看起来会有些不同:

hola.asm

; ----------------------------------------------------------------------------------------
; 这是一个macOS控制台程序,它在一行上写入" Hola,mundo",然后退出。
; 它使用C库中的puts。编译汇编代码并运行:
;
; nasm -fmacho64 hola.asm && gcc hola.o && ./a.out
; ----------------------------------------------------------------------------------------
          global    _main
          extern    _puts

          section   .text
_main:    push      rbx                     ; 调用堆栈必须对齐
          lea       rdi, [rel message]      ; 第一个参数是消息的地址
          call      _puts                   ; puts(message)
          pop       rbx                     ; Fix up stack before returning
          ret

          section   .data
message:  db        "Hola, mundo", 0        ; C字符串末尾需要一个零字节结尾
$ nasm -fmacho64 hola.asm && gcc hola.o && ./a.out
Hola, mundo

在 macOS 领域中,C 函数(或实际上是从一个模块导出到另一个模块的任何函数)必须以下划线作为前缀。调用堆栈必须在 16 字节边界上对齐(稍后会对此进行更多介绍)。并且在访问命名变量时,需要rel前缀。

理解参数调用约束

我们怎么知道puts的参数放在RDI中?答:有多个参数调用约定。

当你为 C library集成的 64 位 Linux 编写代码时,必须遵循《AMD64 ABI Reference》中说明的调用约定 。您也可以从Wikipedia获这些信息 。

注: x86-64 System V ABI下载地址曾是http://x86-64.org/documentation/abi.pdf,现在 System V x86-64 psABI 已迁移到GitHub上维护,最新版本可以查看 J.J. Lu的Github Wiki

在这里列出最重要的几点:

  • 传递参数时,按照从左到右的顺序,将尽可能多的参数依次保存在寄存器中。存放位置的寄存器顺序是确定的:
    • 对于整数和指针:rdi,rsi,rdx,rcx,r8,r9
    • 对于浮点(float和double类型):xmm0,xmm1,xmm2,xmm3,xmm4,xmm5, xmm6,xmm7
  • 剩下的参数将按照从右到左的顺序压入栈中,并在调用之后 由调用函数推出栈
  • 等所有的参数传入后,会生成调用指令。所以当被调用函数得到控制权后,返回地址会被保存在 [rsp] 中,第一个局部变量会被保存在 [rsp+8] 中,以此类推。
  • 栈指针rsp在调用之前,必须与16 字节边界对齐处理。当然,调用的过程中只会把一个 8 bytes 的返回地址推入栈中,所以当函数得到控制权时,rsp 并没有对齐。你需要向栈中压入数据或者从 rsp 减去 8 来使之对齐。
  • 调用函数需要预留如下寄存器(the calle-save registers):rbp,rbx,r12,r13,r14,r15。其他的寄存器可以自由使用。
  • 被调用函数也需要保存 XMCSR 的控制位和 x87 指令集的控制字,但是 x87 指令在 64 位系统中很少见,所以您不必担心这一点。
  • 整数被返回在raxrdx:rax,浮点值返回在xmm0xmm1:xmm0

以上罗列的都理解了吗?什么,还没有?没关系,接下来我们再来一些示例,练习一下。

如下代码,展示如何保存和恢复寄存器:

fib.asm

; ----------------------------------------------------------------------------
; 一个写入前90个斐波那契数字的64位Linux应用程序。至
; 编译汇编代码并运行:
;
; nasm -felf64 fib.asm && gcc fib.o && ./a.out
; ----------------------------------------------------------------------------

        global  main
        extern  printf

        section .text
main:
        push rbx                               ; 我们必须保存它,因为我们使用它

        mov ecx,90                             ; ecx将倒数至0
        xor rax,rax                            ; rax将保留当前数字
        xor rbx,rbx                            ; rbx将保留下一个数字
        inc rbx                                ; rbx最初是1
print:
        ; 我们需要调用printf,但是我们使用的是rax,rbx和rcx。打印
        ; 可能会破坏rax和rcx,因此我们将在调用之前保存它们,并且
        ; 之后恢复它们。

        push rax                               ; caller-save register
        push rcx                               ; caller-save register

        mov rdi,printf                         ; 设置第一个参数(format)
        mov rsi,rax                            ; 设置第二个参数(current_number)
        xor rax,rax                            ; 因为printf是varargs

                                               ; 堆栈已经对齐,因为我们压入了三个8字节寄存器
        call printf                            ; printf(format, current_number)

        pop rcx                                ; restore caller-save register
        pop rax                                ; restore caller-save register

        mov rdx,rax                            ; save the current number
        mov rax,rbx                            ; next number is now current
        add rbx,rdx                            ; get the new next number
        dec ecx                                ; count down
        jnz print                              ; if not done counting, do some more

        pop rbx                                ; returing之前还原rbx
        ret
format:
        db  "%20ld",10,0
$ nasm -felf64 fib.asm && gcc fib.o && ./a.out
                   0
                   1
                   1
                   2
                   .
                   .
                   .
  679891637638612258
 1100087778366101931
 1779979416004714189

通过如上代码,我们学习如下指令:

push x 减少rsp操作数的大小,然后将x存储在[rsp]
pop x 移动[rsp]X,然后增加rsp由操作数的大小
jnz label 如果设置了处理器的 Z(零)标志,请跳至给定标签
call label 按下下一条指令的地址,然后跳到标签
ret 弹出指令指针

C 和汇编语言混合调用示例

该程序只是一个简单的函数,它接受三个整数参数并返回最大值。

maxofthree.asm

; -------------------------------------------------- ---------------------------
; 一个64位函数,该函数返回其三个64位整数的最大值
; 论点。该函数具有签名:
;
; int64_t maxofthree(int64_t x,int64_t y,int64_t z)
;
; 请注意,参数已经在rdi,rsi和rdx中传递。我们
; 只需返回rax中的值即可。
; -------------------------------------------------- ---------------------------

        global  maxofthree
        section .text
maxofthree:
        mov rax,rdi    ; 结果(rax)最初持有x
        cmp rax,rsi    ; x小于y吗?
        cmovl rax,rsi  ; 如果是这样,将结果设置为y
        cmp rax,rdx    ; max(x,y)小于z吗?
        cmovl rax,rdx  ; 如果是这样,将结果设置为z
        ret            ; 最大值将为rax

这是一个调用汇编语言函数的 C 程序。

callmaxofthree.c

/*
 * 一个小程序,说明如何调用我们用汇编语言编写的maxofthree函数。
 *
 */

#include <stdio.h>
#include <inttypes.h>

int64_t maxofthree (int64_t,int64_t,int64_t);

int main(){
    printf("%ld\n", maxofthree(1, -4, -7));
    printf("%ld\n", maxofthree(2, -6, 1));
    printf("%ld\n", maxofthree(2, 3, 1));
    printf("%ld\n", maxofthree(-2, 4, 3));
    printf("%ld\n", maxofthree(2, -6, 5));
    printf("%ld\n", maxofthree(2, 4, 6));
    return 0;
}
$ nasm -felf64 maxofthree.asm && gcc callmaxofthree.c maxofthree.o && ./a.out
1
2
3
4
5
6

有条件的指令

在算术或逻辑指令或比较指令之后cmp,处理器会设置或清除其中的位rflags。最有趣的标志是:

  • s (标志)
  • z (零)
  • c (携带)
  • o (溢出)

因此,执行完一条加法指令后,我们可以根据新的标志设置执行跳转,移动或设置。例如:

jz 标签 如果运算结果为零,则跳至标签 L
cmovno x,y x ← y 如果最后的操作确实溢出
setc x 如果最后一个操作带有进位,则x1,否则,x ← *0,*否则(x必须是字节大小的寄存器或存储器位置)

条件指令具有三种基本形式:j用于条件跳转,cmov用于条件移动和set用于条件设置。指令的后缀具有 30 种形式之一: s ns z nz c nc o no p np pe po e ne l nl le nle g ng ge nge a na ae nae b nb be nbe

命令行参数

在 C 中,main 是一个古老而简单的函数,其实它自身可以附带一些参数:

int main(int argc, char ** argv)

因此,您猜到了,argcrdi结尾,而 argv(指针)以rsi结尾。下面运用这一点,实现将命令行参数简单地逐行显示的程序:

echo.asm

; -------------------------------------------------- ---------------------------
; 一个显示其命令行参数(每行一个)的64位程序。
;
; 在输入时,rdi将包含argc,而rsi将包含argv。
; -------------------------------------------------- ---------------------------

        global  main
        extern  puts
        section .text

main:
        push rdi      ; 保存 puts 函数需要用到的寄存器 
        push rsi
        sub rsp,8     ; 调用函数前让栈顶对齐 

        mov rdi,[rsi] ; 需要输出的字符串参数 
        call puts     ; 调用 puts 输出

        add rsp,8     ; 恢复%rsp到未对齐的值
        pop rsi       ; 恢复puts用到的寄存器
        pop rdi

        add rsi,8     ; 指向下一个参数
        dec rdi       ; 递减参数计数
        jnz main      ; 如果未读完参数则继续 

        ret
$ nasm -felf64 echo.asm && gcc echo.o && ./a.out dog 22 -zzz "hi there"
./a.out
dog
22
-zzz
hi there

一个更长一些的例子

请注意,就 C library而言, 命令行参数总是以字符串的形式传入的。如果要将参数视为整数使用,请调用atoi函数。下面是一个计算 $x^y$ 的函数。

power.asm

; -------------------------------------------------- ---------------------------
; 一个用于计算x ^ y的64位命令行应用程序。
;
; 语法:power x y
; x和y均是(32位)整数
; -------------------------------------------------- ---------------------------

        global  main
        extern  printf
        extern  puts
        extern  atoi

        section .text
main:
        push    r12                     ; 调用者保存寄存器 
        push    r13
        push    r14
        ; 通过压入三个寄存器的值, 栈已经对齐 

        cmp     rdi, 3                  ; 必须有且仅有 2 个参数
        jne     error1

        mov     r12, rsi                ; argv

        ; 我们将使用 ecx 作为指数的计数器, 直至 ecx 减到 0。
        ; 使用 esi 来保存基数, 使用 eax 保存乘积。

        mov     rdi, [r12+16]           ; argv[2]
        call    atoi                    ; y in eax
        cmp     eax, 0                  ; 不允许负指数 
        jl      error2
        mov     r13d, eax               ; y in r13d

        mov     rdi, [r12+8]            ; argv
        call    atoi                    ; x in eax
        mov     r14d, eax               ; x in r14d

        mov     eax, 1                  ; 初始结果 start with answer = 1
check:
        test    r13d, r13d              ; 递减 y 直至 0
        jz      gotit                   ; done
        imul    eax, r14d               ; 再乘上一个 x
        dec     r13d
        jmp     check
gotit:                                  ; print report on success
        mov     rdi, answer
        movsxd  rsi, eax
        xor     rax, rax
        call    printf
        jmp     done
error1:                                 ; print error message
        mov     edi, badArgumentCount
        call    puts
        jmp     done
error2:                                 ; print error message
        mov     edi, negativeExponent
        call    puts
done:                                   ; restore saved registers
        pop     r14
        pop     r13
        pop     r12
        ret

answer:
        db      "%d", 10, 0
badArgumentCount:
        db      "Requires exactly two arguments", 10, 0
negativeExponent:
        db      "The exponent may not be negative", 10, 0
$ nasm -felf64 power.asm && gcc -o power power.o
$ ./power 2 19
524288
$ ./power 3 -8
The exponent may not be negative
$ ./power 1 500
1
$ ./power 1
Requires exactly two arguments

浮点数指令

浮点数参数保存在 xmm 寄存器中。下面是一个用来计算存放在数组中的浮点数的和的简单的函数:

sum.asm

; -------------------------------------------------- ---------------------------
; 一个64位程序,该函数返回浮点数数组元素之和
; 函数声明如下:
;
; double sum(double []array,uint64_t length)
; -------------------------------------------------- ---------------------------

        global  sum
        section .text
sum:
        xorpd   xmm0, xmm0              ; 初始化累加和为 0
        cmp     rsi, 0                  ; 考虑数组长度为 0 的特殊情形 
        je      done
next:
        addsd   xmm0, [rdi]             ; 累加当前数组元素的值 
        add     rdi, 8                  ; 指向下一个数组元素
        dec     rsi                     ; 计数器递减
        jnz     next                    ; 如果计数器未归0,则继续累加 
done:
        ret                             ; 返回保存在 xmm0 寄存器中的值 

请注意,浮点指令具有sd后缀;这是最常见的一种,但稍后我们会再看到其他一些。这是一个调用它的 C 程序:

callum.c

/**
 * 说明如何调用用汇编语言编写的sum函数。
 */

#include <stdio.h>
#include <inttypes.h>

double sum(double[], uint64_t);

int main() {
    double test[] = {
        40.5, 26.7, 21.9, 1.5, -40.5, -23.4
    };
    printf("%20.7f\n", sum(test, 6));
    printf("%20.7f\n", sum(test, 2));
    printf("%20.7f\n", sum(test, 0));
    printf("%20.7f\n", sum(test, 3));
    return 0;
}
$ nasm -felf64 sum.asm && gcc sum.o callsum.c && ./a.out
          26.7000000
          67.2000000
           0.0000000
          89.1000000

数据段

在大多数操作系统上,.data 数据段是只读的,所以你需要使用数据段。.data 部分仅仅用来初始化数据,而您还可以发现有一个特殊的.bss 的段,是用来存放未初始化过的数据的下面是一个程序用来计算通过命令行参数传递的整数的平均值,并且以浮点数输出结果的程序。

average.asm

; -------------------------------------------------- ---------------------------
; 一个把参数当做整数处理, 并且以浮点数形式输出他们平均值的 64 位程序。
; 这个程序将使用一个数据段来保存中间结果。
; 这不是必须的, 但是在此我们想展示数据段是如何使用的。
; -------------------------------------------------- ---------------------------

        global   main
        extern   atoi
        extern   printf
        default  rel

        section  .text
main:
        dec      rdi              ; argc-1,因为我们不计算程序名称
        jz       nothingToAverage
        mov      [count], rdi     ; 保存浮点数参数的个数 
accumulate:
        push     rdi              ; 保存调用 atoi 需要使用的寄存器 
        push     rsi
        mov      rdi, [rsi+rdi*8] ; argv[rdi]
        call     atoi             ; 现在 rax 里保存着 arg 的整数值 
        pop      rsi              ; 调用完 atoi 函数后恢复寄存器 
        pop      rdi
        add      [sum], rax       ; 继续累加 
        dec      rdi              ; 递减 
        jnz      accumulate       ; 还有参数吗?
average:
        cvtsi2sd xmm0, [sum]
        cvtsi2sd xmm1, [count]
        divsd    xmm0, xmm1       ; xmm0 现在值为 sum/count
        mov      rdi, format      ; printf 的第一个参数 [注: 输出格式]
        mov      rax, 1           ; printf 是多参数的, 含有一个不是整数的参数 

        sub      rsp, 8           ; 对齐栈指针 
        call     printf           ; printf(format, sum/count)
        add      rsp, 8           ; 恢复栈指针 

        ret

nothingToAverage:
        mov      rdi, error
        xor      rax, rax
        call     printf
        ret

        section  .data
count:  dq       0
sum:    dq       0
format: db       "%g", 10, 0
error:  db       "There are no command line arguments to average", 10, 0
$ nasm -felf64 average.asm && gcc average.o && ./a.out 19 8 21 -33
3.75
$ nasm -felf64 average.asm && gcc average.o && ./a.out
There are no command line arguments to average

该程序着重介绍了一些在整数和浮点值之间转换的处理器指令。一些最常见的是:

cvtsi2sd xmmreg,r/m32 xmmreg [63..0]intToDouble(r / m32)
cvtsi2ss xmmreg,r/m32 xmmreg [31..0]intToFloat(r / m32)
cvtsd2si reg32,xmmr/m64 reg32doubleToInt(xmmr / m64)
cvtss2si reg32,xmmr/m32 reg32floatToInt(xmmr / m32)

递归

也许令人惊讶的是,实现递归功能并没有什么不同寻常的。您只需要像往常一样小心保存寄存器的状态即可。在递归调用周围推动和弹出是一种典型的策略。

factorial.asm

; ----------------------------------------------------------------------------
; 一种递归函数的实现:
;
;   uint64_t factorial(uint64_t n) {
;       return (n <= 1) ? 1 : n * factorial(n-1);
;   }
; ----------------------------------------------------------------------------

        global  factorial

        section .text
factorial:
        cmp     rdi, 1                  ; n <= 1?
        jnbe    L1                      ; 如果不是, 进行递归调用 
        mov     rax, 1                  ; 否则, 返回 1
        ret
L1:
        push    rdi                     ; 将n保存在堆栈上 (同时对齐 %rsp!)
        dec     rdi                     ; n-1
        call    factorial               ; factorial(n-1), 返回值保保存到 %rax
        pop     rdi                     ; 恢复 n
        imul    rax, rdi                ; n * factorial(n-1), 保存到 %rax
        ret

一个调用示例:

callfactorial.c

/**
 *这是一个调用外部定义的阶乘函数的程序。
 */

#include <stdio.h>
#include <inttypes.h>

uint64_t factorial(uint64_t n);

int main() {
    for (uint64_t i = 0; i < 20; i++) {
        printf("factorial(%2lu) = %lu\n", i, factorial(i));
    }
    return 0;
}
$ nasm -felf64 factorial.asm && gcc -std=c99 factorial.o callfactorial.c && ./a.out
factorial( 0) = 1
factorial( 1) = 1
factorial( 2) = 2
factorial( 3) = 6
factorial( 4) = 24
factorial( 5) = 120
factorial( 6) = 720
factorial( 7) = 5040
factorial( 8) = 40320
factorial( 9) = 362880
factorial(10) = 3628800
factorial(11) = 39916800
factorial(12) = 479001600
factorial(13) = 6227020800
factorial(14) = 87178291200
factorial(15) = 1307674368000
factorial(16) = 20922789888000
factorial(17) = 355687428096000
factorial(18) = 6402373705728000
factorial(19) = 121645100408832000

SIMD 并行

XMM 寄存器可以对浮点值进行一次算术运算(一次标量)或一次执行多次运算(打包)。操作具有以下形式:

op xmmreg_or_memory,xmmreg

对于浮点加法,说明如下:

addpd 并行执行 2 个双精度加法(添加压缩双精度)
addsd 使用寄存器的低 64 位仅执行一次双精度加法(将标量加倍)
addps 并行执行 4 个单精度加法(添加打包的单个)
addss 使用寄存器的低 32 位仅执行一个单精度加法(加标量单)

这是一个可以一次添加四个浮点数的函数:

add_four_floats.asm

; void add_four_floats(float x[4], float y[4])
; x[i] += y[i] for i in range(0..4)

        global   add_four_floats
        section  .text

add_four_floats:
        movdqa   xmm0, [rdi]            ; x的所有四个值
        movdqa   xmm1, [rsi]            ; y的所有四个值
        addps    xmm0, xmm1             ; 一次完成所有四个总和
        movdqa   [rdi], xmm0
        ret

一个呼叫者:

test_add_four_floats.c

#include <stdio.h>
void add_four_floats(float[], float[]);

int main() {
    float x[] = {-29.750, 244.333, 887.29, 48.1E22};
    float y[] = {29.750,  199.333, -8.29,  22.1E23};
    add_four_floats(x, y);
    printf("%f\n%f\n%f\n%f\n", x[0], x[1], x[2], x[3]);
    return 0;
}

还可以参考:nice little x86 floating-point slide deck from Ray Seyfarth

饱和运算

XMM 寄存器还可以对整数进行算术运算。这些说明具有以下形式:

op xmmreg_or_memory, xmmreg

对于整数加法,说明如下:

paddb 做 16 个字节加法
paddw 做 8 个单词加法
paddd 做 4 个 dword 加法
paddq 做 2 个 qword 加法
paddsb 执行 16 个字节加法并带符号饱和度(80..7F)
paddsw 进行 8 个带符号饱和的单词加法(8000..7F)
paddusb 执行 16 个字节的无符号饱和(00..FF)
paddusw 进行 8 个无符号饱和(00..FFFF)的单词加法

这是一个例子。它还说明了如何加载 XMM 寄存器。您无法加载立即值;您必须使用它movaps来移出内存。还有其他方法,但是我们不会在本教程中介绍所有内容。

satexample.asm

; ----------------------------------------------------------------------------------------
; 有符号饱和运算示例。
; ----------------------------------------------------------------------------------------
        global  main
        extern  printf

        section .text
main:
        push    rbp
        movaps  xmm0, [arg1]
        movaps  xmm1, [arg2]
        paddsw  xmm0, xmm1
        movaps  [result], xmm0

        lea     rdi, [format]
        mov     esi, dword [result]
        mov     edx, dword [result+4]
        mov     ecx, dword [result+8]
        mov     r8d, dword [result+12]
        xor     rax, rax
        call    printf
        pop     rbp
        ret
        section .data
        align   16
arg1:   dw      0x3544,0x24FF,0x7654,0x9A77,0xF677,0x9000,0xFFFF,0x0000
arg2:   dw      0x7000,0x1000,0xC000,0x1000,0xB000,0xA000,0x1000,0x0000
result: dd      0, 0, 0, 0
format: db      '%x%x%x%x',10,0

图形

TODO

局部变量和堆栈框架

首先,请阅读Eli Bendersky 的文章, 该概述比我的简短笔记更完整。

调用函数时,调用者将首先将参数存入正确的寄存器中,然后发出call指令。调用之前,超出寄存器覆盖范围的其他参数将被推入栈中。所调用的指令会把返回地址存入栈顶。所以如果有以下的函数:

int64_t example(int64_t x, int64_t y) {
    int64_t a, b, c;
    b = 7;
    return x * b + y;
}

在函数的入口,x 将存在 edi 中,y 将存在 esi 中,返回地址将在堆栈的顶部。局部变量会被存到哪里?无论是否有足够的寄存器,一种简单的选择就是存入函数自己的栈中。

如果程序运行在一个实现了 ABI 标准的机器上,你可以在 rsp 保持不变的情况下获取无法在寄存器中保存的参数值和局部变量值,例如:

                +----------+
         rsp-24 |    a     |
                +----------+
         rsp-16 |    b     |
                +----------+
         rsp-8  |    c     |
                +----------+
         rsp    | retaddr  |
                +----------+
         rsp+8  | caller's |
                | stack    |
                | frame    |
                | ...      |
                +----------+

因此,我们的函数看上去是这个样子的:

        global  example
        section .text
example:
        mov     qword [rsp-16], 7
        mov     rax, rdi
        imul    rax, [rsp+8]
        add     rax, rsi
        ret

如果被调用的函数需要调用其他函数,你就需要调整 rsp 的值来得到正确的返回地址。

在 Windows 上,您不能使用此方案,因为当中断发生时,栈指针上方的所有内容都会被抹去。而在其他大多数操作系统中,不会发生这种情况,因为在栈指针后面,有一个 128 字节的"红色区域”来保护栈指针的安全。在这种情况下,您可以立即在栈上腾出空间:

例:
        sub rsp, 24

因此我们的堆栈如下所示:

                +----------+
         rsp    |    a     |
                +----------+
         rsp+8  |    b     |
                +----------+
         rsp+16 |    c     |
                +----------+
         rsp+24 | retaddr  |
                +----------+
         rsp+32 | caller's |
                | stack    |
                | frame    |
                | ...      |
                +----------+

现在是这里的功能。请注意,我们必须记住在返回之前要替换栈指针!

        global  example
        section .text
example:
        sub     rsp, 24
        mov     qword [rsp+8], 7
        mov     rax, rdi
        imul    rax, [rsp+8]
        add     rax, rsi
        add     rsp, 24
        ret

在 macOS 上使用 NASM

希望您已经使用基于 Linux 的操作系统(或更正确地说,是 ELF64 系统)阅读了以上整个教程。要使这些示例在 64 位 macOS 系统上工作,几乎只有五件事要了解:

  • 此目标文件格式macho64不是elf64
  • 系统调用值完全不同
  • 模块之间共享符号以下划线作为前缀
  • 除非您进行一些设置调整,否则 macOS 中的 gcc 链接器似乎不允许绝对寻址。因此default rel,在引用标记的内存位置时添加,并且始终用lea获取地址。
  • 另外,似乎有时在 Linux 下,不强制执行 16 位堆栈对齐要求,但似乎始终在 macOS 下强制执行。

因此,这是上面为 macOS 编写的普通程序。

average.asm

; -------------------------------------------------- ---------------------------
; 64位程序,将其所有命令行参数都视为整数和
; 将其平均值显示为浮点数。该程序使用数据
; 存储中间结果的部分,不是必须要存储的,而仅仅是
; 说明如何使用数据段。
;
; 为OS X设计。组装和运行:
;
; nasm -fmacho64 average.asm && gcc average.o && ./a.out
; -------------------------------------------------- ---------------------------

        global   _main
        extern   _atoi
        extern   _printf
        default  rel

        section  .text
_main:
        push     rbx              ; 我们从未使用,但是必须的代码,对齐堆栈,以便我们调用东西
        dec      rdi              ; argc-1, 因为我们不计算程序名称
        jz       nothingToAverage
        mov      [count], rdi     ; 保存实参数量
accumulate:
        push     rdi              ; save register across call to atoi
        push     rsi
        mov      rdi, [rsi+rdi*8] ; argv[rdi]
        call     _atoi            ; now rax has the int value of arg
        pop      rsi              ; restore registers after atoi call
        pop      rdi
        add      [sum], rax       ; accumulate sum as we go
        dec      rdi              ; count down
        jnz      accumulate       ; more arguments?
average:
        cvtsi2sd xmm0, [sum]
        cvtsi2sd xmm1, [count]
        divsd    xmm0, xmm1       ; xmm0 is sum/count
        lea      rdi, [format]    ; 1st arg to printf
        mov      rax, 1           ; printf is varargs, there is 1 non-int argument
        call     _printf          ; printf(format, sum/count)
        jmp      done

nothingToAverage:
        lea      rdi, [error]
        xor      rax, rax
        call     _printf

done:
        pop      rbx              ; undoes the stupid push at the beginning
        ret

        section  .data
count:  dq       0
sum:    dq       0
format: db       "%g", 10, 0
error:  db       "There are no command line arguments to average", 10, 0
$ nasm -fmacho64 average.asm && gcc average.o && ./a.out
There are no command line arguments to average
$ nasm -fmacho64 average.asm && gcc average.o && ./a.out 54.3
54
$ nasm -fmacho64 average.asm && gcc average.o && ./a.out 54.3 -4 -3 -25 455.1111
95.4

在 Windows 上使用 NASM

我不确定 Windows 上的 syscall 是什么,但是我确实知道,如果您要汇编和链接 C 库,则必须了解x64 约定。阅读它们。您将学到以下内容:

  • 前四个整数参数在 RCX,RDX,R8 和 R9 中传递。其余的将被推入堆栈。
  • 被调用者(callee)必须保留 RBX,RBP,RDI,RSI,RSP,R12,R13,R14 和 R15。
  • 您猜对了,前四个浮点参数被通过 XMM0,XMM1,XMM2 和 XMM3。
  • 返回值进入 RAX 或 XMM0。

重要说明:在任何文档中都很难找到一件事:x64 调用约定要求您在每次调用之前分配 32 字节的影子空间,并在调用之后将其删除。这意味着您的"hello world"程序如下所示:

hello.asm

; -------------------------------------------------- --------------------------------------
; 这是一个Win64控制台程序,它在一行上写入" Hello",然后退出。它
; 使用C库中的puts。编译汇编代码并运行:
;
; nasm -fwin64 hello.asm && gcc hello.obj && a
; -------------------------------------------------- --------------------------------------

        global  main
        extern  puts
        section .text
main:
        sub     rsp, 28h                        ; 保留影子空间
        mov     rcx, message                    ; 第一个参数是message变量的地址
        call    puts                            ; puts(message)
        add     rsp, 28h                        ; 删除影子空间
        ret
message:
        db      'Hello', 0                      ; C strings need a zero byte at the end
       

您是否注意到我们实际上保留了 40 个字节?最小 32 字节的影子空间是必需的。在我们的main函数中,我们正在调用另一个函数,因此我们的堆栈必须在 16 字节边界处对齐。当main被调用时,返回地址(8 个字节)被压入,因此我们必须向影子空间"添加"额外的 8 个字节。

About

Nasm指南中文 (NASM Tutorial)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published