これは、Ubuntu Online、Fedora Online、Windowsオンラインエミュレーター、MACOSオンラインエミュレーターなどの複数の無料オンラインワークステーションのXNUMXつを使用してOnWorks無料ホスティングプロバイダーで実行できるコマンドsieve-testです。
プログラム：
NAME
sieve-test-PigeonholeのSieveスクリプトテスター
SYNOPSIS
ふるいテスト [オプション] スクリプトファイル メールファイル
DESCRIPTION
この ふるいテスト コマンドはピジョンホールプロジェクトの一部です（鳩の穴（7））、これはふるいを追加します
（RFC 5228）DovecotセキュアIMAPおよびPOP3サーバーのサポート（鳩小屋（1））。
使い方 ふるいテスト コマンドを使用すると、Sieveスクリプトの実行をテストできます。 これは評価します
提供されたメッセージのスクリプト。一連のSieveアクションを生成します。 でない限り -e オプション
が指定されている場合、実際にはこれらのアクションを実行しません。つまり、保存されません。
またはメッセージを転送します。 代わりに、どのアクションが実行されるかの詳細なリストを出力します
通常は行われます。 でも注意してください -e が指定されている場合、メッセージはありません
リモートSMTP受信者に送信されます。 送信メッセージは常にに印刷されます (Linuxで言うところのstdout）
を代わりにお使いください。
これは、Sieveスクリプトの実行をデバッグするための非常に便利なツールです。 それはに使用することができます
新しくインストールされたスクリプトの意図された動作を確認すると、より詳細なスクリプトを提供できます
Sieveプラグインによって報告されるスクリプト実行の問題に関する情報
たとえば、コマンドとテストの実行と評価をそれぞれトレースします。
OPTIONS
-a 元の受信者アドレス
元のエンベロープ受信者アドレス。 これは、Sieveのエンベロープテストが行うことです
「to」エンベロープ部分が要求されたときと比較してください。 いくつかのテストとアクションは
これをスクリプト所有者の電子メールアドレスとしても使用します。 このオプションを省略した場合、
受信者アドレスは、「Envelope-To：」または「To：」メッセージヘッダーから取得されます。
これらのヘッダーのいずれも存在しない場合、受信者アドレスはデフォルトで次のようになります。
[メール保護].
-c 設定ファイル
代替のDovecot構成ファイルパス。
-C コンパイルを強制します。 デフォルトでは、コンパイルされたバイナリはディスクに保存されます。 このとき
バイナリは、の次の実行中に検出されます ふるいテスト とその変更時間
スクリプトファイルよりも新しい、使用され、スクリプトはコンパイルされません
また。 このオプションは、スクリプトを強制的にコンパイルするため、存在するものを無視します
バイナリ。 参照する ふるい（1）Sieveのコンパイルの詳細については。
-D Sieveデバッグを有効にします。
-d ダンプファイル
生成されたコードのダンプが指定されたファイルに書き込まれます。 これは
によって生成されたダンプと同じ ふるいダンプ（1）。 ファイル名として「-」を使用すると、
書き込まれるダンプ (Linuxで言うところのstdout）.
-e スクリプトの実行から生じる一連のアクションの真の実行を有効にします。
と組み合わせて -l パラメータ、メッセージの実際の配信は
テスト済み。 これにより、リモートSMTP受信者にメッセージが送信されないことに注意してください。
このようなアクションは、送信メッセージを (Linuxで言うところのstdout）.
-f エンベロープ送信者
エンベロープ送信者アドレス（リターンパス）。 これは、Sieveのエンベロープテストが行うことです
「from」エンベロープ部分が要求されたときと比較してください。 また、これは応答がどこにあるかです
メッセージは「送信」されます。 このオプションを省略すると、送信者アドレスが取得されます
「Return-Path：」、「Sender：」、または「From：」メッセージヘッダーから。 これらのどれも
ヘッダーも存在します。送信者のエンベロープアドレスはデフォルトで次のようになります。
[メール保護].
-l メールの場所
ユーザーのメールストアの場所。 このオプションの構文 メールの場所
パラメータは、Dovecotのmail_location設定に使用されるものと同じです。
設定ファイル。 このパラメータは通常、と組み合わせて使用されます -e テストするには
メッセージの実際の配信。 もしも -l 省略した場合 -e 指定、メールストア
fileintoやkeepなどのアクションはスキップされます。
-m デフォルト-メールボックス
keepアクションがメッセージを格納するメールボックス。 デフォルトでは「INBOX」です。
-r 受信者アドレス
最終的なエンベロープ受信者アドレス。 一部のテストとアクションでは、これを
スクリプト所有者の電子メールアドレス。 たとえば、これは休暇で使用されるものです
返信が適切かどうかを確認するためのアクション。 の場合 -r オプションを省略した場合、
代わりに、元のエンベロープ受信者アドレスが使用されます（を参照）。 -a 詳細のオプション
情報）。
-s スクリプトファイル
メインスクリプトの前に実行する追加のスクリプトを指定します。 多数 -s
引数が許可され、指定されたスクリプトがで順番に実行されます
コマンドラインで指定された順序。
-t トレースファイル
ランタイムトレースのデバッグを有効にします。 トレースデバッグは、
Sieveスクリプトによって実行される操作。 ランタイムトレースのデバッグを参照してください
以下のセクション。 トレース情報は指定されたファイルに書き込まれます。 '-'を使用する
ファイル名により、トレースデータが書き込まれます (Linuxで言うところのstdout）.
-T トレースオプション
-tオプションで有効になるランタイムトレースデバッグを設定します。 参照する
以下のランタイムトレースデバッグセクション。
-x エクステンション
利用可能な拡張子を設定します。 パラメータは、アクティブのスペースで区切られたリストです
拡張機能。 拡張識別子の前に + or -、拡張機能は
構成されたアクティブな拡張機能のセットに関連して含まれる、または除外される。 いいえの場合
拡張機能には + or - プレフィックス、明示的にリストされている拡張子のみ
有効になります。 不明な拡張子は無視され、警告が生成されます。
例えば、 -x 「+ imapflags-enotify」は、非推奨のimapflags拡張機能を有効にします
enotify拡張機能を無効にします。 残りのアクティブな拡張機能は、
sieve_extensions と sieve_global_extensions 設定。 デフォルトでは、つまり
sieve_extensions と sieve_global_extensions 未構成のまま、すべてサポート
非推奨の拡張機能またはまだ残っている拡張機能を除いて、拡張機能を利用できます
開発中で。
議論
スクリプトファイル
（コンパイルおよび）実行するスクリプトを指定します。
このツールは、コンパイル済みのバイナリファイルを検索することに注意してください。 .svbin
そして、指定されたスクリプトと同じベース名とパスを使用します。 使用 -C オプション
スクリプトを強制的に新しいバイナリにコンパイルして、この動作を無効にします。
メールファイル
テストする電子メールメッセージを含むファイルを指定します。
USAGE
ランタイム TRACE デバッグ
使い方 -t オプション、 ふるいテスト 詳細なトレースを印刷するようにツールを構成できます
ファイルまたは標準出力へのSieveスクリプトの実行に関する情報。 たとえば、
検出されたコマンド、実行されたテスト、および一致した値を出力できます。
ランタイムトレースは、 -T 複数指定できるオプション
回数。 次のように使用できます。
-Tlevel =..。
トレースデバッグの詳細レベルを設定します。 次の値のいずれかが可能です
提供：
行動 （デフォルト）
keep、fileinto、reject、redirectなどの実行されたアクションコマンドのみを出力します。
コマンド
テストコマンドを除く、実行されたコマンドを出力します。
テスト
実行されたすべてのコマンドと実行されたテストを印刷します。
マッチング
実行されたすべてのコマンド、実行されたテスト、およびそれらのテストで一致した値を出力します。
-Tdebug
デバッグメッセージも出力します。 これは通常、開発者にのみ役立ち、可能性があります
乱雑な出力を生成します。
-住所
現在のトレース出力のバイトコードアドレスを出力します。 通常、現在のふるいのみ
ソースコードの位置（行番号）が出力されます。 バイトコードアドレスは
を使用して生成されたバイナリダンプにリストされているもの -d オプションまたは ふるいダンプ(1)
DEBUG ふるい EXTENSION
スクリプトのデバッグを改善するために、このSieve実装はカスタムSieve言語をサポートしています
'vnd.dovecot.debug'と呼ばれる拡張子。 それは追加します デバッグログ ロギングを許可するコマンド
デバッグメッセージ。
例：
「vnd.dovecot.debug」が必要です。
if header：contains "subject" "hello" {
debug_log "件名ヘッダーにhelloが含まれています！";
}
ツール ふるいテスト, ふるい と ふるいダンプ vnd.dovecot.debugをサポートしている
拡張機能はデフォルトで有効になっており、有効にする必要はなく、無効にすることもできません。
デバッグ拡張機能の可用性 -x オプション。 ログに記録されたメッセージはに書き込まれます
(Linuxで言うところのstdout） この場合。
対照的に、Dovecot LDAの実際のSieveプラグインの場合（dovecot-lda（1））
vnd.dovecot.debug拡張子は、を使用して明示的に有効にする必要があります sieve_extensions
設定。 その後、メッセージはユーザーのプライベートスクリプトログファイルに記録されます。 で使用する場合
グローバルスクリプトの場合、メッセージはデフォルトのDovecotログ機能を介してログに記録されます。
EXIT ステータス
ふるいテスト 次のいずれかの値で終了します。
0 実行は成功しました。 （EX_OK、EXIT_SUCCESS）
1 操作に失敗しました。 これは、ほとんどすべての障害に対して返されます。 （EXIT_FAILURE）
64 無効なパラメーターが指定されました。 （EX_USAGE）
onworks.netサービスを使用してオンラインでふるいテストを使用する
