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