summaryrefslogtreecommitdiffstats
path: root/tcpd
diff options
context:
space:
mode:
authorSam Varshavchik2020-10-27 20:04:18 -0400
committerSam Varshavchik2020-10-27 20:04:18 -0400
commit6441fb0adc939f73f75fc1b03ee7f42bd57a1b2b (patch)
tree29acca57c42cc21eb2c1ee2780b85e1fcb18a29d /tcpd
parent173736bb46202f970a4167f2ea66cf12a0977087 (diff)
downloadcourier-libs-6441fb0adc939f73f75fc1b03ee7f42bd57a1b2b.tar.bz2
Update documentation
Diffstat (limited to 'tcpd')
-rw-r--r--tcpd/couriertcpd.sgml18
1 files changed, 14 insertions, 4 deletions
diff --git a/tcpd/couriertcpd.sgml b/tcpd/couriertcpd.sgml
index 1d10157..86d5038 100644
--- a/tcpd/couriertcpd.sgml
+++ b/tcpd/couriertcpd.sgml
@@ -1,5 +1,5 @@
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
-<!-- Copyright 2000-2015 Double Precision, Inc. See COPYING for -->
+<!-- Copyright 2000-2020 Double Precision, Inc. See COPYING for -->
<!-- distribution information. -->
<refentry>
<info><author><firstname>Sam</firstname><surname>Varshavchik</surname><contrib>Author</contrib></author><productname>Courier Mail Server</productname></info>
@@ -122,9 +122,9 @@ information.</para>
</varlistentry>
<varlistentry>
- <term>-block=<replaceable>zone</replaceable>[,<replaceable>var</replaceable>[/<replaceable>n.n.n.n</replaceable>][,<replaceable>msg</replaceable>]]
+ <term>-block=<replaceable>zone</replaceable>[=<replaceable>display_zone</replaceable>][,<replaceable>var</replaceable>[/<replaceable>n.n.n.n</replaceable>][,<replaceable>msg</replaceable>]]
or
- -allow=<replaceable>zone</replaceable>[,<replaceable>var</replaceable>[/<replaceable>n.n.n.n</replaceable>[,]]]</term>
+ -allow=<replaceable>zone</replaceable>[=<replaceable>display_zone</replaceable>][,<replaceable>var</replaceable>[/<replaceable>n.n.n.n</replaceable>[,]]]</term>
<listitem>
<para>
Initialize the environment variable <replaceable>var</replaceable> if both of
@@ -681,6 +681,15 @@ file, the entry for the most specific IP address.</para>
</para>
<para>
+ An optional <quote>=<replaceable>display_zone</replaceable></quote>
+ follows the DNS zone. This sets the contents of
+ <varname>BLOCK_ZONE</varname> DNS access list variable (see
+ below), which defaults to the DNS zone name. This is only useful
+ with <option>-allow</option>, since <option>-block</option> rejects
+ the message, so nothing gets set anyway.
+ </para>
+
+ <para>
For IPv6 addresses, the DNS query consists of individual hexadecimal
nybbles (in reverse order, like the IPv4 query).
</para>
@@ -887,7 +896,8 @@ file, the entry for the most specific IP address.</para>
<term>BLOCK_ZONE</term>
<para>
The DNS zone of the succesfull access list lookup, like
- <quote>dnsbl.example.com</quote>.
+ <quote>dnsbl.example.com</quote>, or an explicit
+ display zone name.
</para>
</varlistentry>
</variablelist>