nisplus_table revision 1.1.1.1 
1#++
2# NAME
3#	nisplus_table 5
4# SUMMARY
5#	Postfix NIS+ client
6# SYNOPSIS
7#	\fBpostmap -q "\fIstring\fB" "nisplus:[\fIname\fB=%s];\fIname.name.\fB"\fR
8#
9#	\fBpostmap -q - "nisplus:[\fIname\fB=%s];\fIname.name.\fB"\fR <\fIinputfile\fR
10# DESCRIPTION
11#	The Postfix mail system uses optional lookup tables.
12#	These tables are usually in \fBdbm\fR or \fBdb\fR format.
13#	Alternatively, lookup tables can be specified as NIS+
14#	databases.
15#
16#	To find out what types of lookup tables your Postfix system
17#	supports use the "\fBpostconf -m\fR" command.
18#
19#	To test Postfix NIS+ lookup tables, use the "\fBpostmap -q\fR"
20#	command as described in the SYNOPSIS above.
21# QUERY SYNTAX
22# .ad
23# .fi
24#	Most of the NIS+ query is specified via the NIS+ map name. The
25#	general format of a Postfix NIS+ map name is as follows:
26#
27# .fi
28#	    \fBnisplus:[\fIname\fB=%s];\fIname.name.name\fB.:\fIcolumn\fR
29# .fi
30#
31#	Postfix NIS+ map names differ from what one normally
32#	would use with commands such as \fBniscat\fR:
33# .IP \(bu
34#	With each NIS+ table lookup, "\fB%s\fR" is replaced by a
35#	version of the lookup string.  There can be only one
36#	"\fB%s\fR" instance in a Postfix NIS+ map name.
37# .IP \(bu
38#	Postfix NIS+ map names use "\fB;\fR" instead of "\fB,\fR",
39#	because the latter character is special in the Postfix
40#	main.cf file.  Postfix replaces "\fB;\fR" characters in
41#	the map name by "\fB,\fR" before making NIS+ queries.
42# .IP \(bu
43#	The ":\fIcolumn\fR" part in the NIS+ map name is not part
44#	of the actual NIS+ query. Instead, it specifies the number
45#	of the table column that provides the lookup result. When
46#	no ":\fIcolumn\fR" is specified the first column (1) is used.
47# EXAMPLE
48# .ad
49# .fi
50#	A NIS+ aliases map might be queried as follows:
51#
52# .nf
53#	    alias_maps = dbm:/etc/mail/aliases,
54#		nisplus:[alias=%s];mail_aliases.org_dir.$mydomain.:1
55# .fi
56#
57#	This queries the local aliases file before the NIS+ file.
58# SEE ALSO
59#	postmap(1), Postfix lookup table manager
60# README FILES
61# .ad
62# .fi
63#	Use "\fBpostconf readme_directory\fR" or
64#	"\fBpostconf html_directory\fR" to locate this information.
65# .na
66# .nf
67#	DATABASE_README, Postfix lookup table overview
68# LICENSE
69# .ad
70# .fi
71#	The Secure Mailer license must be distributed with this software.
72# AUTHOR(S)
73#	Geoff Gibbs
74#	UK-HGMP-RC
75#	Hinxton
76#	Cambridge
77#	CB10 1SB, UK
78#
79#	Adopted and adapted by:
80#	Wietse Venema
81#	IBM T.J. Watson Research
82#	P.O. Box 704
83#	Yorktown Heights, NY 10598, USA
84#--
85