makemap.8
上传用户:xu_441
上传日期:2007-01-04
资源大小:1640k
文件大小:3k
源码类别:

Email客户端

开发平台:

Unix_Linux

  1. ." Copyright (c) 1998, 1999 Sendmail, Inc. and its suppliers.
  2. ."  All rights reserved.
  3. ." Copyright (c) 1988, 1991, 1993
  4. ." The Regents of the University of California.  All rights reserved.
  5. ."
  6. ." By using this file, you agree to the terms and conditions set
  7. ." forth in the LICENSE file which can be found at the top level of
  8. ." the sendmail distribution.
  9. ."
  10. ."
  11. ."     $Id: makemap.8,v 8.21 1999/07/30 06:15:31 gshapiro Exp $
  12. ."
  13. .TH MAKEMAP 8 "November 16, 1992"
  14. .SH NAME
  15. .B makemap
  16. - create database maps for sendmail
  17. .SH SYNOPSIS
  18. .B makemap
  19. .RB [ -C
  20. .IR file ]
  21. .RB [ -N ]
  22. .RB [ -c
  23. .IR cachesize ]
  24. .RB [ -d "] [" -e "] [" -f "] [" -l "] [" -o "] [" -r "] [" -s "] [" -u "] [" -v ]
  25. .I 
  26. maptype mapnam
  27. .SH DESCRIPTION
  28. .B Makemap
  29. creates the database maps used by the keyed map lookups in
  30. sendmail(8).  
  31. It reads input from the standard input
  32. and outputs them to the indicated
  33. .I mapname.
  34. .PP
  35. Depending on how it is compiled,
  36. .B makemap
  37. handles up to three different database formats, 
  38. selected using the
  39. .I maptype
  40. parameter.  
  41. They may be
  42. .TP
  43. dbm
  44. DBM format maps.  
  45. This requires the 
  46. ndbm(3) 
  47. library.
  48. .TP
  49. btree
  50. B-Tree format maps.  
  51. This requires the new Berkeley DB 
  52. library.
  53. .TP
  54. hash
  55. Hash format maps.  
  56. This also requires the Berkeley DB 
  57. library.
  58. .PP
  59. In all cases,
  60. .B makemap
  61. reads lines from the standard input consisting of two 
  62. words separated by white space.  
  63. The first is the database key, 
  64. the second is the value.  
  65. The value may contain 
  66. ``%fInfP'' 
  67. strings to indicate parameter substitution.  
  68. Literal percents should be doubled 
  69. (``%%'').
  70. Blank lines and lines beginning with ``#'' are ignored.
  71. .PP
  72. If the
  73. .I TrustedUser
  74. option is set in the sendmail configuration file and
  75. .B makemap
  76. is invoked as root, the generated files will be owned by 
  77. the specified
  78. .IR TrustedUser.
  79. .SS Flags
  80. .TP  
  81. .B -C
  82. Use the specified sendmail configuration file for 
  83. looking up the TrustedUser option.
  84. .TP 
  85. .B -N
  86. Include the null byte that terminates strings 
  87. in the map.  
  88. This must match the -N flag in the sendmail.cf 
  89. ``K'' line.
  90. .TP
  91. .B -c
  92. Use the specified hash and B-Tree cache size.
  93. .TP
  94. .B -d
  95. Allow duplicate keys in the map.  
  96. This is only allowed on B-Tree format maps.  
  97. If two identical keys are read, 
  98. they will both be inserted into the map.
  99. .TP
  100. .B -e
  101. Allow empty value (right hand side).
  102. .TP
  103. .B -f
  104. Normally all upper case letters in the key 
  105. are folded to lower case.  
  106. This flag disables that behaviour.  
  107. This is intended to mesh with the 
  108. -f flag in the 
  109. .B K 
  110. line in sendmail.cf.  
  111. The value is never case folded.
  112. .TP
  113. .B -l
  114. List supported map types.
  115. .TP
  116. .B -o
  117. Append to an old file.  
  118. This allows you to augment an existing file.
  119. .TP
  120. .B -r
  121. Allow replacement of existing keys.  
  122. Normally
  123. .B makemap
  124. complains if you repeat a key, 
  125. and does not do the insert.
  126. .TP
  127. .B -s
  128. Ignore safety checks on maps being created.  
  129. This includes checking for hard or symbolic 
  130. links in world writable directories.
  131. .TP
  132. .B -u
  133. dump (unmap) the content of the database to standard output.
  134. .TP
  135. .B -v
  136. Verbosely print what it is doing.
  137. .SH SEE ALSO
  138. sendmail(8)
  139. .SH HISTORY
  140. The
  141. .B makemap
  142. command appeared in 
  143. 4.4BSD.