Import sendmail 8.13.8
[dragonfly.git] / contrib / sendmail-8.13.8 / makemap / makemap.0
1 MAKEMAP(8)                                                          MAKEMAP(8)
2
3
4
5 N\bNA\bAM\bME\bE
6        makemap - create database maps for sendmail
7
8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
9        m\bma\bak\bke\bem\bma\bap\bp  [-\b-C\bC  _\bf_\bi_\bl_\be] [-\b-N\bN] [-\b-c\bc _\bc_\ba_\bc_\bh_\be_\bs_\bi_\bz_\be] [-\b-d\bd] [-\b-D\bD _\bc_\bo_\bm_\bm_\be_\bn_\bt_\bc_\bh_\ba_\br] [-\b-e\be] [-\b-f\bf]
10        [-\b-l\bl] [-\b-o\bo] [-\b-r\br] [-\b-s\bs] [-\b-t\bt _\bd_\be_\bl_\bi_\bm] [-\b-u\bu] [-\b-v\bv] _\bm_\ba_\bp_\bt_\by_\bp_\be _\bm_\ba_\bp_\bn_\ba_\bm
11
12 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
13        M\bMa\bak\bke\bem\bma\bap\bp creates the database maps used by  the  keyed  map  lookups  in
14        sendmail(8).   It  reads input from the standard input and outputs them
15        to the indicated _\bm_\ba_\bp_\bn_\ba_\bm_\be_\b.
16
17        Depending on how it is compiled, m\bma\bak\bke\bem\bma\bap\bp handles up to three  different
18        database formats, selected using the _\bm_\ba_\bp_\bt_\by_\bp_\be parameter.  They may be
19
20        dbm    DBM format maps.  This requires the ndbm(3) library.
21
22        btree  B-Tree  format maps.  This requires the new Berkeley DB library.
23
24        hash   Hash format maps.  This also requires the Berkeley DB library.
25
26        In all cases, m\bma\bak\bke\bem\bma\bap\bp reads lines from the standard input consisting of
27        two words separated by white space.  The first is the database key, the
28        second is the value.  The value may contain ``%_\bn'' strings to  indicate
29        parameter  substitution.   Literal percents should be doubled (``%%'').
30        Blank lines and lines beginning with ``#'' are ignored.
31
32        Notice: do n\bno\bot\bt use  m\bma\bak\bke\bem\bma\bap\bp  to  create  the  aliases  data  base,  but
33        n\bne\bew\bwa\bal\bli\bia\bas\bse\bes\bs  which  puts  a  special  token  into  the data base that is
34        required by s\bse\ben\bnd\bdm\bma\bai\bil\bl.\b.
35
36        If the _\bT_\br_\bu_\bs_\bt_\be_\bd_\bU_\bs_\be_\br option is set in the sendmail configuration file and
37        m\bma\bak\bke\bem\bma\bap\bp  is  invoked  as root, the generated files will be owned by the
38        specified _\bT_\br_\bu_\bs_\bt_\be_\bd_\bU_\bs_\be_\br_\b.
39
40    F\bFl\bla\bag\bgs\bs
41        -\b-C\bC     Use the specified s\bse\ben\bnd\bdm\bma\bai\bil\bl configuration file for looking up the
42               TrustedUser option.
43
44        -\b-N\bN     Include  the null byte that terminates strings in the map.  This
45               must match the -N flag in the sendmail.cf ``K'' line.
46
47        -\b-c\bc     Use the specified hash and B-Tree cache size.
48
49        -\b-D\bD     Use to specify the character to use to indicate a comment (which
50               is ignored) instead of the default of '#'.
51
52        -\b-d\bd     Allow duplicate keys in the map.  This is only allowed on B-Tree
53               format maps.  If two identical keys are read, they will both  be
54               inserted into the map.
55
56        -\b-e\be     Allow empty value (right hand side).
57
58        -\b-f\bf     Normally  all  upper case letters in the key are folded to lower
59               case.  This flag disables that behaviour.  This is  intended  to
60               mesh  with  the -f flag in the K\bK line in sendmail.cf.  The value
61               is never case folded.
62
63        -\b-l\bl     List supported map types.
64
65        -\b-o\bo     Append to an old file.  This allows you to augment  an  existing
66               file.
67
68        -\b-r\br     Allow  replacement of existing keys.  Normally m\bma\bak\bke\bem\bma\bap\bp complains
69               if you repeat a key, and does not do the insert.
70
71        -\b-s\bs     Ignore safety checks  on  maps  being  created.   This  includes
72               checking  for  hard or symbolic links in world writable directo-
73               ries.
74
75        -\b-t\bt     Use the specified delimiter instead of white space.
76
77        -\b-u\bu     dump (unmap) the content of the database to standard output.
78
79        -\b-v\bv     Verbosely print what it is doing.
80
81 S\bSE\bEE\bE A\bAL\bLS\bSO\bO
82        sendmail(8), newaliases(1)
83
84 H\bHI\bIS\bST\bTO\bOR\bRY\bY
85        The m\bma\bak\bke\bem\bma\bap\bp command appeared in 4.4BSD.
86
87
88
89                          $Date: 2002/06/27 23:41:04 $               MAKEMAP(8)