pagermap.4f
上传用户:weiyuanprp
上传日期:2020-05-20
资源大小:1169k
文件大小:4k
源码类别:

传真(Fax)编程

开发平台:

C/C++

  1. ." $Id: pagermap.4f,v 1.1.1.1 2005/11/11 21:32:03 faxguy Exp $
  2. ."
  3. ." HylaFAX Facsimile Software
  4. ."
  5. ." Copyright (c) 1995-1996 Sam Leffler
  6. ." Copyright (c) 1995-1996 Silicon Graphics, Inc.
  7. ." HylaFAX is a trademark of Silicon Graphics
  8. ." 
  9. ." Permission to use, copy, modify, distribute, and sell this software and 
  10. ." its documentation for any purpose is hereby granted without fee, provided
  11. ." that (i) the above copyright notices and this permission notice appear in
  12. ." all copies of the software and related documentation, and (ii) the names of
  13. ." Sam Leffler and Silicon Graphics may not be used in any advertising or
  14. ." publicity relating to the software without the specific, prior written
  15. ." permission of Sam Leffler and Silicon Graphics.
  16. ." 
  17. ." THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
  18. ." EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
  19. ." WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
  20. ." 
  21. ." IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  22. ." ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  23. ." OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  24. ." WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
  25. ." LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
  26. ." OF THIS SOFTWARE.
  27. ."
  28. .if n .po 0
  29. .ds Fx fIHylas-1FAXs+1fP
  30. .TH PAGERMAP ${MANNUM4_5} "May 8, 1996"
  31. .SH NAME
  32. pagermap - s-1SNPPs+1 pager identifier mapping file
  33. .SH DESCRIPTION
  34. The file
  35. .B etc/pagermap
  36. (by default) is used by the s-1SNPPs+1 support in
  37. .IR hfaxd (${MANNUM1_8})
  38. to map pager identifiers specified with the s-1PAGEs+1 directive
  39. to
  40. .SM IXO/TAP
  41. or
  42. .SM SMS
  43. service providers and optionally a Pager Identification
  44. Number (s-1PINs+1).
  45. (The ability to specify a s-1PINs+1 makes it possible to define 
  46. .I aliases
  47. for pagers.)
  48. Note that 
  49. .B etc/pagermap
  50. may be called a different name; the filename is specified
  51. with the
  52. .I PagerIDMapFile
  53. configuration parameter read by
  54. .IR hfaxd (${MANNUM1_8}).
  55. .PP
  56. The pagermap file is comprised of one or more
  57. lines of the following format:
  58. .sp
  59. .nf
  60. .RS
  61. <fIpatternfP> <fIdialstringfP>[/<fIpinfP>]
  62. .RE
  63. .fi
  64. .PP
  65. Each line specifies a <fIpatternfP> that is matched against
  66. a client-specified pager identifier string.
  67. A pattern may be a plain string or a
  68. .SM POSIX
  69. 1003.2 extended regular expression; plain strings
  70. must compare exactly while regular expressions are unanchored and any
  71. substring match constitutes a ``hit''.
  72. Regular expressions are distinguished from plain strings by the
  73. presence of one or more of the magic characters ``[]*.^$-+{}()''.
  74. The <fIdialstringfP> identifies the
  75. .SM IXO/TAP
  76. or
  77. .SM SMS
  78. service provider to contact for delivery or, if <fIdialstringfP>
  79. is the string ``reject'' (case insensitive) then the pager identifier
  80. is rejected.
  81. If the optional <fIpinfP> is specified then it used to deliver the
  82. page instead of the client-specified identifier.
  83. .PP
  84. If the matching expression is a regular expression
  85. the optional <fIpinfP>
  86. may reference the entire string matched by the
  87. regular expression with the ``&'' character.
  88. Substrings matched with the ``(...)'' constructs may be referenced
  89. by using ``efInfP'' where
  90. .I n
  91. is a single numeric digit between 1 and 9 that refers to the
  92. .IR n -th
  93. matched substring; c.f.
  94. .IR re_format (7),
  95. .IR sed (1),
  96. etc.
  97. .PP
  98. .I hfaxd
  99. processes lines in the mapping file sequentially; the first line
  100. with a pattern that matches the pager identifier is used to deliver
  101. or reject the page.
  102. Lines that begin with a ``#'' are treated as comments and discarded.
  103. Leading whitespace on a line is also ignored.
  104. .SH EXAMPLES
  105. The following defines an alias for ``sam'', submits all destinations
  106. with a leading ``Sky'' to a particular
  107. .SM IXO/TAP 
  108. service provider, and otherwise rejects the pager ID.
  109. (Note that using alphabetics in dial strings requires
  110. a dialstring rules file that understands how to map alphabetics
  111. to key codes(emor one that passes them through verbatim.)
  112. .sp .5
  113. .nf
  114. .RS
  115. .ft C
  116. .ta w'Sky(.*)    'u
  117. # a simple mapping example
  118. sam 5551212/99
  119. Sky(.*) 1800SkyTel/e1
  120. &.* reject
  121. .ft P
  122. .RE
  123. .fi
  124. .sp .5
  125. .SH "SEE ALSO"
  126. .IR hfaxd (${MANNUM1_8}),
  127. .IR hylafax-server (${MANNUM4_5})