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