summaryrefslogtreecommitdiffstats
path: root/man/man5/nisplus_table.5
blob: 79176a17c1ffe16072b9cc81204d5f6f2cd67c37 (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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
.TH NISPLUS_TABLE 5 
.ad
.fi
.SH NAME
nisplus_table
\-
Postfix NIS+ client
.SH "SYNOPSIS"
.na
.nf
\fBpostmap \-q "\fIstring\fB" "nisplus:[\fIname\fB=%s];\fIname.name.\fB"\fR

\fBpostmap \-q \- "nisplus:[\fIname\fB=%s];\fIname.name.\fB" <\fIinputfile\fR
.SH DESCRIPTION
.ad
.fi
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.
.SH "QUERY SYNTAX"
.na
.nf
.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.
.SH "EXAMPLE"
.na
.nf
.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.
.SH "SEE ALSO"
.na
.nf
postmap(1), Postfix lookup table manager
.SH "README FILES"
.na
.nf
.ad
.fi
Use "\fBpostconf readme_directory\fR" or
"\fBpostconf html_directory\fR" to locate this information.
.na
.nf
DATABASE_README, Postfix lookup table overview
.SH "LICENSE"
.na
.nf
.ad
.fi
The Secure Mailer license must be distributed with this software.
.SH "AUTHOR(S)"
.na
.nf
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