Commit | Line | Data |
---|---|---|
9b79cc94 KB |
1 | .\" Copyright (c) 1988, 1991, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
c1000245 EA |
3 | .\" |
4 | .\" %sccs.include.redist.man% | |
5 | .\" | |
9b79cc94 | 6 | .\" @(#)makemap.8 8.1 (Berkeley) %G% |
c1000245 | 7 | .\" |
b5a9a6fd EA |
8 | .Dd November 16, 1992 |
9 | .Dt MAKEMAP 8 | |
10 | .Os BSD 4.4 | |
11 | .Sh NAME | |
12 | .Nm makemap | |
13 | .Nd create database maps for sendmail | |
14 | .Sh SYNOPSIS | |
15 | .Nm | |
16 | .Op Fl N | |
17 | .Op Fl f | |
18 | .Op Fl o | |
19 | .Op Fl r | |
20 | .Op Fl v | |
21 | .Ar maptype | |
22 | .Ar mapname | |
23 | .Sh DESCRIPTION | |
24 | .Nm | |
c1000245 | 25 | creates the database maps used by the keyed map lookups in |
b5a9a6fd | 26 | .Xr sendmail 8 . |
c1000245 EA |
27 | It reads input from the standard input |
28 | and outputs them to the indicated | |
b5a9a6fd EA |
29 | .Ar mapname . |
30 | .Pp | |
c1000245 | 31 | Depending on how it is compiled, |
b5a9a6fd | 32 | .Nm |
c1000245 EA |
33 | handles up to three different database formats, |
34 | selected using the | |
b5a9a6fd | 35 | .Ar maptype |
c1000245 EA |
36 | parameter. |
37 | They may be | |
b5a9a6fd EA |
38 | .Bl -tag -width Fl |
39 | .It Li dbm | |
c1000245 EA |
40 | DBM format maps. |
41 | This requires the | |
b5a9a6fd | 42 | .Xr ndbm 3 |
c1000245 | 43 | library. |
b5a9a6fd | 44 | .It Li btree |
c1000245 EA |
45 | B-Tree format maps. |
46 | This requires the new Berkeley | |
b5a9a6fd | 47 | .Xr db 3 |
c1000245 | 48 | library. |
b5a9a6fd | 49 | .It Li hash |
c1000245 EA |
50 | Hash format maps. |
51 | This also requires the | |
b5a9a6fd | 52 | .Xr db 3 |
c1000245 | 53 | library. |
b5a9a6fd EA |
54 | .El |
55 | .Pp | |
c1000245 | 56 | In all cases, |
b5a9a6fd | 57 | .Nm |
c1000245 EA |
58 | reads lines from the standard input consisting of two |
59 | words separated by white space. | |
60 | The first is the database key, | |
61 | the second is the value. | |
62 | The value may contain | |
63 | ``%\fIn\fP'' | |
64 | strings to indicated parameter substitution. | |
65 | Literal parentheses should be doubled | |
66 | (``%%''). | |
67 | Blank lines and lines beginning with ``#'' are ignored. | |
b5a9a6fd EA |
68 | .Ss Flags |
69 | .Bl -tag -width Fl | |
70 | .It Fl N | |
c1000245 EA |
71 | Include the null byte that terminates strings |
72 | in the map. | |
73 | This must match the \-N flag in the sendmail.cf | |
74 | ``K'' line. | |
b5a9a6fd | 75 | .It Fl f |
1b15d3af EA |
76 | Fold all upper case letters in the key |
77 | to lower case; | |
78 | this is intended to mesh with the | |
79 | \-f flag in the | |
b5a9a6fd | 80 | \fBK\fP |
1b15d3af EA |
81 | line in sendmail.cf. |
82 | The value is not case folded. | |
b5a9a6fd | 83 | .It Fl o |
c1000245 EA |
84 | Append to an old file. |
85 | This allows you to augment an existing file. | |
b5a9a6fd | 86 | .It Fl r |
c1000245 EA |
87 | Allow replacement of existing keys. |
88 | Normally | |
b5a9a6fd | 89 | .Nm |
c1000245 EA |
90 | complains if you repeat a key, |
91 | and does not do the insert. | |
b5a9a6fd | 92 | .It Fl v |
c1000245 | 93 | Verbosely print what it is doing. |
b5a9a6fd EA |
94 | .El |
95 | .Sh SEE ALSO | |
96 | .Xr sendmail 8 | |
97 | .Sh HISTORY | |
98 | The | |
99 | .Nm | |
100 | command appeared in | |
101 | .Bx 4.4 . |