


MAKEMAP(8)                                             MAKEMAP(8)


NAME
       makemap - create database maps for sendmail

SYNOPSIS
       makemap  [-C file] [-N] [-c cachesize] [-d] [-e] [-f] [-l]
       [-o] [-r] [-s] [-t delim] [-u] [-v] maptype mapnam

DESCRIPTION
       Makemap creates the database maps used by  the  keyed  map
       lookups  in sendmail(8).  It reads input from the standard
       input and outputs them to the indicated mapname.

       Depending on how it is compiled,  makemap  handles  up  to
       three  different database formats, selected using the map-
       type parameter.  They may be

       dbm    DBM  format  maps.   This  requires   the   ndbm(3)
              library.

       btree  B-Tree format maps.  This requires the new Berkeley
              DB library.

       hash   Hash format maps.  This also requires the  Berkeley
              DB library.

       In  all cases, makemap reads lines from the standard input
       consisting of two words separated  by  white  space.   The
       first  is  the database key, the second is the value.  The
       value may contain ``%n''  strings  to  indicate  parameter
       substitution.    Literal   percents   should   be  doubled
       (``%%'').  Blank lines and lines beginning with ``#''  are
       ignored.

       Notice:  do  not  use  makemap  to create the aliases data
       base, but newaliases which puts a special token  into  the
       data base that is required by sendmail.

       If  the TrustedUser option is set in the sendmail configu-
       ration file and makemap is invoked as root, the  generated
       files will be owned by the specified TrustedUser.

   Flags
       -C     Use  the  specified sendmail configuration file for
              looking up the TrustedUser option.

       -N     Include the null byte that  terminates  strings  in
              the  map.  This must match the -N flag in the send-
              mail.cf ``K'' line.

       -c     Use the specified hash and B-Tree cache size.

       -d     Allow duplicate keys in  the  map.   This  is  only
              allowed  on  B-Tree  format maps.  If two identical
              keys are read, they will both be inserted into  the



                   $Date: 2002/03/12 18:00:25 $                 1





MAKEMAP(8)                                             MAKEMAP(8)


              map.

       -e     Allow empty value (right hand side).

       -f     Normally  all  upper  case  letters  in the key are
              folded to lower  case.   This  flag  disables  that
              behaviour.   This  is  intended to mesh with the -f
              flag in the K line in sendmail.cf.   The  value  is
              never case folded.

       -l     List supported map types.

       -o     Append  to an old file.  This allows you to augment
              an existing file.

       -r     Allow  replacement  of  existing  keys.    Normally
              makemap complains if you repeat a key, and does not
              do the insert.

       -s     Ignore safety checks on maps being  created.   This
              includes  checking  for  hard  or symbolic links in
              world writable directories.

       -t     Use the specified delimiter instead of white space.

       -u     dump  (unmap)  the content of the database to stan-
              dard output.

       -v     Verbosely print what it is doing.

SEE ALSO
       sendmail(8), newaliases(1)

HISTORY
       The makemap command appeared in 4.4BSD.






















                   $Date: 2002/03/12 18:00:25 $                 2


