筛分测试 - 云端在线

程序：

您的姓名

筛测试 - Pigeonhole 的 Sieve 脚本测试器

概要

筛检 [选项] 脚本文件 邮件文件

商品描述

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

使用 筛检 命令，可以测试 Sieve 脚本的执行。 这评估
所提供消息的脚本，产生一组 Sieve 操作。 除非 -e 选项
指定，它实际上并不执行这些操作，这意味着它不存储
或转发消息。 相反，它会打印详细的操作列表
通常发生。 请注意，即使当 -e 已指定，永远不会有任何消息
传输到远程 SMTP 收件人。 传出的消息总是打印到 标准输出
代替。

这是一个非常有用的工具，用于调试 Sieve 脚本的执行。 它可以用来
验证新安装的脚本的预期行为，它可以提供更详细的
Sieve 插件报告的有关脚本执行问题的信息，用于
例如，分别跟踪命令和测试的执行和评估。

配置

-a 原始收件人地址
原始信封收件人地址。 这就是 Sieve 的信封测试将要做的
与请求“to”信封部分的时间进行比较。 一些测试和操作将
还可以将此用作脚本所有者的电子邮件地址。 如果省略此选项，则
收件人地址是从“信封-收件人：”或“收件人：”邮件头中检索的。
如果这些标头都不存在，则收件人地址默认为
[email protected].

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

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

-D 启用筛选调试。

-d 转储文件
将生成的代码转储写入指定文件。 这是
与产生的转储相同 筛渣(1). 使用“-”作为文件名会导致
要写入的转储 标准输出.

-e 启用由运行脚本产生的一组操作的真实执行。
结合 -l 参数，消息的实际传递可以是
测试。 请注意，这不会向远程 SMTP 收件人传输任何消息。
此类操作仅将传出消息打印到 标准输出.

-f 信封发件人
信封发件人地址（返回路径）。 这就是 Sieve 的信封测试将要做的
与请求“来自”信封部分的时间进行比较。 此外，这是响应
消息被“发送”到。 如果省略此选项，则检索发件人地址
来自“返回路径：”、“发件人：”或“发件人：”邮件标头。 如果这些都没有
headers 也存在，发件人信封地址默认为
[email protected].

-l 邮件位置
用户邮件存储的位置。 此选项的语法 邮件位置
参数与 Dovecot 中用于 mail_location 设置的参数相同
配置文件。 该参数通常与 -e 测试
消息的实际传递。 如果 -l 省略时 -e 指定，邮件存储
跳过 fileinto 和 keep 等操作。

-m 默认邮箱
keep 操作存储消息的邮箱。 默认情况下这是“收件箱”。

-r 收件人地址
最终的信封收件人地址。 一些测试和操作将使用它作为
脚本所有者的电子邮件地址。 例如，这是假期使用的
检查回复是否合适的动作。 如果 -r 选项被省略，
将改为使用原始信封收件人地址（请参阅 -a 选择更多
信息）。

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

-t 跟踪文件
启用运行时跟踪调试。 跟踪调试提供了详细的洞察力
由 Sieve 脚本执行的操作。 参考运行时跟踪调试
以下部分。 跟踪信息被写入指定的文件。 使用 '-'
因为文件名导致跟踪数据被写入 标准输出.

-T 跟踪选项
配置运行时跟踪调试，通过 -t 选项启用。 参考
下面的运行时跟踪调试部分。

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

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

争论

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

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

邮件文件
指定包含要测试的电子邮件消息的文件。

用法

运行 跟踪 调试
使用 -t 选项， 筛检 工具可以配置为打印详细的跟踪
有关 Sieve 脚本执行到文件或标准输出的信息。 例如，
遇到的命令、执行的测试和匹配的值都可以打印出来。

运行时跟踪可以使用 -T 选项，可以指定多个
次。 它可以按如下方式使用：

-T级=...
设置跟踪调试的详细程度。 以下值之一可以是
提供：

行动 （默认）
仅打印已执行的操作命令，例如 keep、fileinto、reject 和 redirect。

命令
打印任何已执行的命令，不包括测试命令。

测试
打印所有执行的命令和执行的测试。

匹配
打印所有已执行的命令、已执行的测试以及在这些测试中匹配的值。

-调试
也打印调试消息。 这通常只对开发人员有用，并且很可能
产生混乱的输出。

-T地址
打印当前跟踪输出的字节代码地址。 通常，只有当前的 Sieve
打印源代码位置（行号）。 字节码地址等于
使用生成的二进制转储中列出的那些 -d 选项或由 筛渣(1)
命令。

DEBUG 筛 延长
为了改进脚本调试，此 Sieve 实现支持自定义 Sieve 语言
扩展名为“vnd.dovecot.debug”。 它添加了 调试日志 允许记录的命令
调试消息。

计费示例：

需要“vnd.dovecot.debug”；

如果标题：包含“主题”“你好”{

debug_log "主题标题包含你好！";

}

诸如 筛检, 筛分 和 筛渣 支持 vnd.dovecot.debug
扩展默认启用，没有必要启用也不可能禁用
调试扩展的可用性 -x 选项。 记录的消息被写入
标准输出 在这种情况下。

相比之下，对于 Dovecot LDA 的实际 Sieve 插件（鸽舍-lda(1)) 的
vnd.dovecot.debug 扩展需要使用显式启用 筛网扩展
环境。 然后将消息记录到用户的私有脚本日志文件中。 如果在一个
全局脚本，消息通过默认的 Dovecot 日志工具记录。

退出 状态

筛检 将以下列值之一退出：

0 执行成功。 (EX_OK, EXIT_SUCCESS)

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

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

使用 onworks.net 服务在线使用筛选测试