2020-05-29 15:33:52 +00:00
|
|
|
cdist-type__mail_alias(7)
|
|
|
|
=========================
|
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2020-05-30 15:24:26 +00:00
|
|
|
cdist-type__mail_alias - Manage mail aliases.
|
2020-05-29 15:33:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
2020-10-01 10:55:38 +00:00
|
|
|
This cdist type allows you to configure mail aliases (/etc/aliases).
|
2020-05-29 15:33:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
|
|
-------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
|
|
-------------------
|
2020-05-30 15:24:26 +00:00
|
|
|
state
|
|
|
|
'present' or 'absent', defaults to 'present'
|
|
|
|
alias
|
2020-10-01 10:55:38 +00:00
|
|
|
an alias, i.e. a mail address where mail for the user should be redirected
|
|
|
|
to.
|
|
|
|
This parameter can be specified multiple times to redirect to multiple
|
|
|
|
recipients.
|
|
|
|
If ``--state`` is ``present`` this parameter is required.
|
|
|
|
See `aliases(5)` for the different forms this parameter can take.
|
2020-05-29 15:33:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
|
|
------------------
|
|
|
|
None.
|
|
|
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
--------
|
|
|
|
|
|
|
|
.. code-block:: sh
|
|
|
|
|
2020-05-30 15:24:26 +00:00
|
|
|
# Redirect root mail to a "real" email address
|
|
|
|
__mail_alias root --alias admin@example.com
|
2020-05-29 15:33:52 +00:00
|
|
|
|
2020-05-30 15:24:26 +00:00
|
|
|
# Disable redirection of mail for joe
|
|
|
|
__mail_alias joe --state absent
|
2020-05-29 15:33:52 +00:00
|
|
|
|
2020-06-11 18:50:42 +00:00
|
|
|
|
|
|
|
BUGS
|
|
|
|
----
|
2020-11-16 12:57:34 +00:00
|
|
|
- Quoted strings are not parsed by this type. As a result, aliases
|
|
|
|
containing ``,`` (commas) are treated incorrectly (they are treated as
|
|
|
|
separate aliases.)
|
|
|
|
Make sure that email addresses, file names, and pipe commands do not contain
|
|
|
|
commas.
|
|
|
|
- ``:include:`` directives in the aliases file are not evaluated by this type.
|
|
|
|
They are treated like a regular alias, the values of the included file are
|
|
|
|
not expanded.
|
|
|
|
|
2020-06-11 18:50:42 +00:00
|
|
|
|
2020-05-29 15:33:52 +00:00
|
|
|
SEE ALSO
|
|
|
|
--------
|
2020-05-30 15:24:26 +00:00
|
|
|
:strong:`aliases`\ (5)
|
2020-05-29 15:33:52 +00:00
|
|
|
|
|
|
|
|
|
|
|
AUTHORS
|
|
|
|
-------
|
|
|
|
Dennis Camera <dennis.camera@ssrq-sds-fds.ch>
|
|
|
|
|
|
|
|
|
|
|
|
COPYING
|
|
|
|
-------
|
|
|
|
Copyright \(C) 2020 Dennis Camera. You can redistribute it
|
|
|
|
and/or modify it under the terms of the GNU General Public License as
|
|
|
|
published by the Free Software Foundation, either version 3 of the
|
|
|
|
License, or (at your option) any later version.
|