NISPLUS_TABLE(5) NISPLUS_TABLE(5)
NAME
nisplus_table - Postfix NIS+ client
SYNOPSIS
postmap -q "string(3,n)" "nisplus:[name=%s];name.name."
postmap -q - "nisplus:[name=%s];name.name." <inputfile
DESCRIPTION
The Postfix mail(1,8) system uses optional lookup tables. These tables are
usually in(1,8) dbm or db 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 "postconf(1,5) -m" command.
To test Postfix NIS+ lookup tables, use the "postmap -q" command as
described in(1,8) 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 follows:
nisplus:[name=%s];name.name.name.:column
Postfix NIS+ map names differ from what one normally would use with
commands such as niscat:
With each NIS+ table lookup, "%s" is replaced by a version(1,3,5) of
the lookup string. There can be only one "%s" instance in(1,8) a
Postfix NIS+ map name.
Postfix NIS+ map names use ";" instead of ",", because the lat-
ter character is special in(1,8) the Postfix main.cf file. Postfix
replaces ";" characters in(1,8) the map name by "," before making
NIS+ queries.
The ":column" part in(1,8) 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(1,8)/aliases,
nisplus:[alias=%s];mail_aliases.org_dir.$mydomain.:1
This queries the local aliases file(1,n) before the NIS+ file.
SEE ALSO
postmap(1), Postfix lookup table manager
README FILES
Use "postconf(1,5) readme_directory" or "postconf(1,5) html_directory" to locate
this information.
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)