postfix-master/dnsblog.8.html

   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>
   7 DNSBLOG(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>