The VM harness (tests/vm/) builds and exercises the tools on real Debian and Alpine guests, driving the serial console (no sshd/cloud-init dependency). Results on Debian 12 (glibc 2.36, gcc 12.2): 12/12 checks pass, 0 warnings with -Wall -Wextra, including a real 128M -> 256M resize and the rollback save/restore/reject paths. Results on Alpine 3.20 (musl 1.2.5): the build cannot start. configure stops at "reiserfsprogs requires a method to add printf modifiers" because reiserfscore/prints.c depends on glibc's register_printf_specifier(3) and <printf.h>, which musl does not provide. This is pre-existing and out of scope here; measured at 341 use sites across 20+ files, all routed through reiserfs_warning()/reiserfs_info(). Documented in tests/vm/RESULTS.md. Fix the one real defect the harness surfaced: fsck/semantic_check.c: check_check_regular_file() is called with NULL for new_ih (line 466), so the block that would fill *new_ih is unreachable and check_semantic_pass() never returns RELOCATED through that path. The "case RELOCATED:" arm still reads relocated_ih.ih_key, which gcc 12.2 reports as "may be used uninitialized" (-Wmaybe-uninitialized); gcc 16 does not, because it proves the path dead. Zero-initialise the struct and say why. Verified: 0 warnings on gcc 12.2 after the change, and the Debian battery stays at 12/12.
Ambiente de testes em VM
Este documento descreve o ambiente de validação do reiserfsprogs em máquinas virtuais (libvirt/KVM), usado para exercitar o build e as ferramentas em distribuições diferentes da máquina de desenvolvimento.
O ambiente é efêmero: as VMs ficam em /var/tmp/vmtest e não fazem parte
do repositório. Os scripts que o reproduzem estão em tests/vm/.
Requisitos do host
| Componente | Verificação |
|---|---|
| KVM | ls -l /dev/kvm |
| libvirt (user session) | virsh -c qemu:///session list --all |
virt-install, qemu-img |
which virt-install qemu-img |
guestfs-tools (offline) |
which virt-customize |
mkisofs ou xorriso |
which mkisofs xorriso |
No Fedora: sudo dnf install libvirt-daemon-kvm qemu-kvm virt-install guestfs-tools genisoimage.
O ambiente usa qemu:///session (sem root). Não requer a rede default
do libvirt: a conectividade vem do backend passt em modo user.
Topologia
graph LR
H[host] -->|qemu:///session| D[rfs-debian<br/>Debian 12 · gcc]
H -->|qemu:///session| A[rfs-alpine<br/>Alpine 3.20 · gcc/musl]
D -->|passt :2222| S[ssh opcional]
A -->|passt| S
H -->|attach-disk| V[vdb: fontes + run_tests.sh]
Cada VM recebe:
- imagem cloud (qcow2) redimensionada para 8 GiB;
- um disco de dados
vdb(ext4) comrfs-src.tar.gzerun_tests.sh; - acesso por console serial (pty do libvirt), que é o canal de automação usado — independente de rede.
Por que console serial e não SSH
Nas imagens cloud o sshd demora a subir e o cloud-init nem sempre aplica
a senha (o datasource NoCloud exige rótulo cidata e o CD precisa estar no
Barramento certo). O console serial está disponível assim que o getty sobe e
é suficiente para: autenticar, copiar arquivos (já estão no vdb) e rodar
qualquer comando. Por isso o tests/vm/guestcmd.py dirige o pty.
Ciclo de uso
cd tests/vm
# 1. preparar imagens e VMs (uma vez)
./setup_env.sh
# 2. rodar a bateria em uma VM
./run_in_vm.sh rfs-alpine
./run_in_vm.sh rfs-debian
# 3. destruir tudo
./teardown_env.sh
O que a bateria cobre (tests/vm/run_tests.sh)
Executado dentro do guest, sobre o código extraído do vdb:
autogen.sh && configure --enable-warnings && make -j— build limpo;- contagem de warnings (esperado: 0);
mkreiserfsem imagem de 64 MiB;reiserfsck --check(esperado: No corruptions found);debugreiserfs -S(superblock consistente);reiserfstune -l(troca de label);resize_reiserfs128 MiB → 256 MiB;reiserfsckpós-resize;- rollback:
-Rgrava,--rollback-fsck-changesrestaura, arquivo inválido é rejeitado.
Resultados obtidos
Ver tests/vm/RESULTS.md.