Samsung/Walrus

삼성 오픈소스 경량 WebAssembly 런타임 Walrus의 WASI 계층과 인터프리터에 기여했습니다.

기간
2026.04 ~ 2026.12
역할
오픈소스 기여
분류
System Software
기술
C++, WebAssembly
Walrus 구조와 기여 위치
그림 1. Walrus 구조와 기여 위치생성형 AI로 만든 이미지입니다.

개요

Walrus(WebAssembly Lightweight RUntime)는 삼성이 개발해 오픈소스로 공개한 C++ 기반 경량 WebAssembly 런타임입니다. WebAssembly 모듈을 인터프리터와 JIT 컴파일러로 실행하며, 파일과 소켓 같은 시스템 기능을 쓰기 위한 WASI, WebAssembly GC, 표준 C API(wasm-c-api)를 지원합니다. 이 가운데 WASI 계층과 인터프리터 부분에 기여했습니다.

WASI 시스템 콜 구현

PR #401, #406

문제

Walrus는 WASI 함수 호출을 uvwasi 라이브러리에 넘겨 처리하는데, 기여한 5개의 WASI 함수는 지원되지 않았습니다. 이 함수들을 import하는 WebAssembly 모듈은 Walrus에서 실행할 수 없었습니다.

해결

다섯 함수를 uvwasi에 바인딩하고 시그니처와 함께 WASI 함수 테이블에 등록했습니다.

검증

함수마다 .wast 테스트를 직접 작성해 동작을 확인했습니다.

Apple Clang 바이트코드 매핑 버그 수정

이슈 #398, PR #472

문제

macOS(Apple Clang)에서 빌드하면 computed-goto 인터프리터의 opcode 레이블이 tail merging으로 같은 주소로 합쳐집니다. 그러면 주소로 opcode를 찾는 역방향 테이블(m_addressToOpcodeTable)이 잘못된 값을 돌려주고, 바이트코드와 실행 경로의 매핑이 어긋납니다. JIT 컴파일에 치명적인 문제였습니다.

기존 대응

일부 바이트코드(MoveFloat 등)에서 src와 dst 필드 순서를 일부러 뒤집는 임시 우회 코드로 증상만 피하고 있었습니다.

해결

DEFINE_OPCODE 매크로에서 레이블마다 __asm__ volatile 배리어를 넣어, 본문이 같아도 병합되지 않게 했습니다. 우회 코드를 지우고 필드 순서를 원래대로 되돌렸으며, 불필요해진 UnaryReversedOperation 클래스는 리뷰 의견을 받아 함께 정리했습니다.

초기화 시 추가한 검사. 병합이 다시 일어나면 조용히 틀리지 않고 시작 시점에 멈춥니다.

RELEASE_ASSERT(m_addressToOpcodeTable.size() == OpcodeKindEnd);
검증

레이블마다 코드가 늘어 성능 영향을 질문받았고, 벤치마크를 10회 실행해 비교했습니다. dispatch 비중이 큰 테스트는 빨라졌고, 일부 테스트는 소폭 느려졌습니다.

결과

메인테이너 2명의 승인을 받아 병합됐습니다.