manual/sendmail/original/man8/makemap.8

   1 .\" Copyright (c) 1998-2000 Sendmail, Inc. and its suppliers.
   2 .\"      All rights reserved.
   3 .\" Copyright (c) 1988, 1991, 1993
   4 .\"     The Regents of the University of California.  All rights reserved.
   5 .\"
   6 .\" By using this file, you agree to the terms and conditions set
   7 .\" forth in the LICENSE file which can be found at the top level of
   8 .\" the sendmail distribution.
   9 .\"
  10 .\"
  11 .\"     $Id: makemap.8,v 8.27 2000/12/29 18:16:55 gshapiro Exp $
  12 .\"
  13 .TH MAKEMAP 8 "$Date: 2000/12/29 18:16:55 $"
  14 .SH NAME
  15 makemap
  16 \- create database maps for sendmail
  17 .SH SYNOPSIS
  18 .B makemap
  19 .RB [ \-C
  20 .IR file ]
  21 .RB [ \-N ]
  22 .RB [ \-c
  23 .IR cachesize ]
  24 .RB [ \-d ]
  25 .RB [ \-e ]
  26 .RB [ \-f ]
  27 .RB [ \-l ]
  28 .RB [ \-o ]
  29 .RB [ \-r ]
  30 .RB [ \-s ]
  31 .RB [ \-t
  32 .IR delim ]
  33 .RB [ \-u ]
  34 .RB [ \-v ]
  35 .I
  36 maptype mapnam
  37 .SH DESCRIPTION
  38 .B Makemap
  39 creates the database maps used by the keyed map lookups in
  40 sendmail(8).
  41 It reads input from the standard input
  42 and outputs them to the indicated
  43 .I mapname.
  44 .PP
  45 Depending on how it is compiled,
  46 .B makemap
  47 handles up to three different database formats,
  48 selected using the
  49 .I maptype
  50 parameter.
  51 They may be
  52 .TP
  53 dbm
  54 DBM format maps.
  55 This requires the
  56 ndbm(3)
  57 library.
  58 .TP
  59 btree
  60 B-Tree format maps.
  61 This requires the new Berkeley DB
  62 library.
  63 .TP
  64 hash
  65 Hash format maps.
  66 This also requires the Berkeley DB
  67 library.
  68 .PP
  69 In all cases,
  70 .B makemap
  71 reads lines from the standard input consisting of two
  72 words separated by white space.
  73 The first is the database key,
  74 the second is the value.
  75 The value may contain
  76 ``%\fIn\fP''
  77 strings to indicate parameter substitution.
  78 Literal percents should be doubled
  79 (``%%'').
  80 Blank lines and lines beginning with ``#'' are ignored.
  81 .PP
  82 If the
  83 .I TrustedUser
  84 option is set in the sendmail configuration file and
  85 .B makemap
  86 is invoked as root, the generated files will be owned by
  87 the specified
  88 .IR TrustedUser.
  89 .SS Flags
  90 .TP
  91 .B \-C
  92 Use the specified
  93 .B sendmail
  94 configuration file for looking up the TrustedUser option.
  95 .TP
  96 .B \-N
  97 Include the null byte that terminates strings
  98 in the map.
  99 This must match the \-N flag in the sendmail.cf
 100 ``K'' line.
 101 .TP
 102 .B \-c
 103 Use the specified hash and B-Tree cache size.
 104 .TP
 105 .B \-d
 106 Allow duplicate keys in the map.
 107 This is only allowed on B-Tree format maps.
 108 If two identical keys are read,
 109 they will both be inserted into the map.
 110 .TP
 111 .B \-e
 112 Allow empty value (right hand side).
 113 .TP
 114 .B \-f
 115 Normally all upper case letters in the key
 116 are folded to lower case.
 117 This flag disables that behaviour.
 118 This is intended to mesh with the
 119 \-f flag in the
 120 .B K
 121 line in sendmail.cf.
 122 The value is never case folded.
 123 .TP
 124 .B \-l
 125 List supported map types.
 126 .TP
 127 .B \-o
 128 Append to an old file.
 129 This allows you to augment an existing file.
 130 .TP
 131 .B \-r
 132 Allow replacement of existing keys.
 133 Normally
 134 .B makemap
 135 complains if you repeat a key,
 136 and does not do the insert.
 137 .TP
 138 .B \-s
 139 Ignore safety checks on maps being created.
 140 This includes checking for hard or symbolic
 141 links in world writable directories.
 142 .TP
 143 .B \-t
 144 Use the specified delimiter instead of white space.
 145 .TP
 146 .B \-u
 147 dump (unmap) the content of the database to standard output.
 148 .TP
 149 .B \-v
 150 Verbosely print what it is doing.
 151 .SH SEE ALSO
 152 sendmail(8)
 153 .SH HISTORY
 154 The
 155 .B makemap
 156 command appeared in
 157 4.4BSD.