Print this page
9097 typos in makemap(1M)/editmap(1M)

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/editmap.1m
          +++ new/usr/src/man/man1m/editmap.1m
↓ open down ↓ 15 lines elided ↑ open up ↑
  16   16  .\" terms, and the disclaimer/limitation of liability set    forth as paragraph 6 below, in the documentation and/or other materials    provided with the distribution.  For the purposes of binary distribution    the "Copyright Notice" refers to the following language:    "Copyright (c) 1998-2004 Sendmail,
  17   17  .\" Inc.  All rights reserved."  4. Neither the name of Sendmail, Inc. nor the University of California nor    the names of their contributors may be used to endorse or promote    products derived from this software without specific prior written    permission.  The name "sendmail" is a trademark
  18   18  .\" of Sendmail, Inc.  5. All redistributions must comply with the conditions imposed by the    University of California on certain embedded code, whose copyright    notice and conditions for redistribution are as follows:     (a) Copyright (c) 1988, 1993 The Regents of the University of        California.
  19   19  .\"  All rights reserved.     (b) Redistribution and use in source and binary forms, with or without        modification, are permitted provided that the following conditions        are met:        (i)   Redistributions of source code must retain the above copyright             notice, this list of
  20   20  .\" conditions and the following disclaimer.        (ii)  Redistributions in binary form must reproduce the above             copyright notice, this list of conditions and the following             disclaimer in the documentation and/or other materials provided             with the distribution.
  21   21  .\"       (iii) Neither the name of the University nor the names of its             contributors may be used to endorse or promote products derived             from this software without specific prior written permission. 6. Disclaimer/Limitation of Liability: THIS SOFTWARE IS PROVIDED BY    SENDMAIL,
  22   22  .\" INC. AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED    WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF    MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN    NO EVENT SHALL SENDMAIL, INC., THE REGENTS OF THE UNIVERSITY OF    CALIFORNIA OR CONTRIBUTORS
  23   23  .\" BE LIABLE FOR ANY DIRECT, INDIRECT,    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF    USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON    ANY THEORY OF LIABILITY, WHETHER
  24   24  .\" IN CONTRACT, STRICT LIABILITY, OR TORT    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
  25   25  .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.
  26      -.TH EDITMAP 1M "Sep 14, 2001"
       26 +.\" Copyright (c) 2019 Peter Tribble.
       27 +.TH EDITMAP 1M "Jan 21, 2019"
  27   28  .SH NAME
  28   29  editmap \- query and edit single records in database maps for sendmail
  29   30  .SH SYNOPSIS
  30   31  .LP
  31   32  .nf
  32   33  \fBeditmap\fR \fB-C\fR \fIfile\fR [\fB-N\fR] [\fB-f\fR] [\fB-q\fR | \fB-u\fR | \fB-x\fR] \fImaptype\fR \fImapname\fR \fIkey\fR
  33   34       ["\fIvalue\fR"]...
  34   35  .fi
  35   36  
  36   37  .SH DESCRIPTION
  37      -.sp
  38   38  .LP
  39   39  The \fBeditmap\fR command queries or edits one record in a database maps used
  40   40  by the keyed map lookups in \fBsendmail\fR(1M). Arguments are passed on the
  41   41  command line and output (for queries) is directed to standard output.
  42   42  .sp
  43   43  .LP
  44   44  Depending on how it is compiled, \fBeditmap\fR handles up to three different
  45   45  database formats, selected using the \fImaptype\fR parameter. See
  46   46  \fBOPERANDS\fR.
  47   47  .sp
  48   48  .LP
  49      - If the \fBTrustedUser\fR option is set in the \fBsendmail\fR configuration
       49 +If the \fBTrustedUser\fR option is set in the \fBsendmail\fR configuration
  50   50  file and \fBeditmap\fR is invoked as root, the generated files are owned by the
  51   51  specified \fBTrustedUser\fR.
  52   52  .SH OPTIONS
  53      -.sp
  54   53  .LP
  55   54  The following options are supported:
  56   55  .sp
  57   56  .ne 2
  58   57  .na
  59      -\fB\fB-C\fR \fIfile\fR\fR
       58 +\fB-C\fR \fIfile\fR
  60   59  .ad
  61   60  .RS 11n
  62   61  Use the specified \fBsendmail\fR configuration file (\fIfile\fR) to look up the
  63   62  \fBTrustedUser\fR option.
  64   63  .RE
  65   64  
  66   65  .sp
  67   66  .ne 2
  68   67  .na
  69      -\fB\fB-f\fR\fR
       68 +\fB-f\fR
  70   69  .ad
  71   70  .RS 11n
  72   71  Disable the folding of all upper case letters in the key to lower case.
  73      -Normally, all upper case letters in the key are folded to upper case. This is
  74      -intended to mesh with the \fB-f\fR flag in the \fBK\fR line  in
       72 +Normally, all upper case letters in the key are folded to lower case. This is
       73 +intended to mesh with the \fB-f\fR flag in the \fBK\fR line in
  75   74  \fBsendmail.cf\fR. The value is never case folded.
  76   75  .RE
  77   76  
  78   77  .sp
  79   78  .ne 2
  80   79  .na
  81      -\fB\fB-N\fR\fR
       80 +\fB-N\fR
  82   81  .ad
  83   82  .RS 11n
  84      - Include the null byte that terminates strings in the map (for alias maps).
       83 +Include the null byte that terminates strings in the map (for alias maps).
  85   84  .RE
  86   85  
  87   86  .sp
  88   87  .ne 2
  89   88  .na
  90      -\fB\fB-q\fR\fR
       89 +\fB-q\fR
  91   90  .ad
  92   91  .RS 11n
  93   92  Query the map for the specified key. If found, print value to standard output
  94   93  and exit with \fB0\fR. If not found then print an error message to \fBstdout\fR
  95   94  and exit with \fBEX_UNAVAILABLE\fR.
  96   95  .RE
  97   96  
  98   97  .sp
  99   98  .ne 2
 100   99  .na
 101      -\fB\fB-u\fR\fR
      100 +\fB-u\fR
 102  101  .ad
 103  102  .RS 11n
 104      -Update the record for key with value or inserts a new record if one doesn't
 105      -exist. Exits with \fB0\fR on success or \fBEX_IOERR\fR on failure.
      103 +Update the record for the specified key with the specified value or inserts a
      104 +new record if one doesn't exist. Exits with \fB0\fR on success or
      105 +\fBEX_IOERR\fR on failure.
 106  106  .RE
 107  107  
 108  108  .sp
 109  109  .ne 2
 110  110  .na
 111      -\fB\fB-x\fR\fR
      111 +\fB-x\fR
 112  112  .ad
 113  113  .RS 11n
 114      - Delete the specific key from the map. Exit with \fB0\fR on success or
      114 +Delete the specified key from the map. Exits with \fB0\fR on success or
 115  115  \fBEX_IOERR\fR on failure.
 116  116  .RE
 117  117  
 118  118  .SH OPERANDS
 119      -.sp
 120  119  .LP
 121  120  The following operands are supported:
 122  121  .sp
 123  122  .ne 2
 124  123  .na
 125      -\fB\fIkey\fR\fR
      124 +\fIkey\fR
 126  125  .ad
 127  126  .RS 12n
 128  127  The left hand side of a record.
 129  128  .sp
 130  129  Each record is of the form:
 131  130  .sp
 132  131  .in +2
 133  132  .nf
 134  133  \fIkey\fR \fIvalue\fR
 135  134  .fi
 136  135  .in -2
 137  136  .sp
 138  137  
 139  138  \fIkey\fR and \fIvalue\fR are separated by white space.
 140  139  .RE
 141  140  
 142  141  .sp
 143  142  .ne 2
 144  143  .na
 145      -\fB\fImapname\fR \fR
      144 +\fImapname\fR
 146  145  .ad
 147  146  .RS 12n
 148  147  File name of the database map being created.
 149  148  .RE
 150  149  
 151  150  .sp
 152  151  .ne 2
 153  152  .na
 154      -\fB\fImaptype\fR \fR
      153 +\fImaptype\fR
 155  154  .ad
 156  155  .RS 12n
 157  156  Specifies the database format. The following \fImaptype\fR parameters are
 158  157  available:
 159  158  .sp
 160  159  .ne 2
 161  160  .na
 162      -\fB\fBdbm\fR \fR
      161 +\fBdbm\fR
 163  162  .ad
 164  163  .RS 10n
 165  164  Specifies \fBDBM\fR format maps.
 166  165  .RE
 167  166  
 168  167  .sp
 169  168  .ne 2
 170  169  .na
 171      -\fB\fBbtree\fR \fR
      170 +\fBbtree\fR
 172  171  .ad
 173  172  .RS 10n
 174  173  Specifies B-Tree format maps.
 175  174  .RE
 176  175  
 177  176  .sp
 178  177  .ne 2
 179  178  .na
 180      -\fB\fBhash\fR \fR
      179 +\fBhash\fR
 181  180  .ad
 182  181  .RS 10n
 183  182  Specifies hash format maps.
 184  183  .RE
 185  184  
 186  185  .RE
 187  186  
 188  187  .sp
 189  188  .ne 2
 190  189  .na
 191      -\fB\fIvalue\fR\fR
      190 +\fIvalue\fR
 192  191  .ad
 193  192  .RS 12n
 194  193  The right hand side of a record.
 195  194  .sp
 196  195  Each record is of the form:
 197  196  .sp
 198  197  .in +2
 199  198  .nf
 200  199  \fIkey\fR \fIvalue\fR
 201  200  .fi
 202  201  .in -2
 203  202  .sp
 204  203  
 205  204  \fIkey\fR and \fIvalue\fR are separated by white space.
 206  205  .RE
 207  206  
 208  207  .SH SEE ALSO
 209      -.sp
 210  208  .LP
 211  209  \fBmakemap\fR(1M), \fBsendmail\fR(1M), \fBattributes\fR(5)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX