Différences
Ci-dessous, les différences entre deux révisions de la page.
Prochaine révision | Révision précédenteProchaine révisionLes deux révisions suivantes | ||
logiciel:systeme:msmtp:config:param:start [2022/06/25 17:48] – créée admin | logiciel:systeme:msmtp:config:param:start [2022/06/25 19:04] – [Commandes d'authentification] admin | ||
---|---|---|---|
Ligne 5: | Ligne 5: | ||
===== Commandes générales ===== | ===== Commandes générales ===== | ||
+ | ; defaults | ||
+ | : Définir les valeurs par défaut. Les commandes suivantes définiront les valeurs par défaut pour toutes les définitions de compte suivantes dans le fichier de configuration actuel. | ||
+ | ; account name [: account[, | ||
+ | : Commence une nouvelle définition de compte avec le nom donné. Les valeurs par défaut en cours sont renseignées. Si deux-points et une liste de comptes précédemment définis sont donnés après le nom du compte, le nouveau compte, avec les valeurs par défaut renseignées, | ||
+ | ; host hostname | ||
+ | : Le serveur SMTP auquel envoyer le courrier. L' | ||
+ | ; port number | ||
+ | : Port d' | ||
+ | ; source_ip [IP] | ||
+ | : Définit une adresse IP source à laquelle lier la connexion sortante. Utile seulement dans des cas particuliers, | ||
+ | ; proxy_host [IP|hostname] | ||
+ | : Utiliser un proxy SOCKS. Tout le trafic réseau passera par cet hôte proxy, y compris les requêtes DNS, à l' | ||
+ | ; proxy_port [number] | ||
+ | : Numéro de port pour l' | ||
+ | ; socket [socketname] | ||
+ | : Nom de fichier d'un socket de domaine Unix auquel se connecter. Cela remplace à la fois ' | ||
+ | ; timeout (off|seconds) | ||
+ | : Définit ou désactive un délai d' | ||
+ | ; protocol (smtp|lmtp) | ||
+ | : Protocole à utiliser. Actuellement, | ||
+ | ; domain argument | ||
+ | : Cette commande définit l' | ||
+ | * %H sera remplacé par $HOSTNAME, ou en cas d' | ||
+ | * %C sera remplacé par le nom canonique de %H. | ||
+ | * %M sera remplacé par le contenu de / | ||
===== Commandes d' | ===== Commandes d' | ||
+ | ; auth [(on|off|method)] | ||
+ | : Activation ou désaction de l' | ||
+ | ; user [username] | ||
+ | : Nom d' | ||
+ | ; password [secret] | ||
+ | : Mot de passe pour l' | ||
+ | ; passwordeval [eval] | ||
+ | : Définit le mot de passe pour l' | ||
===== Commandes TLS ===== | ===== Commandes TLS ===== | ||
+ | ; ‘tls [(on|off)]’ | ||
+ | : Enable or disable TLS (also known as SSL) for secured connections. | ||
+ | ; ‘tls_starttls [(on|off)]’ | ||
+ | : Choose the TLS variant: start TLS from within the session (‘on’, default), or tunnel the session through TLS (‘off’). | ||
+ | ; ‘tls_trust_file [file]’ | ||
+ | : Activate server certificate verification using a list of trusted Certification Authorities (CAs). The default is the special value ‘system’, | ||
+ | ; ‘tls_fingerprint [fingerprint]’ | ||
+ | : Set the fingerprint of a single certificate to accept for TLS. This certificate will be trusted regardless of its contents (this overrides ‘tls_trust_file’). The fingerprint should be of type SHA256, but can for backwards compatibility also be of type SHA1 or MD5 (please avoid this). The format should be 01: | ||
+ | ; ‘tls_key_file [file]’ | ||
+ | : Send a client certificate to the server (use this together with ‘tls_cert_file’). The file must contain the private key of a certificate in PEM format. An empty argument disables this feature. | ||
+ | ; ‘tls_cert_file [file]’ | ||
+ | : Send a client certificate to the server (use this together with ‘tls_key_file’). The file must contain a certificate in PEM format. An empty argument disables this feature. | ||
+ | ; ‘tls_certcheck [(on|off)]’ | ||
+ | : Enable or disable checks of the server certificate. They are enabled by default. Disabling them will override ‘tls_trust_file’ and ‘tls_fingerprint’. WARNING: When the checks are disabled, TLS sessions will not be secure! | ||
+ | ; ‘tls_priorities [priorities]’ | ||
+ | : Set priorities for TLS session parameters. The default is set by the TLS library and can be selected by using an empty argument to this command. The interpretation of the priorities string depends on the TLS library. Use ‘--version’ to find out which TLS library you use. For GnuTLS, see the section on Priority Strings in the manual. For libtls, the priorites string is a space-separated list of parameter strings prefixed with either PROTOCOLS=, CIPHERS=, or ECDHECURVES=. These parameter strings will be passed to the functions ‘tls_config_parse_protocols’, | ||
+ | ; ‘tls_host_override [host]’ | ||
+ | : By default, TLS host verification uses the host name given by the ‘host’ command. This command allows one to use a different host name for verification. This is only useful in special cases. | ||
===== Commandes propres au mode sendmail ===== | ===== Commandes propres au mode sendmail ===== | ||
+ | ; ‘from [address]’ | ||
+ | : Set the envelope-from address. The following substitution patterns are supported: | ||
+ | * %U will be replaced by $USER, or if that fails by $LOGNAME, or if that fails by the login name of the user running msmtp. | ||
+ | * %H will be replaced by $HOSTNAME, or if that fails by the host name of the system. | ||
+ | * %C will be replaced by the canonical name of %H. | ||
+ | * %M will be replaced by the contents of / | ||
+ | |||
+ | To enforce the use of this envelope-from address and ignore the ‘-f’ / ‘--from’ option, see [allow from override], page 6. See Section 7.1 [Envelope-from address], page 20. | ||
+ | Furthermore, | ||
+ | |||
+ | ; ‘allow_from_override (on|off)’ | ||
+ | : By default, the [–from], page 11, option overrides the [from], page 5, command. Set to ‘off’ to disable this. | ||
+ | ; ‘dsn_notify (off|condition)’ | ||
+ | : Set the condition(s) under which the mail system should send DSN (Delivery Status Notification) messages. The argument ‘off’ disables explicit DSN requests, which means the mail system decides when to send DSN messages. This is the default. The condition must be ‘never’, | ||
+ | ; ‘dsn_return (off|amount)’ | ||
+ | : This command controls how much of a mail should be returned in DSN (Delivery Status Notification) messages. The argument ‘off’ disables explicit DSN requests, which means the mail system decides how much of a mail it returns in DSN messages. This is the default. The amount must be ‘headers’, | ||
+ | ; ‘set_from_header [(auto|on|off)]’ | ||
+ | : When to set a From header: ‘auto’ adds a From header if the mail does not have one (this is the default), ‘on\’ always sets a From header and overrides any existing one, and ‘off’ never sets a From header. If the mail server rejects the mail because its From header does not match the envelope from address (a common anti-spam measure), then you might want to set this option to ‘on’. The From header is created based on the envelope-from address. Disable [allow from override], page 6, to prevent programs from setting their own envelope-from address. For compatibility with older versions, add_missing_from_header [(on|off)]’ is still supported and corresponds to the ‘auto’ and ‘off’ settings. See Section 7.3 [Header handling], page 20. | ||
+ | ; set_date_header [(auto|off)]’ | ||
+ | : When to set a Date header: ‘auto’ adds a Date header if the mail does not have one (this is the default), and ‘off’ never sets a Date header. For compatibility with older versions, ‘add_missing_date_header [(on|off)]’ is still supported and corresponds to the ‘auto’ and ‘off’ settings. See Section 7.3 [Header handling], page 20. | ||
+ | ; ‘remove_bcc_headers [(on|off)]’ | ||
+ | : This command controls whether to remove Bcc headers. The default is to remove them. | ||
+ | ; ‘undisclosed_recipients [(on|off)]’ | ||
+ | : When set, the original To, Cc, and Bcc headers of the mail are removed and a single new header line "To: undisclosed-recipients:;" | ||
+ | ; ‘logfile [file]’ | ||
+ | : Enable logging to the specified file. An empty argument disables logging. The file name ‘-’ directs the log information to standard output. See Section 7.2 [Logging], page 20. | ||
+ | ; ‘logfile_time_format [fmt]’ | ||
+ | : Set or unset the log file time format. This will be used as the format string for the strftime() function. An empty argument chooses the default (‘" | ||
+ | ; ‘syslog [(on|off|facility)]’ | ||
+ | : Enable or disable syslog logging. The facility can be one of ‘LOG_USER’, | ||
+ | ; ‘aliases [file]’ | ||
+ | : Replace local recipients with addresses in the aliases file. The aliases file is a cleartext file containing mappings between a local address and a list of replacement addresses. The mappings are of the form: local: someone@example.com, | ||
+ | ; ‘auto_from [(on|off)]’ | ||
+ | : Obsolete; you can achieve the same and more using the substitution patterns of the ‘from’ command. Enable or disable automatic envelope-from addresses. The default is ‘off’. When enabled, an envelope-from address of the form user@domain will be generated. The local part will be set to USER or, if that fails, to LOGNAME or, if that fails, to the login name of the current user. The domain part can be set with the ‘maildomain’ command; if that is empty, the address not have a domain part. See Section 7.1 [Envelope-from address], page 20. | ||
===== Voir aussi ===== | ===== Voir aussi ===== | ||