4. Arquivos de controle/configuração

4.1. badmailfrom

Listagem de remetentes que serão proibidos de enviar e-mails para este servidor ou para servidores remotos.

Ex:

null@spammer.com

@spammers.com

Utilizado por: qmail-smtpd.

4.2. bouncefrom

Define o nome de usuário (sender) que será utilizado em mensagens de erro que serão retornadas aos seus respectivos recipientes.

Este usuário não representa um usuário local do sistema.

Padrão: MAILER-DAEMON.

Utilizado por: qmail-send.

4.3. bouncehost

Define o nome de host que será utilizado em mensagens de erro que serão retornadas aos seus respectivos recipientes.

Se a mensagem não puder ser entregue permanentemente, qmail-send envia uma única mensagem de bounce para o sender.

O sender terá o formato bouncefrom@bouncehost, caso contrário será vazio.

Padrão: me.

Utilizado por: qmail-send.

4.4. concurrencylocal

Define o número máximo de entregas locais simultâneas que o qmail pode gerenciar.

Padrão: 10 - podendo se estender a 120 (limite máximo definido na compilação do qmail). Se for 0 (zero), as entregas locais serão colocadas em espera.

Utilizado por: qmail-send.

4.5. concurrencyremote

Define o número máximo de entregas remotas simultâneas que o qmail pode gerenciar.

Padrão: 20 - podendo se estender a 120. (limite máximo definido na compilação do qmail). Se for 0 (zero), as entregas remotas serão colocadas em espera.

Utilizado por: qmail-send.

4.6. databytes

Define o tamanho máximo em bytes que um e-mail pode ter ou 0 (zero) para sem limite. Para definir o tamanho máximo de e-mails em 10MB, utilize:

10485760

Se a mensagem exceder este limite, qmail-smtpd retorna um código de erro permanente ao cliente.

Se o disco local estiver cheio ou qmail-smtpd alcançar um limite de recursos, qmail-smtpd retorna um código de erro temporário ao cliente.

Padrão: 0.

Utilizado por: qmail-smtpd.

4.7. defaultdomain

Domínio padrão que será utilizado em endereços de e-mail que não possuam a forma usuario@nomedohost.dominio.

Por padrão, qmail-inject adiciona o conteúdo de defaultdomain a qualquer nome de host que não possua o domínio; também válido para defaulthost.

Exceções: veja plusdomain.

Padrão: me.

Utilizado por: qmail-inject.

4.8. defaulthost

Nome de host padrão que será utilizado em endereços de e-mail que não possuam a forma usuario@nomedohost.dominio.

Por padrão, qmail-inject adiciona o conteúdo de defaulthost a qualquer endereço de e-mail que não possua o nome do host.

defaulthost não precisa ser o nome corrente do servidor.

Padrão: me.

Utilizado por: qmail-inject.

4.9. doublebouncehost

Especifica o nome de host que será utilizado no sender de mensagens de erro que foram enviadas e retornaram com erro.

Padrão: me.

Utilizado por: qmail-send.

4.10. doublebounceto

Especifica o nome de usuário que será utilizado para receber mensagens de erro que foram enviadas e retornaram com erro.

qmail-send envia mensagens desse tipo para doublebounceto@doublebouncehosts; se a mensagem retornar com erro, qmail exclui a mensagem.

Padrão: postmaster.

Utilizado por: qmail-send.

4.11. envnoathost

Define o domínio padrão a ser utilizado para recipientes que não possuirem “@” em seu endereço de e-mail.

Se qmail-send encontrar um recipiente sem “@” em seu endereço de e-mail, adiciona @envnoathost ao endereço de e-mail.

Padrão: me.

Utilizado por: qmail-send.

4.12. helohost

Nome corrente do host, para ser utilizado por qmail-remote em sessões SMTP somente para identificar-se ao servidor remoto.

Padrão: me.

Utilizado por: qmail-remote.

4.13. idhost

Nome do host que será utilizado no cabeçalho Message-ID em e-mails.

idhost não precisa ser o nome corrente do servidor.

Padrão: me.

Utilizado por: qmail-inject.

4.14. localiphost

Altera o nome da máquina associado ao IP local.

qmail-smtpd é responsável por detectar endereços IP no formato a.b.c.d. Quando qmail-smtpd detecta um endereço de e-mail no formato box@[a.b.c.d] aonde [a.b.c.d] é um endereço IP local, altera pelo conteúdo de localiphost.

Isso é feito antes do processamento de rcpthosts.

Ex:

qmailserver.domain.net

Padrão: me.

Utilizado por: qmail-smtpd.

4.15. locals

Lista de domínios considerados locais pelo qmail, um por linha.

O e-mail usuario@dominio.com será considerado local se dominio.com estiver listado em locals.

Padrão: me.

Utilizado por: qmail-send.

4.16. me

Especifica o nome do host do servidor de e-mail local.

É o arquivo de controle mais importante do qmail, pois seu conteúdo é utilizado como padrão por muitos outros arquivos, caso não estejam presentes. Sem este arquivo o qmail não funciona.

Utilizado por: qmail-send.

4.17. morercpthosts

Listagem de hosts e domínios adicionais que o qmail reconhecerá como locais e aceitará mensagens para seus destinatários.

Utilizando qmail-newmrh, será gerado um arquivo base de dados no formato binário (control/morercpthosts.cdb), que será utilizado por qmail-smtpd para consultas mais rápidas e eficientes. É necessário executar qmail-newmrh toda vez que o conteúdo do arquivo morercpthosts for alterado, para que as alterações sejam efetivadas.

Dica para grande quantidade de domínios: mantenha os 50 domínios mais acessados no arquivo rcpthosts e o restante em morercpthosts

Utilizado por: qmail-smtpd.

4.18. percenthack

Especifica a lista de domínios aonde será checado a presença de “%” (sinal de percentagem) no nome do usuário.

Nomes de usuários do tipo usuario%empresa.com@dominio.com serão convertidos para usuario@empresa.com.

qmail-send processa percenthack antes de locals.

Utilizado por: qmail-send.

4.19. plusdomain

Extensão que qmail-inject adicionará ao final de domínios que terminam com o sinal “+” (adição); também válido para defaulthost, se este terminar com um sinal “+”.

Se o nome do host não possuir a forma nomedohost.dominio mas terminar com o sinal “+”, qmail-inject utilizará plusdomain e não defaultdomain.

Ex:

com.br

Padrão: me.

Utilizado por: qmail-inject.

4.20. qmqpservers

Especifica os endereços de servidores QMQP que serão utilizados pelo programa qmail-qmqpc.

Utilizado por: qmail-qmqpc.

4.21. queuelifetime

Define o número máximo em segundos que uma mensagem pode ficar na fila do qmail.

Depois desse tempo, qmail-send tentará entregar a mensagem mais uma vez e tratará qualquer outro erro, como um erro permanente.

Padrão: 604800 (uma semana).

Utilizado por: qmail-send.

4.22. rcpthosts

Listagem de hosts e domínios que serão reconhecidos pelo qmail como locais e serão aceitas mensagens para seus recipientes. Caso não exista, qmail-smtpd aceitará e-mails para qualquer host ou domínio.

A documentação do qmail recomenda adicionar não mais que 50 hosts ou domínios em rcpthosts.

Domínios adicionais devem ser adicionados em morercpthosts.

Exceção: Se a variável de ambiente $RELAYCLIENT estiver setada, qmail-smtpd ignora rcpthosts e adiciona o conteúdo de $RELAYCLIENT ao endereço do recipiente.

Ex:

qmailserver.domain.net

domain.com.br

Utilizado por: qmail-smtpd.

4.23. smtpgreeting

Especifica a mensagem de boas vindas que será exibida no banner apresentado por qmail-smtpd.

Padrão: me.

Utilizado por: qmail-smtpd.

4.24. smtproutes

Especifica rotas SMTP estáticas para entrega de e-mails em hosts remotos.

Cada linha deve possuir o formato:

dominio:servidor-remoto

ou

dominio:servidor-remoto:porta-tcp

Ex:

dominio.com:[172.11.10.12]

dominio.net:smtp2.dominio.net

dominio.org:mail.dominio.org:26

Aonde, todos e-mails enviados para dominio.com serão entregues no host 172.11.10.12, e-mails enviados para dominio.net serão entregues no host smtp2.dominio.net e e-mails enviados para dominio.org serão entregues no host mail.dominio.org na porta 26/TCP.

qmail-remote não tentará obter a entrada MX ou A via DNS para dominio.com, dominio.net e dominio.org.

Se servidor-remoto não for especificado, qmail-remote atuará de forma padrão, tentando obter a entrada MX para dominio através de DNS.

Ex:

.co.uk:

:master.co.uk

Aonde, mensagens enviadas para domínios que terminam em “.co.uk” (mas não para co.uk) serão roteados através de sua entrada MX; qualquer outro endereço será roteado artificialmente para o host master.co.uk.

Utilizado por: qmail-remote.

4.25. timeoutconnect

Define o número máximo em segundos que qmail-remote aguardará o servidor SMTP remoto aceitar a conexão SMTP antes de desconectar.

Padrão: 60 segundos.

Utilizado por: qmail-remote.

4.26. timeoutremote

Define o número máximo de segundos que qmail-remote aguardará por uma resposta do servidor SMTP remoto (depois da conexão ser aceita) antes de desconectar.

Padrão: 1200 segundos (20 minutos).

Utilizado por: qmail-remote.

4.27. timeoutsmtpd

Especifica o número máximo em segundos que qmail-smtpd irá aguardar para receber dados do cliente SMTP remoto.

Se nenhum dado for recebido por qmail-smtpd ao término de timeoutsmtpd, a conexão SMTP remota será terminada.

Padrão: 1200 segundos (20 minutos).

Utilizado por: qmail-smtpd.

4.28. virtualdomains

Lista de usuários ou domínios que serão tratados pelo qmail como virtuais.

Um usuário virtual possui a forma usuario@dominio.com:prepend.

Quando qmail-send receber um e-mail para usuario@dominio, converterá para prepend-usuario@dominio e aceitará este usuário como local.

Domínios virtuais possuem a forma dominio.com:prepend, que será convertido para prepend-dominio.com para todos os usuário deste domínio.

É permitido a utilização de curingas.

Ex:

.dominio.com:telles

:alias-pegatudo

Aonde, mensagens enviadas para qualquer usuário do domínio dominio.com serão processadas como telles-usuario@dominio.com e alias-pegatudo receberá todas as outras mensagens que não possuirem como destinatário um usuário do domínio dominio.com.

Exceção: O domínio não será tratado como virtual se o prepend for vazio.

qmail-send processa virtualdomains depois de locals; se o domínio estiver listado em locals, não será checado em virtualdomains.

Utilizado por: qmail-send.