MEMCACHE_TABLE(5)                                            MEMCACHE_TABLE(5)

NAME
       memcache_table - Postfix memcache client configuration

SYNOPSIS
       postmap -q "string" memcache:/etc/postfix/filename

       postmap -q - memcache:/etc/postfix/filename <inputfile

DESCRIPTION
       The  Postfix  mail system uses optional tables for address
       rewriting or mail routing. These tables are usually in dbm
       or db format.

       Alternatively, lookup tables can be specified as memcached
       instances.  In order to use  memcache  lookups,  define  a
       memcache source as a lookup table in main.cf, for example:
           alias_maps = memcache:/etc/postfix/memcache-aliases.cf

       The  file  /etc/postfix/memcache-aliases.cf  has  the same
       format as the Postfix main.cf file, and  can  specify  the
       parameters described below.

ALTERNATIVE CONFIGURATION
       For  compatibility  with other Postfix lookup tables, mem-
       cache parameters can also be defined in main.cf.  In order
       to do that, specify as memcache source a name that doesn't
       begin with a slash or a dot.  The memcache parameters will
       then  be accessible as the name you've given the source in
       its definition, an underscore, and the name of the parame-
       ter.   For  example,  if  the  map  is  specified as "mem-
       cache:memcache", the parameter "servers"  below  would  be
       defined in main.cf as "memcache_servers".

MEMCACHE PARAMETERS
       servers
              The  memcache servers that Postfix will try to con-
              nect to and query from.

              servers = mc01.some.domain mc02.some.domain

       The following parameters  provide  ways  to  override  the
       default key used:

       key_format
              Format  of  key  to use. Before the key is actually
              used, all occurrences of %s are replaced  with  the
              address  to  look up, %u are replaced with the user
              portion, and %d with the domain portion. For  exam-
              ple,  to use user:mail_alias as the key (where user
              is the user portion of the address):

              key_format = %u:mail_alias

              This parameter supports the  following  '%'  expan-
       sions:

              %s     This  is  replaced by the input key. Quoting
                     is used to make sure that the input key does
                     not add unexpected metacharacters.

              %u     When the input key is an address of the form
                     user@domain, %u is replaced  by  the  quoted
                     local  part of the address.  If no domain is
                     specified, %u  is  replaced  by  the  entire
                     search string.

              %d     When the input key is an address of the form
                     user@domain, %d is replaced  by  the  quoted
                     domain  part of the address.  When the input
                     key has no domain qualifier, %d is  replaced
                     by the entire search string.

SEE ALSO
       postmap(1), Postfix lookup table manager
       postconf(5), configuration parameters
       ldap_table(5), LDAP lookup tables
       mysql_table(5), MySQL lookup tables
       pgsql_table(5), PostgreSQL lookup tables

README FILES
       DATABASE_README, Postfix lookup table overview
       MEMCACHE_README, Postfix memcache client guide

LICENSE
       The Secure Mailer license must be  distributed  with  this
       software.

HISTORY
       memcache support was written on the 1st of April, 2005.

AUTHOR(S)
       Based on the MySQL client by:
       Scott Cotton, Joshua Marcus
       IC Group, Inc.

       Ported to PostgreSQL by:
       Aaron Sethman

       Modified for memcached by:
       Omar Kilani

       Further enhanced by:
       Liviu Daia
       Institute of Mathematics of the Romanian Academy
       P.O. BOX 1-764
       RO-014700 Bucharest, ROMANIA

                                                             MEMCACHE_TABLE(5)