Documentação
técnica.
O que a linha de comando aceita hoje, o que cada saída significa e onde o programa guarda o que guarda.
Comandos e opções
O que a linha de comando aceita hoje. Sem promessa de comando que não existe.
| Comando ou opção | O que faz |
|---|---|
scan <caminho> | Varre uma pasta ou um arquivo. Aceita --report-html, --report-json, --max-size e --quarantine-suspicious. |
restore <id> | Devolve um item da quarentena ao caminho de origem, conferindo o SHA-256 antes. |
update-signatures <arquivo> | Importa uma lista de hashes ou trechos para a base do usuário. |
--rules <pasta> | Aponta a pasta de regras YARA, quando o pacote opcional está instalado. |
--max-size <MiB> | Limite por arquivo. O padrão é 2048 MiB; acima disso o arquivo é registrado como ignorado. |
--quarantine-suspicious | Faz o que o nome diz: isola também o que for apenas suspeito. |
Formatos de base
A detecção real depende do que você importar. Estes são os formatos aceitos.
-
Texto simples (.txt)
Um SHA-256 por linha. É o formato mais simples de gerar a partir de qualquer planilha.
-
CSV do MalwareBazaar
Exportação direta do serviço. Os hashes são CC0, o que evita problema de licença na redistribuição.
-
JSON no formato do programa
Aceita hashes e trechos. Útil quando você quer versionar a base junto com outra configuração.
-
Trechos de 16 a 256 bytes
Até 5.000 padrões por base. Cada padrão custa uma busca por bloco; para listas grandes, prefira hashes.
Códigos de saída
Para automação não confundir “limpo” com “não terminou”, cada desfecho tem o seu código.
| Desfecho | Significado |
|---|---|
| Limpo | A varredura terminou e não encontrou nada. |
| Achou | Terminou e encontrou ao menos um item malicioso ou suspeito. |
| Incompleto | Não terminou: arquivo ilegível, regra que estourou o tempo ou interrupção. Nunca tratar como limpo. |
Onde ficam os dados
Tudo no seu computador, na pasta de dados do aplicativo.
-
Base de assinaturas
Os hashes importados e os trechos ficam na pasta de assinaturas, versionados junto com o programa, quando você quiser.
-
Quarentena
Itens
.qbrcom manifesto. A chave fica no manifesto: quem usa a sua conta pode lê-lo. -
Histórico e relatórios
Relatórios só quando você pede. Eles contêm caminhos de arquivo, que podem identificar você.
Comece pelo limite, não pela promessa.
A tabela de limites do Antivirus é a mais longa dos três. Ler antes resolve a maior parte das dúvidas do atendimento.