This is an old revision of the document!
Como configurar o arquivo .qmail
Explicação sobre o que é o .qmail
Quando chega uma mensagem (e-mail) para um usuário, o sistema procura um arquivo chamado .qmail no diretório HOME do usuário, onde cada linha desse arquivo é usada pelo sistema como uma instrução sobre o que fazer com essa mensagem (e-mail).
SE não existir arquivo .qmail, a mensagem é entregue num arquivo chamado Mailbox, onde ficarão acumuladas todas as mensagens recebidas.
Como criar e configurar o .qmail
O .qmail é um arquivo texto, e pode ser editado com qualquer editor de texto (emacs, vi, textedit, pico, nano, etc.). Se ele não existe, você pode criá-lo como costuma fazer com arquivos comuns.
Instruções no .qmail
Cada linha do .qmail é vista como uma instrução. A linha não tem limite de comprimento e não pode ser continuada, ao contrário de arquivos contendo scripts. O sistema seguirá essas instruções em seqüência e caso haja várias instruções de entrega, a mensagem será entregue várias vezes.
Instruções de entrega direta
Quando existe um arquivo .qmail, uma mensagem só é entregue se houver uma instrução de entrega. Existem duas formas de entrega direta:
Arquivo
Cada mensagem será adicionada a esse arquivo, e o formato de armazemamento é o mbox (para mais informações sobre esse formato, digite man mbox em uma linha de comando).Esse arquivo pode ser lido por qualquer programa leitor de mail. O formato da linha:
caminho-do-arquivo/nome-do-arquivo
Essa linha NÃO deve terminar com o caracter barra (”/”) e nome-do-arquivo é o arquivo do tipo mbox que conterá as mensagens, caso ele não exista o qmail irá criá-lo assim que uma mensagem chegar. O uso mais comum é um arquivo chamado Mailbox, no diretório HOME do usuário. A linha correspondente é:
./Mailbox
Cuidado: se no .qmail aparecerem 284 linhas ./Mailbox, cada mensagem será entregue 284 vezes nessa caixa de correio.
Diretório
Cada mensagem será gravada em um arquivo separado dentro desse diretório. Esse diretório deverá tem o formato maildir (para mais informações sobre esse formato, digite man maildir em uma linha de comando) , que deverá ser criado usando o comando: maildirmake nome-do-diretório . Esse diretório pode ser lido por programas como por exemplo o pinq. O formato dessa linha deve ser:
caminho-do-diretório/nome-do-diretório/
Essa linha deve terminar com o caracter barra (”/”).O comando usepop3 cria um diretório com o formato maildir chamado Maildir dentro do HOME do usuário e também cria o arquivo .qmail para salvar as mensagens nesse diretório
Instruções de redirecionamento
Isto é simplesmente um endereço (completo) de e-mail. O efeito é mandar uma cópia de cada mensagem para esse endereço.O formato dessa linha deve ser:
nome@dominio
Envio para programas
Uma linha que começa com o caractere | diz para enviar cada mensagem para um programa; mais especificamente, o que segue o | é interpretado como uma linha do shell, com a mensagem na entrada padrão. Para aprender a usar isso com detalhes, digite man qmail-command em uma linha de comando. O formato da linha deve ser:
|caminho-do-programa/nome-do-programa
Abaixo seguem algumas linhas bastante populares:
./Mailbox
Envia os e-mails para o arquivo Mailbox que está no diretório HOME do usuário.
./Maildir/
Envia os e-mails para o diretório Maildir que está no diretório HOME do usuário. Essa linha é necessária para pegar os e-mails usando o protocolo POP (o Thunderbird é um exemplo de programa para ler e-mails que usa esse protocolo), e também para acessar os e-mails pelo webmail.
minhacasa@saopaulo.com.br
Envia os e-mails para o endereço minhacasa@saopaulo.com.br.
| ./scripts/mailfilter
Executa o script mailfilter que está no diretório scripts dentro do HOME do usuário.
Cuidados e observações:
- Lembre, para cada linha do arquivo .qmail será gerada uma cópia do e-mail.
- Se o primeiro caractere da linha for um # , a linha é ignorada.
- A primeira linha não pode estar em branco.
- O .qmail não pode ter permissão de execução