add a pfixtools(7) entry man page

[apps/pfixtools.git] / example / postlicyd.conf

diff --git a/example/postlicyd.conf b/example/postlicyd.conf
index c5773b3..cff01b9 100644 (file)
--- a/example/postlicyd.conf
+++ b/example/postlicyd.conf
@@ -197,7 +197,15 @@ client_whitelist {
 #           - prefix: name (default: "")
 #             prefix to the name of the greylist database
 #           - lookup_by_host: boolean (default: false)
-#             perform lookup per host instead of domain.
+#             perform lookup per host. The default behaviour is to remove the last number of the IP
+#             to match a domain. This behaviour is disabled if a part of the IP is contained in the
+#             hostname (look like a dialup ip from a provider). With this flag on, the "domain"
+#             matching is always disable.
+#           - no_sender: boolean (default: false)
+#             do not use the sender address. Default behaviour is to greylist using the tuple
+#             (client_address, sender, recipient). With this flag on, the sender is not used.
+#           - no_recipient: boolean (default: false)
+#             same as no_sender but with recipient.
 #           - delay: number (default: 300)
 #             number of seconds the client must wait before retrial.
 #           - retry_window: (default: 2 * 24 * 3600)
@@ -208,13 +216,19 @@ client_whitelist {
 #           - max_age: number (default: 30 * 3600)
 #             lifetime of a greylist/whitelist session: ie, if a client does ne reappear during
 #             max_age seconds, the entries associated to this client are invalidated.
+#           - cleanup_period: number (default: 86400)
+#             minimum time between two cleanup of the database. You must keep in mind that cleanup
+#             is important since it remove useless entries from the database and thus help
+#             speeding up the lookups. A cleanup can take a few minutes if the database contains
+#             a lot of entries.
 #         Return value:
 #           - if the client is whitelisted, returns whitelist
 #           - if the client is greylisted, returns greylist
 #           - if a error occured (not currently possible), returns error
 #         State:
-#           this filter is a recipient filter and works in RCPT state only
-#           (smtpd_recipient_restrictions).
+#           this filter is a recipient filter and works in RCPT state onl if no_recipient
+#           is not specified (smtpd_recipient_restrictions). If no_sender is not given, this
+#           requires a sender name, and so must be called after MAIL TO.
 
 # Perform greylisting
 greylist {
@@ -332,4 +346,15 @@ recipient_filter = client_whitelist;
 
 port = 10000;
 
+
+# LOG FORMAT
+#
+# Format of the log printed in syslog. The actual format is "${log_format}: ..."
+#
+# This parameter uses the same format as used to reply to postfix (${field_name} to
+# add a field name).
+
+log_format = "request client=${client_name}[${client_address}] from=<${sender}> "
+             "to=<${recipient}> at ${protocol_state}";
+
 # vim:set syntax=conf: