筛滤器 - 云端在线

程序：

您的姓名

筛过滤器 - Pigeonhole 的 Sieve 邮箱过滤工具

警告： 该工具仍处于试验阶段。 仔细阅读本手册，并备份任何
使用此工具之前的重要邮件。 另请注意，此处记录的某些功能
尚未实际实施； 在适用的情况下明确指出了这一点。

概要

筛滤器 [选项] 脚本文件 源邮箱 [丢弃动作]

商品描述

这个 筛滤器 命令是鸽巢计划的一部分（归档(7))，其中增加了
Sieve (RFC 5228) 支持 Dovecot 安全 IMAP 和 POP3 服务器（鸽舍（1））。

Sieve 语言最初用于在传递时过滤消息。 然而，
有时需要过滤已存储在
邮箱，例如当 Sieve 脚本中的错误导致许多邮件被传递时
不正确。 使用筛网过滤器工具可以在所有
在特定的消息 源邮箱，可以删除消息，存储
他们在不同的邮箱中，更改其内容，并更改分配的 IMAP
标志和关键字。 默认情况下会忽略向外界发送消息的尝试
出于显而易见的原因，但是，使用正确的命令行选项，可以捕获
并处理外发邮件。

如果没有指定选项，sieve-filter 命令在模拟模式下运行，其中
它只打印将要执行的内容，而没有实际执行任何操作。 使用 -e 选项
激活真正的脚本执行。 此外，该 源邮箱 以只读方式打开
默认值，这意味着它通常始终保持不变。 使用 -W 允许的选项
的变化 源邮箱.

即使有了 -W 选项已启用，消息在 源邮箱 只是潜在的
修改或移动到不同的文件夹。 消息永远不会丢失，除非 丢弃动作
论据以外 保持 （默认）被指定。 如果筛网过滤器决定存储
中的消息 源邮箱，在它显然已经存在的地方，它永远不会
在那里重复。 在这种情况下，原始消息的 IMAP 标志可以通过以下方式修改
Sieve 解释器使用 imap4标志 扩展，前提是 -W 被指定。 如果
消息本身由 Sieve 解释器修改（例如使用 编辑头
扩展名），则存储新消息并删除旧消息。 然而，如果 -W is
省略，原始消息保持不变，修改被丢弃。

注意
虽然这是一个非常有用的工具，但如果使用不当，它也可能具有很大的破坏性。
Sieve 脚本中的一个小错误与错误的命令行选项相结合可能
导致它丢弃错误的电子邮件。 而且，即使 源邮箱 在打开
只读模式，以防止此类事故，它仍然可以乱扔垃圾其他邮箱
如果您的 Sieve 脚本决定这样做，您的电子邮件的副本。 因此，建议用户
仔细阅读本手册，并首先使用模拟模式检查
脚本会做。 而且当然：

MAKING A 备份 IS 至关重要的 用于 任何 重要 邮件！

配置

-c 配置文件
替代 Dovecot 配置文件路径。

-C 强制编译。 默认情况下，编译后的二进制文件存储在磁盘上。 当这
在下一次执行期间找到二进制文件 筛滤器 及其修改时间
比脚本文件更新，它被使用并且脚本不被编译
再次。 此选项强制编译脚本，从而忽略任何存在的
二进制。 参考 筛分(1) 有关 Sieve 编译的更多信息。

-D 启用筛选调试。

-e 打开执行模式。 默认情况下，sieve-filter 命令在模拟中运行
它什么都不改变的模式，这意味着没有以任何方式改变邮箱，并且
不执行任何操作。 它只打印将要做的事情。 使用此选项，
筛过滤器命令变为活动状态并执行请求的操作。

-m 默认邮箱
邮箱所在的（隐式） 保持 筛选动作存储消息。 这是平等的
以及 源邮箱 默认情况下。 指定不同的文件夹将具有
移动（或复制，如果 -W 被省略）所有保存的消息到指定的
文件夹，而不仅仅是将它们留在 源邮箱。 参考
的解释 源邮箱 有关邮箱命名的更多信息的参数。

-q 输出邮箱 [不是 实施 然而]
将外发电子邮件存储到指定的 输出邮箱。 默认情况下，
筛选过滤器命令忽略筛选操作，例如重定向、拒绝、休假和
通知，但使用此选项可以将外发消息附加到指定的
邮箱。 此选项在模拟模式下无效。 重定向消息的标志
不被保留。

-Q 邮件命令 [不是 实施 然而]
通过以下方式发送外发电子邮件（例如由重定向、拒绝和休假产生的）
指定的程序。 默认情况下，sieve-filter 命令忽略 Sieve 操作
例如重定向、拒绝、休假和通知，但使用此选项传出
消息可以被馈送到 标准输入 外部 shell 命令。 这个选项没有
模拟模式下的效果。 除非你真的知道自己在做什么， DO 不是 用途
这 TO FEED 邮箱地址 TO 发邮件！.

-s 脚本文件 [不是 实施 然而]
指定要在主脚本之前执行的附加脚本。 多种的 -s
允许参数并且指定的脚本在
在命令行中指定的顺序。

-u 用户
运行给定的 Sieve 脚本 用户.

-v 在过滤期间产生详细的输出。

-W 启用对 源邮箱. 这允许（重新）移动消息
来自 源邮箱，更改其内容，并更改分配的 IMAP
标志和关键字。

-x 扩展
设置可用的扩展。 该参数是一个以空格分隔的活动列表
扩展名。 通过在扩展标识符前面加上 + or -, 扩展可以是
相对于配置的活动扩展集包括或排除。 如果不
扩展有一个 + or - 前缀，只有那些明确列出的扩展
将被启用。 未知扩展名将被忽略并产生警告。

举个例子 -x "+imapflags -enotify" 将启用已弃用的 imapflags 扩展
并禁用 enotify 扩展。 其余的活动扩展取决于
筛网扩展 和 sieve_global_extensions 筛选全局扩展 设置。 默认情况下，即当
筛网扩展 和 sieve_global_extensions 筛选全局扩展 保持未配置，所有支持
扩展可用，但不推荐使用的扩展或仍然存在的扩展除外
正在开发中。

争论

脚本文件
指定要（编译和）执行的 Sieve 脚本。

请注意，此工具会查找带有 .svbin 延期
并具有与指定脚本相同的基本名称和路径。 使用 -C 选项
通过强制将脚本编译为新的二进制文件来禁用此行为。

源邮箱
指定包含 Sieve 过滤器将执行的消息的源邮箱
在。

这是邮箱的名称，对 IMAP 客户端可见，UTF-8 格式除外。
父邮箱和子邮箱之间的层次分隔符通常是 '/' 要么 '.',
但这取决于您选择的邮箱存储格式和命名空间
配置。 邮箱名称可能还需要命名空间前缀。

这个邮箱不会被修改，除非 -W 选项被指定。

丢弃动作
指定对消息中的消息进行的操作 源邮箱 没有保存或
否则由 Sieve 脚本存储； 即那些通常会出现的消息
如果 Sieve 脚本在交付时执行，则丢弃。 这 丢弃动作
参数接受以下值之一：

保持 （默认）
将丢弃的邮件保留在源邮箱中。

移动 邮箱
将丢弃的消息移动到指定的 邮箱. 这是例如
将邮件移动到垃圾箱邮箱很有用。 参考说明
源邮箱 有关邮箱命名的更多信息的参数。

删除 将丢弃的消息标记为 \DELETED。

清除
删除丢弃的消息，这意味着这些消息将在以下情况下不可逆转地删除
工具完成过滤。

当。。。的时候 -W 选项未指定， 源邮箱 是不可变的，并且
指定 丢弃动作 没有效果。 这意味着消息最多 复制
到一个新的位置。 相比之下，当 -W 被指定，消息是
Sieve 脚本成功存储在其他地方 时刻 从
源邮箱, 结果是这些 移动 到新位置。 这个
发生与指定的无关 丢弃动作. 记住：只能丢弃
消息受指定的影响 丢弃动作.

示例

[...]

退出 状态

筛滤器 将以下列值之一退出：

0 筛滤器应用成功。 (EX_OK, EXIT_SUCCESS)

1 手术失败。 几乎所有失败都会返回此值。 (EXIT_FAILURE)

64 给出的参数无效。 (EX_USAGE)

使用 onworks.net 服务在线使用筛网过滤器