postfix - Programme de contrôle Postfix
SYNOPSIS
postfix [-Dv] [-c config_dir] commande
DESCRIPTION
Cette commande est réservée à l’utilisateur super. Pour soumettre du courrier, utilisez la commande sendmail(1) de Postfix.
La commande postfix(1) contrôle le fonctionnement du système de messagerie Postfix : démarrage ou arrêt du démon master(8), vérification de l’état et autres opérations de maintenance.
Par défaut, la commande postfix(1) configure un environnement standardisé et exécute le script shell postfix-script pour effectuer les opérations.
Cependant, lorsqu’un support pour plusieurs instances de Postfix est configuré, postfix(1) exécute la commande spécifiée avec le paramètre de configuration multi_instance_wrapper. Cette commande exécutera la commande pour chaque instance Postfix applicable.
Les commandes suivantes sont implémentées :
check Avertit de problèmes de propriété ou de permissions de répertoires/fichiers, et crée les répertoires manquants.
start Démarre le système de messagerie Postfix. Ceci exécute également la vérification de configuration décrite ci-dessus.
start-fg
Comme start, mais maintient le démon master(8) en cours d’exécution au premier plan et active le mode « init » de master(8) lorsqu’il s’exécute en tant que PID 1. Cette commande nécessite que le support multi-instance soit désactivé (c’est-à-dire que la valeur du paramètre multi_instance_directories doit être vide).
Lors de l’exécution de Postfix dans un conteneur, consultez MAILLOG_README pour l’enregistrement dans la sortie standard. Postfix enregistre par défaut dans syslog, ce qui nécessite : a) l’exécution d’un processus syslogd dans le conteneur, ou b) le montage du socket /dev/log de l’hôte du conteneur dans le conteneur (exemple : « docker run -v /dev/log:/dev/log … »), et c) un préfixe « syslog_name » Postfix distinct qui identifie l’enregistrement provenant de l’instance Postfix.
stop Arrête le système de messagerie Postfix de manière ordonnée. Si possible, les processus en cours d’exécution sont autorisés à se terminer dès que possible.
Remarque : afin d’actualiser le système de messagerie Postfix après une modification de configuration, n’utilisez pas les commandes start et stop en succession. Utilisez plutôt la commande reload.
abort Arrête brusquement le système de messagerie Postfix. Les processus en cours d’exécution reçoivent un signal pour s’arrêter immédiatement.
flush Force la distribution : tente de distribuer tous les messages de la file d’attente de courrier différé. Normalement, les tentatives de distribution du courrier retardé se produisent à intervalles réguliers, l’intervalle doublant après chaque tentative infructueuse.
Avertissement : la distribution fréquente du courrier non distribuable entraînera de mauvaises performances de distribution de tous les autres courriers.
reload Relit les fichiers de configuration. Les processus en cours d’exécution se terminent dès que possible.
status Indique si le système de messagerie Postfix est actuellement en cours d’exécution (code de sortie zéro) ou arrêté (code de sortie différent de zéro).
set-permissions [name=value ...]
Définit la propriété et les permissions des fichiers et répertoires liés à Postfix, comme spécifié dans le fichier postfix-files.
Spécifiez name=value pour remplacer et mettre à jour des paramètres de configuration spécifiques dans le fichier main.cf. Utilisez ceci, par exemple, pour modifier le paramètre mail_owner ou définir le paramètre setgid_group pour un système Postfix déjà installé.
Cette fonctionnalité est disponible dans Postfix 2.1 et les versions ultérieures. Avec Postfix 2.0 et les versions antérieures, utilisez "$config_directory/post-install set-permissions".
logrotate
Effectue une rotation du fichier journal spécifié avec $maillog_file, en ajoutant un suffixe horodaté formaté selon $maillog_file_rotate_suffix, et en compressant le fichier avec la commande spécifiée avec $maillog_file_compressor. Cela ne fera pas pivoter les fichiers /dev/* .
Cette fonctionnalité est disponible dans Postfix 3.4 et les versions ultérieures.
tls subcommand
Active TLS opportuniste dans le client ou le serveur SMTP Postfix, et gère les clés privées et les certificats TLS du serveur SMTP Postfix. Consultez postfix-tls(1) pour la documentation.
Cette fonctionnalité est disponible dans Postfix 3.1 et les versions ultérieures.
upgrade-configuration [name=value ...]
Met à jour les fichiers main.cf et master.cf avec les informations dont Postfix a besoin pour fonctionner : ajoute ou met à jour les services, et ajoute ou met à jour les paramètres de configuration.
Spécifiez name=value pour remplacer et mettre à jour des paramètres de configuration spécifiques dans le fichier main.cf.
Cette fonctionnalité est disponible dans Postfix 2.1 et les versions ultérieures. Avec Postfix 2.0 et les versions antérieures, utilisez "$config_directory/post-install upgrade-configuration".
Les options suivantes sont implémentées :
-c config_dir
Lit les fichiers de configuration main.cf et master.cf dans le répertoire spécifié au lieu du répertoire de configuration par défaut. Utilisez ceci pour distinguer plusieurs instances Postfix sur le même hôte.
Avec Postfix 2.6 et les versions ultérieures, cette option force la commande postfix(1) à fonctionner uniquement sur l’instance Postfix spécifiée. Ce comportement est hérité par les commandes postfix(1) qui s’exécutent en tant que processus descendant du processus actuel.
-D (uniquement avec le démarrage de Postfix)
Exécute chaque démon Postfix sous le contrôle d’un débogueur, tel que spécifié via le paramètre de configuration debugger_command.
-v Active la journalisation détaillée à des fins de débogage. Plusieurs options -v rendent le logiciel de plus en plus détaillé.
ENVIRONNEMENT
La commande postfix(1) exporte les variables d’environnement suivantes avant d’exécuter le fichier postfix-script :
MAIL_CONFIG
Ceci est défini lorsque l’option de ligne de commande -c est présente.
Avec Postfix 2.6 et les versions ultérieures, cette variable d’environnement force la commande postfix(1) à fonctionner uniquement sur l’instance Postfix spécifiée. Ce comportement est hérité par les commandes postfix(1) qui s’exécutent en tant que processus descendant du processus actuel.
MAIL_VERBOSE
Ceci est défini lorsque l’option de ligne de commande -v est présente.
MAIL_DEBUG
Ceci est défini lorsque l’option de ligne de commande -D est présente.
Lorsque le service de journalisation interne est activé (en définissant une valeur non vide pour le paramètre maillog_file), la commande postfix(1) exporte les paramètres qui sont utilisés par les processus enfants avant qu’ils ne traitent les paramètres main.cf ou de la ligne de commande.
POSTLOG_SERVICE
Le nom du point de terminaison public du service de journalisation.
POSTLOG_HOSTNAME
Le nom d’hôte à ajouter en préfixe à la journalisation interne.
PARAMÈTRES DE CONFIGURATION
Les paramètres de configuration de main.cf suivants sont exportés en tant que variables d’environnement avec les mêmes noms :
config_directory (voir la sortie de « postconf -d »)
L’emplacement par défaut des fichiers de configuration main.cf et master.cf de Postfix.
command_directory (voir la sortie de « postconf -d »)
L’emplacement de toutes les commandes d’administration Postfix.
daemon_directory (voir la sortie de « postconf -d »)
Le répertoire contenant les programmes de prise en charge et les programmes de démon Postfix.
html_directory (voir la sortie de « postconf -d »)
L’emplacement des fichiers HTML de Postfix qui décrivent comment créer, configurer ou exploiter un sous-système ou une fonctionnalité Postfix spécifique.
mail_owner (postfix)
Le compte système UNIX qui possède la file d’attente Postfix et la plupart des processus de démon Postfix.
mailq_path (voir la sortie de « postconf -d »)
Fonctionnalité de compatibilité Sendmail qui spécifie où la commande Postfix mailq(1) est installée.
manpage_directory (voir la sortie de « postconf -d »)
L’emplacement où sont installées les pages de manuel Postfix.
newaliases_path (voir la sortie de « postconf -d »)
Fonctionnalité de compatibilité Sendmail qui spécifie l’emplacement de la commande newaliases(1).
queue_directory (voir la sortie de « postconf -d »)
L’emplacement du répertoire de file d’attente de niveau supérieur de Postfix.
readme_directory (voir la sortie de « postconf -d »)
L’emplacement des fichiers README de Postfix qui décrivent comment créer, configurer ou exploiter un sous-système ou une fonctionnalité Postfix spécifique.
sendmail_path (voir la sortie de « postconf -d »)
Une fonctionnalité de compatibilité Sendmail qui spécifie l’emplacement de la commande Postfix sendmail(1).
setgid_group (postdrop)
L’appartenance au groupe des commandes Postfix set-gid et des répertoires Postfix accessibles en écriture par le groupe.
Disponible dans Postfix version 2.5 et ultérieure :
data_directory (voir la sortie de « postconf -d »)
Le répertoire contenant les fichiers de données accessibles en écriture par Postfix (par exemple : caches, nombres pseudo-aléatoires).
Disponible dans Postfix version 3.0 et ultérieure :
compatibility_level (0)
Un filet de sécurité qui fait fonctionner Postfix avec des paramètres par défaut rétrocompatibles après une mise à niveau vers une version Postfix plus récente.
meta_directory (voir la sortie de « postconf -d »)
L’emplacement des fichiers non exécutables qui sont partagés entre plusieurs instances Postfix, tels que postfix-files, dynamicmaps.cf, et les fichiers modèles multi-instances main.cf.proto et master.cf.proto.
shlib_directory (voir la sortie de « postconf -d »)
L’emplacement des bibliothèques dynamiques Postfix (libpostfix-*.so), et l’emplacement par défaut des modules de base de données Postfix (postfix-*.so) qui ont un chemin d’accès relatif dans le fichier dynamicmaps.cf.
Disponible dans Postfix version 3.1 et ultérieure :
openssl_path (openssl)
L’emplacement du programme en ligne de commande OpenSSL openssl(1).
Autres paramètres de configuration :
import_environment (voir la sortie de « postconf -d »)
La liste des variables d’environnement qu’un processus Postfix privilégié importera d’un processus parent non-Postfix, ou des remplacements de variables d’environnement au format nom=valeur.
syslog_facility (mail)
La facilité syslog de la journalisation Postfix.
syslog_name (voir la sortie de « postconf -d »)
Un préfixe qui est ajouté au nom du processus dans les enregistrements syslog, de sorte que, par exemple, « smtpd » devienne « prefix/smtpd ».
Disponible dans Postfix version 2.6 et ultérieure :
multi_instance_directories (vide)
Une liste facultative de répertoires de configuration Postfix non par défaut ; ces répertoires appartiennent à des instances Postfix supplémentaires qui partagent les fichiers exécutables Postfix et la documentation avec l’instance Postfix par défaut, et qui sont démarrées, arrêtées, etc., avec l’instance Postfix par défaut.
multi_instance_wrapper (vide)
Le chemin d’accès d’une commande de gestion d’instances multiples que la commande postfix(1) invoque lorsque la valeur du paramètre multi_instance_directories n’est pas vide.
multi_instance_group (vide)
Le nom de groupe facultatif de cette instance Postfix.
multi_instance_name (vide)
Le nom d’instance facultatif de cette instance Postfix.
multi_instance_enable (non)
Autoriser cette instance Postfix à être démarrée, arrêtée, etc., par un gestionnaire d’instances multiples.
Disponible dans Postfix version 3.4 et ultérieure :
maillog_file (vide)
Le nom d’un fichier journal facultatif qui est écrit par le service postlogd(8) de Postfix.
maillog_file_compressor (gzip)
Le programme à exécuter après la rotation de $maillog_file avec « postfix logrotate ».
maillog_file_prefixes (/var, /dev/stdout)
Une liste des préfixes autorisés pour une valeur maillog_file.
maillog_file_rotate_suffix (%Y%m%d-%H%M%S)
Le format du suffixe à ajouter à $maillog_file lors de la rotation du fichier avec « postfix logrotate ».
postlog_service_name (postlog)
Le nom de l’entrée de service postlogd(8) dans master.cf.
FICHIERS
Avant la version 2.6 de Postfix, tous les fichiers suivants se trouvaient dans $config_directory. Certains fichiers se trouvent désormais dans $daemon_directory ou $meta_directory afin qu’ils puissent être partagés entre plusieurs instances qui exécutent la même version de Postfix.
Utilisez la commande « postconf config_directory » ou « postconf daemon_directory » pour développer les noms et obtenir leurs valeurs réelles.
$config_directory/main.cf, paramètres de configuration Postfix
$config_directory/master.cf, processus démons Postfix
$daemon_directory/postfix-script, commandes d’administration
$daemon_directory/post-install, configuration post-installation
$meta_directory/dynamicmaps.cf, clients de base de données de plug-in
$meta_directory/postfix-files, permissions des fichiers/répertoires
CONSULTER AUSSI
Commandes :
postalias(1), création/mise à jour/interrogation de la base de données d’alias
postcat(1), examen du fichier de file d’attente Postfix
postconf(1), utilitaire de configuration Postfix
postdrop(1), utilitaire de publication de courrier Postfix
postfix(1), programme de contrôle Postfix
postfix-tls(1), gestion TLS Postfix
postkick(1), déclenchement du démon Postfix
postlock(1), verrouillage compatible Postfix
postlog(1), journalisation compatible Postfix
postmap(1), gestionnaire de table de correspondance Postfix
postmulti(1), gestionnaire d’instances multiples Postfix
postqueue(1), contrôle de la file d’attente de courrier Postfix
postsuper(1), maintenance Postfix
mailq(1), interface de compatibilité Sendmail
newaliases(1), interface de compatibilité Sendmail
sendmail(1), interface de compatibilité Sendmail
Configuration de Postfix : bounce(5), modèles de messages de notification de non-remise de Postfix master(5), syntaxe du fichier master.cf de Postfix postconf(5), syntaxe du fichier main.cf de Postfix postfix-wrapper(5), API multi-instance de Postfix
Mécanismes basés sur des tables : access(5), table de contrôle d’accès SMTP de Postfix aliases(5), alias locaux de Postfix canonical(5), réécriture d’adresses d’entrée de Postfix generic(5), réécriture d’adresses de sortie de Postfix header_checks(5), body_checks(5), inspection du contenu de Postfix relocated(5), utilisateurs qui ont déménagé transport(5), table de routage de Postfix virtual(5), alias virtuels de Postfix
Mécanismes de recherche dans les tables : cidr_table(5), associe un motif CIDR à une valeur ldap_table(5), client LDAP de Postfix lmdb_table(5), pilote de base de données LMDB de Postfix memcache_table(5), client memcache de Postfix mongodb_table(5), client MongoDB de Postfix mysql_table(5), client MySQL de Postfix nisplus_table(5), client NIS+ de Postfix pcre_table(5), associe un motif PCRE à une valeur pgsql_table(5), client PostgreSQL de Postfix regexp_table(5), associe un motif d’expression régulière POSIX à une valeur socketmap_table(5), client socketmap de Postfix sqlite_table(5), pilote de base de données SQLite de Postfix tcp_table(5), recherche de table client-serveur de Postfix
Processus démons : anvil(8), limitation de connexion/débit de Postfix bounce(8), defer(8), trace(8), rapports d’état de la remise cleanup(8), canonicalise et met en file d’attente les messages discard(8), agent de remise d’annulation de Postfix dnsblog(8), journalisation de la liste d’autorisation/de blocage DNS error(8), agent de remise d’erreur de Postfix flush(8), service ETRN rapide de Postfix local(8), agent de remise local de Postfix master(8), démon principal de Postfix oqmgr(8), ancien gestionnaire de file d’attente de Postfix pickup(8), récupération de courrier local de Postfix pipe(8), transmet le courrier à une commande non Postfix postlogd(8), service de journalisation interne de Postfix postscreen(8), bloqueur de processus zombies de Postfix proxymap(8), serveur proxy de recherche de table de Postfix qmgr(8), gestionnaire de file d’attente de Postfix qmqpd(8), serveur QMQP de Postfix scache(8), gestionnaire de cache de connexion de Postfix showq(8), liste la file d’attente de courrier de Postfix smtp(8), lmtp(8), client SMTP/LMTP de Postfix smtpd(8), serveur SMTP de Postfix spawn(8), exécute un serveur non Postfix tlsmgr(8), cache TLS et gestionnaire d’aléatoire de Postfix tlsproxy(8), serveur proxy TLS de Postfix trivial-rewrite(8), réécriture d’adresse de Postfix verify(8), vérification d’adresse de Postfix virtual(8), agent de remise virtuel de Postfix
Autres :
syslogd(8), journalisation du système
FICHIERS README
Utilisez « postconf readme_directory » ou « postconf html_directory » pour localiser ces informations. OVERVIEW, aperçu des commandes et processus de Postfix BASIC_CONFIGURATION_README, configuration de base de Postfix ADDRESS_REWRITING_README, réécriture d’adresse de Postfix SMTPD_ACCESS_README, contrôle d’accès/relais SMTP CONTENT_INSPECTION_README, inspection du contenu de Postfix QSHAPE_README, analyse de la file d’attente de Postfix
LICENCE
La licence Secure Mailer doit être distribuée avec ce logiciel.
AUTEUR(S)
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
Prise en charge de TLS par :
Lutz Jaenicke Brandenburg University of Technology Cottbus, Allemagne
Victor Duchovni Morgan Stanley
Prise en charge SASL initialement par :
Till Franke SuSE Rhein/Main AG 65760 Eschborn, Allemagne
Prise en charge LMTP initialement par :
Philip A. Prindeville Mirapoint, Inc. USA.
Amos Gouaux University of Texas at Dallas P.O. Box 830688, MC34 Richardson, TX 75083, USA
Prise en charge IPv6 initialement par :
Mark Huizer, Eindhoven University, Pays-Bas Jun-ichiro 'itojun' Hagino, KAME project, Japon The Linux PLD project Dean Strik, Eindhoven University, Pays-Bas