PAGERMAP(5F)

NAME
       pagermap - SNPP pager identifier mapping file

DESCRIPTION
       The  file  etc/pagermap  (by  default) is used by the SNPP
       support in hfaxd(8C) 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(8C).

       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 regu-
       lar expressions are unanchored  and  any  substring  match
       constitutes  a  ``hit''.   Regular expressions are distin-
       guished from plain strings by the presence of one or  more
       of  the  magic  characters  ``[]*.^$-+{}()''.   The <dial-
       string> 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  iden-
       tifier.

       If  the  matching  expression  is a regular expression the
       optional <pin> may reference the entire string matched  by
       the  regular  expression  with  the ``&'' character.  Sub-
       strings matched with the ``(...)'' constructs may be  ref-
       erenced  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 iden-
       tifier  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(8C) hylafax(5F)