external/ibm-public/postfix/dist/proto/nisplus_table

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