EDITMAP(8) Maintenance Commands and 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)