external/ibm-public/postfix/dist/man/man5/nisplus_table.5

   1 .\"     $NetBSD$
   2 .\"
   3 .TH NISPLUS_TABLE 5
   4 .ad
   5 .fi
   6 .SH NAME
   7 nisplus_table
   8 \-
   9 Postfix NIS+ client
  10 .SH "SYNOPSIS"
  11 .na
  12 .nf
  13 \fBpostmap -q "\fIstring\fB" "nisplus:[\fIname\fB=%s];\fIname.name.\fB"\fR
  14
  15 \fBpostmap -q - "nisplus:[\fIname\fB=%s];\fIname.name.\fB"\fR <\fIinputfile\fR
  16 .SH DESCRIPTION
  17 .ad
  18 .fi
  19 The Postfix mail system uses optional lookup tables.
  20 These tables are usually in \fBdbm\fR or \fBdb\fR format.
  21 Alternatively, lookup tables can be specified as NIS+
  22 databases.
  23
  24 To find out what types of lookup tables your Postfix system
  25 supports use the "\fBpostconf -m\fR" command.
  26
  27 To test Postfix NIS+ lookup tables, use the "\fBpostmap -q\fR"
  28 command as described in the SYNOPSIS above.
  29 .SH "QUERY SYNTAX"
  30 .na
  31 .nf
  32 .ad
  33 .fi
  34 Most of the NIS+ query is specified via the NIS+ map name. The
  35 general format of a Postfix NIS+ map name is as follows:
  36
  37 .fi
  38     \fBnisplus:[\fIname\fB=%s];\fIname.name.name\fB.:\fIcolumn\fR
  39 .fi
  40
  41 Postfix NIS+ map names differ from what one normally
  42 would use with commands such as \fBniscat\fR:
  43 .IP \(bu
  44 With each NIS+ table lookup, "\fB%s\fR" is replaced by a
  45 version of the lookup string.  There can be only one
  46 "\fB%s\fR" instance in a Postfix NIS+ map name.
  47 .IP \(bu
  48 Postfix NIS+ map names use "\fB;\fR" instead of "\fB,\fR",
  49 because the latter character is special in the Postfix
  50 main.cf file.  Postfix replaces "\fB;\fR" characters in
  51 the map name by "\fB,\fR" before making NIS+ queries.
  52 .IP \(bu
  53 The ":\fIcolumn\fR" part in the NIS+ map name is not part
  54 of the actual NIS+ query. Instead, it specifies the number
  55 of the table column that provides the lookup result. When
  56 no ":\fIcolumn\fR" is specified the first column (1) is used.
  57 .SH "EXAMPLE"
  58 .na
  59 .nf
  60 .ad
  61 .fi
  62 A NIS+ aliases map might be queried as follows:
  63
  64 .nf
  65     alias_maps = dbm:/etc/mail/aliases,
  66         nisplus:[alias=%s];mail_aliases.org_dir.$mydomain.:1
  67 .fi
  68
  69 This queries the local aliases file before the NIS+ file.
  70 .SH "SEE ALSO"
  71 .na
  72 .nf
  73 postmap(1), Postfix lookup table manager
  74 .SH "README FILES"
  75 .na
  76 .nf
  77 .ad
  78 .fi
  79 Use "\fBpostconf readme_directory\fR" or
  80 "\fBpostconf html_directory\fR" to locate this information.
  81 .na
  82 .nf
  83 DATABASE_README, Postfix lookup table overview
  84 .SH "LICENSE"
  85 .na
  86 .nf
  87 .ad
  88 .fi
  89 The Secure Mailer license must be distributed with this software.
  90 .SH "AUTHOR(S)"
  91 .na
  92 .nf
  93 Geoff Gibbs
  94 UK-HGMP-RC
  95 Hinxton
  96 Cambridge
  97 CB10 1SB, UK
  98
  99 Adopted and adapted by:
 100 Wietse Venema
 101 IBM T.J. Watson Research
 102 P.O. Box 704
 103 Yorktown Heights, NY 10598, USA