.\" Copyright (c) 2005 Sendmail, Inc. and its suppliers.
.\"	 All rights reserved.
.\"
.\"     $Id: createmap.8,v 1.8 2006/10/04 04:08:40 ca Exp $
.\"
.TH CREATEMAP 8 "$Date: 2006/10/04 04:08:40 $"
.SH NAME
createmap
\- create database maps for meta1
.SH SYNOPSIS
.B createmap
.RB [ \-E ]
.RB [ \-F
.IR file ]
.RB [ \-f ]
.RB [ \-n
.IR name ]
.RB [ \-s ]
.RB [ \-t
.IR delim ]
.RB [ \-V ]
.RB [ \-w ]
.SH DESCRIPTION
.B createmap
creates the database maps used by the keyed map lookups in
meta1(8).  
It reads input from the standard input
and outputs them to the indicated
.I mapname.
.SS Flags
.TP
.B \-E
Allow an empty key (not useful for meta1).
.TP
.B \-F
Use the specified file instead of
.BI aliases.db .
.TP
.B \-f
Normally all upper case letters in the key 
are folded to lower case.  
This flag disables that behaviour.  
.TP
.B \-n
Use the specified name for the map instead of
.BI aliases .
.TP
.B \-s
Do not ignore empty lines and lines beginning with '#'.
.TP
.B \-t
Use the specified delimiter instead of colon.
.TP
.B \-V
Increase verbosity (can be specified multiple times).
.TP
.B \-w
Use whitespace (space, horizontal tab) as delimiter.
.SH EXAMPLES
To create the
aliases
map, use
.PP
.nf
createmap < aliases
.fi
.PP
To create the
access
map, use
.PP
.nf
createmap -t'	' -F access.db < access
.fi
.PP
or simply use the
Makefile
generated during the meta1 installation.
.SH SEE ALSO
runas(8),
meta1(8),
smar(8).
.SH CAVEATS
This program actually allows you to run it as
root,
however, this should be avoided if possible.
Use
.B runas
to run as the owner of the map file instead.