|
EDITMAP(1M) |
Maintenance Commands |
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 database 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 configuration 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 lower 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 the specified key with the specified value or inserts a new record if one doesn't exist. Exits with 0 on success or EX_IOERR on failure.
-x
Delete the specified key from the map. Exits 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.
SEE ALSO
makemap(1M), sendmail(1M), attributes(5)