NISPLUSTABLE(5) NISPLUSTABLE(5)

NAME
       nisplustable - Postfix NIS+ client

SYNOPSIS
       ppoossttmmaapp -qq ""string"" ""nniisspplluuss::[[name==%%ss]];;name.name.""

       ppoossttmmaapp -qq - ""nniisspplluuss::[[name==%%ss]];;name.name."" 
DESCRIPTION
       The  Postfix mail system uses optional lookup tables.  These tables are
       usually in ddbbmm or ddbb format.  Alternatively, lookup tables can be spec-
       ified as NIS+ databases.

       To  find  out  what types of lookup tables your Postfix system supports
       use the "ppoossttccoonnff -mm" command.

       To test Postfix NIS+ lookup tables, use the  "ppoossttmmaapp  -qq"  command  as
       described in the SYNOPSIS above.

QQUUEERRYY SSYYNNTTAAXX
       Most  of the NIS+ query is specified via the NIS+ map name. The general
       format of a Postfix NIS+ map name is as follows:

           nniisspplluuss::[[name==%%ss]];;name.name.name..::column

       Postfix NIS+ map names differ from what one  normally  would  use  with
       commands such as nniissccaatt:

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

       +o      Postfix  NIS+ map names use ";;" instead of ",,", because the lat-
              ter character is special in the Postfix main.cf  file.   Postfix
              replaces  ";;"  characters  in  the map name by ",," before making
              NIS+ queries.

       +o      The ":column" 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  ":column"  is
              specified the first column (1) is used.

EEXXAAMMPPLLEE
       A NIS+ aliases map might be queried as follows:

           aliasmaps = dbm:/etc/mail/aliases,
               nisplus:[alias=%s];mailaliases.orgdir.$mydomain.:1

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

SEE ALSO
       postmap(1), Postfix lookup table manager

README FILES       Use  "ppoossttccoonnff rreeaaddmmeeddiirreeccttoorryy" or "ppoossttccoonnff hhttmmllddiirreeccttoorryy" to locate
       this information.
       DATABASEREADME, Postfix lookup table overview

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

AUTHOR(S)       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



                                                              NISPLUSTABLE(5)