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