FreeBSD Primeiros Passos

Um guia para os iniciantes no mundo do FreeBSD Introdução ao uso do procmail.

procmail

Instalando o procmail

O procmail esta disponivel no ports, em /usr/ports/mail/procmail, antes de instalar sugiro que voce faça um CVSUP do seu ports para garantir que vai instalar a ultima versão disponivel. Feito o cvsup, execute os passos abaixo para instalar:
```
# cd /usr/ports/mail/procmail
# make clean
# make install
```
Agora que instalamos o procmail vamos a configuração.

A titulo de informação o client de e-mail que eu utilizo é pine.

Criação e configuração do ~/.procmailrc

Este arquivo é lido todas as vezes que o procmail é executado, é neste arquivo que definimos os criterios de seleção e separação a serem usados. Vejamos um exemplo bem simples:

# .procmailrc de exemplo v. 1.0
#########################################################
#                     Variaveis                         #
#########################################################

# Define o path nos quais o procmail vai procurar por outros
# programas.
PATH=/bin:/usr/bin:/usr/local/bin:

# Define o diretorio onde o procmail vai armazenar suas mensagens.
MAILDIR=$HOME/mail

# Define o mailbox padrão no qual serão armazenados os e-mails
# que nao derem se enquadrarem em nenhuma das regras.
DEFAULT=$HOME/mail/Entrada

# Define o arquivo de log do procmail. No exemplo abaixo
# os logs serão gerados no formato log.20010617
LOGFILE=$MAILDIR/log.`date "+%Y%m%d"`

# Define o shell sob o qual o procmail ira executar programas
# extrenos.
SHELL=/bin/sh

#########################################################
#                     Filtros                           #
#########################################################

# Coloca as mensagens que trouxerem no campos From ou Cc ou To 
# do cabeçalho a string fugspbr(da lista FUGSPBR) no mailbox Fugspbr.
:0:
* ^(From|Cc|To).*fugspbr
Fugspbr

# Fim

No arquivo acima todas as linhas iniciadas por # são ignoradas.
No exemplo acima podemos ver claramente que ele se divide em duas partes, na primeira sao definidas uma serie de variaveis, comentadas no proprio arquivo.
Na segunda temos os filtros propiamente ditos, e abaixo vamos ver mais detalhes de como construi-los.

Regras

A sintaxe de uma regra do procmail pode ser vista abaixo:

:0 flags: LockfileName  
* condição 1
* condição 2
ação

As flags possiveis são:

H	Egrep no cabeçalho da mensagem (default).
B	Egrep no corpo da mensagem
D	Seta o egrep para o modo "case sensitive"
A	A regra nao será executada a menos que a regra anterior (sem uma flag A ou a) tenha sido executada
a	A regra nao sera executada a menos que a regra imediatamente anterior tenha sido executada com sucesso
E	A regra so será executada se a regra imediatamente anteriror nao tiver sido executada.
e	A regra so será executada se a regra imediatamente anterior nao tiver sido executada com sucesso.
h	Envia o cabeçalho da mensagem para um pipe, arquivo ou e-mail. (default)
b	Envia o corpo da mensagem para um pipe, arquivo ou e-mail. (default)
f	Considera o pipe como um filtro.
c	Gera uma copia do e-mail.
w	Aguarda pelo exitcode de um filtro ou programa, se a execução dos mesmos falhar então a mensagem não sera filtrada.
W	O mesmo que w, porém suprimindo a mensagem de erro.
i	Ignora qualquer erro de gravaçao.
r	Raw Mode.

Se voce adicionar um segundo ":" no final da primeira linha de uma regra, o procmail irá utilizar um localockfile. Recomendo utilizar sempre, para evitar corromper sua caixa postal.

Expressões regulares

Para construir as regras do procmail voce tera que utilizar expressões regulares, mas não se assute o conceito é bem simples de ser compreendido :-)

Metacharacter	Função
.	Qualquer caracter
(string)	Trata a string como um item unico
*	Zero ou mais items anteriores
?	Zero ou um item anterior
+	Um ou mais itens anteriores
^	Começo de uma linha
$	Final de uma linha
[lista de caracteres]	Qualquer um dos caracteres da lista
[^lista de caracteres]	Qualquer caracteres que nao conste da lista
\	A palavra string
\|	ou

Vejamos alguns exemplos...

No procmail as expressões regulares são "case insensitive" por default, logo a expressão:

Edson

será atendida por "edson", "Edson", "EdSoN", "edsoN", etc.

Um ponto "." significa qualquer caracter, com excessão de uma nova linha, logo a expressão:

.son Brandi

será atendida por "Edson Brandi", "Wilson Brandi", "Nelson Brandi", etc.

Qualquer regra que traga um caracter seguido de "*" será atendida quando o caracter anterior ao * se repetir 0 ou mais vezes, logo a expressão:

Edson* Brandi

será atendida por "Edso Brandi", "Edson Brandi", "Edsonnnnn Brandi", etc.

Os modificadores "+" e "?" trabalham de forma parecida. A expressão "a+" será atendida por um ou mais a's. A expressão "a?" será atendida por 0 ou 1 a.

Voce pode usar parenteses para agrupar um ou mais expressões para usar com um modificador, por exemplo a expressão:

Ed(son)+

será atendida por "Edson" , "Edsonson", "Edsonsonson", etc

Voce pode usar colchetes para definir expressões usando classes de elementos, por exemplo a expressão:

Capitulo [1234]

será atendida por "Capitulo 1", "Capitulo 2", "Capitulo 3", "Capitulo 4".

Se o primeiro elemento de uma classe for "^", a expressão será atendida quando nao ocorrem nenhum dos elementos da classe, por exemplo a expressão:

[^0123456789]+

será atendida por qualquer serie de um ou mais letras, que nao incluam um numero.

Voce pode tambem utilizar operadores nas suas expressões, por exemplo o operador "|" significa ou, por exemplo a regra:

(Paulo|Jose)

Será atendida por "Paulo" ou "Jose".

Existem tambem varios caracteres especiais, por exemplo "^" significa "linha começando por", e "$" significa "linha terminada por", por exemplo a expressão:

^From

Será atendida por qualquer linha que comece com a palavra "From".

Mas chega de expressões regulares, eu poderia escrever sobre isso por varias paginas e não cobriria todo o assunto, que por si sóo merece um outro tutorial. Para conhecer melhor o uso de expressões regulares eu sugiro que voce leia o man do egrep e do procmail :-) , por hora o que vimos aqui ja da começar a escrever algumas regras.

Exemplos de regras

# A regra abaixo cria uma copia de cada mensagem recebida na caixa postal
# backup
:0c:
backup

# Envia todas as mensagens enviadas pela lista do fugspbr sobre 
# Sendmail para edson@primeirospassos.org e guarda uma copia 
# local no mailbox Sendmail.
# Veja que como estamos aplicando duas regras a uma mesma msg 
# foi necessario duplica-la com a flag "c".
:0
* ^From.*fugspbr
* ^Subject:.*sendmail
{
	:0 c
	! edson@primeirospassos.org

	:0:
        Sendmail
}

# Redireciona todos os e-mails com menos de 5 Kb para 
# ebrandi@fugspbr.org
:0
* < 5000
! ebrandi@fugspbr.org

# Guarda as mensagens enviadas pelo postmaster ou pelo
# Mailer-Daemon para o mailbox postmaster.
:0:
* ^FROM_MAILER
postmaster

# Se vc assina varias listas de discussão sobre o mesmo assunto
# pode vir a receber mensagens duplicadas, postadas por uma mesma pessoa
# para as varias listas. A regra abaixo se baseia nos Message-IDs
# das mensagens mais recentes que voce recebeu e irá redirecionar 
# as msgs duplicadas para o mailbox Duplicadas
:0 Whc: msgid.lock
| formail -D 8192 msgid.cache

:0 a:
Duplicadas

# Se voce utiliza pgp ou gpg, a regra abaixo permite enviar 
# automaticamente a sua chave publica para quem lhe enviar um
# email com o subject "enviar chave pgp".
# Observe que o envio so ocorrera se o campo From não trouxer o 
# meu nome, se o subject nao contiver Re: e se o e-mail nao tiver sido 
# enviado por um mailer daemon.
:0
* !^From +Edson Brandi
* !^Subject:.*Re:
* !^FROM_DAEMON
* ^Subject:.*enviar chave pgp
| (formail -r ; cat ebrandi.asc ) | $SENDMAIL -oi -t

# A regra abaixo me permite descartar os e-mails de alguem que eu nao gosto
:0
* ^From.*pessoa_mala@algumlugar.com.br
/dev/null

# A regra abaixo procura as palavras virus, dinheiro, money, grana
# no corpo da mensagem, se alguma delas for encontrada a mensagem é
# descartada
:0 B:
* (virus|dinheiro|money|grana)
/dev/null

Voce pode aprender mais sobre como escrever suas regras lendo as man pages dos programas procmail, procmailrc, procmailsc, procmailex, formail.

Habilitando o procmail

Se apenas voce irá utilizar o procmail a maneira mais facil de se habilitar o uso do procmail é atraves da criação de um ~/.foward com a seguinte linha:
```
"|IFS=' '&&exec /usr/local/bin/procmail -f-||exit 75 seu_login"
```
O arquivo deve ser setado com permissão 755, e observe que as aspas são necessarias

Porém se voce quiser disponibilizar o procmail para todas as contas do seu servidor, ou mesmo utilizar alguma regra para barrar arquivos .exe, .com, etc , será necessario habilitar o procmail diretamente no sendmail. para isso substitua no seu /etc/mail/sendmail.cf as linhas:
```
Mlocal,         P=/usr/libexec/mail.local, F=lsDFMAw5:/|@qPSXfmnz9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL,
                T=DNS/RFC822/SMTP,
                A=mail.local -l
```
pelas seguintes:
```
Mlocal,         P=/usr/local/bin/procmail, F=lsDFMAw5:/|@qPSXfmnz9, S=EnvFromL/HdrFromL, R=EnvToL/HdrToL,
                T=DNS/RFC822/SMTP,
                A=procmail -Y -a $h -d $u
```
E restarte o seu sendmail. Agora o procmail sera o agente default de entrega de e-mails, quando chegar um e-mail o procmail sera executado e se existir um .procmailrc no home do usuario ele ira efetuar a filtragem, do contrario a mensagem sera entrega como se vc estivesse usando o mail.local.

Observação:

O procmail trata apenas uma mensagem de cada vez, se voce tiver uma caixa postal antiga que queira submeter as regras do seu procmail voce devera executar:
```
# formail -s procmail < sua_caixa_postal
```
Boa sorte!
Edson

Se você possui alguma critica , duvida ou sugestão ,entre em contato pelo e-mail: edson.brandi@uol.com.br