Komentarze

Słowo zaczynające się od # wraz z wszystkimi znakami występującymi po nim aż do znaku nowej linii jest ignorowane. Nie dotyczy to linii warunkowych, które nie mogą być komentowane.

Reguły

Linia zaczynająca się od ":" oznacza początek reguły. Ma następujący format:

:0 [flagi] [ : [lokalnyplikblokujący] ]
<zero lub więcej warunków (jeden na linię)>
<dokładnie jedna linia akcji>

Warunki zaczynają się od "*" i wszystko, co następuje po tym znaku, jest przekazywane niezmienione wewnętrznemu egrepowi, z wyjątkiem początkowych i końcowych białych spacji. Wyrażenia regularne są całkowicie kompatybilne z normalnymi wyrażeniami regularnymi egrep(1). Zobacz także Rozszerzone wyrażenia regularne.

Warunki są logicznie koniugowane; jeżeli nie ma warunków, wynik jest domyślnie prawdziwy.

Flagi mogą być dowolnymi z następujących:

H

Egrepuj nagłówek (domyślnie).

B

Egrepuj ciało.

D

Powiedz wewnętrznemu egrepowi, aby rozróżniał duże i małe litery (zachowaniem domyślnym jest ignorowanie wielkości liter).

A

Ta reguła będzie zależeć od ostatniej poprzedzającej reguły (na bieżącym poziomie zagnieżdżenia) bez flagi "A" lub "a". Umożliwia to wiązanie akcji zależących od wspólnego warunku.

a

Ma takie samo znaczenie jak flaga "A" z dodatkowym warunkiem mówiącym, że bezpośrednio poprzedzająca reguła musi się pomyślnie zakończyć przed uruchomieniem bieżącej reguły.

E

Ta reguła jest wykonywana tylko, jeśli bezpośrednio poprzedzająca reguła nie była wykonana. Wykonanie tej reguły wyłącza także wszelkie bezpośrednio następujące reguły z flagą "E". Umożliwia to definiowanie akcji typu "else if".

e

Ta reguła jest wykonywana tylko, jeśli bezpośrednio poprzedzająca reguła się nie powiodła (tj. podjęto próbę wykonania akcji, ale skończyła się ona błędem).

h

Przesyła nagłówek listu do potoku, pliku lub innego miejsca docelowego (domyślne).

b

Przesyła ciało listu do potoku, pliku lub innego miejsca docelowego (domyślne).

f

Zakłada, że potok jest filtrem.

c

Generuje kopię carbon copy tego listu. Ma to tylko sens dla reguł dostarczających. Jedyną niedostarczającą regułą, dla której flaga ta ma jakiś skutek jest wypadek zagnieżdżonego bloku — w celu wygenerowania kopii proces procmaila zostanie sklonowany (pliki blokujące nie zostaną odziedziczone); podczas gdy klon będzie pracować jak zwykle, rodzic przeskoczy blok.

w

Czeka na zakończenie filtru lub programu i sprawdza kod wyjścia (normalnie ignorowany); jeśli filtr zwrócił błąd, tekst nie był filtrowany.

W

Ma takie samo znaczenie jak flaga "w", lecz powstrzyma wszelkie informacje typu "Program failure".

i

Ignoruje wszelkie błędy zapisu na tej regule (np. zwykle przez wcześnie zamknięty potok).

r

Tryb surowy: nie próbuje zapewnić, że list kończy się pustą linią i zapisuje go takim, jakim jest.

Istnieją pewne warunki specjalne, których można użyć, a które nie są w pełni wyrażeniami regularnymi. Aby je wybrać, warunek musi zaczynać się od:

!

Odwraca warunek.

$

Oszacowuje resztę warunku według reguł podstawiania sh(1) wewnątrz podwójnych cudzysłowów, pomija początkowe białe spacje i ponownie przetwarza regułę.

?

Używa kodu wyjścia podanego programu.

<

Sprawdza, czy całkowita długość listu jest krótsza niż podana (dziesiętnie) liczba bajtów.

>

Analogiczne do "<".

zmienna ??

Porównuje resztę warunku z wartością tej zmiennej środowiskowej (nie może to być pseudozmienna). Specjalnymi wypadkami są zmienne "B", "H", "HB" i "BH", które zwyczajnie przeciążają domyślny obszar przeszukiwania nagłówka/ciała (header/body) zdefiniowanego na początku dla tej reguły.

\

Aby zacytować dowolny z powyższych znaków na początku linii.

Lokalny plik blokujący

Jeśli umieści się drugi (kończący) ":" w pierwszej linii reguły, to procmail użyje lokalnego pliku blokującego (locallockfile; tylko dla tej reguły). Opcjonalnie można podać nazwę pliku, który będzie użyty; jednak jeśli się tego nie zrobi, procmail użyje nazwy pliku celu (lub nazwy pliku następującej po pierwszym ">>") i dopisze do niej $LOCKEXT.

Linia akcji reguły

Linia akcji może zaczynać się od następujących znaków:

!

Przekazuje (forwarduje) e-mail do wszystkich podanych adresów pocztowych.

|

Uruchamia określony program, prawdopodobnie w $SHELL-u, jeśli wykryto któryś ze znaków $SHELLMETAS. Można opcjonalnie poprzedzić ten symbol potoku wyrażeniem zmienna=, co spowoduje, że standardowe wyjście (stdout) programu zostanie przechwycone do zmiennej środowiskowej zmienna (procmail nie zakończy przetwarzania pliku rc w tym momencie). Jeśli podany zostanie tylko symbol potoku, bez żadnego programu, to procmail wypisze list na stdout.

{

Jeśli następuje za tym przynajmniej jedna spacja, tabulacja lub nowa linia, to oznacza to początek zagnieżdżonego bloku. Wszystko, aż do następnego nawiasu zamykającego, będzie zależeć od warunków podanych dla tej reguły. Dozwolone jest nieograniczone zagnieżdżanie. Nawias zamykający istnieje zwyczajnie po to, by oddzielić blok; w żadnym wypadku nie wywoła zakończenia procmaila w żaden sposób. Po dotarciu do końca bloku, przetwarzanie będzie kontynuowane, jak zwykle, po tym bloku. W bloku zagnieżdżonym flagi "H" i "B" dotyczą tylko warunków prowadzących do tego bloku, flagi "h" i "b" w ogóle nie działają.

Wszystko inne będzie uznawane za nazwę skrzynki pocztowej (zarówno nazwę pliku lub katalogu, bezwzględną lub względną w stosunku do bieżącego katalogu (zobacz opis zmiennej MAILDIR)). Jeśli jest to (możliwe że jeszcze nieistniejąca) nazwa pliku, poczta zostanie do niego doklejona.

Jeśli jest to katalog, poczta zostanie dostarczona do nowo utworzonego, unikatowego pliku o nazwie $MSGPREFIX* w podanym katalogu. Jeśli nazwa skrzynki pocztowej kończy się "/.", to katalog ten jest uznawany za folder MH, tj. procmail użyje następnego numeru, który będzie dostępny. Jeśli nazwa skrzynki pocztowej kończy się znakiem "/", to ten katalog jest uznawany za folder maildir, tj. procmail zapisze pocztę w pliku w podkatalogu o nazwie "tmp", a następnie przeniesie go do podkatalogu o nazwie "new". Jeśli skrzynka pocztowa jest podana jako folder MH lub maildir, procmail utworzy wymagane katalogi, jeśli nie istnieją, zamiast traktować skrzynkę pocztową jako nieistniejącą. Gdy procmail dostarcza do katalogów, można podać wiele katalogów, do których należy dostarczyć (procmail dostarczy pocztę, używając twardych dowiązań).

Domyślne wartości zmiennych środowiskowych

LOGNAME, HOME i SHELL

Twoje (odbiorcy) wartości domyślne

PATH

$HOME/bin :/usr/local/bin :/usr/bin :/bin (z wyjątkiem przetwarzania pliku /etc/procmailrc, w którego czasie zostanie ustawione na "/usr/local/bin :/usr/bin :/bin".)

SHELLMETAS

& |<>~;?*[

SHELLFLAGS

-c

ORGMAIL

/var/mail/$LOGNAME
(Chyba że podano -m, wtedy opcja ta jest nieustawiona)

MAILDIR

$HOME
(Chyba że nazwa pierwszego pomyślnie otwartego pliku rc zaczyna się od "./", w którym wypadku wartością domyślną jest ".")

DEFAULT

$ORGMAIL

MSGPREFIX

msg.

SENDMAIL

/usr/sbin/sendmail

SENDMAILFLAGS

-oi

HOST

Nazwa bieżącego komputera

COMSAT

no
(Jeśli plik rc jest podany w linii komend)

PROCMAIL_VERSION

3.23pre

LOCKEXT

.lock

Inne czyszczone lub preustawiane zmienne środowiskowe to IFS, ENV i PWD.

Z powodów bezpieczeństwa podczas startu procmail wyrzuci wszystkie zmienne środowiskowe, co do których ma podejrzenia, że mogą wpływać na działanie dynamicznego konsolidatora (ld.so(8)).

Środowisko

Zanim zgubisz się w mętliku zmiennych środowiskowych, pamiętaj że wszystkie one mają sensowne wartości domyślne.

MAILDIR

Bieżący katalog w momencie, gdy procmail jest uruchomiany (znaczy to, że wszystkie ścieżki są relatywne do $MAILDIR).

DEFAULT

Domyślny plik mailbox (jeśli nie powiedziano inaczej, procmail wrzuci pocztę do tego pliku). Procmail automatycznie użyje $DEFAULT$LOCKEXT jako pliku blokującego przed zapisaniem czegoś do tej skrzynki pocztowej. Nie trzeba ustawiać tej zmiennej, ponieważ standardowo wskazuje ona na standardową skrzynkę pocztową systemu.

LOGFILE

Plik ten będzie zawierał wszelkie komunikaty diagnostyczne i komunikaty o błędach od procmaila (zazwyczaj żadne) lub od innych programów uruchomionych przez procmaila. Jeśli plik ten nie jest podany, komunikaty będą przesyłane e-mailem z powrotem do nadawcy. Zobacz także LOGABSTRACT.

VERBOSE

Ustawiając tę zmienną na "yes" lub "on", można włączyć rozszerzoną diagnostykę, wyłączyć zaś można ją przez ustawienie zmiennej na "no" lub "off".

LOGABSTRACT

Zanim procmail zakończy, raportuje dostarczoną wiadomość w $LOGFILE, pokazując pola "From " i "Subject: " nagłówka, folder, w którym wiadomość została zapisana, oraz jej długość (w bajtach). Ustawienie tej zmiennej na "no" powstrzymuje generowanie tych informacji. Po ustawieniu jej na "all", procmail będzie logował każdą pomyślnie zakończoną regułę dostarczenia, którą przetworzy.

LOG

Wartość przypisana tej zmiennej będzie dopisana do pliku $LOGFILE.

ORGMAIL

Zazwyczaj mailbox systemowy (ORiGinal MAILbox). Jeśli z jakiegoś powodu (jak przepełnienie systemu plików), list nie mógł być dostarczony do tego mailboxa, to procmail dostarczy go tutaj. Jeśli jednak nie będzie mógł nawet tego uczynić, to list zostanie odbity do nadawcy.

LOCKFILE

Globalny plik blokujący. Jeśli plik ten już istnieje, procmail będzie czekał aż zniknie i utworzy go samodzielnie (i wyczyści gdy skończy). Jeśli podano więcej niż jeden plik blokujący, to poprzedni zostanie usunięty przed próbą utworzenia nowego. Używanie globalnego pliku blokującego jest złą praktyką, lepiej używać lokalnych (zależnych od reguły).

LOCKEXT

Domyślne rozszerzenie, które jest dodawane do plików docelowych, aby określić, którego z lokalnych plików blokujących użyć (tylko jeśli używanie tych plików jest włączone dla danej reguły).

LOCKSLEEP

Liczba sekund, które procmail ma odespać przed każdą kolejną próbą użycia pliku blokującego (jeśli taki już istniał); jeśli liczby nie podano, to wynosi ona 8 sekund.

LOCKTIMEOUT

Liczba sekund, które muszą minąć od utworzenia lub ostatniej modyfikacji pliku blokującego, zanim procmail zdecyduje, że jest to plik blokujący pozostawiony w wyniku błędu i że trzeba go usunąć na siłę. Wartość zero mówi, że timeout nie jest ustawiony i że procmail ma czekać do skutku. Jeśli nie jest podany, to odpowiada 1024 sekundom. Wartość ta jest przydatna w zapobieganiu niezdefiniowanym zawieszeniom programów sendmail(8) lub procmail. Procmail jest odporny na różnice w czasie lokalnym na różnych komputerach.

TIMEOUT

Liczba sekund, które muszą minąć zanim procmail zdecyduje, że dziecko, które uruchomił, musiało się zawiesić. Program odbierze od procmaila sygnał TERMINATE, a przetwarzanie pliku rc pójdzie dalej. Jeśli podano zero, to nie będzie tu używany czas oczekiwania i procmail będzie czekać do skutku; jeśli zmienna nie jest podana, wartość domyślna odpowiada 960 sekundom.

MSGPREFIX

Przedrostek nazwy pliku, który jest używany w wypadku dostarczania do katalogu (nie używany w katalogach maildir lub MH).

HOST

Jeśli nie jest to nazwa bieżącego komputera, to przetwarzanie bieżącego pliku rc zostaje natychmiast przerywane. Jeśli w linii komend podano inne pliki rc, to przetwarzanie będzie kontynuowane z następnym z nich. Jeśli wykorzystane zostaną wszystkie pliki rc, program zakończy pracę, lecz nie wygeneruje błędu (np. mailer będzie sądził, że wiadomość została dostarczona).

UMASK

Nazwa mówi za siebie (jeśli nie, zapomnij o tym :-). Cokolwiek zostanie przypisane do zmiennej UMASK jest interpretowane jako wartość ósemkowa. Jeśli nie jest podana, to domyślna wartość maski wynosi 077. Jeśli maska zezwala na ustawienie o+x, to owo o+x zostanie dodane do praw dostępu wszystkich skrzynek pocztowych, do których procmail dostarcza pocztę bezpośrednio. Może to być używane do sprawdzania, czy przybyła nowa poczta.

SHELLMETAS

Jeśli jakikolwiek ze znaków wymienionych w SHELLMETAS pojawi się w linii określającej filtr lub program, to linia zostanie przekazana powłoce $SHELL, a nie zostanie wywołana bezpośrednio.

SHELLFLAGS

Każde wywołanie powłoki $SHELL będzie następujące:
"$SHELL" "$SHELLFLAGS" "$*";

SENDMAIL

Jeśli nie używa się właściwości forwardowania, nie należy się tym przejmować. Określa to program wzywany do forwardowania poczty.
Jest wywoływany jako: "$SENDMAIL" $SENDMAILFLAGS "$@";

NORESRETRY

Liczba powtórek, które mają być dokonane po wystąpieniu jednego z błędów "process table full", "file table full", "out of memory" lub "out of swap space". Jeśli liczba ta jest ujemna, procmail będzie próbował wiecznie; jeśli nie jest podana, odpowiada wartości 4. Powtórki zachodzą co każde $SUSPEND sekund. Idea, która się za tym kryje, jest taka, że jeśli np. całkowicie wykorzystane zostały obszar pamięci wymiany lub tablica procesów, to wiele innych programów wykryje to także i przerwie działanie lub "padnie", zwalniając cenne zasoby procmailowi.

SUSPEND

Liczba sekund, podczas których procmail będzie czekał, jeśli musi, na coś, co obecnie jest niedostępne (pamięć, fork, itd.); jeśli nie podano, to wartością domyślną jest 16 sekund. Zobacz także: LOCKSLEEP.

LINEBUF

Długość wewnętrznych buforów liniowych, nie może być mniejsza niż 128. Wszystkie linie odczytywane z pliku rc nie powinny mieć więcej niż $LINEBUF znaków przed i po rozszerzeniu. Jeśli wartość nie jest podana, odpowiada 2048. Limitu tego oczywiście nie stosuje się do samego listu, który może mieć dowolne długości linii lub może być plikiem binarnym. Patrz także opis PROCMAIL_OVERFLOW.

DELIVERED

Jeśli ustawione na "yes", to procmail będzie udawał przed agentem pocztowym, że poczta została dostarczona. Jeśli poczta nie mogła być dostarczona po napotkaniu tego ustawienia, zostanie utracona (tj. nie będzie zwrócona do nadawcy).

TRAP

Gdy procmail będzie kończył działanie, ale nie z powodu otrzymania sygnału, to wywoła zawartość tej zmiennej. Kopia listu może być odczytana ze stdin. Wszelkie wyjście wyprodukowane przez tę komendę będzie dodane do pliku $LOGFILE. Przykładowe zastosowania TRAP to: usuwanie plików tymczasowych, logowanie własnych uzupełnień, itp. Zobacz także EXITCODE i LOGABSTRACT.

EXITCODE

Domyślne procmail zwraca zerowy kod błędu (oznaczający powodzenie), jeśli udało mu się poprawnie dostarczyć list lub gdy zmienna HOST nie była ustawiona na nazwę bieżącego komputera, a w linii poleceń nie podano kolejnych plików rc. W przeciwnym wypadku zwracany jest błąd. Przed zakończeniem jednakże procmail sprawdza wartość tej zmiennej. Jeśli została ustawiona na dodatnią wartość numeryczną, procmail użyje jej jako kodu wyjścia. Jeśli zmienna ta jest ustawiona, lecz pusta, procmail ustawi kod wyjścia na wartość zwracaną przez program TRAP. Jeśli zmienna ta nie została ustawiona, procmail ustawi ją na krótko przed wywołaniem programu TRAP.

LASTFOLDER

Zmienna ta jest inicjowana przez procmail za każdym razem, gdy dostarcza coś jakiemuś folderowi lub programowi. Zawsze zawiera nazwę ostatniego foldera (lub programu), do którego coś dostarczano. Jeśli ostatnie dostarczenie obejmowało łącznie kilka folderów, to $LASTFOLDER będzie zawierał nazwy wszystkich plików (będących de facto dowiązaniami twardymi) jako listę rozdzieloną spacjami.

MATCH

Zmienna ta jest inicjowana przez procmail za każdym razem, gdy ma wyciągnąć tekst z wyrażenia regularnego. Będzie zawierać cały tekst odpowiadającego wyrażenia regularnego występującego po żetonie "\/".

SHIFT

Przypisanie dodatniej wartości tej zmiennej daje taki sam rezultat, jak komenda "shift" w sh(1). Komenda ta jest najbardziej użyteczna do wyciągania dodatkowych argumentów podanych procmailowi działającemu jako filtr pocztowy.

INCLUDERC

Nazywa plik rc (względny w stosunku do bieżącego katalogu), który powinien być włączony jako część bieżącego pliku rc. Dozwolone jest nieograniczone zagnieżdżanie (limitowane tylko przez zasoby systemowe takie jak pamięć czy liczba dostępnych deskryptorów plików). Ponieważ nie są są sprawdzane ani uprawnienia, ani właściciel pliku rc, użytkownicy INCLUDERC powinni się upewnić, że tylko zaufani użytkownicy mają prawa do zapisu włączanego pliku rc i do katalogu, w którym się ten plik znajduje. Przypisanie zmiennej INCLUDERC wartości w linii poleceń nie ma żadnego efektu.

SWITCHRC

Nazywa plik rc (względny w stosunku do bieżącego katalogu), na który powinno się przełączyć przetwarzanie. Jeśli podany plik rc nie istnieje, nie jest zwykłym plikiem ani plikiem /dev/null, to zostanie wypisany błąd i będzie kontynuowane przetwarzanie bieżącego pliku rc. W przeciwnym razie przetwarzanie bieżącego pliku rc zostanie przerwane i rozpocznie się przetwarzanie pliku podanego jako wartość tej zmiennej. Jeśli zmienna SWITCHRC zostanie usunięta, to procmail przerywa przetwarzanie bieżącego pliku, tak jakby plik ten się kończył na linii usuwającej tę zmienną. Podobnie jak w przypadku INCLUDERC nie są są sprawdzane ani uprawnienia, ani właściciel pliku rc, a przypisanie tej zmiennej wartości w linii poleceń nie ma żadnego efektu.

PROCMAIL_VERSION

Numer wersji działającego procmaila.

PROCMAIL_OVERFLOW

Zmienna ta zostanie ustawiona na niepustą wartość, jeśli procmail wykryje przepełnienie bufora. Patrz rozdział BŁĘDY poniżej po opis innych działań podejmowanych po wykryciu przepełnienia bufora.

COMSAT

Notyfikacja comsat(8)/biff(1) domyślnie jest włączona, lecz można ją wyłączyć przez ustawienie tej zmiennej na "no". Alternatywnie, usługę biff można dokonfigurować przez ustawienie zmiennej na "service@", "@hostname" lub "sevice@hostname". Wartością domyślną jest biff@localhost.

DROPPRIVS

Jeśli jest to ustawione na "yes", procmail porzuci wszelkie uprawnienia (suid lub sgid), jakie może mieć. Opcja ta jest użyteczna, aby zagwarantować, że dolna część pliku /etc/procmailrc jest wywoływana w imieniu odbiorcy.

Rozszerzone wyrażenia regularne

Następujące żetony rozpoznawane są zarówno przez wewnętrzny egrep procmaila, jak i przez standardowy egrep(1) (proszę być świadomym tego, że niektóre implementacje egrepa zawierają niestandardowe rozszerzenia, w szczególności operator powtarzania { nie jest obsługiwany przez wewnętrznego egrepa procmaila):

^

Początek linii.

$

Koniec linii.

.

Dowolny znak poza znakiem nowej linii.

a*

Dowolna sekwencja składająca się z zera lub więcej znaków "a".

a+

Dowolna sekwencja składająca się z jednego lub więcej znaków "a".

a?

Ciąg pusty albo jeden znak "a".

[^-a-d]

Dowolny znak, który nie jest kreską, znakiem "a", "b", "c" lub "d", lub znakiem nowej linii.

de|abc

Albo sekwencja "de", albo "abc".

(abc)*

Zero lub więcej sekwencji "abc".

\.

Dopasowuje pojedynczą kropkę; należy użyć \ przed którymkolwiek ze znaków specjalnych, aby pozbyć się jego specjalnego znaczenia. Patrz także opis podstawień zmiennych $\nazwa w rozdziale BŁĘDY.

Były to tylko przykłady, oczywiście można używać również bardziej złożonych kombinacji.

Następujące znaczenia żetonów są rozszerzeniami procmaila:

^ lub $

Pasuje do znaku nowej linii (dla trafień wieloliniowych).

^^

Zakotwicza wyrażenie na samym początku obszaru przeszukiwania lub jeśli napotkane na końcu wyrażenia, na samym końcu obszaru przeszukiwań.

\< lub \>

Dopasowuje znak przed słowem lub po nim. Są to ogólnie skróty dla "[^a-zA-Z0-9_]", lecz mogą także dopasowywać znaki nowej linii. Ponieważ odpowiadają rzeczywistym znakom, nadają się tylko do oddzielania słów, nie do oddzielania przestrzeni między słowami.

\/

Dzieli wyrażenie na dwie części. Wszystko odpowiadające prawej stronie będzie przypisane do zmiennej środowiskowej MATCH.