Home | History | Annotate | Line # | Download | only in proto
      1      1.1      tron <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
      2  1.1.1.4  christos         "https://www.w3.org/TR/html4/loose.dtd">
      3      1.1      tron 
      4      1.1      tron <html>
      5      1.1      tron 
      6      1.1      tron <head>
      7      1.1      tron 
      8      1.1      tron <title>Postfix memcache client Howto</title>
      9      1.1      tron 
     10  1.1.1.2  christos <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
     11  1.1.1.3  christos <link rel='stylesheet' type='text/css' href='postfix-doc.css'>
     12      1.1      tron 
     13      1.1      tron </head>
     14      1.1      tron 
     15      1.1      tron <body>
     16      1.1      tron 
     17      1.1      tron <h1><img src="postfix-logo.jpg" width="203" height="98" ALT="">Postfix memcache client Howto</h1>
     18      1.1      tron 
     19      1.1      tron <hr>
     20      1.1      tron 
     21      1.1      tron <h2>Introduction</h2>
     22      1.1      tron 
     23      1.1      tron <p>The Postfix memcache client allows you to hook up Postfix to a
     24      1.1      tron memcache server. The current implementation supports one memcache
     25      1.1      tron server per Postfix table, with one optional Postfix database that
     26      1.1      tron provides persistent backup.  The Postfix memcache client supports
     27      1.1      tron the lookup, update, delete and sequence operations.  The sequence
     28      1.1      tron (i.e. first/next) operation requires a backup database that supports
     29      1.1      tron this operation. </p>
     30      1.1      tron 
     31      1.1      tron <p> Typically, the Postfix memcache client is used to reduce query
     32      1.1      tron load on a persistent database, but it may also be used to query a
     33      1.1      tron memory-only database for low-value, easy-to-recreate, information
     34      1.1      tron such as a reputation cache for postscreen(8), verify(8) or greylisting.
     35      1.1      tron </p>
     36      1.1      tron 
     37      1.1      tron <h2>Limitations</h2>
     38      1.1      tron 
     39      1.1      tron <ul>
     40      1.1      tron 
     41      1.1      tron <li> <p> The Postfix memcache client cannot be used for security-sensitive
     42      1.1      tron tables such as <tt>alias_maps</tt> (these may contain "<tt>|command</tt>"
     43      1.1      tron and "<tt>/file/name</tt>" destinations), or <tt>virtual_uid_maps</tt>,
     44      1.1      tron <tt>virtual_gid_maps</tt> and <tt>virtual_mailbox_maps</tt> (these
     45      1.1      tron specify UNIX process privileges or "<tt>/file/name</tt>" destinations).
     46      1.1      tron Typically, a memcache database is writable by any process that can
     47      1.1      tron talk to the memcache server; in contrast, security-sensitive tables
     48      1.1      tron must never be writable by the unprivileged Postfix user.  </p>
     49      1.1      tron 
     50      1.1      tron <li> <p> The Postfix memcache client requires additional configuration
     51      1.1      tron when used as postscreen(8) or verify(8) cache.  For details see the
     52      1.1      tron <tt>backup</tt> and <tt>ttl</tt> parameter discussions in the
     53      1.1      tron memcache_table(5) manual page. </p>
     54      1.1      tron 
     55      1.1      tron </ul>
     56      1.1      tron 
     57      1.1      tron <h2>Building Postfix with memcache support</h2>
     58      1.1      tron 
     59      1.1      tron <p>The Postfix memcache client has no external dependencies,
     60      1.1      tron and is therefore built into Postfix by default. </p>
     61      1.1      tron 
     62      1.1      tron <h2>Configuring memcache lookup tables</h2>
     63      1.1      tron 
     64      1.1      tron <p> Configuration is described in the memcache_table(5) manpage. </p>
     65      1.1      tron 
     66      1.1      tron <h2>Credits</h2>
     67      1.1      tron 
     68      1.1      tron <p> The first memcache client for Postfix was written by Omar Kilani,
     69      1.1      tron and was based on the libmemcache library. </p>
     70      1.1      tron 
     71      1.1      tron <p> Wietse wrote the current memcache client from the ground up for
     72      1.1      tron Postfix version 2.9.  This implementation does not use libmemcache,
     73      1.1      tron and bears no resemblance to earlier work.  </p>
     74      1.1      tron 
     75      1.1      tron </body>
     76      1.1      tron 
     77      1.1      tron </html>
     78