NISPLUS_TABLE(5)                                              NISPLUS_TABLE(5)

NAME
       nisplus_table - Postfix NIS+ client

SYNOPSIS
       postmap -q "string" "nisplus:[name=%s];name.name."

       postmap -q - "nisplus:[name=%s];name.name." <inputfile

DESCRIPTION
       The  Postfix  mail  system  uses  optional  lookup tables.
       These tables are usually in dbm or  db  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 "postconf -m" command.

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

QUERY SYNTAX
       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:

           nisplus:[name=%s];name.name.name.:column

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

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

       o      Postfix  NIS+  map  names  use  ";" instead of ",",
              because the latter  character  is  special  in  the
              Postfix main.cf file.  Postfix replaces ";" charac-
              ters 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.

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

           alias_maps = dbm:/etc/mail/aliases,
                 nisplus:[alias=%s];mail_aliases.org_dir.$mydomain.:1

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

SEE ALSO
       postmap(1), Postfix lookup table manager

README FILES
       DATABASE_README, Postfix lookup table overview

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

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

       Based on the NIS client code:

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

                                                              NISPLUS_TABLE(5)