summaryrefslogtreecommitdiffstats
path: root/proto/nisplus_table
blob: 2c8aefca4047877d776e4eb9ae7ebd5371848698 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
#++
# NAME
#	nisplus_table 5
# SUMMARY
#	Postfix NIS+ client
# SYNOPSIS
#	\fBpostmap -q "\fIstring\fB" "nisplus:[\fIname\fB=%s];\fIname.name.\fB"\fR
#
#	\fBpostmap -q - "nisplus:[\fIname\fB=%s];\fIname.name.\fB" <\fIinputfile\fR
# DESCRIPTION
#	The Postfix mail system uses optional lookup tables.
#	These tables are usually in \fBdbm\fR or \fBdb\fR format.
#	Alternatively, lookup tables can be specified as NIS+
#	databases.
#
#	To find out what types of lookup tables your Postfix system
#	supports use the "\fBpostconf -m\fR" command.
#
#	To test Postfix NIS+ lookup tables, use the "\fBpostmap -q\fR"
#	command as described in the SYNOPSIS above.
# QUERY SYNTAX
# .ad
# .fi
#	Most of the NIS+ query is specified via the NIS+ map name. The
#	general format of a Postfix NIS+ map name is as follows:
#
# .fi
#	    \fBnisplus:[\fIname\fB=%s];\fIname.name.name\fB.:\fIcolumn\fR
# .fi
#
#	Postfix NIS+ map names differ from what one normally
#	would use with commands such as \fBniscat\fR:
# .IP \(bu
#	With each NIS+ table lookup, "\fB%s\fR" is replaced by a
#	version of the lookup string.  There can be only one
#	"\fB%s\fR" instance in a Postfix NIS+ map name.
# .IP \(bu
#	Postfix NIS+ map names use "\fB;\fR" instead of "\fB,\fR",
#	because the latter character is special in the Postfix
#	main.cf file.  Postfix replaces "\fB;\fR" characters in
#	the map name by "\fB,\fR" before making NIS+ queries.
# .IP \(bu
#	The ":\fIcolumn\fR" 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 ":\fIcolumn\fR" is specified the first column (1) is used.
# EXAMPLE
# .ad
# .fi
#	A NIS+ aliases map might be queried as follows:
#
# .nf
#	    alias_maps = dbm:/etc/mail/aliases,
#		nisplus:[alias=%s];mail_aliases.org_dir.$mydomain.:1
# .fi
#
#	This queries the local aliases file before the NIS+ file.
# SEE ALSO
#	postmap(1), Postfix lookup table manager
# README FILES
# .ad
# .fi
#	Use "\fBpostconf readme_directory\fR" or
#	"\fBpostconf html_directory\fR" to locate this information.
# .na
# .nf
#	DATABASE_README, Postfix lookup table overview
# LICENSE
# .ad
# .fi
#	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
#
#	Wietse Venema
#	Google, Inc.
#	111 8th Avenue
#	New York, NY 10011, USA
#--