tamiz-prueba - en línea en la nube

PROGRAMA:

NOMBRE

tamiz-prueba - probador de guiones Sieve de Pigeonhole

SINOPSIS

prueba de tamiz [opciones] archivo de comandos archivo de correo

DESCRIPCIÓN

El prueba de tamiz comando es parte del Proyecto Pigeonhole (encasillar(7)), que agrega Sieve
(RFC 5228) compatibilidad con el servidor seguro IMAP y POP3 de Dovecot (palomar(1)).

Usando el prueba de tamiz comando, se puede probar la ejecución de los scripts de Sieve. Esto evalúa
el script para el mensaje proporcionado, produciendo un conjunto de acciones de Sieve. A menos que el -e opción
se especifica, en realidad no ejecuta estas acciones, lo que significa que no almacena
o reenviar el mensaje en cualquier lugar. En cambio, imprime una lista detallada de las acciones que
normalmente tienen lugar. Tenga en cuenta que, incluso cuando -e se especifica, nunca hay mensajes
transmitido a destinatarios SMTP remotos. Los mensajes salientes siempre se imprimen en stdout
preferiblemente.

Esta es una herramienta muy útil para depurar la ejecución de scripts de Sieve. Se puede utilizar para
verificar los scripts recién instalados para el comportamiento previsto y puede proporcionar más detalles
información sobre los problemas de ejecución de scripts que informa el complemento Sieve, para
ejemplo rastreando la ejecución y evaluación de comandos y pruebas respectivamente.

OPCIONES

-a dirección-destinatario-orig
La dirección del destinatario del sobre original. Esto es lo que hará la prueba de envolvente de Sieve
comparar con cuando se solicita la parte del sobre "a". Algunas pruebas y acciones
también utilícelo como la dirección de correo electrónico del propietario del script. Si se omite esta opción, la
La dirección del destinatario se recupera de los encabezados de los mensajes "Sobre para:" o "Para:".
Si tampoco hay ninguno de estos encabezados, la dirección del destinatario se establece de forma predeterminada en
[email protected].

-c archivo de configuración
Ruta alternativa del archivo de configuración de Dovecot.

-C Forzar compilación. De forma predeterminada, el binario compilado se almacena en el disco. Cuando esto
binario se encuentra durante la siguiente ejecución de prueba de tamiz y su tiempo de modificación
es más reciente que el archivo de secuencia de comandos, se utiliza y la secuencia de comandos no está compilada
de nuevo. Esta opción fuerza la compilación del script, ignorando así cualquier presente
binario. Referirse a tamiz(1) para obtener más información sobre la compilación de Sieve.

-D Habilite la depuración de Sieve.

-d archivo de volcado
Hace que se escriba un volcado del código generado en el archivo especificado. Este es
idéntico al vertedero producido por tamiz-volcado(1). El uso de '-' como nombre de archivo hace que el
volcado para ser escrito stdout.

-e Habilita la verdadera ejecución del conjunto de acciones que resulta de ejecutar el script.
En combinación con el -l parámetro, la entrega real de mensajes puede ser
probado. Tenga en cuenta que esto no transmitirá ningún mensaje a los destinatarios SMTP remotos.
Tales acciones solo imprimen el mensaje saliente a stdout.

-f remitente de sobre
La dirección del remitente del sobre (ruta de retorno). Esto es lo que hará la prueba del sobre de Sieve
comparar con cuando se solicita la parte del sobre "de". Además, aquí es donde la respuesta
los mensajes se 'envían' a. Si se omite esta opción, se recupera la dirección del remitente
de los encabezados de los mensajes "Return-Path:", "Sender:" o "From:". Si ninguno de estos
encabezados está presente, la dirección del sobre del remitente se establece de forma predeterminada en
[email protected].

-l ubicación de correo
La ubicación del almacén de correo del usuario. La sintaxis de esta opción ubicación de correo
El parámetro es idéntico al que se utiliza para la configuración mail_location en Dovecot
archivo de configuración. Este parámetro se utiliza normalmente en combinación con -e para probar el
entrega real de mensajes. Si -l se omite cuando -e se especifica, tienda de correo
acciones como fileinto y keep se omiten.

-m buzón de correo predeterminado
El buzón donde la acción de conservación almacena el mensaje. Esto es "INBOX" por defecto.

-r Dirección del receptor
La dirección final del destinatario del sobre. Algunas pruebas y acciones utilizarán esto como
dirección de correo electrónico del propietario del script. Por ejemplo, esto es lo que utilizan las vacaciones.
acción para comprobar si una respuesta es apropiada. Si el -r se omite la opción, la
En su lugar, se utilizará la dirección del destinatario del sobre original (consulte -a opción para más
información).

-s archivo de comandos
Especifique scripts adicionales que se ejecutarán antes del script principal. Múltiple -s
Se permiten argumentos y los scripts especificados se ejecutan secuencialmente en el
orden especificado en la línea de comando.

-t archivo de rastreo
Habilita la depuración de seguimiento en tiempo de ejecución. La depuración de seguimiento proporciona información detallada en el
operaciones realizadas por el script Sieve. Consulte la depuración de seguimiento en tiempo de ejecución
sección siguiente. La información de seguimiento se escribe en el archivo especificado. Utilizando '-'
como nombre de archivo hace que los datos de seguimiento se escriban en stdout.

-T opción de rastreo
Configura la depuración de seguimiento en tiempo de ejecución, que se habilita con la opción -t. Referirse a
la sección de depuración de seguimiento en tiempo de ejecución a continuación.

-x extensiones
Configure las extensiones disponibles. El parámetro es una lista separada por espacios de los activos
extensiones. Al anteponer los identificadores de extensión con + or -, las extensiones pueden ser
incluido o excluido en relación con el conjunto configurado de extensiones activas. Si no
las extensiones tienen un + or - prefijo, solo aquellas extensiones que se enumeran explícitamente
estará habilitado. Las extensiones desconocidas se ignoran y se genera una advertencia.

Por ejemplo: -x "+ imapflags -enotify" habilitará la extensión imapflags obsoleta
y deshabilite la extensión enotify. El resto de extensiones activas depende de la
extensiones_de_pantalla y tamiz_global_extensiones ajustes. Por defecto, es decir, cuando
extensiones_de_pantalla y tamiz_global_extensiones permanecen desconfigurados, todos compatibles
las extensiones están disponibles, excepto las extensiones obsoletas o las que aún están
en desarrollo.

ARGUMENTOS

archivo de comandos
Especifica el script para (compilar y) ejecutar.

Tenga en cuenta que esta herramienta busca un archivo binario precompilado con un .svbin extensión
y con nombre de base y ruta idénticos al script especificado. Utilizar el -C opción de
deshabilite este comportamiento forzando la compilación del script en un nuevo binario.

archivo de correo
Especifica el archivo que contiene el mensaje de correo electrónico para realizar la prueba.

USO

TIEMPO DE FUNCIONAMIENTO TRACE DEPURACIÓN
Usando el -t opción, la prueba de tamiz La herramienta se puede configurar para imprimir un seguimiento detallado
información sobre la ejecución del script Sieve en un archivo o salida estándar. Por ejemplo, el
comandos encontrados, las pruebas realizadas y los valores coincidentes se pueden imprimir.

El seguimiento de tiempo de ejecución se puede configurar mediante el -T opción, que se puede especificar múltiples
veces. Se puede utilizar de la siguiente manera:

-Tlevel = ...
Establezca el nivel de detalle de la depuración de seguimiento. Uno de los siguientes valores puede ser
suministrado:

acciones (Por defecto)
Imprima solo los comandos de acción ejecutados, como mantener, archivar en, rechazar y redirigir.

comandos
Imprime cualquier comando ejecutado, excluyendo los comandos de prueba.

pruebas
Imprime todos los comandos ejecutados y las pruebas realizadas.

pareo
Imprima todos los comandos ejecutados, las pruebas realizadas y los valores coincidentes en esas pruebas.

-Tdebug
Imprime también mensajes de depuración. Por lo general, esto solo es útil para los desarrolladores y es probable
para producir una salida desordenada.

-Diseños
Imprime direcciones de códigos de bytes para la salida de seguimiento actual. Normalmente, solo el tamiz actual
Se imprime la posición del código fuente (número de línea). Las direcciones de códigos de bytes son iguales a
los enumerados en un volcado binario producido utilizando el -d opción o por la tamiz-volcado(1)
mando.

DEBUG TAMIZ EXTENSIÓN
Para mejorar la depuración de scripts, esta implementación de Sieve admite un lenguaje Sieve personalizado
extensión llamada 'vnd.dovecot.debug'. Agrega el registro de depuración comando que permite el registro
depurar mensajes.

Ejemplo:

requieren "vnd.dovecot.debug";

if header: contiene "asunto" "hola" {

debug_log "El encabezado del asunto contiene ¡hola!";

}

Herramientas tales como prueba de tamiz, tamiz y tamiz-volcado tienen soporte para vnd.dovecot.debug
extensión habilitada por defecto y no es necesario habilitar ni posible deshabilitar la
disponibilidad de la extensión de depuración con la -x opción. Los mensajes registrados se escriben en
stdout en este caso.

Por el contrario, para el complemento Sieve real para Dovecot LDA (palomar-lda(1)) el
La extensión vnd.dovecot.debug debe habilitarse explícitamente utilizando la extensiones_de_pantalla
configuración. Luego, los mensajes se registran en el archivo de registro de secuencia de comandos privado del usuario. Si se usa en un
script global, los mensajes se registran a través de la función de registro predeterminada de Dovecot.

SALIR ESTADO

prueba de tamiz saldrá con uno de los siguientes valores:

0 La ejecución fue exitosa. (EX_OK, EXIT_SUCCESS)

1 Operación fallida. Esto se devuelve para casi todos los fallos. (EXIT_FAILURE)

64 Se proporcionó un parámetro no válido. (EX_USAGE)

Utilice la prueba de tamiz en línea utilizando los servicios de onworks.net