PAGERMAP(5)							File Formats Manual						       PAGERMAP(5)

NAME

       pagermap - SNPP pager identifier mapping file

DESCRIPTION

       The  file  etc/pagermap	(by default) is used by the SNPP support in hfaxd(8) to map pager identifiers specified with the PAGE directive to
       IXO/TAP or SMS service providers and optionally a Pager Identification Number (PIN).  (The ability to specify a PIN makes  it  possible	to
       define  aliases for pagers.)  Note that etc/pagermap may be called a different name; the filename is specified with the PagerIDMapFile con-
       figuration parameter read by hfaxd(8).

       The pagermap file is comprised of one or more lines of the following format:

	      <pattern> <dialstring>[/<pin>]

       Each line specifies a <pattern> that is matched against a client-specified pager identifier string.  A pattern may be a plain string  or  a
       POSIX  1003.2  extended	regular  expression; plain strings must compare exactly while regular expressions are unanchored and any substring
       match constitutes a ``hit''.  Regular expressions are distinguished from plain strings by the presence of one or more of the magic  charac-
       ters  ``[]*.^$-+{}()''.	The <dialstring> identifies the IXO/TAP or SMS service provider to contact for delivery or, if <dialstring> is the
       string ``reject'' (case insensitive) then the pager identifier is rejected.  If the optional <pin> is specified then it used to deliver the
       page instead of the client-specified identifier.

       If  the	matching  expression  is a regular expression the optional <pin> may reference the entire string matched by the regular expression
       with the ``&'' character.  Substrings matched with the ``(...)'' constructs may be referenced by using ``
'' where n is a  single  numeric
       digit between 1 and 9 that refers to the n-th matched substring; c.f.  re_format(7), sed(1), etc.

       hfaxd  processes lines in the mapping file sequentially; the first line with a pattern that matches the pager identifier is used to deliver
       or reject the page.  Lines that begin with a ``#'' are treated as comments and discarded.  Leading whitespace on a line is also ignored.

EXAMPLES

       The following defines an alias for ``sam'', submits all destinations with a leading ``Sky'' to a particular IXO/TAP service  provider,  and
       otherwise  rejects the pager ID.  (Note that using alphabetics in dial strings requires a dialstring rules file that understands how to map
       alphabetics to key codes--or one that passes them through verbatim.)
	      # a simple mapping example
	      sam	 5551212/99
	      Sky(.*)	 1800SkyTel/1
	      .*	 reject

SEE ALSO

       hfaxd(8), hylafax-server(5)

								    May 8, 1996 						       PAGERMAP(5)