X-Git-Url: http://gitweb.michael.orlitzky.com/?p=list-remote-forwards.git;a=blobdiff_plain;f=doc%2Fman1%2Flist-remote-forwards.1;h=77eec6e43bbd469b7536fc908ad2153094e69590;hp=fb9fb5cfbdff05f206ab8b6cc7038ebb1f33482b;hb=f75845314598408bce3a1b972f2ba274d93d0e8d;hpb=e3ef76e60ddd54e5fad787c5883533d2410b3e2a diff --git a/doc/man1/list-remote-forwards.1 b/doc/man1/list-remote-forwards.1 index fb9fb5c..77eec6e 100644 --- a/doc/man1/list-remote-forwards.1 +++ b/doc/man1/list-remote-forwards.1 @@ -49,7 +49,22 @@ server. See the default value for an example. Default: \(dqSELECT domain FROM domain WHERE domain <> 'ALL' ORDER BY domain;\(dq -.IP \fB\-\-forward-query\fR +.IP \fB\-\-exclude-mx\fR,\ \fB-e\fR +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 \fIall\fR 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) + +.IP \fB\-\-forward-query\fR,\ \fB-f\fR 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 \(dqgoto\(dq is the destination address; i.e. to where @@ -58,7 +73,7 @@ than one email address, separated by commas. Default: \(dqSELECT address,goto FROM alias ORDER BY address;\(dq -.IP \fB\-\-host\fR +.IP \fB\-\-host\fR,\ \fB-h\fR Hostname where the database is located (Postgres-only). Default: None, a UNIX domain socket connection is attempted (Postgres only) @@ -73,7 +88,7 @@ Port number used to connect to the database (Postgres-only). Default: None, a UNIX domain socket connection is attempted (Postgres only) -.IP \fB\-\-username\fR +.IP \fB\-\-username\fR,\ \fB-u\fR Username used to connect to the database (Postgres-only). Default: The current user @@ -81,11 +96,12 @@ Default: The current user .SH EXAMPLES .nf -.I $ list-remote-forwards --database=postfixadmin.sqlite3 +.I $ list-remote-forwards --database=test/fixtures/postfixadmin.sqlite3 user1@example.com -> user1@example.net user2@example.com -> user1@example.org user2@example.com -> user2@example.org user2@example.com -> user3@example.org +user7@example.com -> user8@example.net .fi .SH BUGS .P