xref: /netbsd-src/external/ibm-public/postfix/dist/html/nisplus_table.5.html (revision a45db23f655e22f0c2354600d3b3c2cb98abf2dc)
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=utf-8">
5<title> Postfix manual - nisplus_table(5) </title>
6</head> <body> <pre>
7NISPLUS_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> &lt;<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