commit: 4b31645ff7767f9b549c8d8bde50ff7fda6c32df Author: Michael Orlitzky <mjo <AT> gentoo <DOT> org> AuthorDate: Wed Apr 24 11:51:46 2024 +0000 Commit: Michael Orlitzky <mjo <AT> gentoo <DOT> org> CommitDate: Wed Apr 24 11:54:24 2024 +0000 URL: https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=4b31645f
net-mail/list-remote-forwards: drop long longdescription Signed-off-by: Michael Orlitzky <mjo <AT> gentoo.org> net-mail/list-remote-forwards/metadata.xml | 146 ++--------------------------- 1 file changed, 8 insertions(+), 138 deletions(-) diff --git a/net-mail/list-remote-forwards/metadata.xml b/net-mail/list-remote-forwards/metadata.xml index d81f432bdff8..062f4341e706 100644 --- a/net-mail/list-remote-forwards/metadata.xml +++ b/net-mail/list-remote-forwards/metadata.xml @@ -1,142 +1,12 @@ <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE pkgmetadata SYSTEM "https://www.gentoo.org/dtd/metadata.dtd";> <pkgmetadata> - <maintainer type="person"> - <email>[email protected]</email> - <name>Michael Orlitzky</name> - </maintainer> - <maintainer type="project"> - <email>[email protected]</email> - <name>Gentoo Haskell</name> - </maintainer> - <longdescription> - /Usage/: - - @ - list-remote-forwards [OPTIONS] - @ - - List all remote forwards for mail accounts stored in a SQL database. - - A list of local domains is supplied to the program (more or less) - through the @--domain-query@ option. Any addresses which - forward to another address not contained in this list of local domains - is considered a remote forward. Remote forwards can cause problems for - a number of reasons, the most common of which are, - - * If the sender has an SPF record authorizing his mail server to send - mail on his behalf, then when his message is forwarded by the - recipient's mail server, it will fail any subsequent SPF checks. This - will likely cause the message to be rejected, and the original - recipient's server will generate backscatter. - - * If any spam makes it through the filter on the recipient's mail - server, that spam will then be forwarded to a remote destination. The - remote destination will blame the forwarding server for the spam, and - that can impact its reputation and potentially lead to a blacklisting - even though the spam did not originate on the recipient's server. - - Whether or not these are an issue depends on the circumstances, but in - any case it is useful to know who is forwarding mail off-site. - - /Input:/ - - None. - - /Output:/ - - A list of addresses that are forwarded to remote domains. - - /Options/: - - @ - \--database - @ - - The name of the database (or file, if SQLite) to which we should - connect. - - Default: The name of the current user (Postgres only). - - @ - \--domain-query - @ - SQL query used to produce a list of local domains. This should return - the set of all domains (i.e one column) that are local to the - server. See the default value for an example. - - Default: \"SELECT domain FROM domain WHERE domain <> 'ALL' ORDER BY domain;\" - - @ - \--exclude-mx, -e - @ - - The name of a mail exchanger, the forwards of whose domains we should - ignore. For example, if one mail exchanger, mx1.example.com, has - strict spam filtering, it may be acceptable to have remote forwarding - for domains that have mx1.example.com as their sole mail exchanger (MX - record). In that case, you might want to exclude those domains from - the report by naming mx1.example.com here. - - A forward will be excluded from the report only if /all/ of its MX - records are contained in the given exclude list. - - This option can be repeated to add mail exchangers to the exclude list. - - Default: [] (empty) - - @ - \--forward-query, -f - @ - - SQL query used to produce a list of all forwards on the mail - system. This query should return the set of all (address, goto) - triples, where \"goto\" is the destination address; i.e. to where - the \"address\" forwards. The \"goto\" field may contain more - than one email address, separated by commas. - - Default: \"SELECT address,goto FROM alias ORDER BY address;\" - - @ - \--host, -h - @ - - Hostname where the database is located (Postgres-only). - - Default: None, a UNIX domain socket connection is attempted (Postgres only) - - @ - \--password - @ - - Password used to connect to the database (Postgres-only). - - Default: None (assumes passwordless authentication) - - @ - \--port - @ - Port number used to connect to the database (Postgres-only). - - Default: None, a UNIX domain socket connection is attempted (Postgres only) - - @ - \--username, -u - @ - - Username used to connect to the database (Postgres-only). - - Default: The current user - - /Examples/: - - @ - $ list-remote-forwards --database=test/fixtures/postfixadmin.sqlite3 - [email protected] -> [email protected] - [email protected] -> [email protected] - [email protected] -> [email protected] - [email protected] -> [email protected] - [email protected] -> [email protected] - @ - </longdescription> + <maintainer type="person"> + <email>[email protected]</email> + <name>Michael Orlitzky</name> + </maintainer> + <maintainer type="project"> + <email>[email protected]</email> + <name>Gentoo Haskell</name> + </maintainer> </pkgmetadata>
