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

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man1m/makemap.1m
          +++ new/usr/src/man/man1m/makemap.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  .\"  Copyright (c) 2009, Sun Microsystems, Inc.  All Rights Reserved.
  26      -.TH MAKEMAP 1M "Apr 22, 2008"
       26 +.\" Copyright (c) 2019 Peter Tribble.
       27 +.TH MAKEMAP 1M "Jan 21, 2019"
  27   28  .SH NAME
  28   29  makemap \- create database maps for sendmail
  29   30  .SH SYNOPSIS
  30   31  .LP
  31   32  .nf
  32   33  \fBmakemap\fR [\fB-N\fR] [\fB-d\fR] [\fB-f\fR] [\fB-o\fR] [\fB-r\fR] [\fB-s\fR] [\fB-v\fR] [\fB-C\fR \fIfile\fR]
  33   34       [\fB-c\fR \fIcachesize\fR] [\fB-D\fR \fIcommentchar\fR] [\fB-e\fR] [\fB-l\fR] [\fB-t\fR \fIdelim\fR]
  34      -     [\fB-u\fR] \fImantype\fR \fImapname\fR
       35 +     [\fB-u\fR] \fImaptype\fR \fImapname\fR
  35   36  .fi
  36   37  
  37   38  .SH DESCRIPTION
  38      -.sp
  39   39  .LP
  40   40  \fBmakemap\fR creates the database maps used by the keyed map lookups in
  41   41  \fBsendmail\fR(1M). \fBmakemap\fR reads from the standard input and outputs to
  42   42  the specified \fImapname\fR.
  43   43  .sp
  44   44  .LP
  45   45  In all cases, \fBmakemap\fR reads lines from the standard input consisting of
  46   46  two words separated by whitespace. The first is the database key, the second is
  47      -the value. The value may contain \fB%\fR\fIn\fR strings to indicated parameter
       47 +the value. The value may contain \fB%\fR\fIn\fR strings to indicate parameter
  48   48  substitution. Literal percents should be doubled (\fB%%\fR). Blank lines and
  49   49  lines beginning with \fB#\fR are ignored.
  50   50  .sp
  51   51  .LP
  52      -\fBmakemap\fR handles three different database formats. Database format is
  53      -selected using the \fImaptype\fR parameter. See \fBOPERANDS\fR.
       52 +Depending on how it is compiled, \fBmakemap\fR handles up to three different
       53 +database formats, selected using the \fImaptype\fR parameter. See
       54 +\fBOPERANDS\fR.
  54   55  .SH OPTIONS
  55      -.sp
  56   56  .LP
  57   57  The following options are supported:
  58   58  .sp
  59   59  .ne 2
  60   60  .na
  61      -\fB\fB-c\fR \fIcachesize\fR\fR
       61 +\fB-c\fR \fIcachesize\fR
  62   62  .ad
  63   63  .RS 18n
  64   64  Use the specified hash and B-Tree cache size (\fIcachesize\fR).
  65   65  .RE
  66   66  
  67   67  .sp
  68   68  .ne 2
  69   69  .na
  70      -\fB\fB-C\fR \fIfile\fR\fR
       70 +\fB-C\fR \fIfile\fR
  71   71  .ad
  72   72  .RS 18n
  73      -Use the specified sendmail configuration file (\fIfile\fR) for looking up the
  74      -TrustedUser option.
       73 +Use the specified \fBsendmail\fR configuration file (\fIfile\fR) for looking up
       74 +the \fBTrustedUser\fR option.
  75   75  .RE
  76   76  
  77   77  .sp
  78   78  .ne 2
  79   79  .na
  80      -\fB\fB-d\fR\fR
       80 +\fB-d\fR
  81   81  .ad
  82   82  .RS 18n
  83   83  Allow duplicate keys in the map. This is only allowed on B-Tree format maps. If
  84      -two identical keys are read, both be inserted into the map.
       84 +two identical keys are read, both are inserted into the map.
  85   85  .RE
  86   86  
  87   87  .sp
  88   88  .ne 2
  89   89  .na
  90      -\fB\fB-D\fR \fIcommentchar\fR\fR
       90 +\fB-D\fR \fIcommentchar\fR
  91   91  .ad
  92   92  .RS 18n
  93   93  Use the specified character to indicate a comment (which is ignored) instead of
  94   94  the default of '\fB#\fR'.
  95   95  .RE
  96   96  
  97   97  .sp
  98   98  .ne 2
  99   99  .na
 100      -\fB\fB-e\fR\fR
      100 +\fB-e\fR
 101  101  .ad
 102  102  .RS 18n
 103  103  Allow empty value (right hand side).
 104  104  .RE
 105  105  
 106  106  .sp
 107  107  .ne 2
 108  108  .na
 109      -\fB\fB-f\fR\fR
      109 +\fB-f\fR
 110  110  .ad
 111  111  .RS 18n
 112  112  Normally, all upper case letters in the key are folded to lower case. This flag
 113  113  disables that behavior. This is intended to mesh with the \fB-f\fR flag in the
 114  114  \fBK\fR line in \fBsendmail.cf\fR. The value is never case folded.
 115  115  .RE
 116  116  
 117  117  .sp
 118  118  .ne 2
 119  119  .na
 120      -\fB\fB-l\fR\fR
      120 +\fB-l\fR
 121  121  .ad
 122  122  .RS 18n
 123  123  List supported map types.
 124  124  .RE
 125  125  
 126  126  .sp
 127  127  .ne 2
 128  128  .na
 129      -\fB\fB-N\fR\fR
      129 +\fB-N\fR
 130  130  .ad
 131  131  .RS 18n
 132  132  Include the null byte that terminates strings in the map. This must match the
 133      -\fB-N\fR flag in the \fBK\fR line in \fBsendmail.cf\fR
      133 +\fB-N\fR flag in the \fBK\fR line in \fBsendmail.cf\fR.
 134  134  .RE
 135  135  
 136  136  .sp
 137  137  .ne 2
 138  138  .na
 139      -\fB\fB-o\fR\fR
      139 +\fB-o\fR
 140  140  .ad
 141  141  .RS 18n
 142  142  Append to an old file. This allows you to augment an existing file.
 143  143  .RE
 144  144  
 145  145  .sp
 146  146  .ne 2
 147  147  .na
 148      -\fB\fB-r\fR\fR
      148 +\fB-r\fR
 149  149  .ad
 150  150  .RS 18n
 151  151  Allow replacement of existing keys. Normally \fBmakemap\fR complains if you
 152  152  repeat a key, and does not do the insert.
 153  153  .RE
 154  154  
 155  155  .sp
 156  156  .ne 2
 157  157  .na
 158      -\fB\fB-s\fR\fR
      158 +\fB-s\fR
 159  159  .ad
 160  160  .RS 18n
 161  161  Ignore safety checks on maps being created. This includes checking for hard or
 162  162  symbolic links in world writable directories.
 163  163  .RE
 164  164  
 165  165  .sp
 166  166  .ne 2
 167  167  .na
 168      -\fB\fB-t\fR \fIdelim\fR\fR
      168 +\fB-t\fR \fIdelim\fR
 169  169  .ad
 170  170  .RS 18n
 171  171  Use the specified delimiter (\fIdelim\fR) instead of whitespace.
 172  172  .RE
 173  173  
 174  174  .sp
 175  175  .ne 2
 176  176  .na
 177      -\fB\fB-u\fR\fR
      177 +\fB-u\fR
 178  178  .ad
 179  179  .RS 18n
 180  180  Dump (unmap) the content of the database to standard output. Note that, if the
 181  181  \fB-t\fR option is also provided, the specified delimiter is used when the
 182  182  content is dumped instead of whitespace.
 183  183  .RE
 184  184  
 185  185  .sp
 186  186  .ne 2
 187  187  .na
 188      -\fB\fB-v\fR\fR
      188 +\fB-v\fR
 189  189  .ad
 190  190  .RS 18n
 191      -Verbosely print what it is doing.
      191 +Verbosely print keys and values being added.
 192  192  .RE
 193  193  
 194  194  .SH OPERANDS
 195      -.sp
 196  195  .LP
 197  196  The following operands are supported:
 198  197  .sp
 199  198  .ne 2
 200  199  .na
 201      -\fB\fImapname\fR\fR
      200 +\fImapname\fR
 202  201  .ad
 203  202  .RS 11n
 204  203  File name of the database map being created.
 205  204  .RE
 206  205  
 207  206  .sp
 208  207  .ne 2
 209  208  .na
 210      -\fB\fImaptype\fR\fR
      209 +\fImaptype\fR
 211  210  .ad
 212  211  .RS 11n
 213  212  Specifies the database format. The following \fImaptype\fR parameters are
 214  213  available:
 215  214  .sp
 216  215  .ne 2
 217  216  .na
 218      -\fB\fBdbm\fR\fR
      217 +\fBdbm\fR
 219  218  .ad
 220  219  .RS 9n
 221  220  Specifies \fBDBM\fR format maps.
 222  221  .RE
 223  222  
 224  223  .sp
 225  224  .ne 2
 226  225  .na
 227      -\fB\fBbtree\fR\fR
      226 +\fBbtree\fR
 228  227  .ad
 229  228  .RS 9n
 230  229  Specifies B-Tree format maps.
 231  230  .RE
 232  231  
 233  232  .sp
 234  233  .ne 2
 235  234  .na
 236      -\fB\fBhash\fR\fR
      235 +\fBhash\fR
 237  236  .ad
 238  237  .RS 9n
 239  238  Specifies hash format maps.
 240  239  .RE
 241  240  
 242  241  .RE
 243  242  
 244  243  .SH SEE ALSO
 245      -.sp
 246  244  .LP
 247  245  \fBeditmap\fR(1M), \fBsendmail\fR(1M), \fBattributes\fR(5)
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX