xref: /netbsd-src/external/ibm-public/postfix/dist/html/nisplus_table.5.html (revision f89f6560d453f5e37386cc7938c072d2f528b9fa)
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>
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                                                              NISPLUS_TABLE(5)
82</pre> </body> </html>
83