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 configuration 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  characters  ``[]*.^$-+{}()''.
       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  ``\n''  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)