Post

[CS] WebAssembly

[CS] WebAssembly

WebAssembly(Wasm)는 웹 브라우저를 비롯한 여러 환경에서 빠르게 실행할 수 있도록 설계된 바이너리 명령어 형식이다.

JavaScript와 마찬가지로 브라우저 내부에서 실행될 수 있지만 JavaScript 소스 코드를 직접 실행하는 것과는 구조가 다르다.

일반적으로 C/C++ 등의 언어를 WebAssembly로 컴파일한 뒤 실행하며 브라우저에서는 JavaScript를 통해 Wasm 모듈을 로드하고 사용할 수 있다.

V8에서는 JavaScript뿐만 아니라 WebAssembly 역시 직접 실행할 수 있다.


Module

Module은 Wasm 바이너리를 파싱하고 검증한 결과를 나타낸다. JavaScript에서는 WebAssembly.Module을 통해 생성할 수 있다.

1
2
3
4
5
6
const wasmCode = new Uint8Array([
  0x00, 0x61, 0x73, 0x6d,
  0x01, 0x00, 0x00, 0x00
]);

const module = new WebAssembly.Module(wasmCode);

여기서 wasmCode는 WebAssembly 바이너리이다.

Wasm 바이너리의 시작 부분에는 다음과 같은 Magic Number가 존재한다.

1
00 61 73 6d

위 코드는 내용이 거의 없는 최소한의 WebAssembly Module이다.

중요한 점은 Module 자체는 실행 중인 프로그램 인스턴스가 아니라는 것이다.

Module은 대략 다음과 같은 정보를 가지고 있다.

  • Function 정보
  • Type 정보
  • Import 정보
  • Export 정보
  • Memory 정보
  • Table 정보

실제 실행을 위해서는 Module을 기반으로 Instance를 생성해야 한다.


Instance

WebAssembly.Instance는 Module을 실제로 실행할 수 있도록 생성된 실행 인스턴스이다.

1
const instance = new WebAssembly.Instance(module);

하나의 Module로 여러 개의 INstance를 생성하는 것도 가능하다.

1
2
const instance1 = new WebAssembly.Instance(module);
const instance2 = new WebAssembly.Instance(module);

즉 module은 프로그램 구조, Instance는 실행 상태로 생각하면 편하다.

Instance에는 해당 Wasm 프로그램이 사용하는 Memory, Table, Global 등의 실행 상태가 연결될 수 있다.


Export

WebAssembly 내부에서 정의한 함수나 Memory 등을 JavaScript에서 사용하려면 Export해야한다.

예를 들어 다음과 같은 Wasm 함수가 있다.

(module 
	(func $add (param i32 i32) (result i32) 
    	local.get 0 
        local.get 1 
        i32.add 
    ) 
    
    (export "add" (func $add)) 
)

위 module에는 두 정수를 더하는 add 함수가 존재한다.

그리고 (export "add" (func $add)) 코드가 이 함수를 외부로 노출한다.

1
2
3
const add = instance.exports.add;

console.log(add(10, 20));

결과는 30이 나온다.


Import

반대로 WebAssembly가 외부의 함수나 객체를 사용해야 할 수도 있다.

이때 사용하는 것이 Import이다.

예를 들어 Wasm에서 외부 함수 print를 사용한다고 가정한다.

1
2
3
4
5
(module 
	(import "env" "print"
    	(func $print (param i32)) 
	) 
)

JavaScript에서는 Instance를 생성하면서 해당 함수를 전달한다.

1
2
3
4
5
6
7
8
9
const imports = { 
  env: { 
    print: function (value) { 
      console.log(value); 
    } 
  } 
}; 

const instance = new WebAssembly.Instance(module, imports);

따라서 Import와 Export는 JavaScript와 Wasm 사이의 인터페이스 역할을 한다.


Memory

WebAssembly는 데이터를 저장하기 위해 Linear Memory라는 메모리 구조를 사용할 수 있다.

JavaScript에서는 다음과 같이 생성한다.

1
2
3
const memory = new WebAssembly.Memory({
	initial: 1
});

여기서 initial: 1은 메모리의 초기 크기가 1 page라는 의미이다.

WebAssembly에서 한 page의 크기는 64KiB와 같다.

따라서 initial이 2라면 초기 크기는 128KiB가 된다.

Linear Memory

WebAssembly의 Memory는 하나의 연속된 바이트 배열처럼 생각할 수 있다.

Wasm 코드에서는 메모리 주소를 offset 형태로 사용한다.

예를 들어 i32.load 또는 i32.store 같은 명령어를 통해 값을 읽고 쓸 수 있다.

JavaScript에서는 해당 Memory를 ArrayBuffer 형태로 접근할 수 있다.

1
const buffer = memory.buffer;

그리고 TypedArray를 이용하면 실제 데이터를 읽고 쓸 수 있다.

1
2
3
4
const view = new Uint8Array(memory.buffer);

view[0] = 0x41;
console.log(view[0]);

결과는 65가 나온다.

Grow

WebAssembly Memory는 실행 중 크기를 증가시킬 수도 있다.

1
memory.grow(1);

이 경우 메모리가 1 page 증가한다.

단 Memory는 자유롭게 무한정 증가하는 것이 아니라 maximum을 설정할 수도 있다.

1
2
3
4
const memory = new WebAssembly.Memory({
  initial: 1,
  maximum: 10
});

이 경우 최대 크기는 10 * 64KiB 가 된다.


Table

WebAssembly에는 Table이라는 객체도 존재한다.

Table은 주로 함수 등의 참조를 저장하는 배열과 비슷한 구조이다.

1
2
3
4
5
6
WebAssembly.Table

index
0 -> function A
1 -> function B
2 -> function C

특히 Wasm의 간접 함수 호출에 사용된다.

예를 들어 다음과 같은 Table을 생성할 수 있다.

1
2
3
4
const table = new WebAssembly.Table({
  initial: 10,
  element: "anyfunc"
});

최근 WebAssembly에서는 function reference와 관련하여 funcref라는 타입 개념이 사용된다.

Wasm 코드에서는 call_indirect 명령어를 통해 Table의 특정 엔트리에 저장된 함수를 호출할 수 있다.

Table은 C/C++에서의 함수 포인터 테이블과 비슷하다고 이해했다.


Global

WebAssembly에는 전역 값을 저장하기 위한 Global도 존재한다.

1
2
3
4
5
6
7
const global = new WebAssembly.Global(
  {
    value: "i32",
    mutable: true
  },
  10
};

값은 다음과 같이 접근할 수 있다.

1
console.log(global.value);

결과는 10이 나온다.

mutable: true라면 값을 수정할 수도 있다.

1
global.value = 20;

Global에는 Wasm이 사용하는 기본 타입의 값이 저장될 수 있다.


Wasm의 기본 타입

WebAssembly에서는 JavaScript보다 훨씬 명확한 타입을 사용한다. 대표적인 숫자 타입은 다음과 같다.

1
2
3
4
i32
i64
f32
f64

각각

  • i32 -> 32-bit Integer
  • i64 -> 64-bit Integer
  • f32 -> 32-bit Floating Point
  • f64 -> 64-bit Floating Point

를 의미한다.

예를 들어

(func (param i32 i32) (result i32))

라면

i32 두 개를 입력 받아서 i32 하나를 반환하는 함수인 것이다.

JavaScript처럼 실행 중에 값의 타입이 자유럽게 변하는 구조와는 다르다.


Wasm Function

WebAssembly의 함수는 다음과 같이 정의할 수 있다.

1
2
3
4
5
6
7
8
9
(func $add
	(param $a i32) 
    (param $b i32) 
    (result i32) 
    
    local.get $a 
    local.get $b 
    i32.add 
)

동작은 a와 b를 i32.add로 result를 내는 함수이다.

Wasm은 Stack Machine 형태의 명령어 모델을 사용한다. 이러한 명령들은 나중에 V8의 Wasm 컴파일러에 의해 실제 머신 코드로 변환된다.


This post is licensed under CC BY 4.0 by the author.