teste de peneira - Online na nuvem

PROGRAMA:

NOME

Sieve-test - testador de script Pigeonhole Sieve

SINOPSE

teste de peneira [opções] Arquivo de script arquivo de correio

DESCRIÇÃO

A teste de peneira comando faz parte do Projeto Pigeonhole (classificar(7)), que adiciona peneira
(RFC 5228) suporte para o servidor IMAP e POP3 seguro Dovecot (dovecot(1)).

Com o teste de peneira comando, a execução de scripts Sieve pode ser testada. Isso avalia
o script para a mensagem fornecida, produzindo um conjunto de ações Sieve. A menos que -e opção
for especificado, ele não executa realmente essas ações, o que significa que não armazena
ou encaminhe a mensagem em qualquer lugar. Em vez disso, ele imprime uma lista detalhada de quais ações seriam
normalmente ocorrem. Observe que, mesmo quando -e é especificado, nenhuma mensagem é jamais
transmitido para destinatários SMTP remotos. As mensagens enviadas são sempre impressas para stdout
ao invés.

Esta é uma ferramenta muito útil para depurar a execução de scripts do Sieve. Pode ser usado para
verifique os scripts recém-instalados para o comportamento pretendido e pode fornecer mais detalhes
informações sobre problemas de execução de script relatados pelo plug-in Sieve, para
exemplo, rastreando a execução e avaliação de comandos e testes, respectivamente.

OPÇÕES

-a endereço do destinatário original
O endereço do destinatário do envelope original. Isso é o que o teste de envelope de Sieve irá
compare quando a parte "para" do envelope é solicitada. Alguns testes e ações irão
também use isso como o endereço de e-mail do proprietário do script. Se esta opção for omitida, o
o endereço do destinatário é obtido nos cabeçalhos das mensagens "Envelope-To:" ou "To:"
Se nenhum desses cabeçalhos estiver presente, o endereço padrão do destinatário será
[email protegido].

-c arquivo de configuração
Caminho alternativo do arquivo de configuração Dovecot.

-C Forçar compilação. Por padrão, o binário compilado é armazenado no disco. Quando isso
binário é encontrado durante a próxima execução de teste de peneira e seu tempo de modificação
é mais recente que o arquivo de script, é usado e o script não é compilado
novamente. Esta opção força o script a ser compilado, ignorando assim qualquer presente
binário. Referir-se Sievec(1) para obter mais informações sobre a compilação do Sieve.

-D Habilite a depuração do Sieve.

-d despejar arquivo
Faz com que um dump do código gerado seja gravado no arquivo especificado. Isto é
idêntico ao despejo produzido por despejo de peneira(1). Usar '-' como nome de arquivo causa o
despejo para ser escrito para stdout.

-e Habilita a verdadeira execução do conjunto de ações que resulta da execução do script.
Em combinação com o -l parâmetro, a entrega real de mensagens pode ser
testado. Observe que isso não transmitirá nenhuma mensagem a destinatários SMTP remotos.
Essas ações apenas imprimem a mensagem de saída para stdout.

-f remetente de envelope
O endereço do remetente do envelope (caminho de retorno). Isso é o que o teste de envelope de Sieve irá
compare com quando a parte "de" do envelope é solicitada. Além disso, é aqui que a resposta
as mensagens são 'enviadas' para. Se esta opção for omitida, o endereço do remetente é recuperado
nos cabeçalhos de mensagem "Return-Path:", "Sender:" ou "From:" Se nenhum desses
cabeçalhos estiverem presentes, o endereço padrão do envelope do remetente é
[email protegido].

-l localização de correio
A localização do armazenamento de correio do usuário. A sintaxe desta opção localização de correio
parâmetro é idêntico ao que é usado para a configuração mail_location no Dovecot
arquivo de configuração. Este parâmetro é normalmente usado em combinação com -e para testar o
entrega real de mensagens. Se -l é omitido quando -e é especificado, armazenamento de correio
ações como fileinto e keep são ignoradas.

-m caixa de correio padrão
A caixa de correio onde a ação manter armazena a mensagem. Por padrão, é "CAIXA DE ENTRADA".

-r Endereço do destinatário
O endereço final do destinatário do envelope. Alguns testes e ações usarão isso como o
endereço de e-mail do proprietário do script. Por exemplo, isso é o que é usado para as férias
ação para verificar se uma resposta é apropriada. Se o -r opção é omitida, o
O endereço do destinatário do envelope original será usado em seu lugar (consulte -a opção para mais
informações).

-s Arquivo de script
Especifique scripts adicionais a serem executados antes do script principal. Múltiplo -s
argumentos são permitidos e os scripts especificados são executados sequencialmente no
pedido especificado na linha de comando.

-t arquivo de rastreamento
Ativa a depuração de rastreamento em tempo de execução. A depuração de rastreamento fornece uma visão detalhada no
operações executadas pelo script Sieve. Consulte a depuração de rastreamento em tempo de execução
seção abaixo. As informações de rastreamento são gravadas no arquivo especificado. Usando '-'
como nome do arquivo faz com que os dados de rastreamento sejam gravados stdout.

-T opção de rastreamento
Configura a depuração de rastreamento de tempo de execução, que é habilitada com a opção -t. Referir-se
a seção de depuração de rastreamento de tempo de execução abaixo.

-x extensões
Defina as extensões disponíveis. O parâmetro é uma lista separada por espaço do ativo
extensões. Incluindo os identificadores de extensão com + or -, as extensões podem ser
incluídos ou excluídos em relação ao conjunto configurado de extensões ativas. Se não
extensões têm um + or - prefixo, apenas as extensões que estão explicitamente listadas
será ativado. Extensões desconhecidas são ignoradas e um aviso é produzido.

Por exemplo -x "+ imapflags -enotify" ativará a extensão imapflags obsoleta
e desabilite a extensão enotify. O resto das extensões ativas depende do
criva_extensões e peneira_global_extensions definições. Por padrão, ou seja, quando
criva_extensões e peneira_global_extensions permanecem desconfigurados, todos com suporte
extensões estão disponíveis, exceto extensões obsoletas ou aquelas que ainda estão
em desenvolvimento.

ARGUMENTOS

Arquivo de script
Especifica o script a (compilar e) executar.

Observe que esta ferramenta procura por um arquivo binário pré-compilado com um .svbin extensão
e com nome de base e caminho idêntico ao script especificado. Use o -C opção para
desative esse comportamento, forçando o script a ser compilado em um novo binário.

arquivo de correio
Especifica o arquivo que contém a mensagem de e-mail com a qual testar.

USO

TEMPO DE EXECUÇÃO TRACE DEPURAÇÃO
Com o -t opção, o teste de peneira ferramenta pode ser configurada para imprimir traços detalhados
informações sobre a execução do script Sieve em um arquivo ou saída padrão. Por exemplo, o
os comandos encontrados, os testes realizados e os valores correspondentes podem ser impressos.

O rastreamento de tempo de execução pode ser configurado usando o -T opção, que pode ser especificada em vários
vezes. Ele pode ser usado da seguinte maneira:

-Tlevel = ...
Defina o nível de detalhe da depuração de rastreio. Um dos seguintes valores pode ser
fornecido:

Ações (Padrão)
Imprime apenas comandos de ação executados, como manter, arquivar, rejeitar e redirecionar.

comandos
Imprima qualquer comando executado, exceto comandos de teste.

testes
Imprime todos os comandos e testes executados.

correspondente
Imprime todos os comandos executados, testes realizados e os valores correspondentes nesses testes.

-Tdebug
Imprima mensagens de depuração também. Isso geralmente é útil apenas para desenvolvedores e é provável
para produzir uma saída confusa.

-Endereços
Imprime endereços de código de byte para a saída de rastreamento atual. Normalmente, apenas o atual Sieve
a posição do código-fonte (número da linha) é impressa. Os endereços do código de byte são iguais a
aqueles listados em um dump binário produzido usando o -d opção ou pelo despejo de peneira(1)
comando.

DEBUG PENEIRA EXTENSÃO
Para melhorar a depuração do script, esta implementação do Sieve oferece suporte a uma linguagem Sieve personalizada
extensão chamada 'vnd.dovecot.debug'. Adiciona o log_debug comando que permite o registro
depurar mensagens.

Exemplo:

requer "vnd.dovecot.debug";

if header: contém "assunto" "hello" {

debug_log "Cabeçalho do assunto contém olá!";

}

Ferramentas como teste de peneira, Sievec e despejo de peneira tem suporte para o vnd.dovecot.debug
extensão habilitada por padrão e não é necessário habilitar nem possível desabilitar o
disponibilidade da extensão de depuração com o -x opção. As mensagens registradas são gravadas em
stdout nesse caso.

Em contraste, para o plugin Sieve real para o Dovecot LDA (pombal-lda(1)) o
A extensão vnd.dovecot.debug precisa ser ativada explicitamente usando o criva_extensões
configuração. As mensagens são então registradas no arquivo de log de script privado do usuário. Se usado em um
script global, as mensagens são registradas por meio do recurso de registro Dovecot padrão.

SAIR STATUS

teste de peneira sairá com um dos seguintes valores:

0 A execução foi bem-sucedida. (EX_OK, EXIT_SUCCESS)

1 Operação falhou. Isso é retornado para quase todas as falhas. (EXIT_FAILURE)

64 Parâmetro inválido fornecido. (EX_USAGE)

Use o teste de peneira online usando os serviços onworks.net