tamiz-filtro - Online en la nube

PROGRAMA:

NOMBRE

tamiz-filtro - herramienta de filtro de buzón de tamiz de Pigeonhole's Sieve

ADVERTENCIA: Esta herramienta aún es experimental. Lea este manual con atención y haga una copia de seguridad de cualquier
correo importante antes de utilizar esta herramienta. También tenga en cuenta que algunas de las características documentadas aquí
aún no se han implementado realmente; esto se indica claramente en su caso.

SINOPSIS

tamiz-filtro [opciones] archivo de comandos buzón de fuente [acción de descarte]

DESCRIPCIÓN

El elemento tamiz-filtro comando es parte del Proyecto Pigeonhole (encasillar(7)), que agrega
Soporte de Sieve (RFC 5228) para el servidor seguro IMAP y POP3 de Dovecot (palomar(1)).

El lenguaje Sieve fue originalmente diseñado para filtrar mensajes en el momento de la entrega. Sin embargo,
Hay ocasiones en las que es deseable filtrar los mensajes que ya están almacenados en un
buzón de correo, por ejemplo, cuando un error en un script de Sieve provocó la entrega de muchos mensajes
incorrectamente. Usando la herramienta tamiz-filtro es posible aplicar un script Sieve en todos
mensajes en un particular buzón de fuente, lo que permite eliminar mensajes, almacenar
en un buzón diferente, para cambiar su contenido y para cambiar el IMAP asignado
banderas y palabras clave. Los intentos de enviar mensajes al mundo exterior se ignoran de forma predeterminada.
por razones obvias, pero, utilizando las opciones de línea de comando adecuadas, es posible capturar
y manejar el correo saliente también.

Si no se especifican opciones, el comando tamiz-filtro se ejecuta en un modo de simulación en el que
solo imprime lo que se realizaría, sin hacer nada realmente. Utilizar el -e opción
para activar la ejecución real de un script. También el buzón de fuente se abre como de solo lectura por
predeterminado, lo que significa que normalmente siempre permanece sin cambios. Utilizar el -W opción para permitir
cambios en el buzón de fuente.

Incluso con el -W opción habilitada, mensajes en el buzón de fuente son solo potencialmente
modificado o movido a una carpeta diferente. Los mensajes nunca se pierden a menos que un acción de descarte
argumento que no sea keep (el predeterminado) está especificado. Si el filtro de tamiz decide almacenar
el mensaje en el buzón de fuente, donde obviamente ya existe, nunca es
duplicado allí. En ese caso, las banderas IMAP del mensaje original se pueden modificar mediante
el intérprete de Sieve utilizando el imap4flags extensión, siempre que -W está especificado. Si
el mensaje en sí es modificado por el intérprete de Sieve (por ejemplo, utilizando el editar encabezado
extensión), se almacena un mensaje nuevo y se borra el anterior. Sin embargo, si -W is
omitido, el mensaje original se deja intacto y las modificaciones se descartan.

PRECAUCIÓN
Aunque se trata de una herramienta muy útil, también puede resultar muy destructiva si se utiliza de forma incorrecta.
Un pequeño error en su script de Sieve en combinación con las opciones de línea de comando incorrectas podría
hacer que descarte los correos electrónicos incorrectos. E incluso si el buzón de fuente se abre en
modo de solo lectura para evitar tales contratiempos, aún puede ensuciar otros buzones de correo con
copias de sus correos electrónicos si su script de Sieve decide hacerlo. Por tanto, se aconseja a los usuarios
leer este manual detenidamente y utilizar el modo de simulación primero para comprobar qué
el guión servirá. Y por supuesto:

HACIENDO A BACKUP IS IMPERATIVO PARA CUALQUIER IMPORTANTE ¡CORREO!

OPCIONES

-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 tamiz-filtro 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.

-e Activa el modo de ejecución. Por defecto, el comando tamiz-filtro se ejecuta en simulación
modo en el que no cambia nada, lo que significa que ningún buzón se modifica de ninguna manera y
no se realizan acciones. Solo imprime lo que se haría. Usando esta opción,
el comando tamiz-filtro se activa y realiza las acciones solicitadas.

-m buzón de correo predeterminado
El buzón donde el (implícito) keep La acción del tamiz almacena mensajes. Esto es igual
En el correo electrónico “Su Cuenta de Usuario en su Nuevo Sistema XNUMXCX”. buzón de fuente por defecto. Especificar una carpeta diferente tendrá la
efecto de mover (o copiar si -W se omite) todos los mensajes guardados al indicado
carpeta, en lugar de simplemente dejarlos en la carpeta buzón de fuente. Referirse a
explicación de la buzón de fuente argumento para obtener más información sobre la denominación de buzones.

-q buzón de salida [no implementado todavía]
Almacene el correo electrónico saliente en el buzón de salida. Por defecto, el
El comando tamiz-filtro ignora las acciones del tamiz como redireccionar, rechazar, vacaciones y
notificar, pero usando esta opción, los mensajes salientes se pueden agregar al
buzón. Esta opción no tiene ningún efecto en el modo de simulación. Banderas de mensajes redirigidos
no se conservan.

-Q comando de correo [no implementado todavía]
Envíe correo electrónico saliente (por ejemplo, producido por redireccionamiento, rechazo y vacaciones) a través de
el programa especificado. De forma predeterminada, el comando tamiz-filtro ignora las acciones del tamiz
como redirigir, rechazar, vacaciones y notificar, pero usando esta opción salientes
los mensajes se pueden enviar a la stdin de un comando de shell externo. Esta opción no tiene
efecto en el modo de simulación. A menos que realmente sepa lo que está haciendo, DO USO
ESTE A FEED MAIL A ¡ENVIAR CORREO!.

-s archivo de comandos [no implementado todavía]
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.

-u usuario
Ejecute el script de Sieve para el usuario.

-v Produzca una salida detallada durante el filtrado.

-W Habilita el acceso de escritura al buzón de fuente. Esto permite (re) mover los mensajes
desde la buzón de fuente, cambiando su contenido y cambiando el IMAP asignado
banderas y palabras clave.

-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 las tamiz_global_extensiones ajustes. Por defecto, es decir, cuando
extensiones_de_pantalla y las 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 de Sieve 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.

buzón de fuente
Especifica el buzón de origen que contiene los mensajes sobre los que actuará el filtro Sieve
sobre.

Este es el nombre de un buzón, visible para los clientes IMAP, excepto en formato UTF-8.
El separador de jerarquía entre un buzón principal y otro secundario suele ser '/"O".',
pero esto depende del formato de almacenamiento de buzón y del espacio de nombres seleccionados
configuración. Los nombres de los buzones también pueden requerir un prefijo de espacio de nombres.

Este buzón no se modifica a menos que el -W Se especifica la opción.

acción de descarte
Especifica lo que se hace con los mensajes en el buzón de fuente que donde no se guarda o
de lo contrario almacenado por el script Sieve; es decir, aquellos mensajes que normalmente serían
se descarta si el script Sieve se ejecutó en el momento de la entrega. los acción de descarte
El parámetro acepta uno de los siguientes valores:

keep (Por defecto)
Mantenga los mensajes descartados en el buzón de origen.

movimiento buzón
Mover los mensajes descartados al indicado buzón. Esto es por ejemplo
útil para mover mensajes a un buzón de basura. Consulte la explicación del
buzón de fuente argumento para obtener más información sobre la denominación de buzones.

elimínelo Marca los mensajes descartados como \ DELETED.

borrar
Eliminar los mensajes descartados, lo que significa que se eliminan de forma irreversible cuando
la herramienta termina de filtrar.

Cuando el -W opción no está especificada, la buzón de fuente es inmutable y el
especificado acción de descarte no tiene efecto. Esto significa que los mensajes son como máximo copiado
a una nueva ubicación. En contraste, cuando el -W se especifica, mensajes que son
almacenados con éxito en otro lugar por el script de Sieve son borrado de la
buzón de fuente, con el efecto de que estos son por lo tanto emocionado a la nueva ubicación. Esta
sucede independientemente de lo especificado acción de descarte. Recuerda: solo descartado
los mensajes se ven afectados por el especificado acción de descarte.

EJEMPLOS

[...]

SALIR ESTADO

tamiz-filtro saldrá con uno de los siguientes valores:

0 Filtro de tamiz aplicado correctamente. (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 tamiz-filtro en línea utilizando los servicios de onworks.net