sito-test - Online w chmurze

PROGRAM:

IMIĘ

sito-test - tester skryptów Sive firmy Pigeonhole

STRESZCZENIE

test sitowy [Opcje] plik-skryptu plik poczty

OPIS

Kurs test sitowy polecenie jest częścią projektu Pigeonhole (szufladkować(7)), który dodaje Sito
(RFC 5228) obsługa bezpiecznego serwera IMAP i POP3 firmy Dovecot (gołębnik(1)).

Korzystanie z test sitowy polecenia, można przetestować wykonanie skryptów Sieve. To ocenia
skrypt dla dostarczonej wiadomości, dający zestaw akcji Sieve. Dopóki -e opcja
jest określony, w rzeczywistości nie wykonuje tych akcji, co oznacza, że ​​nie przechowuje
lub przekaż wiadomość w dowolne miejsce. Zamiast tego drukuje szczegółową listę działań
normalnie mieć miejsce. Zauważ, że nawet kiedy -e jest określony, żadne komunikaty nigdy nie są wyświetlane
przesyłane do zdalnych odbiorców SMTP. Wiadomości wychodzące są zawsze drukowane do stdout
zamiast.

Jest to bardzo przydatne narzędzie do debugowania wykonywania skryptów Sieve. Można to wykorzystać
zweryfikować nowo zainstalowane skrypty pod kątem zamierzonego zachowania i może podać bardziej szczegółowe informacje
informacje o problemach z wykonaniem skryptu, które są zgłaszane przez wtyczkę Sieve, np
przykład, śledząc wykonanie i ocenę odpowiednio poleceń i testów.

OPCJE

-a adres-odbiorcy-oryg
Oryginalny adres odbiorcy koperty. To właśnie zrobi test obwiedni Sieve'a
porównaj z momentem, w którym wymagana jest część koperty „do”. Niektóre testy i działania będą
użyj tego również jako adresu e-mail właściciela skryptu. Jeśli ta opcja zostanie pominięta, plik
adres odbiorcy jest pobierany z nagłówków wiadomości „Koperta-do:” lub „Do:”.
Jeśli żaden z tych nagłówków nie jest obecny, domyślny adres odbiorcy to
[email chroniony].

-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 test sitowy 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.

-d plik-zrzutu
Powoduje zapisanie zrzutu wygenerowanego kodu w określonym pliku. To jest
identyczny z wysypiskiem wyprodukowanym przez wysypisko sitowe(1). Użycie „-” jako nazwy pliku powoduje, że
zrzut, do którego należy pisać stdout.

-e Umożliwia prawdziwe wykonanie zestawu akcji, które wynikają z uruchomienia skryptu.
W połączeniu z -l parametru, rzeczywiste dostarczanie wiadomości może być
przetestowany. Pamiętaj, że nie spowoduje to przesłania żadnych wiadomości do zdalnych odbiorców SMTP.
Takie akcje powodują wyświetlenie tylko wiadomości wychodzącej stdout.

-f nadawca koperty
Kopertowy adres nadawcy (ścieżka zwrotna). To właśnie zrobi test obwiedni Sieve'a
porównaj z momentem, w którym wymagana jest część koperty „od”. Również tutaj jest odpowiedź
wiadomości są „wysyłane”. W przypadku pominięcia tej opcji zostanie pobrany adres nadawcy
z nagłówków wiadomości „Return-Path:”, „Sender:” lub „From:”. Jeśli żaden z tych
headers jest obecny, domyślnym adresem koperty nadawcy jest
[email chroniony].

-l lokalizacja poczty
Lokalizacja magazynu pocztowego użytkownika. Składnia tej opcji lokalizacja poczty
jest identyczny z tym, który jest używany dla ustawienia mail_location w Dovecot
plik konfiguracyjny. Ten parametr jest zwykle używany w połączeniu z -e przetestować
rzeczywiste dostarczanie wiadomości. Jeśli -l jest pomijany, gdy -e jest określony, magazyn poczty
akcje takie jak fileinto i keep są pomijane.

-m domyślna skrzynka pocztowa
Skrzynka pocztowa, w której akcja Keep przechowuje wiadomość. Domyślnie jest to „INBOX”.

-r adres odbiorcy
Ostateczny adres odbiorcy koperty. Niektóre testy i działania będą używać tego jako
adres e-mail właściciela skryptu. Na przykład to, co jest używane przez wakacje
działania w celu sprawdzenia, czy odpowiedź jest właściwa. jeśli -r opcja jest pominięta,
zamiast tego zostanie użyty adres odbiorcy w oryginalnej kopercie (zob -a opcja na więcej
informacje).

-s plik-skryptu
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ń.

-t plik śledzenia
Włącza debugowanie śledzenia w czasie wykonywania. Debugowanie śledzenia zapewnia szczegółowy wgląd w plik
operacji wykonywanych przez skrypt Sieve. Zapoznaj się z debugowaniem śledzenia w czasie wykonywania
sekcja poniżej. Informacje o śledzeniu są zapisywane w określonym pliku. Za pomocą '-'
jako nazwa pliku powoduje zapisanie danych śledzenia stdout.

-T opcja śledzenia
Konfiguruje debugowanie śledzenia w czasie wykonywania, które jest włączane za pomocą opcji -t. Odnosić się do
sekcja debugowania śledzenia w czasie wykonywania poniżej.

-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 do (skompilowania i) wykonania.

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.

plik poczty
Określa plik zawierający wiadomość e-mail do przetestowania.

ZASTOSOWANIE

CZAS PRACY TRACE DEBUGOWANIE
Korzystanie z -t opcja, test sitowy narzędzie można skonfigurować do drukowania szczegółowego śladu
informacje o wykonaniu skryptu Sieve do pliku lub na standardowe wyjście. Na przykład
napotkanych poleceń, wykonane testy i dopasowane wartości można wydrukować.

Śledzenie w czasie wykonywania można skonfigurować za pomocą pliku -T opcja, którą można określić wiele
czasy. Można go używać w następujący sposób:

-Tpoziom=...
Ustaw poziom szczegółowości debugowania śledzenia. Może to być jedna z następujących wartości
dostarczane:

działania (Domyślne)
Drukuj tylko wykonane polecenia akcji, takie jak zachowaj, złóż, odrzuć i przekieruj.

Polecenia
Wydrukuj dowolne wykonane polecenie, z wyjątkiem poleceń testowych.

Testy
Wydrukuj wszystkie wykonane polecenia i wykonane testy.

dopasowywanie
Wydrukuj wszystkie wykonane polecenia, wykonane testy i wartości dopasowane w tych testach.

-Tdebug
Drukuj również komunikaty debugowania. Jest to zwykle przydatne tylko dla programistów i jest prawdopodobne
produkować niechlujny wydruk.

-Adresy
Wydrukuj adresy kodu bajtowego dla bieżącego wyjścia śledzenia. Normalnie tylko bieżące sito
drukowana jest pozycja kodu źródłowego (numer wiersza). Adresy kodu bajtowego są równe
te wymienione w zrzucie binarnym utworzonym przy użyciu -d opcja lub wg wysypisko sitowe(1)
dowództwo.

DEBUG SITO ROZBUDOWA
Aby usprawnić debugowanie skryptów, ta implementacja Sieve obsługuje niestandardowy język Sieve
rozszerzenie o nazwie „vnd.dovecot.debug”. Dodaje dziennik_debugowania polecenie umożliwiające logowanie
komunikaty debugowania.

Przykład:

wymagać „vnd.dovecot.debug”;

jeśli nagłówek : zawiera „temat” „cześć” {

debug_log "Nagłówek tematu zawiera cześć!";

}

Narzędzia takie jak test sitowy, sito i wysypisko sitowe mieć wsparcie dla vnd.dovecot.debug
rozszerzenie domyślnie włączone i nie ma potrzeby włączania ani możliwości wyłączania
dostępność rozszerzenia debugowania z rozszerzeniem -x opcja. Zarejestrowane wiadomości są zapisywane
stdout w tym przypadku.

W przeciwieństwie do rzeczywistej wtyczki Sieve dla Dovecot LDA (gołębnik-lda(1)
Rozszerzenie vnd.dovecot.debug musi być włączone jawnie przy użyciu pliku sito_przedłużenia
ustawienie. Komunikaty są następnie rejestrowane w prywatnym pliku dziennika skryptów użytkownika. Jeśli jest używany w
global script, komunikaty są rejestrowane przez domyślną funkcję rejestrowania Dovecot.

EXIT STATUS

test sitowy zakończy się z jedną z następujących wartości:

0 Wykonanie powiodło się. (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)

Skorzystaj z sito-test online, korzystając z usług onworks.net