1rate.conf(5) isdnlog 4.71 rate.conf(5)
2
3
4
6 /etc/isdn/rate.conf - rate and provider configuration
7
8
10 isdnlog and related programs like isdnrep or isdnrate obtain the infor‐
11 mation about telephone rates or fees from a rate-file. In addition to
12 the general data from the rate-file it is necessary to provide informa‐
13 tion about the individual situation. This is the purpose of the con‐
14 figuration file rate.conf.
15
16 Words below consisting of uppercase letters like RATEFILE refer to the
17 so named setting in the general isdnlog configuration file
18 /etc/isdn/isdn.conf.
19
20
21 General Concepts
22 The rate-file contains one or more providers for a country. A provider
23 covers an offer of a telephone company. Usually there are now many
24 telephone companies in a country and most companies offer several dif‐
25 ferent price lists.
26
27 A provider is identified by provider number and provider variant or sub
28 number. The provider number, short pnum, is commonly used for all
29 offers of one company. The provider variant, short var, is used to
30 number these offers starting from 0. A specific provider is referenced
31 as pnum,var or pnum_var depending on the context.
32
33 VBN contains the shared leading digits of the carrier selection pre‐
34 fixes. The entire prefix for a provider is specified in the rate-file
35 by the B: tag. In Germany the carrier selection prefix begins with 010
36 followed by two or three digits which make the pnum ranging from 10 to
37 199. A mapping like this is not required but common.
38
39 The overall format of rate.conf is similar to the rate-file, lines
40 starting with tags P:, X:, or Q: may occur in any order and quantity.
41 (Of course, the resulting configuration should make sense.)
42
43
44 Provider Booking
45 P:pnum=var
46
47 Mark the provider specified by pnum and var as booked or active. Only
48 booked providers are taken into account when isdnlog computes the con‐
49 nection costs. Booking also tells isdnlog the provider variant to use
50 if there are more than one.
51
52 Beside computation of real connections booking also splits the
53 providers in two groups: the booked ones that are available at the spe‐
54 cific subscriber line at the not booked ones that are less important
55 for price comparison.
56
57 One provider in booked group is declared the default provider by set‐
58 ting PRESELECTED to its pnum. This provider is assumed to be used if a
59 connection is made without a carrier selection prefix and no exceptions
60 matching.
61
62
63 Exceptions to Provider Selection
64 X:number=pnum
65 X:number=pnumzzone
66
67 Connections to number will be assigned the booked provider with pnum as
68 provider number regardless of a dialed provider selection prefix or the
69 PRESELECTED setting. zone if present replaces the normal zone selec‐
70 tion based on destination codes. Exceptions can also be given in the
71 rate-file.
72
73 In rate.conf exceptions may become necessary if there different prese‐
74 lected providers for local and distance calls for example or if prese‐
75 lection does not apply generally, e.g. not for connections to special
76 numbers.
77
78
79 Provider Skipping
80 At least for some countries there are universal rate-files distributed
81 with isdnlog or provided elsewhere. In this case it is desirable to
82 keep the rate-file unmodified so that updates require no further
83 changes beyond installing the new rate-file. If a rate-file aims to
84 cover the telephone market in an entire nation there will be always
85 providers in it which are not available or not suitable for a specific
86 installation. Such providers can be disabled by not booking them but
87 they remain present and may be displayed as overall cheapest provider
88 or the like.
89
90 Provider skipping completely ignores selected, so called skipped
91 providers, from the rate-file. To be more precise, the effect of
92 skipped provider could also be achieved by deleting its lines starting
93 from its P: tag to the last line before the P: tag of the next provider
94 from the rate-file.
95
96 Providers to skip can also be configured in the parameter file of
97 isdnlog using the syntax described below in a line starting with skip‐
98 Prov= instead of Q:.
99
100 Q:[!|~]list
101
102
103 list := range[;list]
104
105
106 range := (*|prov|prov-|-prov|prov-prov)[!|~]
107
108
109 prov := pnum[,var]
110
111
112 Skipping applies to all providers that are matched by a given range.
113 If var is missing, all providers with pnum are skipped.
114
115 * matches all providers.
116
117 Booked providers are not skipped unless ! is given at end of the range
118 or in front of the entire list where it applies to whole line.
119
120 The ~ can be given alternatively to !. Providers that match such a
121 range are not skipped under any circumstances.
122
123 Space can occur anywhere in the line after Q:.
124
125 Example:
126 Q:*; 13,1~; 33-33,1~; 200-299!; 321-323!
127
128 This skips all not booked providers except 13_1, 33_0, and 33_1. Addi‐
129 tionally all providers with a pnum between 200 and 299 or 321 and 323
130 are skipped.
131
132
134 /etc/isdn/rate.conf
135 This file. RATECONF may be used to specify an alternative rate
136 and provider configuration file.
137
138
139 /usr/share/isdn/rate-CC.dat
140 The rate-file for your country. Replace CC with your two letter
141 country code, e.g. de for Germany. RATEFILE defines the rate-
142 file to use.
143
144
146 Tobias Becker <tobiasb@isdn4linux.de>
147
148
150 isdnlog(8) rate-files(5) isdn.conf(5)
151
152
153
154
155ISDN 4 Linux 3.13 2007/01/05 rate.conf(5)