Trabalhando com o sistema de arquivos WASI
Aprenda como o WASI expõe o sistema de arquivos do host a um módulo em sandbox por meio de diretórios pré-abertos e acesso a arquivos baseado em capacidades.
Trabalhando com o sistema de arquivos WASI é uma aula grátis de WebAssembly (WASM) for High Performance Apps no CoddyKit. Esta é a aula 4 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de WebAssembly (WASM) for High Performance Apps, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de WebAssembly (WASM) for High Performance Apps inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
Why Files Need Special Handling
A WASM module has no ambient authority — it cannot open any file by default. WASI grants file access only through preopened directories handed to the module at startup.
- No path traversal outside what was granted
- Access is capability-based, not permission-based
Preopened Directories
When a runtime launches a module it can map a host folder to a guest path. The module receives a file descriptor for each mapping.
Example with wasmtime: wasmtime --dir=. app.wasm grants the current directory.
wasmtime run --dir=./data app.wasmReading a File from WASI
In a WASI language SDK the standard library file APIs are wired to WASI calls. In C, fopen works only for preopened paths.
#include <stdio.h>
int main() {
FILE *f = fopen("data/hello.txt", "r");
if (!f) { perror("open"); return 1; }
char buf[128];
while (fgets(buf, sizeof buf, f)) fputs(buf, stdout);
fclose(f);
return 0;
}Writing Files Safely
Writing also requires a preopened directory with the right rights. Attempting to write outside it returns an error such as ENOTCAPABLE.
#include <stdio.h>
int main() {
FILE *f = fopen("data/out.txt", "w");
if (!f) return 1;
fputs("written via WASI\n", f);
fclose(f);
return 0;
}File Descriptors & Rights
Each WASI file descriptor carries a set of rights (read, write, seek, etc.). A directory descriptor can be more restrictive than its host counterpart, enabling least-privilege design.
Path Resolution Rules
WASI resolves paths relative to a preopened descriptor. The runtime picks the longest matching preopen. There is no global root; / is meaningless unless mapped.
The wasi-libc Layer
Languages like C compiled with wasi-sdk use wasi-libc, which translates POSIX calls into WASI syscalls. This is why familiar APIs just work inside the sandbox.
clang --target=wasm32-wasi -o app.wasm app.cListing a Directory
Directory iteration uses fd_readdir under the hood. High-level languages expose this as normal directory listing once a directory is preopened.
Common Errors
Typical filesystem errors when learning WASI:
ENOENT— file not found within the preopenENOTCAPABLE— path is outside any granted directoryEACCES— descriptor lacks the required right
Multiple Preopens
You can grant several directories, each with a distinct guest alias.
wasmtime run --dir=./in::input --dir=./out::output app.wasmBest Practices
Grant the narrowest directory possible, prefer read-only preopens, and never assume host absolute paths exist inside the module.
Quick Check
Test your understanding of WASI file access.
Recap
You learned that WASI uses preopened directories and capability-based descriptors to expose files safely. Paths resolve relative to preopens, rights enforce least privilege, and wasi-libc bridges POSIX APIs to WASI syscalls.
Perguntas Frequentes
A aula “Trabalhando com o sistema de arquivos WASI” é grátis?
Sim — o texto completo de “Trabalhando com o sistema de arquivos WASI” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de WebAssembly (WASM) for High Performance Apps, atualize para CoddyKit PRO. O curso de WebAssembly (WASM) for High Performance Apps inclui 4 aulas no total.
O que vou aprender em “Trabalhando com o sistema de arquivos WASI”?
Aprenda como o WASI expõe o sistema de arquivos do host a um módulo em sandbox por meio de diretórios pré-abertos e acesso a arquivos baseado em capacidades. Você pratica WebAssembly (WASM) for High Performance Apps com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar WebAssembly (WASM) for High Performance Apps?
Nenhuma experiência prévia é necessária. WebAssembly (WASM) for High Performance Apps no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 4 de 4.
Quanto tempo leva a aula “Trabalhando com o sistema de arquivos WASI”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de WebAssembly (WASM) for High Performance Apps?
Sim. Cada aula de WebAssembly (WASM) for High Performance Apps inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Introdução ao WASI e seus objetivos
- Criando e executando módulos WASI
- Recursos e futuro do WASI
- Trabalhando com o sistema de arquivos WASI