A regra: reproduzir antes de alterar
Um relato útil descreve o comportamento esperado, o resultado real e as condições do teste. “Não inicia” é pouco. “Após selecionar UEFI no QEMU, aparece uma tela preta antes do terminal” já ajuda a isolar a etapa.
Ferramentas de inspeção
Dentro de um sistema Linux em execução, estes comandos podem ajudar:
uname -a
journalctl -b -p warning --no-pager
systemctl --failed
lsblk -o NAME,SIZE,TYPE,MOUNTPOINTS
lsblk aqui é apenas leitura. Não use comandos de formatação como método de depuração.
Diagnóstico por sintomas
| Sintoma | Primeiro ponto de verificação |
|---|---|
mkarchiso falhou |
Mensagem final, pacotes e espaço livre |
| ISO não inicia | Arquivos de boot, firmware da VM e perfil |
| Entra no terminal | Sessão gráfica e gerenciador de login não configurados |
| Sem rede | Adaptador da VM, serviço e logs |
| Tela preta | Configuração de vídeo, display manager e logs |
| Instalou, não reinicia | Bootloader e sistema realmente instalado |
Registre o bug
Modelo:
Título: sessão gráfica não aparece no modo UEFI
Versão: 0.2-alpha
Ambiente: QEMU + UEFI
Esperado: abrir a tela de login
Obtido: termina no terminal
Como reproduzir: iniciar a ISO com run_archiso -i
Log relevante: [colar somente as linhas necessárias]
Status: aberto
Antes de divulgar logs, remova tokens, senhas, dados pessoais e endereços que não sejam necessários ao diagnóstico.