xref: /netbsd-src/external/ibm-public/postfix/dist/html/dnsblog.8.html (revision c3ab26950fe8540fb553d1d1dcae454bc98e5a25)
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
17       white/blacklist lookup service.  This  may  eventually  be
18       replaced  by an UDP client that is built directly into the
19       <a href="postscreen.8.html"><b>postscreen</b>(8)</a> server.
20
21<b>PROTOCOL</b>
22       With each connection, the <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a> server receives a DNS
23       white/blacklist  domain  name,  IP address, and an ID.  If
24       the address is listed under the DNS  white/blacklist,  the
25       <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a>  server  logs  the  match  and replies with the
26       query arguments plus an address list with the resulting IP
27       addresses  separated  by whitespace.  Otherwise it replies
28       with the query  arguments  plus  an  empty  address  list.
29       Finally, The <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).
33
34<b>CONFIGURATION PARAMETERS</b>
35       Changes  to  <a href="postconf.5.html"><b>main.cf</b></a>  are picked up automatically, as <b>dns-</b>
36       <b>blog</b>(8) processes run for only a limited amount  of  time.
37       Use the command "<b>postfix reload</b>" to speed up a change.
38
39       The  text  below  provides  only  a parameter summary. See
40       <a href="postconf.5.html"><b>postconf</b>(5)</a> for 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
44              <a href="master.5.html">master.cf</a> configuration 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
48              handle a request  before  it  is  terminated  by  a
49              built-in watchdog timer.
50
51       <b><a href="postconf.5.html#postscreen_dnsbl_sites">postscreen_dnsbl_sites</a> (empty)</b>
52              Optional  list of DNS white/blacklist domains, fil-
53              ters and weight factors.
54
55       <b><a href="postconf.5.html#ipc_timeout">ipc_timeout</a> (3600s)</b>
56              The time limit for sending or receiving information
57              over an internal communication channel.
58
59       <b><a href="postconf.5.html#process_id">process_id</a> (read-only)</b>
60              The  process  ID  of  a  Postfix  command or daemon
61              process.
62
63       <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
64              The process name of a  Postfix  command  or  daemon
65              process.
66
67       <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
68              The  location of the Postfix top-level queue direc-
69              tory.
70
71       <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
72              The syslog facility of Postfix logging.
73
74       <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
75              The mail system  name  that  is  prepended  to  the
76              process  name  in  syslog  records, so that "smtpd"
77              becomes, for example, "postfix/smtpd".
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       syslogd(5), system logging
83
84<b>LICENSE</b>
85       The Secure Mailer license must be  distributed  with  this
86       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                                                                    DNSBLOG(8)
98</pre> </body> </html>
99