mirror of
https://kernel.googlesource.com/pub/scm/linux/kernel/git/tglx/remail.git
synced 2024-11-24 21:32:39 +01:00
05ac7bb6ac
When using pipe mode configuration updates are not handled until the next mail is sent to the list. That means that e.g. welcome mails are delayed. Add a command line option to allow the invocation of remail_pipe just to deal with configuration updates without trying to process mail from stdin. The update handling is serialized against concurrent incoming mail via the folder lock, so no extra serialization is required. Whichever comes first handles it. Reported-by: Konstantin Ryabitsev <konstantin@linuxfoundation.org> Signed-off-by: Thomas Gleixner <tglx@linutronix.de> Tested-by: Konstantin Ryabitsev <konstantin@linuxfoundation.org>
82 lines
2 KiB
ReStructuredText
82 lines
2 KiB
ReStructuredText
.. SPDX-License-Identifier: GPL-2.0
|
|
|
|
.. _remail_pipe_man:
|
|
|
|
remail_pipe manual page
|
|
=========================
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
**remail_pipe** [*options*] config_file
|
|
|
|
Description
|
|
-----------
|
|
|
|
:program:`remail_pipe`, The pipe script for decrypting incoming mail and
|
|
sending it re-encrypted to the subscribers of an encrypted mailing
|
|
list. The incoming mail is read from stdin.
|
|
|
|
|
|
Options
|
|
-------
|
|
|
|
-h, --help
|
|
Show this help message and exit
|
|
|
|
-c, --cfgupdate
|
|
Read the configuration update and do not process mail from stdin. That
|
|
allows to send out welcome mails after a list configuration file was
|
|
updated. Otherwise the welcome mails are delayed until actual mail
|
|
delivery happens. The update and welcome mail processing is serialized
|
|
via the lock file in the working directory; no external serialization
|
|
against a concurrent mail delivery required.
|
|
|
|
-s syslog, --syslog
|
|
Use syslog for logging. Default is stderr
|
|
|
|
-v, --verbose
|
|
Enable verbose logging.
|
|
|
|
-V, --version
|
|
Display version information
|
|
|
|
|
|
Configuration file
|
|
------------------
|
|
|
|
remail_pipe reads the configuration file which was handed in as command
|
|
line argument. The configuration file is a simple yaml file. Non-mandatory
|
|
configuration options which are not in the configuration file are set to
|
|
the default values.
|
|
|
|
See the configuration file man page for detailed information.
|
|
|
|
|
|
Work directory
|
|
--------------
|
|
|
|
remail pipe assumes that the configuration file is in the work directory
|
|
which has a defined layout and content. The directory structure is
|
|
documented in the full remail documentation along with hints how to manage
|
|
encrypted mailing lists.
|
|
|
|
Exit codes
|
|
----------
|
|
|
|
.. list-table::
|
|
|
|
* - 0
|
|
- Mail was successfully delivered or config update was successful
|
|
* - 1
|
|
- No enabled mailinglist found for delivery
|
|
* - 2
|
|
- Mail processing incomplete. See log output
|
|
* - 11
|
|
- Configuration error
|
|
* - 12
|
|
- Fatal exception
|
|
|
|
See also
|
|
--------
|
|
:manpage:`remail.config(5)`
|