xref: /netbsd-src/external/ibm-public/postfix/dist/html/dnsblog.8.html (revision 796c32c94f6e154afc9de0f63da35c91bb739b45)
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=us-ascii">
5<title> Postfix manual - dnsblog(8) </title>
6</head> <body> <pre>
7DNSBLOG(8)                                                          DNSBLOG(8)
8
9<b>NAME</b>
10       dnsblog - Postfix DNS white/blacklist 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 white/blacklist 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 white/black-
22       list domain name, an IP address, and an  ID.   If  the  IP  address  is
23       listed  under  the  DNS white/blacklist, the <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a> server logs the
24       match and replies with the query arguments plus an  address  list  with
25       the resulting IP addresses, separated by whitespace, and the reply TTL.
26       Otherwise it replies with the query arguments  plus  an  empty  address
27       list  and  the  reply TTL (-1 if unavailable).  Finally, The <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a>
28       server closes the connection.
29
30<b>DIAGNOSTICS</b>
31       Problems and transactions are logged to <b>syslogd</b>(8).
32
33<b>CONFIGURATION PARAMETERS</b>
34       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
35       run for only a limited amount of time. Use the command "<b>postfix reload</b>"
36       to speed up a change.
37
38       The text below provides only a parameter summary. See  <a href="postconf.5.html"><b>postconf</b>(5)</a>  for
39       more details including examples.
40
41       <b><a href="postconf.5.html#config_directory">config_directory</a> (see 'postconf -d' output)</b>
42              The  default  location of the Postfix <a href="postconf.5.html">main.cf</a> and <a href="master.5.html">master.cf</a> con-
43              figuration files.
44
45       <b><a href="postconf.5.html#daemon_timeout">daemon_timeout</a> (18000s)</b>
46              How much time a Postfix daemon process  may  take  to  handle  a
47              request before it is terminated by a built-in watchdog timer.
48
49       <b><a href="postconf.5.html#postscreen_dnsbl_sites">postscreen_dnsbl_sites</a> (empty)</b>
50              Optional list of DNS white/blacklist domains, filters and weight
51              factors.
52
53       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
54              The time limit for sending  or  receiving  information  over  an
55              internal communication channel.
56
57       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
58              The process ID of a Postfix command or daemon process.
59
60       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
61              The process name of a Postfix command or daemon process.
62
63       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
64              The location of the Postfix top-level queue directory.
65
66       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
67              The syslog facility of Postfix logging.
68
69       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
70              The  mail  system  name that is prepended to the process name in
71              syslog records, so that "smtpd"  becomes,  for  example,  "post-
72              fix/smtpd".
73
74<b>SEE ALSO</b>
75       <a href="smtpd.8.html">smtpd(8)</a>, Postfix SMTP server
76       <a href="postconf.5.html">postconf(5)</a>, configuration parameters
77       syslogd(5), system logging
78
79<b>LICENSE</b>
80       The Secure Mailer license must be distributed with this software.
81
82<b>HISTORY</b>
83       This service was introduced with Postfix version 2.8.
84
85<b>AUTHOR(S)</b>
86       Wietse Venema
87       IBM T.J. Watson Research
88       P.O. Box 704
89       Yorktown Heights, NY 10598, USA
90
91       Wietse Venema
92       Google, Inc.
93       111 8th Avenue
94       New York, NY 10011, USA
95
96                                                                    DNSBLOG(8)
97</pre> </body> </html>
98