nisplus_table.5.html revision 1.1.1.2.6.1 1 <!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
2 "http://www.w3.org/TR/html4/loose.dtd">
3 <html> <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5 <title> Postfix manual - nisplus_table(5) </title>
6 </head> <body> <pre>
7 NISPLUS_TABLE(5) NISPLUS_TABLE(5)
8
9 <b>NAME</b>
10 nisplus_table - Postfix NIS+ client
11
12 <b>SYNOPSIS</b>
13 <b>postmap -q "</b><i>string</i><b>" "<a href="nisplus_table.5.html">nisplus</a>:[</b><i>name</i><b>=%s];</b><i>name.name.</i><b>"</b>
14
15 <b>postmap -q - "<a href="nisplus_table.5.html">nisplus</a>:[</b><i>name</i><b>=%s];</b><i>name.name.</i><b>"</b> <<i>inputfile</i>
16
17 <b>DESCRIPTION</b>
18 The Postfix mail system uses optional lookup tables. These tables are
19 usually in <b>dbm</b> or <b>db</b> format. Alternatively, lookup tables can be spec-
20 ified as NIS+ databases.
21
22 To find out what types of lookup tables your Postfix system supports
23 use the "<b>postconf -m</b>" command.
24
25 To test Postfix NIS+ lookup tables, use the "<b>postmap -q</b>" command as
26 described in the SYNOPSIS above.
27
28 <b>QUERY SYNTAX</b>
29 Most of the NIS+ query is specified via the NIS+ map name. The general
30 format of a Postfix NIS+ map name is as follows:
31
32 <b><a href="nisplus_table.5.html">nisplus</a>:[</b><i>name</i><b>=%s];</b><i>name.name.name</i><b>.:</b><i>column</i>
33
34 Postfix NIS+ map names differ from what one normally would use with
35 commands such as <b>niscat</b>:
36
37 <b>o</b> With each NIS+ table lookup, "<b>%s</b>" is replaced by a version of
38 the lookup string. There can be only one "<b>%s</b>" instance in a
39 Postfix NIS+ map name.
40
41 <b>o</b> Postfix NIS+ map names use "<b>;</b>" instead of "<b>,</b>", because the lat-
42 ter character is special in the Postfix <a href="postconf.5.html">main.cf</a> file. Postfix
43 replaces "<b>;</b>" characters in the map name by "<b>,</b>" before making
44 NIS+ queries.
45
46 <b>o</b> The ":<i>column</i>" part in the NIS+ map name is not part of the
47 actual NIS+ query. Instead, it specifies the number of the table
48 column that provides the lookup result. When no ":<i>column</i>" is
49 specified the first column (1) is used.
50
51 <b>EXAMPLE</b>
52 A NIS+ aliases map might be queried as follows:
53
54 <a href="postconf.5.html#alias_maps">alias_maps</a> = <a href="DATABASE_README.html#types">dbm</a>:/etc/mail/aliases,
55 <a href="nisplus_table.5.html">nisplus</a>:[alias=%s];mail_aliases.org_dir.$<a href="postconf.5.html#mydomain">mydomain</a>.:1
56
57 This queries the local aliases file before the NIS+ file.
58
59 <b>SEE ALSO</b>
60 <a href="postmap.1.html">postmap(1)</a>, Postfix lookup table manager
61
62 <b>README FILES</b>
63 <a href="DATABASE_README.html">DATABASE_README</a>, Postfix lookup table overview
64
65 <b>LICENSE</b>
66 The Secure Mailer license must be distributed with this software.
67
68 <b>AUTHOR(S)</b>
69 Geoff Gibbs
70 UK-HGMP-RC
71 Hinxton
72 Cambridge
73 CB10 1SB, UK
74
75 Adopted and adapted by:
76 Wietse Venema
77 IBM T.J. Watson Research
78 P.O. Box 704
79 Yorktown Heights, NY 10598, USA
80
81 Wietse Venema
82 Google, Inc.
83 111 8th Avenue
84 New York, NY 10011, USA
85
86 NISPLUS_TABLE(5)
87 </pre> </body> </html>
88