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  and  an  IP address. If the
  24        address is listed under the DNS white/blacklist, the  <b>dns-</b>
  25        <b>blog</b>(8)  server  logs the match and replies with the query
  26        arguments plus a non-zero status.   Otherwise  it  replies
  27        with the query arguments plus a zero status.  Finally, The
  28        <a href="dnsblog.8.html"><b>dnsblog</b>(8)</a> 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  <b>dns-</b>
  35        <b>blog</b>(8)  processes  run for only a limited amount of time.
  36        Use the command "<b>postfix reload</b>" to speed up a change.
  37
  38        The text below provides  only  a  parameter  summary.  See
  39        <a href="postconf.5.html"><b>postconf</b>(5)</a> for 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
  43               <a href="master.5.html">master.cf</a> configuration 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
  47               handle  a  request  before  it  is  terminated by a
  48               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 white/blacklist domains,  fil-
  52               ters and weight 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
  56               over an 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
  60               process.
  61
  62        <b><a href="postconf.5.html#process_name">process_name</a> (read-only)</b>
  63               The  process  name  of  a Postfix command or daemon
  64               process.
  65
  66        <b><a href="postconf.5.html#queue_directory">queue_directory</a> (see 'postconf -d' output)</b>
  67               The location of the Postfix top-level queue  direc-
  68               tory.
  69
  70        <b><a href="postconf.5.html#syslog_facility">syslog_facility</a> (mail)</b>
  71               The syslog facility of Postfix logging.
  72
  73        <b><a href="postconf.5.html#syslog_name">syslog_name</a> (see 'postconf -d' output)</b>
  74               The  mail  system  name  that  is  prepended to the
  75               process name in syslog  records,  so  that  "smtpd"
  76               becomes, for example, "postfix/smtpd".
  77
  78 <b>SEE ALSO</b>
  79        <a href="smtpd.8.html">smtpd(8)</a>, Postfix SMTP server
  80        <a href="postconf.5.html">postconf(5)</a>, configuration parameters
  81        syslogd(5), system logging
  82
  83 <b>LICENSE</b>
  84        The  Secure  Mailer  license must be distributed with this
  85        software.
  86
  87 <b>HISTORY</b>
  88        This service was introduced with Postfix version 2.8.
  89
  90 <b>AUTHOR(S)</b>
  91        Wietse Venema
  92        IBM T.J. Watson Research
  93        P.O. Box 704
  94        Yorktown Heights, NY 10598, USA
  95
  96                                                                     DNSBLOG(8)
  97 </pre> </body> </html>