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

NAME

6       isdnrate - Print telefon 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).
17       It's main purpose is the calculation of telefon rates from  your  loca‐
18       tion  to  an  arbitrary  destination at a certain time and of a certain
19       length for all the providers in a rate-file.
20
21   NUMBER
22       A telefon 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, 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 ist 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 second. Default value is 153 secs.
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 startup
92       times.
93
94       -D Start as a daemon, waiting for connections from a client. The socket
95       /tmp/isdnrate is created, which clients can connect to.
96
97       -D2 Start as a daemon and go background.
98
99       -CD3 Stop a running daemon.
100
101       -Gn Print raw data for connection. n may be currently 97,98,99.
102
103       -H Print a header.
104
105       -L Print a semicolon separated list of
106
107              vbn  ;  providername  ;  zone ; day ; time ; currency ; charge ;
108              basicprice ; price ; duration ;  charge/min  ;  takt  ;  minimum
109              price
110
111       -N Show info about following numbers. If no provider is given, the pre‐
112       selected provider is used.
113
114       -Osocketfile Write socket to given filename on start of daemon. Default
115       is tmp/isdnrate.
116
117       -Ppiddir Write own PID to piddir/isdnrate.pid on start of daemon.
118
119       -Ssort Sort output by sort, which may be
120
121              v vbn or n provider name. Default is by charge.
122
123       -T Print a table of charges for daytimes weekday/weekend.
124
125       -V Print version info and exit.
126
127       -Xexplain  Print  additional  information for charge or from rate-file.
128       explain may be
129
130              1 (zone)
131              2 (charge/min, zone, day, time)
132              50 International areas
133              51 National zones
134              52 Services
135              COMMENT Print C:COMMENT: info from rate files.
136
137       If -s is given, the number of the service is also listed  with  -X1  or
138       -X2.
139
140       -Z Print info for LCR
141       e.g. isdnrate -p1 -ZX 19430
142       shows the rate for provider 1 and the cheapest rate to this service.
143
144       Note: Various output options may not be used together. If you gave con‐
145       flicting options you'll see a warning.
146       Note also: Sort by name or providernumber and -bbest will bring you the
147       first best providers in sorting order, not the cheapest.
148       And finally: Some options like -X50, -X51, -X52, -D, -V don't require a
149       telefon NUMBER.
150

FILES

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

EXAMPLES

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

SIGNALS

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

SEE ALSO

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

BUGS

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

AUTHORS

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