postfix-master/nisplus_table.5.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 - nisplus_table(5) </title>
   6 </head> <body> <pre>
   7 NISPLUS_TABLE(5)                                              NISPLUS_TABLE(5)
   8
   9 <b>NAME</b>
  10        nisplus_table - Postfix NIS+ client
  11
  12 <b>SYNOPSIS</b>
  13        <b>postmap -q "</b><i>string</i><b>" "<a href="nisplus_table.5.html">nisplus</a>:[</b><i>name</i><b>=%s];</b><i>name.name.</i><b>"</b>
  14
  15        <b>postmap -q - "<a href="nisplus_table.5.html">nisplus</a>:[</b><i>name</i><b>=%s];</b><i>name.name.</i><b>"</b> &lt;<i>inputfile</i>
  16
  17 <b>DESCRIPTION</b>
  18        The  Postfix  mail  system  uses  optional  lookup tables.
  19        These tables are usually in <b>dbm</b> or  <b>db</b>  format.   Alterna-
  20        tively,  lookup tables can be specified as NIS+ databases.
  21
  22        To find out what types of lookup tables your Postfix  sys-
  23        tem supports use the "<b>postconf -m</b>" command.
  24
  25        To  test  Postfix NIS+ lookup tables, use the "<b>postmap -q</b>"
  26        command as described in the SYNOPSIS above.
  27
  28 <b>QUERY SYNTAX</b>
  29        Most of the NIS+ query is specified via the NIS+ map name.
  30        The  general  format of a Postfix NIS+ map name is as fol-
  31        lows:
  32
  33            <b><a href="nisplus_table.5.html">nisplus</a>:[</b><i>name</i><b>=%s];</b><i>name.name.name</i><b>.:</b><i>column</i>
  34
  35        Postfix NIS+ map names differ from what one normally would
  36        use with commands such as <b>niscat</b>:
  37
  38        <b>o</b>      With  each NIS+ table lookup, "<b>%s</b>" is replaced by a
  39               version of the lookup string.  There  can  be  only
  40               one "<b>%s</b>" instance in a Postfix NIS+ map name.
  41
  42        <b>o</b>      Postfix  NIS+  map  names  use  "<b>;</b>" instead of "<b>,</b>",
  43               because the latter  character  is  special  in  the
  44               Postfix <a href="postconf.5.html">main.cf</a> file.  Postfix replaces "<b>;</b>" charac-
  45               ters in the map name  by  "<b>,</b>"  before  making  NIS+
  46               queries.
  47
  48        <b>o</b>      The ":<i>column</i>" part in the NIS+ map name is not part
  49               of the actual NIS+ query. Instead, it specifies the
  50               number of the table column that provides the lookup
  51               result. When no ":<i>column</i>" is  specified  the  first
  52               column (1) is used.
  53
  54 <b>EXAMPLE</b>
  55        A NIS+ aliases map might be queried as follows:
  56
  57            <a href="postconf.5.html#alias_maps">alias_maps</a> = dbm:/etc/mail/aliases,
  58                <a href="nisplus_table.5.html">nisplus</a>:[alias=%s];mail_aliases.org_dir.$<a href="postconf.5.html#mydomain">mydomain</a>.:1
  59
  60        This  queries the local aliases file before the NIS+ file.
  61
  62 <b>SEE ALSO</b>
  63        <a href="postmap.1.html">postmap(1)</a>, Postfix lookup table manager
  64
  65 <b>README FILES</b>
  66        <a href="DATABASE_README.html">DATABASE_README</a>, Postfix lookup table overview
  67
  68 <b>LICENSE</b>
  69        The  Secure  Mailer  license must be distributed with this
  70        software.
  71
  72 <b>AUTHOR(S)</b>
  73        Geoff Gibbs
  74        UK-HGMP-RC
  75        Hinxton
  76        Cambridge
  77        CB10 1SB, UK
  78
  79        Adopted and adapted by:
  80        Wietse Venema
  81        IBM T.J. Watson Research
  82        P.O. Box 704
  83        Yorktown Heights, NY 10598, USA
  84
  85                                                               NISPLUS_TABLE(5)
  86 </pre> </body> </html>