postfix - Programa de controle do Postfix
SINOPSIS
postfix [-Dv] [-c config_dir] comando
DESCRIÇÃO
Este comando é reservado para o superusuário. Para enviar e-mail, use o comando sendmail(1) do Postfix.
O comando postfix(1) controla a operação do sistema de e-mail Postfix: inicia ou para o daemon master(8), executa uma verificação de saúde e outras tarefas de manutenção.
Por padrão, o comando postfix(1) configura um ambiente padronizado e executa o script postfix-script para realizar o trabalho real.
No entanto, quando o suporte para várias instâncias do Postfix está configurado, o postfix(1) executa o comando especificado com o parâmetro de configuração multi_instance_wrapper. Este comando executará o comando para cada instância aplicável do Postfix.
Os seguintes comandos são implementados:
check Avisa sobre propriedade ou permissões incorretas de diretórios/arquivos e cria diretórios ausentes.
start Inicia o sistema de e-mail Postfix. Isso também executa a verificação de configuração descrita acima.
start-fg
Semelhante a start, mas mantém o daemon master(8) em execução em primeiro plano e habilita o modo "init" do master(8) quando executado como PID 1. Este comando requer que o suporte multi-instância esteja desabilitado (ou seja, o valor do parâmetro multi_instance_directories deve estar vazio).
Quando o Postfix é executado dentro de um contêiner, consulte MAILLOG_README para registrar em stdout. O Postfix registra no syslog por padrão, o que requer a) a execução de um processo syslogd dentro do contêiner ou b) o montagem do socket /dev/log do host do contêiner dentro do contêiner (exemplo: "docker run -v /dev/log:/dev/log ...") e c) um prefixo "syslog_name" distinto do Postfix que identifique o registro da instância do Postfix.
stop Para o sistema de e-mail Postfix de forma organizada. Se possível, os processos em
execução são permitidos terminar assim que possível.
Observação: para atualizar o sistema de e-mail Postfix após uma alteração na configuração,
não use os comandos start e stop em sucessão. Use o comando reload em vez disso.
abort Para abruptamente o sistema de e-mail Postfix. Os processos em execução recebem um
sinal para parar imediatamente.
flush Força a entrega: tenta entregar todas as mensagens na fila de e-mail pendente.
Normalmente, as tentativas de entregar e-mail atrasado ocorrem em intervalos regulares, o
intervalo dobrando após cada tentativa com falha.
Aviso: o flushing frequente de e-mail não entregável resultará em um desempenho de entrega
ruim de todo o outro e-mail.
reload Re-lê os arquivos de configuração. Os processos em execução terminam assim que possível.
status Indica se o sistema de e-mail Postfix está atualmente em execução (código de saída zero)
ou parado (código de saída diferente de zero).
set-permissions [name=value ...]
Define a propriedade e as permissões dos arquivos e diretórios relacionados ao Postfix, conforme especificado no arquivo postfix-files.
Especifique name=value para substituir e atualizar parâmetros de configuração específicos do arquivo main.cf. Use isso, por exemplo, para alterar a configuração mail_owner ou setgid_group para um sistema Postfix já instalado.
Este recurso está disponível no Postfix 2.1 e versões posteriores. Com o Postfix 2.0 e versões anteriores, use "$config_directory/post-install set-permissions".
logrotate
Gire o arquivo de log especificado com $maillog_file, adicionando um sufixo de carimbo de data/hora formatado de acordo com $maillog_file_rotate_suffix e compactando o arquivo com o comando especificado com $maillog_file_compressor. Isso não irá girar arquivos /dev/*
Este recurso está disponível no Postfix 3.4 e versões posteriores.
tls subcommand
Habilite o TLS oportunístico no cliente ou servidor SMTP do Postfix e gerencie as chaves privadas e os certificados TLS do servidor SMTP do Postfix. Consulte postfix-tls(1) para obter documentação.
Este recurso está disponível no Postfix 3.1 e versões posteriores.
upgrade-configuration [name=value ...]
Atualize os arquivos main.cf e master.cf com informações que o Postfix precisa para ser executado: adicione ou atualize serviços e adicione ou atualize as configurações de parâmetros.
Especifique name=value para substituir e atualizar parâmetros de configuração específicos do arquivo main.cf.
Este recurso está disponível no Postfix 2.1 e versões posteriores. Com o Postfix 2.0 e versões anteriores, use "$config_directory/post-install upgrade-configuration".
As seguintes opções são implementadas:
-c config_dir
Leia os arquivos de configuração main.cf e master.cf no diretório especificado em vez do diretório de configuração padrão. Use isso para distinguir entre várias instâncias do Postfix no mesmo host.
Com o Postfix 2.6 e versões posteriores, esta opção força o comando postfix(1) a operar apenas na instância do Postfix especificada. Este comportamento é herdado pelos comandos postfix(1) que são executados como um descendente do processo atual.
-D (apenas com o início do Postfix)
Execute cada daemon do Postfix sob o controle de um depurador conforme especificado por meio do parâmetro de configuração debugger_command.
-v Habilite o registro detalhado para fins de depuração. Várias opções -v tornam o software cada vez mais detalhado.
AMBIENTE
O comando postfix(1) exporta as seguintes variáveis de ambiente antes de executar o arquivo postfix-script:
MAIL_CONFIG
Isso é definido quando a opção de linha de comando -c está presente.
Com o Postfix 2.6 e versões posteriores, esta variável de ambiente força o comando postfix(1) a operar apenas na instância do Postfix especificada. Este comportamento é herdado pelos comandos postfix(1) que são executados como um descendente do processo atual.
MAIL_VERBOSE
Isso é definido quando a opção de linha de comando -v está presente.
MAIL_DEBUG
Isso é definido quando a opção de linha de comando -D está presente.
Quando o serviço de registro interno é habilitado (definindo um valor de parâmetro maillog_file não vazio), o comando postfix(1) exporta configurações que são usadas por processos filhos antes que eles processem main.cf ou configurações de linha de comando.
POSTLOG_SERVICE
O nome do endpoint público do serviço de registro de eventos.
POSTLOG_HOSTNAME
O nome do host a ser adicionado ao registro interno.
PARÂMETROS DE CONFIGURAÇÃO
Os seguintes parâmetros de configuração do arquivo main.cf são exportados como variáveis de ambiente com os mesmos nomes:
config_directory (veja a saída de 'postconf -d')
O local padrão dos arquivos de configuração main.cf e master.cf do Postfix.
command_directory (veja a saída de 'postconf -d')
O local de todos os comandos administrativos do Postfix.
daemon_directory (veja a saída de 'postconf -d')
O diretório com os programas de suporte e os programas daemon do Postfix.
html_directory (veja a saída de 'postconf -d')
O local dos arquivos HTML do Postfix que descrevem como construir, configurar ou operar um subsistema ou recurso específico do Postfix.
mail_owner (postfix)
A conta de usuário do sistema UNIX que é proprietária da fila do Postfix e da maioria dos processos daemon do Postfix.
mailq_path (veja a saída de 'postconf -d')
Recurso de compatibilidade com o Sendmail que especifica onde o comando mailq(1) do Postfix está instalado.
manpage_directory (veja a saída de 'postconf -d')
Onde as páginas de manual do Postfix estão instaladas.
newaliases_path (veja a saída de 'postconf -d')
Recurso de compatibilidade com o Sendmail que especifica o local do comando newaliases(1).
queue_directory (veja a saída de 'postconf -d')
O local do diretório de fila de nível superior do Postfix.
readme_directory (veja a saída de 'postconf -d')
O local dos arquivos README do Postfix que descrevem como construir, configurar ou operar um subsistema ou recurso específico do Postfix.
sendmail_path (veja a saída de 'postconf -d')
Um recurso de compatibilidade com o Sendmail que especifica o local do comando sendmail(1) do Postfix.
setgid_group (postdrop)
A propriedade de grupo dos comandos Postfix set-gid e dos diretórios Postfix graváveis pelo grupo.
Disponível na versão 2.5 ou posterior do Postfix:
data_directory (veja a saída de 'postconf -d')
O diretório com arquivos de dados graváveis pelo Postfix (por exemplo: caches, números pseudoaleatórios).
Disponível na versão 3.0 ou posterior do Postfix:
compatibility_level (0)
Uma rede de segurança que faz com que o Postfix seja executado com configurações padrão compatíveis com versões anteriores após uma atualização para uma versão mais recente do Postfix.
meta_directory (veja a saída de 'postconf -d')
O local de arquivos não executáveis que são compartilhados entre várias instâncias do Postfix, como postfix-files, dynamicmaps.cf e os arquivos de modelo de várias instâncias main.cf.proto e master.cf.proto.
shlib_directory (veja a saída de 'postconf -d')
O local das bibliotecas dinamicamente vinculadas do Postfix (libpostfix-*.so) e o local padrão dos plug-ins de banco de dados do Postfix (postfix-*.so) que têm um caminho relativo no arquivo dynamicmaps.cf.
Disponível na versão 3.1 ou posterior do Postfix:
openssl_path (openssl)
O local do programa de linha de comando OpenSSL openssl(1).
Outros parâmetros de configuração:
import_environment (veja a saída de 'postconf -d')
A lista de variáveis de ambiente que um processo Postfix com privilégios irá importar de um processo pai que não é Postfix, ou substituições de ambiente name=value.
syslog_facility (mail)
A instalação syslog do registro de Postfix.
syslog_name (veja a saída de 'postconf -d')
Um prefixo que é adicionado ao nome do processo nos registros syslog, de modo que, por exemplo, "smtpd" se torne "prefix/smtpd".
Disponível na versão 2.6 do Postfix e posterior:
multi_instance_directories (vazio)
Uma lista opcional de diretórios de configuração Postfix não padrão; esses diretórios pertencem a instâncias adicionais do Postfix que compartilham os arquivos executáveis e a documentação do Postfix com a instância Postfix padrão e que são iniciadas, interrompidas, etc., juntamente com a instância Postfix padrão.
multi_instance_wrapper (vazio)
O caminho de um comando de gerenciador de múltiplas instâncias que o comando postfix(1) invoca quando o valor do parâmetro multi_instance_directories não está vazio.
multi_instance_group (vazio)
O nome opcional do grupo de instância desta instância Postfix.
multi_instance_name (vazio)
O nome opcional da instância desta instância Postfix.
multi_instance_enable (no)
Permite que esta instância Postfix seja iniciada, interrompida, etc., por um gerenciador de múltiplas instâncias.
Disponível na versão 3.4 do Postfix e posterior:
maillog_file (vazio)
O nome de um arquivo de registro opcional que é escrito pelo serviço postlogd(8) do Postfix.
maillog_file_compressor (gzip)
O programa a ser executado após a rotação de $maillog_file com "postfix logrotate".
maillog_file_prefixes (/var, /dev/stdout)
Uma lista de prefixos permitidos para um valor maillog_file.
maillog_file_rotate_suffix (%Y%m%d-%H%M%S)
O formato do sufixo a ser adicionado a $maillog_file durante a rotação do arquivo com "postfix logrotate".
postlog_service_name (postlog)
O nome da entrada do serviço postlogd(8) em master.cf.
ARQUIVOS
Antes da versão 2.6 do Postfix, todos os arquivos a seguir estavam em $config_directory. Alguns arquivos agora estão em $daemon_directory ou $meta_directory para que possam ser compartilhados entre várias instâncias que executam a mesma versão do Postfix.
Use o comando "postconf config_directory" ou "postconf daemon_directory" para expandir os nomes para seus valores reais.
$config_directory/main.cf, parâmetros de configuração do Postfix
$config_directory/master.cf, processos daemon do Postfix
$daemon_directory/postfix-script, comandos administrativos
$daemon_directory/post-install, configuração pós-instalação
$meta_directory/dynamicmaps.cf, clientes de banco de dados de plug-in
$meta_directory/postfix-files, permissões de arquivo/diretório
VEJA TAMBÉM
Comandos:
postalias(1), criar/atualizar/consultar banco de dados de alias
postcat(1), examinar arquivo de fila do Postfix
postconf(1), utilitário de configuração do Postfix
postdrop(1), utilitário de envio de e-mail do Postfix
postfix(1), programa de controle do Postfix
postfix-tls(1), gerenciamento TLS do Postfix
postkick(1), acionar daemon do Postfix
postlock(1), bloqueio compatível com Postfix
postlog(1), registro compatível com Postfix
postmap(1), gerenciador de tabela de consulta do Postfix
postmulti(1), gerenciador de múltiplas instâncias do Postfix
postqueue(1), controle de fila de e-mail do Postfix
postsuper(1), limpeza do Postfix
mailq(1), interface de compatibilidade Sendmail
newaliases(1), interface de compatibilidade Sendmail
sendmail(1), interface de compatibilidade Sendmail
Configuração do Postfix: bounce(5), modelos de mensagens de rejeição do Postfix master(5), sintaxe do arquivo master.cf do Postfix postconf(5), sintaxe do arquivo main.cf do Postfix postfix-wrapper(5), API multi-instância do Postfix
Mecanismos baseados em tabelas: access(5), tabela de controle de acesso SMTP do Postfix aliases(5), alias local do Postfix canonical(5), reescrita de endereço de entrada do Postfix generic(5), reescrita de endereço de saída do Postfix header_checks(5), body_checks(5), inspeção de conteúdo do Postfix relocated(5), usuários que foram movidos transport(5), tabela de roteamento do Postfix virtual(5), alias virtual do Postfix
Mecanismos de pesquisa de tabela: cidr_table(5), associa o padrão CIDR a um valor ldap_table(5), cliente LDAP do Postfix lmdb_table(5), driver de banco de dados LMDB do Postfix memcache_table(5), cliente memcache do Postfix mongodb_table(5), cliente MongoDB do Postfix mysql_table(5), cliente MYSQL do Postfix nisplus_table(5), cliente NIS+ do Postfix pcre_table(5), associa o padrão PCRE a um valor pgsql_table(5), cliente PostgreSQL do Postfix regexp_table(5), associa o padrão POSIX regexp a um valor socketmap_table(5), cliente socketmap do Postfix sqlite_table(5), driver de banco de dados SQLite do Postfix tcp_table(5), pesquisa de tabela cliente-servidor do Postfix
Processos daemon: anvil(8), limitação de conexão/taxa do Postfix bounce(8), defer(8), trace(8), relatórios de status de entrega cleanup(8), normaliza e enfileira a mensagem discard(8), agente de entrega de descarte do Postfix dnsblog(8), registra DNS allow/denylist error(8), agente de entrega de erro do Postfix flush(8), serviço rápido ETRN do Postfix local(8), agente de entrega local do Postfix master(8), daemon mestre do Postfix oqmgr(8), gerenciador de fila antigo do Postfix pickup(8), coleta de e-mail local do Postfix pipe(8), entrega e-mail para um comando não Postfix postlogd(8), serviço de registro interno do Postfix postscreen(8), bloqueador de zumbis do Postfix proxymap(8), servidor proxy de tabela de pesquisa do Postfix qmgr(8), gerenciador de fila do Postfix qmqpd(8), servidor QMQP do Postfix scache(8), gerenciador de cache de conexão do Postfix showq(8), lista a fila de e-mail do Postfix smtp(8), lmtp(8), cliente SMTP+LMTP do Postfix smtpd(8), servidor SMTP do Postfix spawn(8), executa um servidor não Postfix tlsmgr(8), cache TLS e gerenciador de aleatoriedade do Postfix tlsproxy(8), proxy TLS do Postfix trivial-rewrite(8), reescrita de endereço do Postfix verify(8), verificação de endereço do Postfix virtual(8), agente de entrega virtual do Postfix
Outros:
syslogd(8), registro do sistema
ARQUIVOS README
Use "postconf readme_directory" ou "postconf html_directory" para localizar esta informação. OVERVIEW, visão geral dos comandos e processos do Postfix BASIC_CONFIGURATION_README, configuração básica do Postfix ADDRESS_REWRITING_README, reescrita de endereço do Postfix SMTPD_ACCESS_README, controle de acesso/relé SMTP CONTENT_INSPECTION_README, inspeção de conteúdo do Postfix QSHAPE_README, análise de fila do Postfix
LICENÇA
A licença do Secure Mailer deve ser distribuída com este software.
AUTOR(ES)
Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, USA
Wietse Venema Google, Inc. 1118th Avenue New York, NY 10011, USA
Suporte TLS por:
Lutz Jaenicke Brandenburg University of Technology Cottbus, Alemanha
Victor Duchovni Morgan Stanley
Suporte SASL originalmente por:
Till Franke SuSE Rhein/Main AG 65760Eschborn, Alemanha
Suporte LMTP originalmente por:
Philip A. Prindeville Mirapoint, Inc. USA.
Amos Gouaux University of Texas at Dallas P.O. Box 830688, MC34 Richardson, TX 75083, USA
Suporte IPv6 originalmente por:
Mark Huizer, Eindhoven University, Holanda Jun-ichiro 'itojun' Hagino, KAME project, Japão The Linux PLD project Dean Strik, Eindhoven University, Holanda