dist/html/nisplus_table.5.html

<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "https://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link rel='stylesheet' type='text/css' href='postfix-doc.css'>
<title> Postfix manual - nisplus_table(5) </title>
</head> <body> <pre>
NISPLUS_TABLE(5)                                              NISPLUS_TABLE(5)

<b><a name="name">NAME</a></b>
       nisplus_table - Postfix NIS+ client

<b><a name="synopsis">SYNOPSIS</a></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><a name="description">DESCRIPTION</a></b>
       The Postfix mail system uses optional lookup tables.  rewriting or mail
       routing. These tables are usually in <b><a href="lmdb_table.5.html">lmdb</a>:</b>, <b><a href="CDB_README.html">cdb</a>:</b>, <b><a href="DATABASE_README.html#types">hash</a>:</b>, or  <b><a href="DATABASE_README.html#types">dbm</a>:</b>  for-
       mat.

       Alternatively,  lookup  tables  can be specified as NIS+ databases.  To
       find out what types of lookup tables your Postfix system  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><a name="query_syntax">QUERY SYNTAX</a></b>
       Most of the NIS+ query is specified via the NIS+ map name. The  general
       format of a Postfix NIS+ map name is as follows:

           <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  lat-
              ter  character  is special in the Postfix <a href="postconf.5.html">main.cf</a> file.  Postfix
              replaces "<b>;</b>" characters 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><a name="example">EXAMPLE</a></b>
       A NIS+ aliases map might be queried as follows:

           <a href="postconf.5.html#alias_maps">alias_maps</a> = <a href="DATABASE_README.html#types">dbm</a>:/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><a name="see_also">SEE ALSO</a></b>
       <a href="postmap.1.html">postmap(1)</a>, Postfix lookup table manager

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

<b><a name="license">LICENSE</a></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

       Wietse Venema
       Google, Inc.
       111 8th Avenue
       New York, NY 10011, USA

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