WebGPU C API rewritten to match Dawn's webgpu.h
Component: WebGPU | 2eb1451
WebGPU.framework는 WebKit이 WebGPU C API를 Metal 기반으로 구현한 framework입니다. GPU process가 WebContent를 대신해 이를 실행하며, WebContent는 WebGPU IPC와 proxy 계층을 거쳐 여기에 도달합니다. 기존에는 wgpuBufferMapAsync, wgpuInstanceRequestAdapter, wgpuAdapterRequestDevice 같은 entry point가 callback 기반으로 동작했습니다. 이때 완료 시점과 lifetime 규칙은 호출자에 따라 달라졌습니다.
이번 commit으로 C API(WebGPU.h와 Metal entry point)가 Dawn/ANGLE이 빌드에 사용하는 webgpu.h와 일치하도록 변경되었습니다. 먼저 string view, callback-info 구조체를 받는 future, pointer+size 인자, status 반환값이 도입되었습니다. 여기에 _Undefined enum 기본값과 _BindingNotUsed, 그리고 external texture와 max draw count를 위한 chained struct도 추가되었습니다.
한편 pending future는 이제 instance가 소유합니다. wgpuInstanceWaitAny는 future 하나가 완료되거나 timeout이 발생할 때까지 pending 작업을 직접 구동합니다. 또한 wgpuAdapterGetInfo가 문자열을 할당하고, 해제는 wgpuAdapterInfoFreeMembers가 담당하도록 바뀌었습니다. wgpuDeviceGetQueue는 이제 새 reference를 반환합니다.
Before: After:
wgpuXRequest(desc, cb, userdata) wgpuXRequest(desc, CallbackInfo)
└─► work ──► cb(userdata) └─► Instance::createFuture() ──► WGPUFuture
wgpuInstanceWaitAny(futures[], n, timeout)
└─► loop: run pending instance work ──► completeFuture() ──► callback
until anyFutureCompleted() or timeout
Significance
하나의 C header로 Dawn과 WebKit Metal backend를 모두 지원할 수 있게 되었습니다. 다만 그 대가로 거의 모든 entry point의 async, string, refcount 계약이 바뀌었습니다.
Audit directions
새로 생긴 ownership 계약 하나하나가 privileged process 안에서 lifetime 버그로 이어질 수 있는 후보입니다. 먼저 future와 callback-info의 lifetime을 instance teardown 시점과 대조해 확인할 필요가 있습니다. device, adapter, buffer가 파괴된 뒤 callback이 호출되는 경우, 중복 완료(double completion), userdata 처리도 함께 살펴봐야 합니다.
wgpuInstanceWaitAny는 pending 작업을 synchronous하게 실행합니다. 따라서 re-entrancy, 순회 도중 future 집합이 변경되는 경우, timeout 경계 조건을 점검해야 합니다. 유효하지 않거나 이미 완료된 future가 전달되는 경우도 대상입니다.
wgpuAdapterGetInfo/wgpuAdapterInfoFreeMembers(toAPIAllocated, freeAllocated)의 수동 alloc/free 역시 주의할 지점입니다. allocator 불일치, double free, 초기화되지 않은 구조체 해제가 발생하기 쉬운 구조이기 때문입니다. string view의 length와 NUL 종료 사이의 혼동도 가능한데, 이번 주 EME 버그와 같은 유형에 해당합니다.
wgpuDeviceGetQueue의 호출 지점에서는 이제 leak이나 over-release가 발생할 가능성이 있습니다. 새로 작성된 wgpuBufferGetMappedRange, wgpuBufferGetConstMappedRange, wgpu*SetBindGroup, wgpuCommandEncoderFinish의 변환 코드에는 bounds, size, null/zero-count 검사가 필요합니다. 마지막으로, 예상하지 못한 sType 값을 만나는 chained struct 순회와 검증 없이 Metal까지 도달하는 sentinel 값도 점검 대상입니다.