1ISDNRATE(1)                 General Commands Manual                ISDNRATE(1)
2
3
4

NAME

6       isdnrate - Print telephone rates and various info from rate-files(5).
7

SYNOPSIS

9       isdnrate  -bbest  -dday -ffrom -hhour -llen -o -pprovs -r vNN -s -ttakt
10       -vverbose -xexclude  -C -Ddet -Gdata -H -L -N  -Osocketfile  -Ppiddir
11       -Ssort -T -U -V -Xexplain -Z NUMBER ...
12
13       All options are optional.
14

DESCRIPTION

16       The isdnrate program prints various information from rate-files(5). Its
17       main purpose is the calculation of telephone rates from  your  location
18       to  an  arbitrary destination at a certain time and of a certain length
19       for all the providers in a rate-file.
20
21   NUMBER
22       A telephone number may be
23
24              1234 a local area number
25
26              01234 a different area in your country
27
28              +12345 a foreign country
29
30              China text for a foreign country
31
32              Paris a town
33
34              US a code as defined in country.dat.
35
36              Internet a Service name (if option -s is also given).
37
38       Note that currently only city names in AT, DE and NL are supported plus
39       some international capitals.
40       Note  also,  spaces in country- or service names may be given as under‐
41       scores.
42
43   OPTIONS
44       -bbest Print only best providers. Default is all.
45
46       -crateconf Use rateconf as provider selection file and  ignore  setting
47       in isdn.conf.
48
49       -dday Calc rates for day. day can be one of
50
51              dd day of current month
52              dd.mm day month
53              dd.mm.yy[yy] day, month, year
54              W Weekday
55              N Weekday - night
56              E Weekend
57
58       Default is now.
59
60       -ffrom Callers location. Default is from isdn.conf.
61
62       -hhour Time hh[:mm[:ss]] of call. Default is now.
63
64       -iratefile  Use  ratefile (usually rate-CC.dat) as source for telephone
65       fees and ignore setting in isdn.conf.
66
67       -llen Length of call in seconds. Default is 153 seconds.
68
69       -o Show only booked providers. These are providers, which are listed in
70       rate.conf.
71
72       -p  provider[,provider...]   Print  only  info  for  given provider(s).
73       provider  is  the  provider  number,  without  the  leading   VBN,   or
74       provider_variant  if  there  are  more  variations,  or  B for business
75       providers.
76
77       -rvNN Show only providers whose VBN begins with NN.  The  VBN  is  also
78       known as provider prefix consisting of VBN and provider number.
79
80       -s  Consider  NUMBER  as  the name of a service and print all numbers /
81       providers, which supply this service.
82
83       -ttakt Print only providers, which have calculation impulses smaller or
84       equal to takt.  Default is 9999.
85
86       -vverbose Set verbose level.
87
88       -x provider[,provider...]  Exclude these provider(s).
89
90   DISPLAY AND RUN OPTIONS
91       -C  Connect  to  a  running  isdnrate daemon. This avoids long start-up
92       times.
93
94       -D Start as a daemon, waiting for connections from a client. The socket
95       /var/run/isdnrate/socket  is created, which clients can connect to (the
96       socket can be changed by using the -O option).
97
98       -D2 Start as a daemon and go background.
99
100       -CD3 Stop a running daemon.
101
102       -Gn Print raw data for connection. n may be currently 97,98,99.
103
104       -H Print a header.
105
106       -L Print a semicolon separated list of
107
108              vbn ; providername ; zone ; day ; time ;  currency  ;  charge  ;
109              basicprice  ;  price  ;  duration  ; charge/min ; takt ; minimum
110              price
111
112       -N Show info about following numbers. If no provider is given, the pre‐
113       selected provider is used.
114
115       -Osocketfile  Use  given  filename  as  the  socket on start of daemon.
116       Default is /var/run/isdnrate/socket.
117
118       -Ppiddir Write own PID to piddir/isdnrate.pid on start of daemon.
119
120       -Ssort Sort output by sort, which may be
121
122              v vbn or n provider name. Default is by charge.
123
124       -T Print a table of charges for daytimes weekday/weekend.
125
126       -V Print version info and exit.
127
128       -Xexplain Print additional information for charge  or  from  rate-file.
129       explain may be
130
131              1 (zone)
132              2 (charge/min, zone, day, time)
133              50 International areas
134              51 National zones
135              52 Services
136              COMMENT Print C:COMMENT: info from rate files.
137
138       If  -s  is  given, the number of the service is also listed with -X1 or
139       -X2.
140
141       -Z Print info for LCR
142       e.g. isdnrate -p1 -ZX 19430
143       shows the rate for provider 1 and the cheapest rate to this service.
144
145       Note: Various output options may  not  be  used  together.  Conflicting
146       options will produce a warning.
147       Note also: Sort by name or providernumber and -bbest will bring you the
148       first best providers in sorting order, not the cheapest.
149       And finally: Some options like -X50, -X51, -X52, -D, -V don't require a
150       telephone NUMBER.
151

FILES

153       rate-CC.dat,  holiday-CC.dat,  dest.gdbm,  zone-CC-PPP.gdbm, isdn.conf,
154       telrate.cgi and more.
155       Note: The extension of zone- and dest data files depends on  configura‐
156       tion.  Recently .cdb is used.
157

EXAMPLES

159       isdnrate -D2
160       Start the isdnrate daemon.
161
162       isdnrate -D2 -P /var/run -O /tmp/isdnr_socket
163       Start  the  isdnrate  daemon, write isdnrate.pid to /var/run and create
164       the given socket.
165
166       isdnrate -CH -b5 -f01 -l120 Attersee
167       Connect to running daemon, print a header and the  best  5  rates  from
168       Vienna  (01)  to destination Attersee for a connection length of 2 Min‐
169       utes.
170
171
172       isdnrate -CX -p1_2,24 +1
173       Show rates and zones for destination USA for providers 1, 2 and 24.
174
175       isdnrate -C -l60 -rv010 HAM
176       Show rates for a one minute call to Hamburg (HAM: airport code) and use
177       only providers whose vbn begins with 010.  So provider A with vbn 01030
178       is displayed, provider B with vbn 0190023 is not.
179
180       isdnrate -CX -H -dW -b5 US CA
181       Show a header, rates and zones for destinations USA and Canada for best
182       5 providers during workday.
183
184       isdnrate -CHoX US
185       Show  header,  rate  and  zone for destination USA for booked providers
186       only.
187
188       isdnrate -CsX -l60 Internet
189       Show rates and numbers for service Internet for a 1 minute call.
190
191       isdnrate -CZ 19430
192       Show rates and the best provider for this (service-)number.
193
194       isdnrate -CD3
195       Stop the running isdnrate daemon.
196

SIGNALS

198       A isdnrate daemon restarts (and therefore rereads its configuration) on
199       getting a SIGHUP signal.
200

SEE ALSO

202       rate-files(5), isdnlog(8), isdn.conf(5)
203

BUGS

205       Definitely  yes.  Sometimes  more then one daemon can be started, some‐
206       times the socket is not removed, when the daemon  terminates.  if  this
207       happens ('socket in use'), do a rm /tmp/isdnrate and try again.
208

AUTHORS

210       Andreas  Kool  <akool@isdn4linux.de>  started  this  program.   Leopold
211       Toetsch <lt@toetsch.at> continued the work and brought this man page to
212       you.  Michael Reinelt <reinelt@eunet.at> did the calculation engine and
213       various tools for it.
214
215
216
217-lt-                              2004/07/13                       ISDNRATE(1)
Impressum