dist/html/nisplus_table.5.html

<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - nisplus_table(5) </title>
</head> <body> <pre>
NISPLUS_TABLE(5)                                              NISPLUS_TABLE(5)

<b>NAME</b>
       nisplus_table - Postfix NIS+ client

<b>SYNOPSIS</b>
       <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>

       <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>

<b>DESCRIPTION</b>
       The  Postfix  mail  system  uses  optional  lookup tables.
       These tables are usually in <b>dbm</b> or  <b>db</b>  format.   Alterna-
       tively,  lookup tables can be specified as NIS+ databases.

       To find out what types of lookup tables your Postfix  sys-
       tem supports use the "<b>postconf -m</b>" command.

       To  test  Postfix NIS+ lookup tables, use the "<b>postmap -q</b>"
       command as described in the SYNOPSIS above.

<b>QUERY SYNTAX</b>
       Most of the NIS+ query is specified via the NIS+ map name.
       The  general  format of a Postfix NIS+ map name is as fol-
       lows:

           <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>

       Postfix NIS+ map names differ from what one normally would
       use with commands such as <b>niscat</b>:

       <b>o</b>      With  each NIS+ table lookup, "<b>%s</b>" is replaced by a
              version of the lookup string.  There  can  be  only
              one "<b>%s</b>" instance in a Postfix NIS+ map name.

       <b>o</b>      Postfix  NIS+  map  names  use  "<b>;</b>" instead of "<b>,</b>",
              because the latter  character  is  special  in  the
              Postfix <a href="postconf.5.html">main.cf</a> file.  Postfix replaces "<b>;</b>" charac-
              ters in the map name  by  "<b>,</b>"  before  making  NIS+
              queries.

       <b>o</b>      The ":<i>column</i>" part in the NIS+ map name is not part
              of the actual NIS+ query. Instead, it specifies the
              number of the table column that provides the lookup
              result. When no ":<i>column</i>" is  specified  the  first
              column (1) is used.

<b>EXAMPLE</b>
       A NIS+ aliases map might be queried as follows:

           <a href="postconf.5.html#alias_maps">alias_maps</a> = dbm:/etc/mail/aliases,
               <a href="nisplus_table.5.html">nisplus</a>:[alias=%s];mail_aliases.org_dir.$<a href="postconf.5.html#mydomain">mydomain</a>.:1

       This  queries the local aliases file before the NIS+ file.

<b>SEE ALSO</b>
       <a href="postmap.1.html">postmap(1)</a>, Postfix lookup table manager

<b>README FILES</b>
       <a href="DATABASE_README.html">DATABASE_README</a>, Postfix lookup table overview

<b>LICENSE</b>
       The  Secure  Mailer  license must be distributed with this
       software.

<b>AUTHOR(S)</b>
       Geoff Gibbs
       UK-HGMP-RC
       Hinxton
       Cambridge
       CB10 1SB, UK

       Adopted and adapted by:
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA

                                                              NISPLUS_TABLE(5)
</pre> </body> </html>