xref: /netbsd-src/external/ibm-public/postfix/dist/html/dnsblog.8.html (revision a45db23f655e22f0c2354600d3b3c2cb98abf2dc)
1<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2        "http://www.w3.org/TR/html4/loose.dtd">
3<html> <head>
4<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5<title> Postfix manual - dnsblog(8) </title>
6</head> <body> <pre>
7DNSBLOG(8)                                                          DNSBLOG(8)
8
9<b>NAME</b>
10       dnsblog - Postfix DNS allow/denylist logger
11
12<b>SYNOPSIS</b>
13       <b>dnsblog</b> [generic Postfix daemon options]
14
15<b>DESCRIPTION</b>
16       The  <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a>  server  implements an ad-hoc DNS allow/denylist lookup
17       service. This may eventually be replaced by an UDP client that is built
18       directly into the <a href="postscreen.8.html"><b>postscreen</b>(8)</a> server.
19
20<b>PROTOCOL</b>
21       With   each   connection,   the   <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a>   server  receives  a  DNS
22       allow/denylist domain name, an IP  address,  and  an  ID.   If  the  IP
23       address  is  listed under the DNS allow/denylist, the <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a> server
24       logs the match and replies with the query  arguments  plus  an  address
25       list  with the resulting IP addresses, separated by whitespace, and the
26       reply TTL.  Otherwise it replies with the query arguments plus an empty
27       address  list  and  the  reply  TTL; the reply TTL is -1 if there is no
28       reply, or a negative reply that contains no SOA record.   Finally,  the
29       <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a> server closes the connection.
30
31<b>DIAGNOSTICS</b>
32       Problems and transactions are logged to <b>syslogd</b>(8) or <a href="postlogd.8.html"><b>postlogd</b>(8)</a>.
33
34<b>CONFIGURATION PARAMETERS</b>
35       Changes to <a href="postconf.5.html"><b>main.cf</b></a> are picked up automatically, as <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a> processes
36       run for only a limited amount of time. Use the command "<b>postfix reload</b>"
37       to speed up a change.
38
39       The  text  below provides only a parameter summary. See <a href="postconf.5.html"><b>postconf</b>(5)</a> for
40       more details including examples.
41
42       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
43              The default location of the Postfix <a href="postconf.5.html">main.cf</a> and  <a href="master.5.html">master.cf</a>  con-
44              figuration files.
45
46       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
47              How  much  time  a  Postfix  daemon process may take to handle a
48              request before it is terminated by a built-in watchdog timer.
49
50       <b><a href="postconf.5.html#postscreen_dnsbl_sites">postscreen_dnsbl_sites</a> (empty)</b>
51              Optional list of DNS allow/denylist domains, filters and  weight
52              factors.
53
54       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
55              The  time  limit  for  sending  or receiving information over an
56              internal communication channel.
57
58       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
59              The process ID of a Postfix command or daemon process.
60
61       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
62              The process name of a Postfix command or daemon process.
63
64       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
65              The location of the Postfix top-level queue directory.
66
67       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
68              The syslog facility of Postfix logging.
69
70       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
71              A prefix that  is  prepended  to  the  process  name  in  syslog
72              records, so that, for example, "smtpd" becomes "prefix/smtpd".
73
74       Available in Postfix 3.3 and later:
75
76       <b><a href="postconf.5.html#service_name">service_name</a> (read-only)</b>
77              The <a href="master.5.html">master.cf</a> service name of a Postfix daemon process.
78
79<b>SEE ALSO</b>
80       <a href="smtpd.8.html">smtpd(8)</a>, Postfix SMTP server
81       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
82       <a href="postlogd.8.html">postlogd(8)</a>, Postfix logging
83       syslogd(8), system logging
84
85<b>LICENSE</b>
86       The Secure Mailer license must be distributed with this software.
87
88<b>HISTORY</b>
89       This service was introduced with Postfix version 2.8.
90
91<b>AUTHOR(S)</b>
92       Wietse Venema
93       IBM T.J. Watson Research
94       P.O. Box 704
95       Yorktown Heights, NY 10598, USA
96
97       Wietse Venema
98       Google, Inc.
99       111 8th Avenue
100       New York, NY 10011, USA
101
102                                                                    DNSBLOG(8)
103</pre> </body> </html>
104