EDITMAP(8) Maintenance Procedures EDITMAP(8)

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(8). 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

attributes(7), makemap(8), sendmail(8)


January 21, 2019 EDITMAP(8)