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.2 (Berkeley) 09/22/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
76Normally all upper case letters in the key
77are folded to lower case.
78This flag disables that behaviour.
79This is intended to mesh with the
80\-f flag in the
81\fBK\fP
82line in sendmail.cf.
83The value is never case folded.
84.It Fl o
85Append to an old file.
86This allows you to augment an existing file.
87.It Fl r
88Allow replacement of existing keys.
89Normally
90.Nm
91complains if you repeat a key,
92and does not do the insert.
93.It Fl v
94Verbosely print what it is doing.
95.El
96.Sh SEE ALSO
97.Xr sendmail 8
98.Sh HISTORY
99The
100.Nm
101command appeared in
102.Bx 4.4 .
103