.\" {PTM/PB/0.1/02-05-1999/"autonomiczny procesor poczty"}
.\" Translation 1999 Przemek Borys <pborys@dione.ids.pl>
.\" Huh... wida, e pisa to niemiec. takie rozwleke i tracce logik
.\" zdania, e strach :((
.\" Dlatego prosz o ostrone podejcie do niejasnych partii tego tumacznia
.\" W.Kotwica 2001: sprbowaem nieco janiej ;-)
.\" wg procmail.man 1999/11/04 23:26:14 guenther
.\"
.\"if n .pl +(135i-\n(.pu)
.de Id
.ds Rv \\$3
.ds Dt \\$4
..
.Id $Id: procmail.1,v 1.4 2001/07/24 06:42:38 wojtek2 Exp $
.TH PROCMAIL 1 \*(Dt BuGless
.rn SH Sh
.de SH
.br
.ne 11
.Sh "\\$1"
..
.rn SS Ss
.de SS
.br
.ne 10
.Ss "\\$1"
..
.rn TP Tp
.de TP
.br
.ne 9
.Tp \\$1
..
.rn RS Rs
.de RS
.na
.nf
.Rs
..
.rn RE Re
.de RE
.Re
.fi
.ad
..
.de Sx
.PP
.ne \\$1
.RS
..
.de Ex
.RE
.PP
..
.na
.SH NAZWA
procmail \- autonomiczny procesor poczty
.SH SKADNIA
.B procmail
.RB [ \-ptoY ]
.RB [ "\-f \fIfromwhom\fP" ]
.RI [ "parameter\fB=\fPvalue " | " rcfile" ]
\&.\|.\|.
.br
.B procmail
.RB [ \-toY ]
.RB [ "\-f \fIfromwhom\fP" ]
.RB [ "\-a \fIargument\fP" ]
.B \-d
.I recipient
\&.\|.\|.
.br
.B procmail
.RB [ \-ptY ]
.B \-m
.RI [ "parameter\fB=\fPvalue" ]
\&.\|.\|.
.I rcfile
.if n .ti +0.5i
.RI [ argument ]
\&.\|.\|.
.br
.B procmail
.B \-v
.ad
.SH OPIS
Szybk orientacj w temacie mona uzyska czytajc umieszczone na kocu
.BR UWAGI .
.PP
.B Procmail
powinien by wywoywany automatycznie, korzystajc z mechanizmu
.B .forward
w momencie przybycia listu. Alternatywnie, gdy jest zainstalowany przez
administratora systemu, moe by wywoywany bezporednio przez program
pocztowy (mailer).
Po wywoaniu, najpierw ustawia na wartoci domylne pewne zmienne rodowiskowe,
odczytuje wiadomo pocztow ze stdin (do EOF), oddziela jej tre od nagwka,
a nastpnie, jeli nie podano argumentw wiersza polece, zaczyna szuka pliku
o nazwie
.BR $HOME/.procmailrc .
Stosownie do regu przetwarzania zawartych w tym pliku wieo otrzymana
wiadomo pocztowa zostaje umieszczona we waciwym katalogu.
Jeli nie istnieje plik rc, lub jego
przetwarzanie dojdzie do koca, procmail zapisze wiadomo w domylnej
skrzynce pocztowej (mailbox) systemu.
.PP
Jeli nie podano ani pliku rc, ani opcji
.B \-p
w wierszu polece, to program przed odczytaniem $HOME/.procmailrc zinterpretuje
polecenia zawarte w
.B /etc/procmailrc
(o ile istniej).
Podczas tworzenia /etc/procmailrc trzeba uwaa, poniewa jeli warunki na
to pozwol, zostanie on uruchomiony z prawami roota (w przeciwiestwie do
pliku $HOME/.procmailrc).
.PP
Jeli procmail zostanie uruchomiony z uprawnieniami roota lub jako suid root,
to moe pracowa jako agent dostarczania poczty (mail delivery agent),
z poszerzonymi moliwociami, wstecznie zgodny.
.PP
Mona go te wykorzystywa jako uniwersalny filtr pocztowy, tzn. poczyniono
pewne kroki, by procmail mg by wywoywany w specjalnej regule sendmaila.
.PP
Format pliku rc jest opisany szczegowo na stronie podrcznika
.BR procmailrc (5).
.PP
Technika punktowania waonego jest szczegowo opisana na stronie
.BR procmailsc (5).
.PP
Przykady plikw rc mona obejrze na stronie
.BR procmailex (5).
.SS Sygnay
.TP 1.2i
.B TERMINATE
Koczy przedwczenie i ponownie kolejkuje wiadomo.
.TP
.B HANGUP
Koczy przedwczenie i odbija wiadomo do nadawcy.
.TP
.B INTERRUPT
Koczy przedwczenie i odbija wiadomo do nadawcy.
.TP
.B QUIT
Koczy przedwczenie i milczco traci wiadomo.
.TP
.B ALARM
Wymusza przekroczenie limitu czasu (zobacz
.BR TIMEOUT ).
.TP
.B USR1
Rwnowanik
.BR VERBOSE =off.
.TP
.B USR2
Rwnowanik
.BR VERBOSE =on.
.SH OPCJE
.TP 0.5i
.B \-v
Procmail wypisuje swj numer wersji, wywietla wkompilowan konfiguracj i
koczy dziaanie.
.TP
.B \-p
Zachowuje stare rodowisko. Normalnie procmail czyci rodowisko
podczas startu, poza wartoci TZ. Jednak w kadym wypadku: wszelkie
wartoci domylne przesoni uprzednio istniejce zmienne rodowiskowe,
tzn. procmail nie bdzie zwraca uwagi na adne predefiniowane zmienne
rodowiskowe, lecz szczliwie nadpisze je swoimi wartociami domylnymi.
List zmiennych rodowiskowych procmaila
mona znale na stronie podrcznika
.BR procmailrc (5).
Jeli podano zarwno \-p jak i \-m, lista preustawianych zmiennych ogranicza
si do zaledwie: LOGNAME, HOME, SHELL, ORGMAIL i MAILDIR.
.TP
.B \-t
Powoduje, e procmail zawodzi agodnie, np. jeli nie moe dostarczy
przesyki do adnego podanych mu celw, wiadomo nie zostanie odbita, lecz
powrci do kolejki poczty. W przyszoci zostanie dokonana ponowna prba
dostarczenia.
.TP
.I "\fB\-f\fP fromwhom"
Powoduje, e procmail ponownie generuje pocztkow lini `From ' z wartoci
.I fromwhom
jako wysyajcym (zamiast \-f mona uy alternatywnego i przedawnionego \-r).
Jeli
.I fromwhom
skada si z pojedynczego `-', to program tylko odwiey znacznik czasu
w linii `From ' (o ile jest obecny, jeli nie, to utworzy nowy).
.TP
.B \-o
Zamiast pozwoli komukolwiek na generowanie linii `From ', po prostu
przesoni faszywki.
.TP
.B \-Y
Zakada, e do mamy czynienia z tradycyjnym Berkeley'owskim formatem mailboxa,
ignoruje wszelkie pola
.BR Content-Length: .
.TP
.I "\fB\-a\fP argument"
Ustawia $1 na warto
.IR argumentu .
Moe by uywane do przekazywania metainformacji do procmaila. Zazwyczaj
wykonuje si to przez przesyanie informacji $@x z reguy sendmaila.
.TP
.I "\fB\-d\fP recipient .\|.\|."
Wcza jawny tryb dostarczania. Dostarczenie nastpi do lokalnego odbiorcy,
oznaczonego jako
.IR recipient .
Jest to oczywicie moliwe tylko jeli procmail ma prawa roota (lub efektywne
prawa euid i egid odbiorcy). Procmail bdzie si suidowa do podanych
odbiorcw i dostarcza poczt tak, jakby zosta wywoany przez danego
odbiorc bez argumentw (tzn. jeli nie znaleziono pliku rc, dostarczanie
zachodzi jak w zwyczajnej poczcie).
Opcja ta jest niezgodna z
.BR \-p .
.TP
.B \-m
Zmienia procmail w filtr pocztowy oglnego przeznaczenia. W tym trybie
trzeba przekaza jeden plik rc w wierszu polece. Po pliku rc procmail
przyjmie nieograniczon liczb argumentw. Jeli plik rc jest nazw ze
ciek absolutn, zaczynajc si od
.BR /etc/procmailrcs/ ,
bez odwoa wstecznych (np. katalog rodzicielski nie moe by
wymieniony), to procmail sprbuje, jeeli nie napotka narusze
bezpieczestwa, zidentyfikowa waciciela tego pliku (lub dowizania
symbolicznego). Zaawansowane zastosowania tej opcji mona znale w sekcji
.B PRZYKADY
poniej.
.SH ARGUMENTY
Wszelkie argumenty zawierajce '=' s uwaane za przypisania wartoci
zmiennym rodowiskowym. \fIWszystkie\fP one zostan obliczone po przypisaniu
wartoci domylnych, a przed otwarciem pierwszego pliku rc.
.PP
Wszelkie inne argumenty s uwaane za cieki pliku rc: albo absolutne,
albo, jeli zaczynaj si od `./', wzgldne, w odniesieniu do biecego
katalogu.
.B Wszelkie inne cieki wzgldne
s uwaane za podane wzgldem katalogu $HOME, chyba e uyto opcji
.BR \-m .
Wwczas wszystkie cieki wzgldne odnosz si do biecego katalogu.
Procmail zacznie od pierwszej cieki, ktr znajdzie w wierszu polece.
Nastpne zostan przetworzone tylko wtedy, jeli poprzednie nie maj
odpowiadajcego wpisu HOST-directive, lub w wypadku gdy nie istniej.
.PP
Jeli nie poda si plikw rc, procmail zaglda do
.BR $HOME/.procmailrc .
Jeli nawet tego nie dao si znale, przetwarzanie bdzie kontynuowane
zgodnie z domylnymi ustawieniami zmiennych rodowiskowych i zmiennych
podanych w wierszu polece.
.SH PRZYKADY
Przykady plikw rc mona obejrze na stronie
.BR procmailex (5).
May fragment pliku rc mona znale w sekcji
.BR UWAGI ,
poniej.
.PP
Pomi reszt tej sekcji, chyba e jeste administratorem, ktry ma jakie
pojcie o skadni sendmail.cf.
.PP
Opcja
.B \-m
jest zazwyczaj uywana gdy procmail jest wywoywany przez regu pliku
sendmail.cf. Aby mc tego dokona, dobrze jest utworzy dodatkowy wpis
o programie dostarczajcym poczt `procmail' w pliku sendmail.cf
(poza ju obecnym mailerem `local', ktry uruchamia procmaila).
Aby utworzy taki wpis, sugeruj co takiego:
.Sx 2
Mprocmail, P=/usr/bin/procmail, F=mSDFMhun, S=11, R=21,
        A=procmail \-m $h $f $u
.Ex
Umoliwi to wykorzystanie do filtrowania poczty poprzez mailer procmail
regu podobnych do poniszej (prawdopodobnie w zestawie regu (ruleset) 0).
Zwr uwag na poczatkow tabulacj oznaczajc kontynuacj reguy
i tabulacj suc do oddzielenia komentarzy:
.Sx 4
R$*<@some.where>$*
        $#procmail $@/etc/procmailrcs/some.rc $:$1@some.where.procmail$2
R$*<@$*.procmail>$*
        $1<@$2>$3       Ju przefiltrowane, odwzoruj z powrotem
.Ex
A plik etc/procmailrcs/some.rc moe by taki:
.Sx 6
:0                              # spu do muszli poczt mieciow ;)
* ^Subject:.*junk
/dev/null

:0                              # przeka reszt przesyek dalej
! \-oi \-f "$@"
.Ex
Uwaaj gdy z wntrza pliku /etc/procmailrcs/some.rc wysyasz listy:
jeli wylesz je na adresy, ktre odpowiadaj znowu pierwszej regule,
moesz utworzy nieskoczon ptl.
.SH PLIKI
.TP 2.3i
.B /etc/passwd
do ustawiania domylnych wartoci zmiennych LOGNAME, HOME i SHELL odbiorcy
.TP
.B /var/spool/mail/$LOGNAME
systemowa skrzynka pocztowa; zarwno skrzynka systemowa jak i katalog,
w ktrym si ona znajduje, bd tworzone za kadym razem gdy procmail
startuje a ktre z nich nie istnieje
.TP
.B /etc/procmailrc
pocztkowy oglnosystemowy plik rc
.TP
.B /etc/procmailrcs/
cieka specjalnych uprawnie do plikw rc
.TP
.B $HOME/.procmailrc
domylny plik rc
.TP
.B /var/spool/mail/$LOGNAME.lock
plik blokujcy systemowej skrzynki pocztowej (nie jest automatycznie uywany
przez procmail, chyba e $DEFAULT jest rwne /var/spool/mail/$LOGNAME,
a procmail dostarcza co do $DEFAULT)
.TP
.B /usr/sbin/sendmail
domylny program ekspedycji poczty (forwarder)
.TP
.B _????`hostname`
tymczasowe `unikalne' pliki zerowej dugoci tworzone przez procmail
.SH "ZOBACZ TAKE"
.na
.nh
.BR procmailrc (5),
.BR procmailsc (5),
.BR procmailex (5),
.BR sh (1),
.BR csh (1),
.BR mail (1),
.BR mailx (1),
.BR binmail (1),
.BR uucp (1),
.BR aliases (5),
.BR sendmail (8),
.BR egrep (1),
.BR grep (1),
.BR biff (1),
.BR comsat (8),
.BR lockfile (1),
.BR formail (1),
.BR cron (1)
.hy
.ad
.SH DIAGNOSTYKA
.TP 2.3i
Autoforwarding mailbox found
(Znaleziono skrzynk auto-przekazujc)
Skrzynka systemowa miaa ustawiony bit
suid lub sgid, procmail koczy z EX_NOUSER, zakadajc e do tej skrzynki
nie wolno dostarcza poczty.
.TP
Bad substitution of "x"
(Ze podstawienie "x")
Nie podano prawidowej nazwy zmiennej rodowiskowej.
.TP
Closing brace unexpected
(Niespodziewane zamknicie nawiasu)
Nie byo odpowiadajcego nawiasu otwierajcego (zagnidenie bloku).
.TP
Conflicting options
(Kolidujce opcje)
Nie wszystkie kombinacje opcji s uyteczne.
.TP
Conflicting x suppressed
(Zlikwidowane kolidujce x)
Flaga x nie da si pogodzi z innymi flagami tej reguy.
.TP
Couldn't create "x"
(Nieudane utworzenie "x")
Brakowao skrzynki systemowej i nie dao si jej byo utworzy.
.TP
Couldn't create maildir part "x"
(Nieudane utworzenie czci "x" katalogu poczty)
W katalogu pocztowym "x" brakuje jednego lub wicej koniecznych podkatalogw
a procmail nie mg ich utworzy.
.TP
Couldn't create or rename temp file "x"
(Nieudane utworzenie lub przemianowanie tymczasowego pliku "x")
W mechanice dostarczania wiadomoci do katalogu pocztowego "x" wystpi bd.
.TP
Couldn't determine implicit lockfile from "x"
(Nie mona okreli jawnego pliku blokady z "x")
Nie znaleziono przekierowa `>>', uywa zwyczajnie `$LOCKEXT' jako lokalnego
pliku blokujcego (locallockfile).
.TP
Couldn't read "x"
(Nieudany odczyt "x")
Procmail nie by w stanie otworzy pliku rc albo nie by to zwyczajny plik
lub te program nie mg otworzy katalogu MH, by znale plik o najwyszym
numerze.
.TP
Couldn't unlock "x"
(Nieudane odblokowanie "x")
Plik blokujcy ju znikn lub odebrano prawa zapisu do jego katalogu.
.TP
Deadlock attempted on "x"
(Prba zakleszczenia na "x")
Lokalny plik blokujcy (locallockfile) podany w tej regule jest rwny
nadal aktywnemu $LOCKFILE.
.TP
Denying special privileges for "x"
(Odmowa specjalnych uprawnie dla "x")
Procmail nie przybierze tosamoci narzucanej mu plikiem rc, poniewa wykryto
pogwacenie bezpieczestwa (np.
.B \-p
lub przypisania zmiennych w wierszu polece) albo program mia zbyt mae
uprawnienia by mc to zrobi.
.TP
Descriptor "x" was not open
(Deskryptor "x" nie by otwarty)
Podczas startu procmaila nie byy przyczone stdin, stdout lub stderr
(prawdopodobnie prba zamania bezpieczestwa).
.TP
Enforcing stricter permissions on "x"
(Wymuszenie bardziej restrykcyjnych uprawnie do "x")
Systemowa skrzynka pocztowa odbiorcy bya niezabezpieczona, procmail
j zabezpieczy.
.TP
Error while writing to "x"
(Bd podczas zapisu do "x")
Nieistniejcy katalog, brak praw zapisu, pad potok lub przepeniony dysk.
.TP
Exceeded LINEBUF
(Przekroczone LINEBUF)
Wykryto przepenienie bufora, LINEBUF by zbyt may, ustawiono
PROCMAIL_OVERFLOW.
.TP
Excessive output quenched from "x"
(Stumiono nadmierne wyjcie z "x")
Program lub filtr "x" prbowa wyprodukowa zbyt wiele wyjcia dla biecego
bufora LINEBUF, reszta zostaa pominita.
.TP
Extraneous x ignored
(Nie zwizane x zignorowane)
Linia akcji lub inne flagi tej reguy odbieraj fladze x znaczenie.
.TP
Failed forking "x"
(Nieudane rozwidlenie "x")
Tabela procesw jest pena (i wykorzystano RORESRETRY).
.TP
Failed to execute "x"
(Nieudane wykonanie "x")
Program nie znajduje si w ciece lub nie jest wykonywalny.
.TP
Forced unlock denied on "x"
Brak praw zapisu do katalogu, w ktrym znajduje si plik blokujcy
.B lockfile
"x", albo w tym samym czasie prbuje wymusi blokowanie wicej ni jeden
procmail.
.TP
Forcing lock on "x"
Plik
.B Lockfile
"x" zostanie usunity si, poniewa nastpio przekroczenie limitu czasu
(zobacz take:
.BR LOCKTIMEOUT ).
.TP
Incomplete recipe
Znaleziono pocztek reguy, lecz nie zostaa zakoczona przed EOF.
.TP
Insufficient privileges
Procmail wymaga uprawnie roota lub musi mie okrelony (e)udi, (e)gid w
trybie dostarczania. Wiadomoci bd odbijane (zwracane nadawcy).
.TP
Invalid regexp "x"
Wyraenie regularne "x" zawiera bdy (najprawdopodobniej brakujce
lub nadmiarowe nawiasy).
.TP
Kernel-lock failed
Podczas prby uycia obsugiwanych przez jdro wywoa blokujcych, ktre
z nich nie powiodo si (zwykle wskazuje to na bd systemu), procmail
ignoruje ten bd i dziaa dalej.
.TP
Kernel-unlock failed
Zawioda prba odblokowania za porednictwem funkcji jdra. Zobacz wyej.
.TP
Lock failure on "x"
Moe si pojawi tylko jeli podasz jakie naprawd dziwne (i niedozwolone)
nazwy plikw blokujcych, lub jeli nie mona byo utworzy pliku
.B lockfile
z powodu braku uprawnie lub nieistniejcych podkatalogw.
.TP
Lost "x"
Procmail prbowa sklonowa si, lecz nie mg znale pliku rc "x" (zosta
przeniesiony lub by ciek wzgldn, a zmienie katalog od ostatniego
otwarcia go przez procmaila).
.TP
Missing action
(Brak akcji)
Bieca regua nie jest kompletna.
.TP
Missing closing brace
(Brak nawiasu zamykajcego)
Rozpoczto zagniedony blok, ale go nie zakoczono.
.TP
Missing name
(Brak nazwy)
Opcja \-f wymaga dodatkowego argumentu.
.TP
Missing argument
(Brak argumentu)
Podae opcj \-a, lecz zapomniae argumentu.
.TP
Missing rcfile
(Brak pliku rc)
Podae opcj \-m, procmail oczekuje nazwy pliku rc jako argumentu.
.TP
Missing recipient
(Brak odbiorcy)
Podae opcj \-d lub wywoae procmail pod inn nazw, program oczekuje
przynajmniej jednego odbiorcy jako argumentu.
.TP
No space left to finish writing "x"
System plikw zawierajcy "x" nie ma do wolnego miejsca, aby umoliwi
dostarczenie wiadomoci do pliku.
.TP
Out of memory
Systemowi brakuje swapu (a wyczerpano NORESRETRY).
.TP
Processing continued
Nierozpoznane opcje wierszu polece s ignorowane, kontynuowanie jak zwykle.
.TP
Program failure (nnn) of "x"
Program uruchomiony przez procmaila zwrci nnn zamiast 
EXIT_SUCCESS (=0);
Jeli nnn jest ujemne, to jest to sygnaem, e program umar.
.TP
Quota exceeded while writing "x"
(Podczas zapisu "x" przekroczono ograniczenie udziau dyskowego)
Ograniczenie wielkoci pliku (quota) w systemie plikw odbiorcy
zawierajcym "x" nie pozwala na dostarczenie danej wiadomoci do pliku.
.TP
Renaming bogus "x" into "x"
Systemowa skrzynka pocztowa odbiorcy okazaa si by zmylona, procmail
wykona dziaania wymijajce.
.TP
Rescue of unfiltered data succeeded/failed
(Ratowanie nieprzefiltrowanych danych pomylne/nieudane)
Filtr zakoczy prac niepomylnie, procmail prbowa odzyska oryginalny
tekst.
.TP
Skipped: "x"
(Pominito: "x")
Program nie mg nic zrobi z "x" w pliku rc (bd skadni), ignoruje to.
.TP
Suspicious rcfile "x"
(Podejrzany plik rc "x")
Waciciel pliku rc nie by odbiorc ani rootem, plik by dostpny do zapisu
dla wszystkich, lub zawierajcy go katalog by zapisywalny dla wszystkich,
lub by to domylny plik rc ($HOME/.procmailrc) i albo ten plik, albo
zawierajcy go katalog byy zapisywalne przez grup.
(Plik rc nie zosta uyty).
.TP
Terminating prematurely whilst waiting for .\|.\|.
(Przedwczesne zakoczenie podczas oczekiwania na .\|.\|.)
Procmail otrzyma sygna podczas oczekiwania na .\|.\|.
.TP
Timeout, terminating "x"
W filtrze lub programie "x" nastpio przekroczenie limitu czasu.
.TP
Timeout, was waiting for "x"
W programie, filtrze lub pliku "x" nastpio przekroczenie limitu czasu.
Jeli by to program lub filtr, to wyglda na to, e ju nie dziaa.
.TP
Truncated file to former size
Plik nie mg by szczliwie dostarczony, wic zosta skrcony do
poprzedniej wielkoci.
.TP
Truncating "x" and retrying lock
"x" nie wydaje si by prawidow nazw pliku lub plik nie jest pusty.
.TP
Unable to treat as directory "x"
(Niemoliwe traktowanie jako katalogu "x")
Albo przyrostek katalogu "x" wskazuje na to, e powinien to by MH
lub katalog wiadomoci pocztowych (maildir), albo zosta on wymieniony
jako drugi katalog, do ktrego naley wykona dowizanie, ale ju istnieje
i nie jest to katalog.
.TP
Unexpected EOL
(Niespodziewany EOL)
Brak zamykajcego cytatu lub prba ucieczki EOF.
.TP
Unknown user "x"
(Nieznany uytkownik "x")
Podany odbiorca nie ma odpowiadajcego mu uid.
.SH "ROZSZERZONA DIAGNOSTYKA"
Rozszerzon diagnostyk mona wcza i wycza ustawieniem zmiennej
VERBOSE.
.TP 2.3i
[pid] time & date
Pid i timestamp procmaila. Generowane za kadym razem gdy procmail loguje
diagnostyk, gdy upyna chocia sekunda od ostatniego timestampu.
.TP
Acquiring kernel-lock
Procmail prbuje zablokowa przez jdro ostatnio otwarty plik (deskryptor).
.TP
Assigning "x"
Przyznanie wartoci zmiennej rodowiskowej.
.TP
Assuming identity of the recipient, VERBOSE=off
Porzucenie wszystkich uprawnie (jeli jakie byy), bezwarunkowo wycza
rozszerzon diagnostyk.
.TP
Bypassed locking "x"
Katalog spool poczty nie by dostpny procmailowi, bazowa wycznie na
blokadach jdra.
.TP
Executing "x"
Uruchamianie programu "x"; jeli jest on uruchamiany bezporednio przez
procmaila (bez poredniej powoki), procmail pokae gdzie oddzieli
argumenty poprzez wstawienie przecinkw.
.TP
HOST mismatched "x"
Ten host by nazwany "x", HOST zawierao co innego.
.TP
Locking "x"
Tworzenie pliku blokujcego "x".
.TP
Linking to "x"
Tworzenie dowizania twardego pomidzy folderami katalogw.
.TP
Match on "x"
Trafiony warunek.
.TP
Matched "x"
Przyznano "x" warto
.BR MATCH .
.TP
No match on "x"
Warunek nie pasowa, regua pominita.
.TP
Non-zero exitcode (nnn) by "x"
Niezerowy kod zakoczenia "x".
Program uruchomiony przez procmaila jako warunek lub akcja
przepisu
z flag `W' zwrci nnn zamiast EXIT_SUCCESS (=0); sposb uycia wskazuje
na to, e nie jest to niespodziewana okoliczno.
.TP
Notified comsat: "$LOGNAME@offset:file"
Wysano informacj do comsat/biff, e pojawia si poczta dla uytkownika
$LOGNAME pod `offsetem' w pliku `file'.
.TP
Opening "x"
Otwieranie pliku "x" dla dopisywania.
.TP
Rcfile: "x"
Plik rc zmieniony na "x".
.TP
Reiterating kernel-lock
Podczas prbowania rnych metod blokowania, jedna z nich si nie powioda.
Procmail bdzie iterowa od nowa, a wszystkie si nie powiod.
.TP
Score: added newtotal "x"
Ten warunek dooy `dodatkowe' punkty, co dao w wyniku `now sum' punktacji.
.TP
Unlocking "x"
Ponowne usuwanie pliku blokujcego (lockfile) "x".
.SH OSTRZEENIA
Powiniene utworzy skrypt powoki, ktry uywa
.BR lockfile (1)
zanim wywoasz swoj powok pocztow na ktrymkolwiek pliku skrzynki pocztowej, 
innym
ni skrzynka systemowa (chyba, e twoja powoka pocztowa uywa tych samych
plikw blokujcych (lokalnych lub globalnych), ktre podae w pliku rc).
.PP
W rzadkich przypadkach, gdy musisz ubi procmaila zanim zakoczy dziaanie,
uyj zwykego polecenia kill (np. 
.I nie
kill \-9, zobacz podsekcj
.I Sygnay
dla sugestii), inaczej niektre pliki blokujce (lockfiles)
mog nie zosta usunite.
.PP
Strze si gdy uywasz opcji
.B \-t ,
jeli procmail jest cigle niezdolny do dostarczenia poczty (np. przez
nieprawidowy plik rc), kolejka poczty systemu moe si przepeni. Moe to
zgorszy zarwno postmastera, jak i innych uytkownikw.
.PP
Plik
.B /etc/procmailrc
moe by uruchamiany z prawami roota, wic bd bardzo ostrony z tym, co
tam wstawiasz.
.B SHELL
bdzie zgodny z powok biecego odbiorcy, wic jeli procmail ma
wywoywa powok, lepiej ustaw to wpierw na bezpieczn warto. Zobacz take\h'-\w' 'u' :
.BR DROPPRIVS .
.PP
Pamitaj, e jeli na plikach w
.BR /etc/procmailrcs/
dozwolony jest
.BR chown (1),
to mog one by chown-owane na roota (lub kogokolwiek innego) przez ich
obecnych wacicieli. Dla maksymalnego bezpieczestwa upewnij si, e
katalog ten jest
.I wykonywalny
tylko dla roota.
.PP
Procmail nie jest waciwym narzdziem do wsplnego uytkowania jednej
skrzynki pocztowej przez wielu uytkownikw, jak to wystpuje w przypadku,
gdy masz jedno konto POP dla caej poczty w swojej domenie.
Da si to zrobi, jeli uda ci si skonfigurowa MTA tak, by dodawa nagwki
z danymi odbiorcy kopertowego, dziki ktrym procmail bdzie wiedzia, dla
kogo jest dana wiadomo, jednak zwykle nie jest to dobre rozwizanie.
By moe lepiej zbada czy uywany MTA oferuje 'tabele uytkownikw
wirtualnych' (`virtual user tables') lub poszuka np. funkcji `multidrop'
(wielopunktowoci) Fetchmaila.
.SH BDY
Po usuniciu si pliku blokujcego, procmail czeka $SUSPEND sekund zanim
utworzy nowy plik blokujcy, tak by inny proces, ktry chce usun stary plik
blokujcy nie usun przypadkiem nowego.
.PP
Procmail uywa zwykego sygnau TERMINATE do zakoczenia filtrw, ktre
ucieky, lecz nie sprawdza czy filtr odpowiada na sygna.  Poza tym wysya
sygna tylko do filtra, nie do jego dzieci.
.PP
Kontynuowane pole
.B Content-Length:
nie jest prawidowo obsugiwane.
.SH RӯNE
Jeli w nagwku istnieje pole
.BR Content-Length:
a nie podano flagi
.BR \-Y ,
procmail wykorzysta to pole do zgoszenia waciwego rozmiaru. Procmail nie
zmienia szerokoci pola.
.PP
Jeli nie ma pola
.B Content-Length:
lub jeli podano flag
.BR \-Y ,
a procmail dopisuje do zwykych folderw pocztowych, to wszelkie linie ciaa
wiadomoci, ktre wygldaj jak znaki pocztowe, s poprzedzane `>' (rozbraja
nieprawdziwe nagwki pocztowe). Wyraenie regularne uywane do wyszukiwania
tych znakw pocztowych to:
.RS
`\\nFrom '
.RE
.PP
Jeli nazwa celu uyta w jawnym trybie dostarczania nie figuruje w
/etc/passwd, procmail zadziaa tak, jakby tryb ten nie by wczony.
Jeli nie jest w jawnym trybie dostarczania, a uid, pod ktrym dziaa
nie ma odpowiadajcego wpisu /etc/passwd, to HOME bdzie odpowiada /,
LOGNAME bdzie odpowiada #uid, a SHELL bdzie odpowiada /bin/sh.
.PP

Gdy procmail jest w jawnym trybie dostarczania, to bdzie generowa
pocztkowe linie `From ', jeli brak takowych. Jeli linia taka ju
istnieje, procmail pozostawi j bez zmian. Jeli procmail nie jest wywoany
z jednym z nastpujcych id uytkownika lub grupy\h'-\w' 'u' : root, daemon,
uucp, mail, x400, network, list, lists lub
news, lecz wci musi generowa lub przyjmowa now lini `From ', to
bdzie generowa dodatkow lini `>From ', pomagajc odrni faszywe
listy. (?)
.PP
Ze wzgldw bezpieczestwa, w wypadkach gdy wacicielem pliku rc jest 
odbiorca lub root, a plik nie jest oglnie zapisywalny, lub gdy katalog,
w ktrym on si znajduje nie jest oglnie zapisywalny, procmail bdzie
uywa tylko plikw rc o nazwach bezwzgldnych lub wyznaczonych wzgldem
$HOME.  Plik $HOME/.procmailrc ma dodatkowe ograniczenie: ani on, ani
katalog, w ktrym si znajduje, nie mog by zapisywalne przez grup.
.PP
Jeli /var/spool/mail/$LOGNAME jest zmylon skrzynk (np. nie naley do
odbiorcy, jest niezapisywalny, jest dowizaniem), procmail podczas startu
sprbuje zmieni jego nazw na zaczynajc si od `BOGUS.$LOGNAME.'
i koczc si numerem sekwencyjnym i-wza. Jeli okae si to niemoliwe,
.B ORGMAIL
.I nie
bdzie mie wartoci pocztkowej i wskutek tego bdzie zakazywa dostarczania
bez naleytego pliku rc.
.PP
Jeli /var/spool/mail/$LOGNAME jest ju prawidow skrzynk, lecz ma zbyt
sabe prawa, procmail to poprawi. Aby zapobiec temu, ustaw bity u+x.
.PP
Podczas dostarczania do katalogw (lub folderw MH),
.B nie
musisz uywa plikw blokujcych w celu zapobieenia zamieszaniu powodowanemu
przez kilka pracujcych naraz procmaili.
.PP
Dostarczanie do folderw MH jest troch bardziej czasochonne ni
dostarczanie do normalnych katalogw lub mailboxw, poniewa procmail musi
poszuka nastpnego dostpnego numeru (zamiast korzystywania od razu
z gotowej nazwy pliku).
.PP
Przy oglnym niepowodzeniu, procmail zwrci EX_CANTCREAT, chyba e podana
zostanie opcja
.BR \-t -
wwczas zwrci EX_TEMPFAIL.
.PP
Procmail skleja wszystkie kontynuowane pola nagwkowe, eby mona byo
w spjniejszy sposb je `egrepowa'. Robi to jednak tylko wewntrznie -
podczas dostarczania poczty, amania linii pojawi si w postaci pierwotnej.
.PP
Jeli procmail jest wywoywany pod nazw nie zaczynajc si od `procmail'
(np. jeli jest dowizany do innej nazwy i wywoany pod tamt nazw), to
wcza si w jawnym trybie dostarczania i oczekuje nazw odbiorcw
jako argumentw wiersza polece(tak, jakby byo podane \-d).
.PP
Powiadomienia comstat/biff s dokonywane za pomoc udp. S one wysyane gdy
procmail generuje wpis pliku z logiem. Komunikaty powiadamiania maj
nastpujcy rozszerzony format (lub tak zbliony, jaki tylko mona uzyska,
gdy ostateczne dostarczenie nie byo do pliku):
.RS
$LOGNAME@offset_wiadomoci_w_mailboksie\h'-\w' 'u' :absolutna_cieka_do_mboxa
.RE
.PP
Kiedy tylko procmail otwiera plik, do ktrego dostarcza, uywa konsystentnie
nastpujcych jdrowych strategii blokowania\h'-\w' 'u' :
.BR fcntl (2)
i
.BR lockf (3).
.PP
Procmail jest odporny na NFS i czysty na smym bicie.
.br
.ne 11
.SH UWAGI
Wywoywanie procmaila z opcj \-h lub \-? spowoduje wywietlenie pomocy
wiersza polece oraz strony skrconej instrukcji flag regu.
.PP
Istnieje doskonae FAQ dla pocztkujcych dotyczce filtrw pocztowych
(w szczeglnoci procmaila). Jest prowadzone przez Nancy McGough <nancym@ii.com>,
a mona je otrzyma wysyajc na adres mail-server@rtfm.mit.edu list z treci:
.RS
send usenet/news.answers/mail/filtering-faq
.RE
.PP
Jeli procnail
.B nie
jest zainstalowany w systemie jako domylny program dostarczania poczty
(zapytaj administratora), musisz si upewni, e jest wywoywany, gdy
przybywa poczta.
W tym wypadku twj $HOME/.forward (uwaga,
.B musi
by dostpny ogowi do odczytu) powinien zawiera ponisz lini. Upewnij
si, e wstawie pojedyncze i podwjne znaki cytowania i
.I musi
to by
.I absolutna
cieka. \fB#\fP\fIYOUR_USERNAME\fP nie jest waciwie parametrem wymaganym
przez procmaila, a w rzeczywistoci procmail nawet go nie ujrzy; jest to
jednak niezbdny fortel przeciw nadoptymalizujcym programom sendmail:
.PP
.na
.nf
"\h'-\w' 'u' |IFS=' '&&exec /usr/local/bin/procmail -f-\h'-\w' 'u' |\h'-\w' 'u' |exit 75 \fB#\fP\fIYOUR_USERNAME\fP"
.fi
.ad
.PP
Procmail moe by te wywoywany do przetworzenia ju wypenionej skrzynki
systemowej. Moe to by uyteczne jeli nie chcesz lub nie moesz uywa
pliku $HOME/.forward (wwczas mona by wywoywa poniszy skrypt albo
periodycznie z 
.BR crona (1)
albo kadorazowo gdy zaczynasz czyta poczt):
.Sx 17
#!/bin/sh

ORGMAIL=/var/spool/mail/$LOGNAME

if cd $HOME &&
 test \-s $ORGMAIL &&
 lockfile \-r0 \-l3600 .newmail.lock 2>/dev/null
then
  trap "rm \-f .newmail.lock" 1 2 3 15
  umask 077
  lockfile \-l3600 \-ml
  cat $ORGMAIL >>.newmail &&
   cat /dev/null >$ORGMAIL
  lockfile \-mu
  formail \-s procmail <.newmail &&
   rm \-f .newmail
  rm \-f .newmail.lock
fi
exit 0
.Ex
.ne 14
.SS "Przykadowy may $HOME/.procmailrc:"
.na
.nf
PATH=/bin:/usr/bin:/usr/bin
MAILDIR=$HOME/Mail      #upewnij si, e istnieje
DEFAULT=$MAILDIR/mbox   #kompletnie opcjonalne
LOGFILE=$MAILDIR/from   #zalecane

:0:
* ^From.*berg
from_me

:0
* ^Subject:.*Flame
/dev/null
.fi
.ad
.PP
Inne przykady regu plikw rc mona obejrze na stronie
.BR procmailex (5).
.Sh RDO
Program ten jest czci pakietu
.I procmail mail-processing-package
(v3.10 1994/10/31) dostpnego w najbliszym archiwum
USENET comp.sources.misc lub na ftp ftp.informatik.rwth-aachen.de jako
.BR pub/packages/procmail/procmail.tar.gz .
.Sh LISTA DYSKUSYJNA
Istnieje lista dyskusyjna dla pyta zwizanych z programami pakietu
procmail:
.RS
procmail@informatik.rwth-aachen.de
.RS
do wysyania pyta/odpowiedzi.
.RE
procmail-request@informatik.rwth-aachen.de
.RS
do zadania zapisania si.
.RE
.RE
.Sh AUTOR
Stephen R. van den Berg z RWTH-Aachen, Germany
.Rs
berg@pool.informatik.rwth-aachen.de
.\" @MY_ALT_MAIL_ADDR@
.Re
.\".if n .pl -(\n(.tu-1i)