1PAGERMAP(5F)                                                      PAGERMAP(5F)


6       pagermap - SNPP pager identifier mapping file


9       The  file  etc/pagermap  (by  default)  is  used by the SNPP support in
10       hfaxd(8C) to map pager identifiers specified with the PAGE directive to
11       IXO/TAP  or SMS service providers and optionally a Pager Identification
12       Number (PIN).  (The ability to specify  a  PIN  makes  it  possible  to
13       define  aliases  for  pagers.)   Note that etc/pagermap may be called a
14       different name; the filename is specified with the PagerIDMapFile  con‐
15       figuration parameter read by hfaxd(8C).
17       The  pagermap  file  is comprised of one or more lines of the following
18       format:
20              <pattern> <dialstring>[/<pin>]
22       Each line specifies a <pattern> that is matched against a client-speci‐
23       fied  pager  identifier  string.   A pattern may be a plain string or a
24       POSIX 1003.2 extended regular expression; plain  strings  must  compare
25       exactly  while  regular  expressions  are  unanchored and any substring
26       match constitutes a ``hit''.   Regular  expressions  are  distinguished
27       from  plain strings by the presence of one or more of the magic charac‐
28       ters ``[]*.^$-+{}()''.  The <dialstring> identifies the IXO/TAP or  SMS
29       service  provider  to  contact  for delivery or, if <dialstring> is the
30       string ``reject'' (case  insensitive)  then  the  pager  identifier  is
31       rejected.   If  the optional <pin> is specified then it used to deliver
32       the page instead of the client-specified identifier.
34       If the matching expression is a regular expression the  optional  <pin>
35       may  reference the entire string matched by the regular expression with
36       the ``&'' character.  Substrings matched with the ``(...)''  constructs
37       may  be  referenced  by  using ``\n'' where n is a single numeric digit
38       between 1 and 9  that  refers  to  the  n-th  matched  substring;  c.f.
39       re_format(7), sed(1), etc.
41       hfaxd  processes lines in the mapping file sequentially; the first line
42       with a pattern that matches the pager identifier is used to deliver  or
43       reject the page.  Lines that begin with a ``#'' are treated as comments
44       and discarded.  Leading whitespace on a line is also ignored.


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


58       hfaxd(8C), hylafax-server(5F)
62                                  May 8, 1996                     PAGERMAP(5F)