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