pagermap(5f)

1PAGERMAP(5F)                                                      PAGERMAP(5F)
2
3
4

NAME

6       pagermap - SNPP pager identifier mapping file
7

DESCRIPTION

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).
16
17       The  pagermap  file  is comprised of one or more lines of the following
18       format:
19
20              <pattern> <dialstring>[/<pin>]
21
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.
33
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.
40
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.
45

EXAMPLES

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
56

NAME

DESCRIPTION

EXAMPLES

SEE ALSO