199 lines
5.4 KiB
Groff
199 lines
5.4 KiB
Groff
.TH rate.conf 5 "January 2007" "ISDN 4 Linux @I4LVERSION@" "isdnlog @ISDNLOG_VERSION@"
|
|
|
|
.SH NAME
|
|
@I4LCONFDIR@/rate.conf \- rate and provider configuration
|
|
|
|
.SH DESCRIPTION
|
|
isdnlog and related programs like isdnrep or isdnrate obtain the
|
|
information about telephone rates or fees from a rate-file.
|
|
In addition to the general data from the rate-file it is necessary
|
|
to provide information about the individual situation.
|
|
This is the purpose of the configuration file rate.conf.
|
|
|
|
Words below consisting of uppercase letters like
|
|
.SB RATEFILE
|
|
refer to the so named setting in the general isdnlog configuration file
|
|
.IR @I4LCONFDIR@/@CONFFILE@ .
|
|
|
|
.SS General Concepts
|
|
|
|
The rate-file contains one or more providers for a country.
|
|
A provider covers an offer of a telephone company.
|
|
Usually there are now many telephone companies in a country and
|
|
most companies offer several different price lists.
|
|
|
|
A provider is identified by provider number and provider variant or
|
|
sub number. The provider number, short
|
|
.IR pnum ,
|
|
is commonly used for all offers of one company.
|
|
The provider variant, short
|
|
.IR var ,
|
|
is used to number these offers starting from 0.
|
|
A specific provider is referenced as
|
|
.IB pnum , var
|
|
or
|
|
.IB pnum _ var
|
|
depending on the context.
|
|
|
|
.SB VBN
|
|
contains the shared leading digits of the carrier selection prefixes.
|
|
The entire prefix for a provider is specified in the rate-file by the B: tag.
|
|
In Germany the carrier selection prefix begins with 010 followed by
|
|
two or three digits which make the
|
|
.I pnum
|
|
ranging from 10 to 199.
|
|
A mapping like this is not required but common.
|
|
|
|
The overall format of rate.conf is similar to the rate-file, lines
|
|
starting with tags
|
|
.BR P: ", " X: ", or " Q:
|
|
may occur in any order and quantity.
|
|
(Of course, the resulting configuration should make sense.)
|
|
|
|
.SS Provider Booking
|
|
|
|
.BI P: pnum = var
|
|
|
|
Mark the provider specified by
|
|
.IR pnum " and " var
|
|
as booked or active.
|
|
Only booked providers are taken into account when isdnlog computes
|
|
the connection costs. Booking also tells isdnlog the provider
|
|
variant to use if there are more than one.
|
|
|
|
Beside computation of real connections booking also splits the providers
|
|
in two groups: the booked ones that are available at the specific subscriber
|
|
line at the not booked ones that are less important for price comparison.
|
|
|
|
One provider in booked group is declared the default provider by setting
|
|
.SB PRESELECTED
|
|
to its
|
|
.IR pnum .
|
|
This provider is assumed to be used if a connection is made without a
|
|
carrier selection prefix and no exceptions matching.
|
|
|
|
.SS Exceptions to Provider Selection
|
|
|
|
.nf
|
|
.BI X: number = pnum
|
|
.BI X: number = pnum z zone
|
|
.fi
|
|
|
|
Connections to
|
|
.I number
|
|
will be assigned the booked provider with
|
|
.I pnum
|
|
as provider number regardless of a dialed provider selection prefix or the
|
|
.SB PRESELECTED
|
|
setting.
|
|
.I zone
|
|
if present
|
|
replaces the normal zone selection based on destination codes.
|
|
Exceptions can also be given in the rate-file.
|
|
|
|
In rate.conf exceptions may become necessary if there different
|
|
preselected providers for local and distance calls for example or if
|
|
preselection does not apply generally, e.g. not for connections to special
|
|
numbers.
|
|
|
|
.SS Provider Skipping
|
|
|
|
At least for some countries there are universal rate-files distributed with
|
|
isdnlog or provided elsewhere. In this case it is desirable to keep the
|
|
rate-file unmodified so that updates require no further changes beyond
|
|
installing the new rate-file. If a rate-file aims to cover the telephone
|
|
market in an entire nation there will be always providers in it which are
|
|
not available or not suitable for a specific installation.
|
|
Such providers can be disabled by not booking them but they remain present
|
|
and may be displayed as overall cheapest provider or the like.
|
|
|
|
Provider skipping completely ignores selected, so called skipped providers,
|
|
from the rate-file. To be more precise, the effect of skipped provider
|
|
could also be achieved by deleting its lines starting from its P: tag to
|
|
the last line before the P: tag of the next provider from the rate-file.
|
|
|
|
Providers to skip can also be configured in the parameter file of isdnlog
|
|
using the syntax described below in a line starting with
|
|
.BR skipProv= " instead of " Q: .
|
|
|
|
.BR Q: [ ! | ~ ]\fIlist\fP
|
|
|
|
.TP
|
|
.I list
|
|
:=
|
|
.IR range [\fB;\fP list ]
|
|
|
|
.TP
|
|
.I range
|
|
:=
|
|
.RI (\fB*\fP| prov | prov \fB-\fP|\fB-\fP prov | prov\fB-\fPprov )[\fB!\fP|\fB~\fP]
|
|
|
|
.TP
|
|
.I prov
|
|
:=
|
|
.IR pnum [\fB,\fR var ]
|
|
|
|
.P
|
|
Skipping applies to all providers that are matched by a given
|
|
.IR range.
|
|
If
|
|
.I var
|
|
is missing, all providers with
|
|
.I pnum
|
|
are skipped.
|
|
|
|
.B *
|
|
matches all providers.
|
|
|
|
Booked providers are not skipped unless
|
|
.B !
|
|
is given at end of the
|
|
.I range
|
|
or in front of the entire list where it applies to whole line.
|
|
|
|
The
|
|
.B ~
|
|
can be given alternatively to
|
|
.BR !.
|
|
Providers that match such a
|
|
.I range
|
|
are not skipped under any circumstances.
|
|
|
|
Space can occur anywhere in the line after
|
|
.BR Q:.
|
|
|
|
Example:
|
|
.br
|
|
Q:*; 13,1~; 33-33,1~; 200-299!; 321-323!
|
|
|
|
This skips all not booked providers except 13_1, 33_0, and 33_1.
|
|
Additionally all providers with a
|
|
.I pnum
|
|
between 200 and 299 or 321 and 323 are skipped.
|
|
|
|
.SH FILES
|
|
.TP
|
|
.B @I4LCONFDIR@/rate.conf
|
|
This file.
|
|
.SB RATECONF
|
|
may be used to specify an alternative rate and provider configuration file.
|
|
|
|
.TP
|
|
.BI @DATADIR@/rate- CC .dat
|
|
The rate-file for your country. Replace
|
|
.I CC
|
|
with your two letter country code, e.g.
|
|
.I de
|
|
for Germany.
|
|
.SB RATEFILE
|
|
defines the rate-file to use.
|
|
|
|
.SH AUTHOR
|
|
Tobias Becker <tobiasb@isdn4linux.de>
|
|
|
|
.SH SEE ALSO
|
|
.BR isdnlog (8)
|
|
.BR rate-files (5)
|
|
.BR isdn.conf (5)
|
|
|