Rodrigo Pereira Telles Devel-IT

telles (at) devel (dot) it

2005 por Rodrigo P. Telles. 2005-06-07 1.0 2005-06-01 rpt Release qmail é um seguro, confiável, eficiente e simples agente de transferência de mensagens (MTA – Mail Transfer Agent). Foi desenhado para efetuar conexões pela internet entre servidores SMTP. Hoje, é o segundo servidor SMTP mais comumente encontrado na internet e é de longe, o servidor SMTP que mais cresce na internet. Este guia foi escrito com o intuito de auxiliar os iniciantes em qmail bem como os já experientes administradores de sistema a aproveitar ao máximo todos os recursos deste fantástico MTA.

mailsubj assunto recipiente1 recipiente2 ... Recebe o corpo da mensagem via STDIN (entrada padrão), insere assunto como subject da mensagem e envia para recipiente1 e recipiente2. Ex: $ cat /etc/hosts | /var/qmail/bin/mailsubj "Somente teste." foo@bar.org nospam@blackhole.org

Remove da fila de e-mail, e-mails que não foram enviados por motivo de erro. Geralmente o e-mail é removido por motivo de tempo esgotado na tentativa de enviá-lo N vezes, e indisponibilidade da caixa de correio do remetente que o gerou.

qmail-inject [ -nNaAhH ] [ -f sender ] [ recipiente1 recipiente2 ... ] Recebe mensagens via STDIN (entrada padrão), adiciona informações no cabeçalho da mensagem, e invoca o programa qmail-queue para enviar a mensagem para hum ou mais recipientes. qmail-inject normalmente sai com código de erro 0 (zero). Se invocado incorretamente ou caso a mensagem tenha sérios problemas de syntaxe, sai com código de erro 100. Em caso de erros temporários, sai com código de erro 111. Geralmente o programa qmail-inject é utilizado por clientes de e-mail que não suportam o protocolo SMTP para envio de e-mails, e é o substituto direto do programa sendmail. Opções Descrição -n Imprime a mensagem recebida via STDIN (entrada padrão) em STDOUT (saída padrão) ao invés de repassá-la ao programa qmail-queue. -N Repassa a mensagem recebida via STDIN para qmail-queue (Padrão). -a Envia a mensagem recebida via STDIN para todos os endereços de recipientes especificados via linha de comando. Ignora recipientes contidos no cabeçalho da mensagem. -A Envia a mensagem recebida via STDIN para todos os recipientes especificados via linha de comando. Se nenhum endereço de recipiente for especificado via linha comando, utilizará os endereços de recipientes contidos no cabeçalho da mensagem (Padrão). -h Envia a mensagem recebida via STDIN para todos os endereços de recipientes contidos no cabeçalho da mensagem. Para mensagens que não são forwards, significa que serão utilizados os endereços de e-mail contidos nos campos To, Cc, Bcc e Apparently-To do cabeçalho da mensagem. Para mensagens que são forwards, serão utilizados os endereços de e-mail contidos nos campos Resent-To, Resent-Cc e Resent-Bcc do cabeçalho da mensagem. Ignora recipientes especificados via linha de comando. -H Envia a mensagem recebida via STDIN para todos os endereços de e-mail contidos no cabeçalho da mensagem e todos os recipientes especificados via linha de comando. -f sender Repassa a mensagem recebida via STDIN para o programa qmail-queue substituindo o endereço de sender da mensagem por sender. Substitui também o conteúdo do campo Return-Path do cabeçalho da mensagem e variáveis de ambiente por sender. recipiente1 Endereço de e-mail do primeiro recipiente. recipiente2 Endereço de e-mail do segundo recipiente.

qmail-local [ -nN ] usuário diretório-home local traço extensão domínio sender defaultdelivery Entrega ou encaminha e-mails para contas locais. Executa tarefas muito importantes como, detectar se o e-mail está em loop - quando já possui “Delivered-To” entre os cabeçalhos do e-mail, denunciando que o e-mail já foi entregue 1 (uma) vez para este destinatário. O recipiente da mensagem será local@domínio. qmail-local criará um novo cabeçalho “Delivered-To” na mensagem contendo local@domínio. Caso o cabeçalho “Delivered-To: local@domain” já exista na mensagem, qmail-local devolve a mensagem, identificando-a como em loop de entrega. O sender da mensagem será sender, e qmail-local criará um novo cabeçalho “Return-Path” contendo sender. diretório-home é o diretório $HOME de usuário. traço e extensão identificarão qual arquivo .qmailtraçoextensão será utilizado por qmail-local no momento da entrega, seguido das instruções contidas em defaultdelivery a serem executadas, caso o arquivo não exista. Se a entrega da mensagem for executada com sucesso, qmail-local sai com código de erro 0 (zero). Se a entrega falhar temporariamente, sai com código de erro 111. Se a entrega da mensagem falhar permanentemente, qmail-local sai com código de erro diferente de 0 (zero). Opções Descrição -n Ao invés de ler e entregar a mensagem, imprime em tela a descrição das instruções de entrega. -N Lê e entrega a mensagem (Padrão).

qmail-lspawn defaultdelivery Invocado pelo programa qmail-send, qmail-lspawn lê uma série de comandos via descriptor 0 (zero), invoca o programa qmail-local para a entrega da mensagem e imprime as mensagens de resultado no descriptor 1. defaultdelivery é passado ao programa qmail-local como instrução padrão de entrega da mensagem. qmail-lspawn invoca qmail-local de forma assíncrona, sendo assim, as mensagens de resultado podem não retornar na mesma ordem que os comandos. Antes de invocar qmai-local, qmail-lspawn verifica se o endereço do recipiente não está listado no mecanismo qmail-users, se o endereço não estiver listado, invoca o programa qmail-getpw. qmail-lspawn ignora endereços de recipientes em branco.

qmail-pop3d maildirname Permite ao usuário ler ou remover mensagens em sua caixa de e-mail no servidor POP3. Suporta apenas formato de caixa de e-mail do tipo Maildir – cada e-mail é um arquivo dentro da caixa de e-mail – e geralmente utiliza a porta 110/TCP. qmail-pop3d é geralmente invocado pelo programa qmail-popup, que é responsável por receber informações de usuário e senha. maildirname indica o nome do diretório a ser utilizado por qmail-pop3d na manipulação de mensagens dentro do diretório $HOME de cada usuário. qmail-pop3d possui timeout de inatividade de 20 minutos. qmail-pop3d suporta os comandos UIDL, TOP e LAST. qmail-pop3d adiciona uma linha em branco extra a cada mensagem para corrigir alguns bugs sérios em certos clientes de e-mail. qmail-pop3d é baseado em um programa contribuído por Russ Nelson.

qmail-popup nome-do-host subprograma Valida usuário e senha dos clientes remotos e executa subprograma. Suporta usuário e senha em texto plano (sem encriptação) e método de autenticação encriptada (APOP). Geralmente qmail-pop3d é utilizado como subprograma e nome-do-host é utilizado em conexões APOP como uma derivação do timestamp de conexão. qmail-popup possui timeout de inatividade de 20 minutos. qmail-popup é baseado em um programa contribuído por Russ Nelson.

Comunica-se com um servidor QMQP (qmail-qmqpd) remoto e o repassa todos os e-mails recebidos. qmail-qmqpc substitui qmail-queue (via link simbólico) para entregar as mensagens recebidas ao servidor QMQP.

Recebe conexões do tipo QMQP de clientes qmail-qmqpc remotos. Uma vez que a conexão é aceita, a mensagem é entregue diretamente ao programa qmail-queue. Geralmente utiliza a porta 628/TCP. Basicamente, QMQP é utilizado para enviar mensagens de um servidor qmail a outro servidor qmail de forma rápida e segura. NOTA: QMQP (Quick Mail Queuing Protocol) é um protocolo desenvolvido por Daniel J. Bernstein e só pode ser utilizado entre 2 (dois) servidores qmail.

Recebe conexões do tipo QMTP de clientes remotos. Uma vez que a conexão é aceita, a mensagem é entregue diretamente ao programa qmail-queue. Geralmente utiliza a porta 209/TCP. qmail-qmtpd suporta os mecanimos rcpthosts, morercpthosts, RELAYCLIENTS, databytes e DATABYTES. NOTA: QMTP (Quick Mail Transfer Protocol) é um protocolo desenvolvido por Daniel J. Bernstein e tem o intuito de ser um substituto ao protocolo SMTP.

Injeta mensagens na fila de e-mail para serem processadas futuramente por qmail-send. É invocado pelos programas qmail-inject, qmail-smtpd, qmail-qmtpd e qmail-qmqpd. Todo o processamento de e-mails passa por qmail-queue, tornando-o o coração do qmail. qmail-queue sempre adiciona uma linha Received no início do cabeçalho da mensagem. qmail-queue impõe algumas regras na estrutura da fila de e-mails: cada subdiretório mess precisa estar localizado no mesmo sistema de arquivos que o diretório pid; cada subdiretório todo precisa estar localizado no mesmo sistema de arquivos que o diretório intd. qmail-queue não imprime diagnósticos em tela. Sai com código de erro 0 (zero) caso a mensagem tenha sido injetada com sucesso na fila de e-mails, e sai com código de erro entre 1 e 99 caso tenha ocorrido falha no momento de injetar a mensagem na fila. Todos os códigos entre 11 e 40 indicam erros permanentes. Código Descrição 11 Endereço de e-mail muito longo. 31 O servidor de e-mail está recusando permanentemente a enviar mensagens para qualquer recipiente. (Não utilizado por qmail-queue, mas utilizado por programas que utilizam a mesma estrutura). Todos os demais códigos indicam erros temporários. Código Descrição 51 Estouro de memória. 52 Tempo esgotado. 53 Erro de escrita (Ex: disco cheio). 54 Não foi possível ler a mensagem ou os cabeçalhos de entrega. 55 Não foi possível ler os arquivos de configuração (Não utilizado por qmail-queue). 56 Problemas ao tentar fazer uma conexão de rede a partir do host local (Não utilizado por qmail-queue). 61 Problemas com o diretório home do qmail. 62 Problemas com o diretório da fila de e-mail. 63 Problemas ao criar a estrutura queue/pid. 64 Problemas ao criar a estrutura queue/mess. 65 Problemas ao criar a estrutura queue/intd. 66 Problemas ao criar a estrutura queue/todo. 71 O servidor de e-mail está recusando temporariamente a enviar mensagens para qualquer recipiente. (Não utilizado por qmail-queue). 72 Tempo esgotado na conexão com o servidor de e-mail. (Não utilizado por qmail-queue). 73 Conexão com o servidor de e-mail foi rejeitada. (Não utilizado por qmail-queue). 74 Sucesso na conexão com o servidor de e-mail, mas a comunicação falhou. (Não utilizado por qmail-queue). 81 Bug interno. (Ex: falha de segmentação). 91 Erro no formato dos cabeçalhos de entrega. Cada mensagem na fila de e-mail possui o seu próprio contador de tempo, que indica ao qmail em que momento e quantas vezes ainda deve tentar entregar a mensagem antes de devolvê-la ao seu remetente. Este tempo não é configurável, e funciona como mostrado na tabela abaixo: Tentativa de Entrega Segundos Dias – HH:MM:SS 1 0 0 - 00:00:00 2 400 0 - 00:06:40 3 1600 0 - 00:26:40 4 3600 0 - 01:00:00 5 6400 0 - 01:46:40 6 10000 0 - 02:46:40 7 14400 0 - 04:00:00 8 19600 0 - 05:26:40 9 25600 0 - 07:06:40 10 32400 0 - 09:00:00 11 40000 0 - 11:06:40 12 48400 0 - 13:26:40 13 57600 0 - 16:00:00 14 67600 0 - 18:46:40 15 78400 0 - 21:46:40 16 90000 1 - 01:00:00 17 102400 1 - 04:26:40 18 115600 1 - 08:06:40 19 129600 1 - 12:00:00 20 144400 1 - 16:06:40 21 160000 1 - 20:26:40 22 176400 2 - 01:00:00 23 193600 2 - 05:46:40 24 211600 2 - 10:46:40 25 230400 2 - 16:00:00 26 250000 2 - 21:26:40 27 270400 3 - 03:06:40 28 291600 3 - 09:00:00 29 313600 3 - 15:06:40 30 336400 3 - 21:26:40 31 360000 4 - 04:00:00 32 384400 4 - 10:46:40 33 409600 4 - 17:46:40 34 435600 5 - 01:00:00 35 462400 5 - 08:26:40 36 490000 5 - 16:06:40 37 518400 6 - 00:00:00 38 547600 6 - 08:06:40 39 577600 6 - 16:26:40 40 608400 7 - 01:00:00 Mensagens ficam em fila, quando o qmail por algum motivo não pôde entregá-las pela primeira vez ou na tentativa anterior; tais mensagens recebem o nome de “deferred” (entrega falhou e foi adiada).

qmail-remote host-remoto sender recipiente [ recipiente1 recipiente2 ... ] Invocado pelo programa qmail-rspawn, qmail-remote recebe mensagens via entrada padrão (STDIN) e as entrega para recipientes localizados em servidores remotos, utilizando o protocolo SMTP. qmail-remote envia a mensagem para host-remoto ou para o host listado como entrada MX ou A na zona DNS de cada domínio. host-remoto deve ser um nome de DNS válido: presunto.black.hole.net ou o endereço IP do host entre colchetes: [172.18.73.19] O recipiente da mensagem será recipiente e opcionalmente recepiente1 e recepiente2. O sender da mensagem será sender. qmail-remote imprime uma série de flags de recipientes, seguido de um relatório da mensagem. Casa relatório inicia com uma única letra. qmail-remote sempre sai com código de erro 0 (zero). Flag Descrição r Relatório de recipiente: recipiente aceito. h Relatório de recipiente: recipiente permanentemente rejeitado. s Relatório de recipiente: recipiente temporariamente rejeitado. K Relatório de mensagem: sucesso na entrega. Host remoto tomou a responsabilidade de entregar a mensagem para cada recipiente aceito. Z Relatório de mensagem: falha temporária na entrega. D Relatório de mensagem: falha permanente na entrega. Depois das letras, qmail-remote imprime na tela o que ocorreu na tentativa de entrega da mensagem. Ex: $ cat /etc/hosts | /var/qmail/bin/qmail-remote foo.bar.net master@rrunner.net presunto@black-hole.net salsisha@black-hole.org master@rrunner.net presunto@black-hole.net salsisha@black-hole.org rrK172.18.73.19 accepted message. Remote host said: 250 ok 1079277646 qp 1337

Recebe uma série de comandos de entrega remota via descriptor 0, invoca qmail-remote para efetuar a entrega da mensagem e imprime os resultados no descriptor 1. qmail-rspawn é invocado por qmail-send, quando este classifica o e-mail como remoto, baseando-se no endereço de recipiente. qmail-rspawn invoca qmail-remote de forma assíncrona, sendo assim, as mensagens de resultado podem não retornar na mesma ordem que os comandos.

Entrega e-mails armazenados na fila de e-mail. Utiliza qmail-lspawn para entregar mensagens à recipientes locais e qmail-rspawn para entregar mensagens à recipientes remotos. Se a mensagem não pôde ser entregue temporariamente para 1 (hum) ou mais recipientes, qmail-send deixa a mensagem na fila e tenta entregá-la novamente mais tarde. qmail-send imprime registros legíveis de suas atividades no descriptor 0, escreve comandos para qmail-lspawn, qmail-rspawn e qmail-clean via descriptor 1 (hum), 3 (trêz) e 5 (cinco) e lê as respostas via descriptor 2 (dois), 4 (quatro) e 6 (seis). qmail-send é responsável por evitar situações que possam causar um “beco sem saída” (deadlock). Se qmail-send receber um sinal kill do tipo TERM , aguarda a finalização de todas as entregas de e-mail correntes antes de ser derrubado. Se qmail-send receber um sinal kill do tipo ALRM, reagenda a entrega imediata de todas as mensagens armazenadas na fila de e-mail.

Recebe e-mails de computadores remotos e os repassa ao programa qmail-queue, que irá depositar a mensagem na fila de e-mails. Utiliza o protocolo SMTP e geralmente a porta 25/TCP. qmail-smtpd é responsável pela contagem de hops (servidores por onde a mensagem passou); rejeita qualquer e-mail com 100 (cem) ou mais entradas “Received” ou “Delivered-To” em seu cabeçalho. qmail-smtpd suporta “ESMTP”, incluindo opções 8BITMIME e PIPELINING. qmail-smtpd converte SMTP “newlines” em “UNIX newlines”, convertendo entradas “CR LF” em “LF”; qmail-smtpd retorna um erro temporário e aborta a conexão caso encontre uma entrada “LF” com problemas. qmail-smtpd aceita mensagens com linhas muito longas ou caracteres não “ASCII”, mesmo que estas mensagens violem as especificações do protocolo SMTP.

qmail-start [ defaultdelivery [ logger argumentos ... ] ] Inicia todo o sistema de entrega de e-mails Invoca os programas qmail-send, qmail-lspawn, qmail-rspawn e qmail-clean com seus devidos UIDs (ID de usuário) e GIDs (ID de grupo). Estes serviços cooperam entre si na entrega de e-mails. defaultdelivery é o formato padrão de entrega de mensagens que será utilizado por qmail-lspawn, e deve ser do tipo Maildir ou Mailbox. Se não informado, qmail-lspawn utilizará o formato Mailbox como padrão. Se logger for informado, qmail-start repassará os logs de atividade do programa qmail-send para logger. Variáveis de ambiente passadas à qmail-start são eventualmente utilizadas pelo programa qmail-local; tenha sempre certeza de limpar o ambiente de variáveis se executar qmail-start manualmente. Ex: # env – PATH="/var/qmail/bin:$PATH" qmail-start ./Maildir splogger qmail & Limites de recursos e controles de TTYs também são repassados de qmail-start para qmail-local. NOTA: qmail-send normalmente pode iniciar muitas entregas de e-mails simultâneas; para reduzir o impacto de qmail-send em outros programas do sistema, você pode executar qmail-start com prioridade baixa.

Substitui diretamente as funcionalidades do conhecido programa sendmail. Geralmente é utilizado por clientes de e-mail que não suportam o protocolo SMTP para o envio de e-mails.

splogger [ tag [ fac ] ] Lê e insere mensagens geradas pelo qmail no sistema de logs (syslog). Insere tag (Padrão: splogger) e um timestamp numérico no início de cada mensagem. splogger checa por alert: ou warning: no início de cada mensagem e seleciona uma prioridade syslog (LOG_ALERT, LOG_WARNING ou LOG_INFO) para a mensagem. splogger loga mensagens com a facilidade fac. fac precisa ser numérico. (Padrão é 2). splogger converte caracteres que não podem ser impressos por “?” (interrogação). splogger não loga linhas em branco. splogger quebra linhas que contenham mais que 800 caracteres (desde que syslog não suporte longas mensagens) e adiciona um “+” (adição) depois do timestamp para indicar uma quebra de linha. Funcionamento geral da entrega de mensagens no qmail:

Estes utilitários ampliam os recursos do qmail. Basicamente, ajudam em tarefas específicas e geralmente são invocados no momento do recebimento de e-mails, ou seja, no momento anterior a entrada do e-mail na caixa do usuário. Normalmente são utilizados dentro dos arquivos .qmail.

bouncesaying erro [ programa [ argumentos ...] ] Redireciona o e-mail para o programa programa (e opicionalmente os argumentos para serem utilizados em programa). Se o código de erro retornado por programa for 0 (zero), o texto indicado em erro será enviado para o remetente, logado no sistema de logs e a mensagem não será entregue. Se programa retornar qualquer outro código de erro ou não existir, bouncesaying sai com código de erro 0 (zero) e continua o processo. Se não for informado nenhum programa, bouncesaying sempre retornará a mensagem indicada em erro: bouncesaying 'This address no longer accepts mail.'

condredirect novoendereço programa [ argumentos ] Redireciona o e-mail para o programa programa(e opicionalmente os argumentos para serem utilizados em programa). Se o código de erro retornado por programa for 0 (zero), condredirect redireciona o e-mail para novoendereço e sai com código de erro 99 (noventa e nove), ignorando qualquer outro comando. Se o código de erro retornado por programa for 111 (cento e onze), condredirect sai com código de erro 111, o e-mail volta para a fila de e-mails e a entrega será tentada novamente mais tarde. Se programa retornar qualquer outro código de erro ou não existir, condredirect sai retornando código de erro 0 (zero) e continua o processo de entrega da mensagem. OBS: Se habilitar condredirect em um arquivo .qmail, não se esqueça de adicionar uma linha especificando a entrega na sua caixa de e-mail. Ex: conteúdo do arquivo $HOME/.qmail | condredirect telles@newdomain.com $HOME/meuscript.sh

except programa [ argumentos ] Altera o código de retorno de erro de um programa. Se programa retornar o código de erro 0 (zero), except sai com código de erro 100 (cem). Se programa sair com código de erro 111 (cento e onze), except também sai com código de erro 111. Qualquer outro código de erro retornado por programa faz com que except saia com código de erro 0 (zero). except é normalmente utilizado em conjunto com bouncesaying e condredirect. Ex: conteúdo do arquivo $HOME/.qmail | bouncesaying ‘Apenas p/ o assunto qmail !’ except grep -qi ‘Sobre qmail’ ./Maildir/ O exemplo acima, faz com que bouncesaying retorne o e-mail para o destinatário caso o e-mail não contenha as palavras ‘Sobre qmail’ no cabeçalho do e-mail ou em seu corpo.

forward recipiente1 recipiente2 ... Redireciona novos e-mails para um ou mais endereços de recipientes. Possui o mesmo efeito que inserir cada endereço dentro de um arquivo .qmail, mas com a vantagem de poder contruír o endereço de e-mail do recipiente no momento da entrega. Ex: | forward ${LOCAL/rodrigo/rodrigo-lixo}@${HOST} No exemplo anterior, quando utilizado no arquivo .qmail dentro do diretório $HOME do usuário rodrigo, forward encaminhará todas as novas mensagens para a conta rodrigo-lixo do mesmo domínio que rodrigo.

Monitora o diretório de e-mail do usuário e reporta quando novas mensagens são recebidas, exibindo um pequeno sumário com as novas mensagens. maildirwatch imprime na tela, um sumário de novas mensagens 2 (duas) vezes por minuto. maildirwatch utiliza a variável de ambiente $MAILDIR para identificar o diretório a ser monitorado. Foi desenvolvido para ser executado em um terminal compatível com VT100; limpa a tela antes da impressão de cada sumário.

preline [ -dfr ] programa [ argumentos ] Sujeita cada nova mensagem atravéz de programa. Por padrão, preline adiciona 3 (três) campos no cabeçalho do e-mail. Os campos From:, Return-Path: e Delivered-To: são adicionados ao cabeçalho do e-mail (caso já não existam) com seus respectivos valores. Algumas opções podem ser utilizadas para modificar a ação padrão de preline. Opção Descrição -d Não insere o campo Delivered-To:. Utilize esta opção quando o recipiente da mensagem de entrada está atualmente sob controle remoto, mas foi enviada aqui atravéz de control/virtualdomains para roteamento manual. -f Não insere o campo From:. -r Não insere o campo Return-Path:.

Imprime uma mensagem no terminal do usuário quando um novo e-mail chegar em sua caixa de e-mails. Para que esta notificação funcione, é necessário que o programa qbiff esteja devidamente configurado no arquivo $HOME/.qmail do usuário. Ex: ./Maildir/ | qbiff OBS: É necessário habilitar o recebimento de mensagens no terminal do usuário via ‘biff y’.

qreceipt seu-email Responde à mensagens que solicitam uma confirmação de recebimento. Se seu-email estiver contido no campo Notice-Requested-Upon-Delivery-To: do cabeçalho do e-mail, qreceipt enviará uma notificação de recebimento ao remetente. OBS: Se habilitar qreceipt em um arquivo .qmail, não se esqueça de adicionar uma linha especificando a entrega na sua caixa de e-mail. Ex: ./Maildir/ | qreceipt telles@domain.org A mensagem que o remetente da mensagem receberá, será algo como: From: DELIVERY NOTICE SYSTEM <endereco-remetente> To: <endereco-remetente> Subject: success notice Hi! This is the qreceipt program. Your message was delivered to the following address: telles@domain.org. Thanks for asking.

Converte caixas de correio no formato Maildir para o formato mbox (Mailbox). Requer 3 (trêz) variáveis de ambiente setadas: Variável Descrição $MAIL Localização do Mailbox do usuário a ser criado. $MAILTMP Localização do arquivo temporário de transição a ser utilizado. $MAILDIR Localização do Maildir do usuário a ser convertido. $MAIL e $MAILTMP precisam estar no mesmo sistema de arquivos. maildir2mbox não remove a mensagem de $MAILDIR enquanto não escreve-la completamente dentro de $MAIL. maildir2mbox trava o arquivo $MAIL para protegê-lo de acesso simultâneo por um cliente de e-mail. Este sistema de trava não protege $MAIL de acesso simultâneo por outro processo maildir2mbox. Execute apenas uma instância de maildir2mbox por vez.

maildirmake Maildir Cria o diretório Maildir utilizando o formato de caixa de correio Maildir. maildirmake criará a estrututra new, cur e tmp dentro de Maildir, aonde Maildir deve ser criado dentro do diretório $HOME do usuário e usuário deve ser o dono de Maildir e todos os seus subdiretórios.

qmail-getpw local Procura o usuário que controla o endereço local. Retorna usuário, Unix userid, Unix groupid, $HOME, traço e extensão. Quando local é igual a usuário, traço e extensão retornam vazios. Quando local é igual a usuário-algumacoisa, traço será “-“ e extensão será “algumacoisa”. Aonde, mensagens para local serão gerenciadas por $HOME/.qmail-traçoextensão. Se qmail-getpw não encontrar o usuário que controla local, o usuário alias entra em cena e toma o controle da mensagem. Neste caso, traço será “-“ e ext será “local”. Se qmail-getpw encontrar problemas na execução, sai com código de erro diferente de 0 (zero) e não imprime nada em tela. qmail-getpw considera como conta local todos os usuários do arquivo /etc/passwd se: Não possuir UID 0 (zero). O diretório $HOME do usuário existir e for visível por qmail-getpw. O usuário é o dono de seu diretório $HOME. qmail-getpw ignora nomes de usuários que contenham letras em maiúsculas. qmail-getpw assume que todos os nomes de usuários possuem menos de 32 caracteres. OBS: O mecanismo qmail-users cancela as decisões tomadas por qmail-getpw, é confiável, altamente configurável e muito mais rápido que qmail-getpw.

Cria o arquivo base de dados control/morercpthosts.cdb em formato binário a partir do arquivo control/morercpthosts, que será utilizado pelo programa qmail-smtpd de forma mais eficiente. Caso exista algum problema com o arquivo control/morercpthosts, qmail-newmrh exibe uma mensagem de erro e não gera o novo arquivo control/morercpthosts.cdb. qmail-newmrh assegura que control/morercpthosts.cdb seja atualizado atomicamente (atualizações simultâneas), desta forma, qmail-smtpd não precisa aguardar qmail-newmrh liberar o arquivo para acessá-lo de forma segura. qmail-newmrh não tenta proteger control/morercpthosts.cdb contra atualizações simultâneas. O binário control/morercpthosts.cdb é portável entre máquinas diferentes.

Cria o arquivo database /var/qmail/users/cdb em formato binário a partir do arquivo /var/qmail/users/assign, que será utilizado por qmail-lspawn de forma mais eficiente. Caso exista algum problema na leitura do arquivo users/assign, qmail-newu exibe uma mensagem de erro e não gera o novo arquivo users/cdb. qmail-newu assegura que users/cdb seja atualizado atomicamente (atualizações simultâneas), desta forma, qmail-lspawn não precisa aguardar qmail-newu liberar o arquivo para acessá-lo de forma segura. qmail-newu não tenta proteger users/cdb contra atualizações simultâneas. O binário users/cdb é portável entre máquinas diferentes.

qmail-pw2u [ -/ohHuUC ] [ -c char ] Lê é um arquivo de senhas no padrão V7 da entrada padrão e imprime na saída padrão no formato qmail-users. Geralmente a saída produzida pelo comando qmail-pw2u dever ser gravada no arquivo users/assign. Cada linha de um arquivo de senhas no formato V7 deve ter a forma: usuário:senha:uid:gid:gecos:home:shell Aonde, usuário é o nome da conta local, uid e gid são o User ID e Group ID de usuário, home é o diretório $HOME de usuário. senha, gecos e shell são ignorados por qmail-pw2u. qmail-pw2u ignora o usuário se: Possuir UID 0 (zero). Diretório $HOME não existir. O usuário não for o dono de seu diretório $HOME. O nome de usuário possuir letras em maiúsculo. Se o conteúdo impresso por qmail-pw2u for gravado no arquivo /var/qmail/users/assign e for executado o comando qmail-newu, qmail-lspawn irá obedecer todas as instruções impressas por qmail-pw2u. OBS: Após alterar qualquer usuário, uid, gid ou diretório $HOME dentro do arquivo de senhas, é necessário executar qmail-pw2u e qmail-newu novamente, para que qmail-lspawn obedeça às alterações. As ações padrão de qmail-pw2u podem ser alteradas, utilizando-se os seguintes arquivos dentro do diretório /var/qmail/users: include Lista de usuários permitidos, um por linha. Se include existir, e o usuário não estiver listado neste arquivo, será ignorado. exclude Lista de usuários que devem ser ignorados, um por linha. Se exclude existir, e o usuário estiver listado neste arquivo, será ignorado. mailnames Nomes substitutos para nomes de usuários, cada linha deve ter a forma: usuario:mailname1:mailnamel2Aonde mensagens para os endereços de e-mail mailname1, mailname1-algumacoisa, mailname2 serão entregues para usuario. OBS: Mensagens para os endereços usuário e usuário-algumacoisa não serão entregues para usuário, a menos que estejam listados como um dos mailnames. subusers Endereços extra para nomes de usuários, cada linha deve ter a forma: sub:usuario:extra:sub será gerenciado por $HOME/.qmail-extra, aonde $HOME será o diretório $HOME de usuário.sub-algumacoisa será gerenciado por $HOME/.qmail-extra-algumacoisa. append Tarefas extras, que serão impressas na tela no final do processamento de qmail-pw2u. Pode-se ainda utilizar as opções: Opção Descrição -o Ignora usuário se seu diretório $HOME não existir (ou não seja visível por qmail-pw2u) ou caso não seja o dono de seu diretório $HOME (Padrão). -h Pára o processamento se o diretório $HOME do usuário não existir (apropriado se cada usuário deve ter seu diretório $HOME) ou caso não seja o dono de seu diretório $HOME. -H Não checa se o usuário é dono de seu diretório $HOME. -u Permite letras em maiúsculo no nome do usuário. -U Ignora usuário, se houver alguma letra em maiúsculo no nome do usuário (Padrão). -c char Utiliza char como delimitador de extensão de usuário no lugar de “-” -C Desabilita o mecanismo de extensão de usuários. -/ Utiliza $HOME/.qmail-/... ao invés de $HOME/.qmail-...

Gera e mostra um relatório detalhado das mensagens que estão aguardando na fila do qmail. Este relatório mostra a data que a mensagem entrou em fila, tamanho em bytes, remetente e todos os recipientes que devem receber a mensagem. Deve ser executado pelo usuário root ou pelo usuário qmails membro do grupo qmail.

Gera e mostra um relatório com o número de mensagens que estão aguardando na fila do qmail para serem processadas e entregues. Deve ser executado pelo usuário root ou por algum usuário do grupo qmail.

Analisa os arquivos de configuração do qmail e mostra sua configuração corrente de forma detalhada.

Limpa a tabela de timeout TCP do programa qmail-remote, fazendo com que qmail-remote não utilize nenhuma referência de tempo para os endereços que falharam. Deve ser executado pelo usuário root ou pelo usuário qmailr membro do grupo qmail.

Gera e mostra um relatório com os timeouts da tabela TCP do programa qmail-remote. Se o programa qmail-remote falhar em uma tentativa de conexão SMTP, o IP do host remoto é gravado nesta tabela. Se a conexão SMTP para este host falhar uma segunda vez (depois de no mínimo 2 minutos de conexões sem sucesso), esta entrada é marcada na tabela e o qmail não tentará entregar esta mensagem por 1 (uma) hora. Deve ser executado pelo usuário root ou pelo usuário qmailr membro do grupo qmail.

tcp-env [ -rR ] [ -t n ] programa [ argumentos ] Tenta obter informações sobre conexões TCP para setar uma série de variáveis de ambiente que serão utilizadas por programa (e opcionalmente seus argumentos). A entrada de dados para o programa tcp-env deve ser uma conexão do tipo TCP. tcp-env é geralmente utilizado em conjunto com o programa inetd. Opção Descrição -r Tenta obter informação do host remoto e setar a variável $TCPREMOTEINFO (Padrão). -R Não tenta obter $TCPREMOTEINFO do host remoto. -t n Tempo máximo em segundos que tentará obter $TCPREMOTEINFO de uma conexão TCP antes de desistir. O padrão é 30 segundos.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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

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.

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.

Especifica a mensagem de boas vindas que será exibida no banner apresentado por qmail-smtpd. Padrão: me. Utilizado por: qmail-smtpd.

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.

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.

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.

Especifica o número máximo em segundos que qmail-s