PAGERMAP(5F)PAGERMAP(5F)NAMEpagermap - 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
May 8, 1996 1
PAGERMAP(5F)PAGERMAP(5F)
alphabetics to key codes--or one that passes them through
verbatim.)
# a simple mapping example
sam 5551212/99
Sky(.*) 1800SkyTel/\1
.* reject
SEE ALSOhfaxd(8C), hylafax-server(5F)
May 8, 1996 2
