filtr sitowy - Online w chmurze

PROGRAM:

IMIĘ

sito-filter - narzędzie do filtrowania skrzynek pocztowych Pigeonhole's Sive

UWAGA: To narzędzie jest wciąż w fazie eksperymentalnej. Przeczytaj uważnie tę instrukcję i wykonaj kopię zapasową
ważną pocztę przed użyciem tego narzędzia. Należy również pamiętać, że niektóre funkcje są tutaj udokumentowane
nie zostały jeszcze faktycznie wdrożone; jest to wyraźnie wskazane, tam gdzie ma to zastosowanie.

STRESZCZENIE

filtr siatkowy [Opcje] plik-skryptu źródłowa skrzynka pocztowa [akcja odrzucania]

OPIS

Kurs filtr siatkowy polecenie jest częścią projektu Pigeonhole (szufladkować(7)), który dodaje
Obsługa sita (RFC 5228) dla bezpiecznego serwera Dovecot IMAP i POP3 (gołębnik(1)).

Język Sieve był pierwotnie przeznaczony do filtrowania wiadomości po dostarczeniu. Jednakże,
zdarzają się sytuacje, gdy pożądane jest filtrowanie wiadomości, które są już zapisane w pliku
skrzynki pocztowej, na przykład gdy błąd w skrypcie Sieve spowodował dostarczenie wielu wiadomości
nieprawidłowo. Używając narzędzia filtra sitowego, możliwe jest zastosowanie skryptu Sieve na wszystkich
wiadomości w konkretnym źródłowa skrzynka pocztowa, umożliwiając usuwanie wiadomości, przechowywanie
je w innej skrzynce pocztowej, aby zmienić ich zawartość i zmienić przypisany IMAP
flagi i słowa kluczowe. Próby wysłania wiadomości do świata zewnętrznego są domyślnie ignorowane
z oczywistych powodów, ale przy użyciu odpowiednich opcji wiersza poleceń możliwe jest przechwytywanie
i obsługuj także pocztę wychodzącą.

Jeśli nie określono żadnych opcji, polecenie sito-filter działa w trybie symulacji, w którym
drukuje tylko to, co zostałoby wykonane, tak naprawdę nic nie robiąc. Użyj -e opcja
aby aktywować prawdziwe wykonanie skryptu. Również, źródłowa skrzynka pocztowa jest otwierany w trybie tylko do odczytu przez
domyślny, co oznacza, że ​​zwykle pozostaje niezmieniony. Użyj -W możliwość zezwolenia
zmiany w źródłowa skrzynka pocztowa.

Nawet z -W opcja włączona, wiadomości w źródłowa skrzynka pocztowa są tylko potencjalnie
zmodyfikowane lub przeniesione do innego folderu. Wiadomości nigdy nie są tracone, chyba że a akcja odrzucania
argument inny niż zachować (domyślnie) jest określone. Jeśli filtr sitowy zdecyduje się przechowywać
wiadomość w źródłowa skrzynka pocztowa, gdzie oczywiście już istnieje, nigdy go nie ma
tam zduplikowane. W takim przypadku flagi IMAP oryginalnej wiadomości można zmodyfikować za pomocą
interpreter Sieve przy użyciu metody imap4flagi przedłużenie, pod warunkiem, że -W jest specyficzne. Gdyby
sama wiadomość jest modyfikowana przez interpreter Sieve (np. przy użyciu metody nagłówek edycji
rozszerzenie), nowa wiadomość zostanie zapisana, a stara zostanie usunięta. Jeśli jednak -W is
pominięty, oryginalna wiadomość pozostaje nienaruszona, a modyfikacje odrzucane.

UWAGA
Chociaż jest to bardzo przydatne narzędzie, może być również bardzo destrukcyjne, jeśli zostanie użyte niewłaściwie.
Może to powodować mały błąd w skrypcie Sieve w połączeniu z niewłaściwymi opcjami wiersza poleceń
spowodować odrzucenie błędnych wiadomości e-mail. I nawet jeśli źródłowa skrzynka pocztowa jest otwarty w
trybie tylko do odczytu, aby zapobiec takim wpadkom, może nadal zaśmiecać inne skrzynki pocztowe fałszywymi
kopie twoich e-maili, jeśli twój skrypt Sieve tak postanowi. Dlatego zaleca się użytkownikom
aby uważnie przeczytać tę instrukcję i najpierw skorzystać z trybu symulacji, aby sprawdzić, co się dzieje
skrypt zrobi. I oczywiście:

ZROBIENIE A BACKUP IS TRYB ROZKAZUJĄCY DLA JAKIEKOLWIEK WAŻNY POCZTA!

OPCJE

-c plik-konfiguracyjny
Alternatywna ścieżka do pliku konfiguracyjnego Dovecot.

-C Kompilacja na siłę. Domyślnie skompilowany plik binarny jest przechowywany na dysku. Kiedy to
plik binarny zostanie znaleziony podczas następnego wykonania programu filtr siatkowy i czas jego modyfikacji
jest nowszy niż plik skryptu, jest używany, a skrypt nie jest kompilowany
Ponownie. Ta opcja wymusza kompilację skryptu, ignorując w ten sposób wszelkie obecne
dwójkowy. Odnosić się do sito(1), aby uzyskać więcej informacji na temat kompilacji Sieve.

-D Włącz debugowanie sita.

-e Włącza tryb wykonania. Domyślnie polecenie sito-filter działa w symulacji
tryb, w którym nic nie zmienia, co oznacza, że ​​żadna skrzynka pocztowa nie jest w żaden sposób zmieniana i
nie są wykonywane żadne działania. Drukuje tylko to, co zostałoby zrobione. Korzystając z tej opcji,
polecenie sito-filter staje się aktywne i wykonuje żądane akcje.

-m domyślna skrzynka pocztowa
Skrzynka pocztowa, w której (domyślnie) zachować Akcja sita przechowuje wiadomości. To jest równe
do źródłowa skrzynka pocztowa domyślnie. Określenie innego folderu spowoduje zmianę
efekt przeniesienia (lub skopiowania, jeśli -W jest pominięty) wszystkie zachowane wiadomości trafiają we wskazane miejsce
folderze, zamiast po prostu zostawiać je w źródłowa skrzynka pocztowa. Zapoznaj się z
wyjaśnienie źródłowa skrzynka pocztowa argument, aby uzyskać więcej informacji na temat nazewnictwa skrzynek pocztowych.

-q wyjściowa skrzynka pocztowa [nie realizowane już]
Przechowuj wychodzącą pocztę e-mail we wskazanym miejscu wyjściowa skrzynka pocztowa. Domyślnie
polecenie sito-filter ignoruje działania sita, takie jak przekierowanie, odrzucenie, urlop i
powiadamiaj, ale korzystając z tej opcji wiadomości wychodzące mogą być dołączane do wskazanych
skrzynka pocztowa. Opcja ta nie ma żadnego wpływu w trybie symulacji. Flagi przekierowanych wiadomości
nie są zachowane.

-Q polecenie pocztowe [nie realizowane już]
Wysyłaj wychodzące wiadomości e-mail (np. powstałe w wyniku przekierowania, odrzucenia i urlopu) poprzez
określonego programu. Domyślnie polecenie sito-filter ignoruje akcje Sito
takie jak przekierowanie, odrzucenie, urlop i powiadomienie, ale przy użyciu tej opcji wychodzącej
wiadomości można przesyłać do stdin zewnętrznego polecenia powłoki. Ta opcja nie ma
efekt w trybie symulacji. Chyba, że ​​naprawdę wiesz, co robisz, DO NIE UŻYWAĆ
TO DO FEED MAIL DO WYŚLIJ MAILA!.

-s plik-skryptu [nie realizowane już]
Określ dodatkowe skrypty do wykonania przed skryptem głównym. Wiele -s
argumenty są dozwolone, a określone skrypty są wykonywane sekwencyjnie w pliku
kolejność określona w wierszu poleceń.

-u użytkownik
Uruchom skrypt Sieve dla danego użytkownik.

-v Generuj szczegółowe dane wyjściowe podczas filtrowania.

-W Umożliwia dostęp do zapisu do pliku źródłowa skrzynka pocztowa. Umożliwia to (ponowne) przenoszenie wiadomości
z źródłowa skrzynka pocztowa, zmieniając ich zawartość i zmieniając przypisany IMAP
flagi i słowa kluczowe.

-x rozszerzenia
Ustaw dostępne rozszerzenia. Parametr jest oddzieloną spacjami listą aktywnych
rozszerzenia. Dodając identyfikatory rozszerzeń za pomocą + or -, rozszerzenia mogą być
włączone lub wykluczone względem skonfigurowanego zestawu aktywnych rozszerzeń. Jeśli nie
rozszerzenia mają + or - prefiks, tylko te rozszerzenia, które są wyraźnie wymienione
zostanie włączony. Nieznane rozszerzenia są ignorowane i generowane jest ostrzeżenie.

Na przykład -x „+imapflags -enotify” włączy przestarzałe rozszerzenie imapflags
i wyłącz rozszerzenie enotify. Reszta aktywnych rozszerzeń zależy od
sito_przedłużenia i sito_global_extensions ustawienia. Domyślnie, tj. kiedy
sito_przedłużenia i sito_global_extensions pozostają nieskonfigurowane, wszystkie obsługiwane
dostępne są rozszerzenia, z wyjątkiem przestarzałych rozszerzeń lub tych, które nadal istnieją
w budowie.

ARGUMENTY

plik-skryptu
Określa skrypt Sieve do (kompilowania i) wykonywania.

Zauważ, że to narzędzie szuka wstępnie skompilowanego pliku binarnego z rozszerzeniem .svbin rozbudowa
oraz z nazwą podstawową i ścieżką identyczną z podanym skryptem. Użyj -C opcja do
wyłącz to zachowanie, wymuszając kompilację skryptu do nowego pliku binarnego.

źródłowa skrzynka pocztowa
Określa źródłową skrzynkę pocztową zawierającą wiadomości, na które będzie działał filtr Sito
na.

Jest to nazwa skrzynki pocztowej widoczna dla klientów IMAP, z wyjątkiem formatu UTF-8.
Separator hierarchii między nadrzędną i podrzędną skrzynką pocztową to zwykle „/"lub".',
ale to zależy od wybranego formatu przechowywania skrzynek pocztowych i przestrzeni nazw
konfiguracja. Nazwy skrzynek pocztowych mogą również wymagać przedrostka przestrzeni nazw.

Ta skrzynka pocztowa nie jest modyfikowana, chyba że -W opcja jest określona.

akcja odrzucania
Określa, co się dzieje z wiadomościami w pliku źródłowa skrzynka pocztowa które nie są przechowywane lub
w inny sposób przechowywane przez skrypt Sieve; tj. te wiadomości, które normalnie byłyby
odrzucane, jeśli skrypt Sieve został wykonany przy dostawie. The akcja odrzucania
parametr przyjmuje jedną z następujących wartości:

zachować (Domyślne)
Przechowuj odrzucone wiadomości w źródłowej skrzynce pocztowej.

ruch skrzynka pocztowa
Przenieś odrzucone wiadomości do wskazanych skrzynka pocztowa. To jest na przykład
przydatne do przenoszenia wiadomości do skrzynki pocztowej Kosz. Zapoznaj się z wyjaśnieniem dot
źródłowa skrzynka pocztowa argument, aby uzyskać więcej informacji na temat nazewnictwa skrzynek pocztowych.

usunąć Oznacz odrzucone wiadomości jako \DELETED.

wykreślić
Usuń odrzucone wiadomości, co oznacza, że ​​zostaną one nieodwracalnie usunięte, gdy
narzędzie kończy filtrowanie.

Podczas -W opcja nie jest określona, źródłowa skrzynka pocztowa jest niezmienna i
określony akcja odrzucania nie ma żadnego efektu. Oznacza to, że wiadomości są co najwyżej skopiowane
do nowej lokalizacji. Natomiast gdy -W jest określone, wiadomości, które są
pomyślnie zapisane w innym miejscu przez skrypt Sieve zawsze wykreślony z
źródłowa skrzynka pocztowa, z tym skutkiem, że są one takie przeniósł do nowej lokalizacji. Ten
dzieje się niezależnie od określonego akcja odrzucania. Pamiętaj: tylko wyrzucone
określone komunikaty mają wpływ akcja odrzucania.

PRZYKŁADY

[...]

EXIT STATUS

filtr siatkowy zakończy się z jedną z następujących wartości:

0 Filtr sitowy został pomyślnie zastosowany. (EX_OK, EXIT_SUCCESS)

1 Operacja nie powiodła się. Jest to zwracane w przypadku prawie wszystkich błędów. (EXIT_FAILURE)

64 Podano nieprawidłowy parametr. (EX_USAGE)

Użyj filtra sitowego online, korzystając z usług onworks.net