editmap(1M)

NAME

     editmap - query and edit single records in database maps for
     sendmail

SYNOPSIS

     editmap -C file [-N] [-f] [-q | -u |  -x]   maptype  mapname
     key ["value"...]

DESCRIPTION

     The editmap command queries or edits one record in  a  data-
     base  maps  used  by  the keyed map lookups in sendmail(1M).
     Arguments are passed on the command  line  and  output  (for
     queries) is directed to standard output.

     Depending on how it is compiled, editmap handles up to three
     different  database  formats,  selected  using  the  maptype
     parameter. See OPERANDS.

      If the TrustedUser option is set in the sendmail configura-
     tion  file  and  editmap  is  invoked as root, the generated
     files are owned by the specified TrustedUser.

OPTIONS

     The following options are supported:

     -C file
           Use the specified sendmail configuration  file  (file)
           to look up the TrustedUser option.

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

     -N     Include the null byte that terminates strings in  the
           map (for alias maps).

     -q    Query the map for the specified key. If  found,  print
           value to standard output and exit with 0. If not found
           then print an error message to stdout  and  exit  with
           EX_UNAVAILABLE.

     -u    Update the record for key with value or inserts a  new
           record  if  one doesn't exist. Exits with 0 on success
           or EX_IOERR on failure.

     -x     Delete the specific key from the map. Exit with 0  on
           success or EX_IOERR on failure.

OPERANDS

     The following operands are supported:

     key   The left hand side of a record.

           Each record is of the form:

           key value

           key and value are separated by white space.

     mapname
           File name of the database map being created.

     maptype
           Specifies the database format. The  following  maptype
           parameters are available:

           dbm   Specifies DBM format maps.

           btree Specifies B-Tree format maps.

           hash  Specifies hash format maps.

     value The right hand side of a record.

           Each record is of the form:

           key value

           key and value are separated by white space.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWsndmu                   |
    |_____________________________|_____________________________|

SEE ALSO

     makemap(1M), sendmail(1M), attributes(5)