summaryrefslogtreecommitdiffstats
path: root/html/nisplus_table.5.html
blob: fc442eea35e2f1de4e2e0c22c40eced8e592e34a (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
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
        "http://www.w3.org/TR/html4/loose.dtd">
<html> <head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<title> Postfix manual - nisplus_table(5) </title>
</head> <body> <pre>
NISPLUS_TABLE(5)                                              NISPLUS_TABLE(5)

<b>NAME</b>
       nisplus_table - Postfix NIS+ client

<b>SYNOPSIS</b>
       <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>

       <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>

<b>DESCRIPTION</b>
       The  Postfix mail system uses optional lookup tables.  These tables are
       usually in <b>dbm</b> or <b>db</b> format.  Alternatively, lookup tables can be spec-
       ified as NIS+ databases.

       To  find  out  what types of lookup tables your Postfix system supports
       use the "<b>postconf -m</b>" command.

       To test Postfix NIS+ lookup tables, use the  "<b>postmap  -q</b>"  command  as
       described in the SYNOPSIS above.

<b>QUERY SYNTAX</b>
       Most  of the NIS+ query is specified via the NIS+ map name. The general
       format of a Postfix NIS+ map name is as follows:

           <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>

       Postfix NIS+ map names differ from what one  normally  would  use  with
       commands such as <b>niscat</b>:

       <b>o</b>      With  each  NIS+  table lookup, "<b>%s</b>" is replaced by a version of
              the lookup string.  There can be only one  "<b>%s</b>"  instance  in  a
              Postfix NIS+ map name.

       <b>o</b>      Postfix  NIS+ map names use "<b>;</b>" instead of "<b>,</b>", because the lat-
              ter character is special in the Postfix <a href="postconf.5.html">main.cf</a>  file.   Postfix
              replaces  "<b>;</b>"  characters  in  the map name by "<b>,</b>" before making
              NIS+ queries.

       <b>o</b>      The ":<i>column</i>" 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  ":<i>column</i>"  is
              specified the first column (1) is used.

<b>EXAMPLE</b>
       A NIS+ aliases map might be queried as follows:

           <a href="postconf.5.html#alias_maps">alias_maps</a> = <a href="DATABASE_README.html#types">dbm</a>:/etc/mail/aliases,
               <a href="nisplus_table.5.html">nisplus</a>:[alias=%s];mail_aliases.org_dir.$<a href="postconf.5.html#mydomain">mydomain</a>.:1

       This queries the local aliases file before the NIS+ file.

<b>SEE ALSO</b>
       <a href="postmap.1.html">postmap(1)</a>, Postfix lookup table manager

<b>README FILES</b>
       <a href="DATABASE_README.html">DATABASE_README</a>, Postfix lookup table overview

<b>LICENSE</b>
       The Secure Mailer license must be distributed with this software.

<b>AUTHOR(S)</b>
       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

                                                              NISPLUS_TABLE(5)
</pre> </body> </html>