Import sendmail 8.13.8
[dragonfly.git] / contrib / sendmail-8.13.8 / editmap / editmap.0
1 EDITMAP(8)                                                          EDITMAP(8)
2
3
4
5 N\bNA\bAM\bME\bE
6        e\bed\bdi\bit\btm\bma\bap\bp - query and edit single records in database maps for sendmail
7
8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
9        e\bed\bdi\bit\btm\bma\bap\bp  [-\b-C\bC  _\bf_\bi_\bl_\be]  [-\b-N\bN]  [-\b-f\bf] [-\b-q\bq|\b|-\b-u\bu|\b|-\b-x\bx] maptype mapname key [ "value
10        ..." ]
11
12 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
13        E\bEd\bdi\bit\btm\bma\bap\bp queries or edits one record in database maps used by the  keyed
14        map  lookups  in sendmail(8).  Arguments are passed on the command line
15        and output (for queries) is directed to standard output.
16
17        Depending on how it is compiled, e\bed\bdi\bit\btm\bma\bap\bp handles up to three  different
18        database formats, selected using the _\bm_\ba_\bp_\bt_\by_\bp_\be parameter.  They may be
19
20        dbm    DBM format maps.  This requires the ndbm(3) library.
21
22        btree  B-Tree  format maps.  This requires the new Berkeley DB library.
23
24        hash   Hash format maps.  This also requires the Berkeley DB library.
25
26        If the _\bT_\br_\bu_\bs_\bt_\be_\bd_\bU_\bs_\be_\br option is set in the sendmail configuration file and
27        e\bed\bdi\bit\btm\bma\bap\bp  is  invoked  as root, the generated files will be owned by the
28        specified _\bT_\br_\bu_\bs_\bt_\be_\bd_\bU_\bs_\be_\br_\b.
29
30    F\bFl\bla\bag\bgs\bs
31        -\b-C\bC     Use the specified s\bse\ben\bnd\bdm\bma\bai\bil\bl configuration file for looking up the
32               TrustedUser option.
33
34        -\b-N\bN     Include  the  null  byte that terminates strings in the map (for
35               alias maps).
36
37        -\b-f\bf     Normally all upper case letters in the key are folded  to  lower
38               case.   This  flag disables that behaviour.  This is intended to
39               mesh with the -f flag in the K\bK line in sendmail.cf.   The  value
40               is never case folded.
41
42        -\b-q\bq     Query  the  map for the specified key.  If found, print value to
43               standard output and exit with 0.  If not  found  then  print  an
44               error message to stdout and exit with EX_UNAVAILABLE.
45
46        -\b-u\bu     Update  the record for _\bk_\be_\by with _\bv_\ba_\bl_\bu_\be or inserts a new record if
47               one doesn't exist.  Exits with 0 on success or EX_IOERR on fail-
48               ure.
49
50        -\b-x\bx     Deletes  the specific key from the map.  Exits with 0 on success
51               or EX_IOERR on failure.
52
53
54        S\bSE\bEE\bE A\bAL\bLS\bSO\bO
55               sendmail(8), makemap(8)
56
57 H\bHI\bIS\bST\bTO\bOR\bRY\bY
58        The e\bed\bdi\bit\btm\bma\bap\bp command has no history.
59
60
61
62                          $Date: 2003/02/01 17:07:42 $               EDITMAP(8)