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