    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

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

                                                                  NISPLUS_TABLE(5)