summaryrefslogtreecommitdiff
path: root/usr.sbin/sendmail/makemap/makemap.8
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/sendmail/makemap/makemap.8')
-rw-r--r--usr.sbin/sendmail/makemap/makemap.894
1 files changed, 50 insertions, 44 deletions
diff --git a/usr.sbin/sendmail/makemap/makemap.8 b/usr.sbin/sendmail/makemap/makemap.8
index d060aeffaa0..70ee4465f3b 100644
--- a/usr.sbin/sendmail/makemap/makemap.8
+++ b/usr.sbin/sendmail/makemap/makemap.8
@@ -29,59 +29,58 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" @(#)makemap.8 8.1 (Berkeley) 6/7/93
+.\" @(#)makemap.8 8.1 (Berkeley) 6/17/93
.\"
-.TH MAKEMAP 8 November\ 16,\ 1992
-.UC 6
-.sh NAME
-makemap \- create database maps for sendmail
-.SH SYNOPSIS
-.B makemap
-[
-\-N
-] [
-\-f
-] [
-\-o
-] [
-\-r
-] [
-\-v
-]
-maptype mapname
-.SH DESCRIPTION
-.I Makemap
+.Dd November 16, 1992
+.Dt MAKEMAP 8
+.Os BSD 4.4
+.Sh NAME
+.Nm makemap
+.Nd create database maps for sendmail
+.Sh SYNOPSIS
+.Nm
+.Op Fl N
+.Op Fl f
+.Op Fl o
+.Op Fl r
+.Op Fl v
+.Ar maptype
+.Ar mapname
+.Sh DESCRIPTION
+.Nm
creates the database maps used by the keyed map lookups in
-.IR sendmail (8).
+.Xr sendmail 8 .
It reads input from the standard input
and outputs them to the indicated
-.IR mapname .
-.PP
+.Ar mapname .
+.Pp
Depending on how it is compiled,
-.I makemap
+.Nm
handles up to three different database formats,
selected using the
-.I maptype
+.Ar maptype
parameter.
They may be
-.IP dbm
+.Bl -tag -width Fl
+.It Li dbm
DBM format maps.
This requires the
-.IR ndbm (3)
+.Xr ndbm 3
library.
-.IP btree
+.It Li btree
B-Tree format maps.
This requires the new Berkeley
-.IR db (3)
+.Xr db 3
library.
-.IP hash
+.It Li hash
Hash format maps.
This also requires the
-.IR db (3)
+.Xr db 3
library.
-.PP
+.El
+.Pp
In all cases,
-.I makemap
+.Nm
reads lines from the standard input consisting of two
words separated by white space.
The first is the database key,
@@ -92,30 +91,37 @@ strings to indicated parameter substitution.
Literal parentheses should be doubled
(``%%'').
Blank lines and lines beginning with ``#'' are ignored.
-.SH FLAGS
-.IP \-N
+.Ss Flags
+.Bl -tag -width Fl
+.It Fl N
Include the null byte that terminates strings
in the map.
This must match the \-N flag in the sendmail.cf
``K'' line.
-.IP \-f
+.It Fl f
Fold all upper case letters in the key
to lower case;
this is intended to mesh with the
\-f flag in the
-.B K
+\fBK\fP
line in sendmail.cf.
The value is not case folded.
-.IP \-o
+.It Fl o
Append to an old file.
This allows you to augment an existing file.
-.IP \-r
+.It Fl r
Allow replacement of existing keys.
Normally
-.I makemap
+.Nm
complains if you repeat a key,
and does not do the insert.
-.IP \-v
+.It Fl v
Verbosely print what it is doing.
-.SH SEE ALSO
-sendmail(8)
+.El
+.Sh SEE ALSO
+.Xr sendmail 8
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.4 .