sieve-filter - クラウドでオンライン

プログラム：

NAME

sieve-filter - Pigeonhole の Sieve メールボックス フィルター ツール

警告： このツールはまだ実験段階です。 このマニュアルをよく読み、必要な場合はバックアップしてください。
このツールを使用する前に重要なメールを確認してください。 ここに記載されている機能の一部にも注意してください。
実際にはまだ実装されていません。 これは該当する場合には明確に示されています。

SYNOPSIS

ふるいフィルター [オプション] スクリプトファイル ソースメールボックス [破棄アクション]

DESCRIPTION

この ふるいフィルター コマンドはピジョンホールプロジェクトの一部です（鳩の穴(7)) を追加します。
Dovecot セキュア IMAP および POP5228 サーバーに対する Sieve (RFC 3) のサポート (鳩小屋（1））。

Sieve 言語はもともと、配信時にメッセージをフィルタリングすることを目的としていました。 しかし、
すでに保存されているメッセージをフィルタリングすることが望ましい場合があります。
メールボックス、たとえば、Sieve スクリプトのバグにより多数のメッセージが配信された場合
間違っています。 sieve-filter ツールを使用すると、すべてのオブジェクトに Sieve スクリプトを適用できます。
特定のメッセージ ソースメールボックス、メッセージの削除、保存が可能になります。
別のメールボックスにそれらを追加し、コンテンツを変更し、割り当てられた IMAP を変更します。
フラグとキーワード。 外部にメッセージを送信しようとしても、デフォルトでは無視されます。
明らかな理由ですが、適切なコマンド ライン オプションを使用すると、
送信メールも処理します。

オプションが指定されていない場合、sieve-filter コマンドはシミュレーション モードで実行されます。
実際には何もせずに、実行される内容を出力するだけです。 使用 -e オプション
真のスクリプト実行をアクティブ化します。 また、 ソースメールボックス によって読み取り専用で開かれます
デフォルトは、通常は常に変更されないことを意味します。 使用 -W 許可するオプション
の変化 ソースメールボックス.

たとえ -W オプションが有効になっている場合、メッセージは ソースメールボックス 潜在的にのみです
変更されるか、別のフォルダーに移動されます。 メッセージが失われることはありません。 破棄アクション
以外の引数 続ける (デフォルト)が指定されます。 Sieve フィルターが保存を決定した場合
のメッセージ ソースメールボックス明らかにすでに存在する場合、決して存在しません。
そこに複製されています。 その場合、元のメッセージの IMAP フラグは次のように変更できます。
を使用する Sieve インタープリタ imap4フラグ 拡張子、ただし、 -W が指定されています。 もしも
メッセージ自体は Sieve インタプリタによって変更されます (たとえば、 編集ヘッダー
拡張子)、新しいメッセージが保存され、古いメッセージは消去されます。 ただし、 -W is
省略すると、元のメッセージはそのまま残され、変更は破棄されます。

注意
これは非常に便利なツールですが、不適切に使用すると非常に破壊的になる可能性もあります。
Sieve スクリプトの小さなバグと間違ったコマンド ライン オプションの組み合わせにより、
間違った電子メールを破棄してしまう可能性があります。 そして、たとえ ソースメールボックス に開かれています
このような事故を防ぐために読み取り専用モードを使用しても、他のメールボックスに偽のメッセージが散在する可能性があります。
Sieve スクリプトがそうすることを決定した場合、電子メールのコピー。 したがって、ユーザーは次のようにアドバイスします。
このマニュアルをよく読んで、最初にシミュレーション モードを使用して、何が起こるかを確認してください。
スクリプトで十分です。 そしてもちろん：

メイキング A BACKUP IS 命令型 FOR ANY 重要 郵便！

OPTIONS

-c 設定ファイル
代替のDovecot構成ファイルパス。

-C コンパイルを強制します。 デフォルトでは、コンパイルされたバイナリはディスクに保存されます。 このとき
バイナリは、の次の実行中に検出されます ふるいフィルター とその変更時間
スクリプトファイルよりも新しい、使用され、スクリプトはコンパイルされません
また。 このオプションは、スクリプトを強制的にコンパイルするため、存在するものを無視します
バイナリ。 参照する ふるい（1）Sieveのコンパイルの詳細については。

-D Sieveデバッグを有効にします。

-e 実行モードをオンにします。 デフォルトでは、sieve-filter コマンドはシミュレーションで実行されます。
何も変更しないモード、つまりメールボックスは一切変更されません。
アクションは実行されません。 実行される内容のみを出力します。 このオプションを使用すると、
sieve-filter コマンドがアクティブになり、要求されたアクションを実行します。

-m デフォルト-メールボックス
(暗黙的に) 続ける Sieve アクションはメッセージを保存します。 これは平等です
から ソースメールボックス デフォルトでは。 別のフォルダーを指定すると、
移動（またはコピーの場合）の効果 -W は省略されます）指定された宛先に保持されているすべてのメッセージ
フォルダーにそのまま残すのではなく、 ソースメールボックス。 を参照してください
の説明 ソースメールボックス メールボックスの名前付けの詳細については、引数を参照してください。

-q 出力メールボックス [いいえ 実装 まだ]
送信電子メールを指定された場所に保存します 出力メールボックス。 デフォルトでは、
sieve-filter コマンドは、リダイレクト、拒否、休暇などの Sieve アクションを無視します。
通知しますが、このオプションを使用すると、送信メッセージを指定されたメッセージに追加できます。
メールボックス。 このオプションはシミュレーション モードでは効果がありません。 リダイレクトされたメッセージのフラグ
は保存されていません。

-Q メールコマンド [いいえ 実装 まだ]
送信電子メール (リダイレクト、拒否、休暇などによって生成されたものなど) を次のように送信します。
指定されたプログラム。 デフォルトでは、sieve-filter コマンドは Sieve アクションを無視します。
リダイレクト、拒否、休暇、通知などですが、このオプションを使用すると送信
メッセージを stdin 外部シェルコマンドの。 このオプションには何もありません
シミュレーションモードでのエフェクト。 自分が何をしているのか本当にわかっていない限り、 DO NOT USE
この に フィード MAIL に メールを送信してください！.

-s スクリプトファイル [いいえ 実装 まだ]
メインスクリプトの前に実行する追加のスクリプトを指定します。 多数 -s
引数が許可され、指定されたスクリプトがで順番に実行されます
コマンドラインで指定された順序。

-u user
指定された Sieve スクリプトを実行します。 user.

-v フィルタリング中に詳細な出力を生成します。

-W への書き込みアクセスを有効にします。 ソースメールボックス。 これにより、メッセージを削除（削除）することができます
ソースメールボックス、その内容の変更、および割り当てられた IMAP の変更
フラグとキーワード。

-x エクステンション
利用可能な拡張子を設定します。 パラメータは、アクティブのスペースで区切られたリストです
拡張機能。 拡張識別子の前に + or -、拡張機能は
構成されたアクティブな拡張機能のセットに関連して含まれる、または除外される。 いいえの場合
拡張機能には + or - プレフィックス、明示的にリストされている拡張子のみ
有効になります。 不明な拡張子は無視され、警告が生成されます。

例えば、 -x 「+ imapflags-enotify」は、非推奨のimapflags拡張機能を有効にします
enotify拡張機能を無効にします。 残りのアクティブな拡張機能は、
sieve_extensions と sieve_global_extensions 設定。 デフォルトでは、つまり
sieve_extensions と sieve_global_extensions 未構成のまま、すべてサポート
非推奨の拡張機能またはまだ残っている拡張機能を除いて、拡張機能を利用できます
開発中で。

議論

スクリプトファイル
(コンパイルして) ​​実行する Sieve スクリプトを指定します。

このツールは、コンパイル済みのバイナリファイルを検索することに注意してください。 .svbin
そして、指定されたスクリプトと同じベース名とパスを使用します。 使用 -C オプション
スクリプトを強制的に新しいバイナリにコンパイルして、この動作を無効にします。

ソースメールボックス
Sieve フィルタが動作するメッセージを含むソース メールボックスを指定します
に。

これは、UTF-8 形式を除き、IMAP クライアントに表示されるメールボックスの名前です。
親メールボックスと子メールボックスの間の階層区切り文字は通常、「」です。/'または'.',
ただし、これは選択したメールボックスの保存形式と名前空間によって異なります。
構成。 メールボックス名には名前空間プレフィックスが必要な場合もあります。

このメールボックスは、 -W オプションが指定されています。

破棄アクション
内のメッセージに対して何を行うかを指定します。 ソースメールボックス 保管されていないもの、または
それ以外の場合は、Sieve スクリプトによって保存されます。 つまり、通常は次のようになるメッセージです。
Sieve スクリプトが配信時に実行された場合は破棄されます。 の 破棄アクション
パラメータは次のいずれかの値を受け入れます。

続ける （デフォルト）
破棄されたメッセージをソース メールボックスに保持します。

メールボックス
破棄されたメッセージを指定された場所に移動します メールボックス。 これは例えば
メッセージをゴミ箱メールボックスに移動するのに便利です。 の説明を参照してください。
ソースメールボックス メールボックスの名前付けの詳細については、引数を参照してください。

削除 破棄されたメッセージに \DELETED のフラグを付けます。

消去
破棄されたメッセージを消去します。つまり、これらのメッセージは次の場合に不可逆的に削除されます。
ツールはフィルタリングを終了します。

時 -W オプションが指定されていない場合、 ソースメールボックス は不変であり、
指定の 破棄アクション 効果はありません。 これは、メッセージが最大でも コピー
新しい場所へ。 対照的に、 -W が指定されている場合、メッセージは
Sieve スクリプトによって別の場所に正常に保存されたものは、 常に から削除されました
ソースメールボックス、つまり、これらは次のようになります が 新しい場所へ。 これ
指定に関係なく発生します 破棄アクション。 覚えておいてください: 破棄されるだけです
メッセージは指定されたものによって影響されます 破棄アクション.

例

[...]

EXIT ステータス

ふるいフィルター 次のいずれかの値で終了します。

0 ふるいフィルターが正常に適用されました。 (EX_OK、EXIT_SUCCESS)

1 操作に失敗しました。 これは、ほとんどすべての障害に対して返されます。 （EXIT_FAILURE）

64 無効なパラメーターが指定されました。 （EX_USAGE）

onworks.net サービスを使用してオンラインで sieve-filter を使用する