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  -a  -bbest  -dday  -ffrom  -hhour  -llen -o -pprovs -r vNN -s
10       -ttakt -vverbose -xexclude  -C  -Ddet  -Gdata  -H  -L  -N  -Osocketfile
11       -Ppiddir  -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       -a Show old and newer rates. Default actual only.
45
46       -bbest Print only best providers. Default is all.
47
48       -crateconf Use rateconf as provider selection file and  ignore  setting
49       in isdn.conf.
50
51       -dday Calc rates for day. day can be one of
52
53              dd day of current month
54              dd.mm day month
55              dd.mm.yy[yy] day, month, year
56              W Weekday
57              N Weekday - night
58              E Weekend
59
60       Default is now.
61
62       -ffrom Callers location. Default is from isdn.conf.
63
64       -hhour Time hh[:mm[:ss]] of call. Default is now.
65
66       -iratefile  Use  ratefile (usually rate-CC.dat) as source for telephone
67       fees and ignore setting in isdn.conf.
68
69       -llen Length of call in seconds. Default is 153 seconds.
70
71       -o Show only booked providers. These are providers, which are listed in
72       rate.conf.
73
74       -p  provider[,provider...]   Print  only  info  for  given provider(s).
75       provider  is  the  provider  number,  without  the  leading   VBN,   or
76       provider_variant  if  there  are  more  variations,  or  B for business
77       providers.
78
79       -rvNN Show only providers whose VBN begins with NN.  The  VBN  is  also
80       known as provider prefix consisting of VBN and provider number.
81
82       -s  Consider  NUMBER  as  the name of a service and print all numbers /
83       providers, which supply this service.
84
85       -ttakt Print only providers, which have calculation impulses smaller or
86       equal to takt.  Default is 9999.
87
88       -vverbose Set verbose level.
89
90       -x provider[,provider...]  Exclude these provider(s).
91
92   DISPLAY AND RUN OPTIONS
93       -C  Connect  to  a  running  isdnrate daemon. This avoids long start-up
94       times.
95
96       -D Start as a daemon, waiting for connections from a client. The socket
97       /tmp/isdnrate is created, which clients can connect to.
98
99       -D2 Start as a daemon and go background.
100
101       -CD3 Stop a running daemon.
102
103       -Gn Print raw data for connection. n may be currently 97,98,99.
104
105       -H Print a header.
106
107       -L Print a semicolon separated list of
108
109              vbn  ;  providername  ;  zone ; day ; time ; currency ; charge ;
110              basicprice ; price ; duration ;  charge/min  ;  takt  ;  minimum
111              price
112
113       -N Show info about following numbers. If no provider is given, the pre‐
114       selected provider is used.
115
116       -Osocketfile Write socket to given filename on start of daemon. Default
117       is tmp/isdnrate.
118
119       -Ppiddir Write own PID to piddir/isdnrate.pid on start of daemon.
120
121       -Ssort Sort output by sort, which may be
122
123              v vbn or n provider name. Default is by charge.
124
125       -T Print a table of charges for daytimes weekday/weekend.
126
127       -V Print version info and exit.
128
129       -Xexplain  Print  additional  information for charge or from rate-file.
130       explain may be
131
132              1 (zone)
133              2 (charge/min, zone, day, time)
134              50 International areas
135              51 National zones
136              52 Services
137              COMMENT Print C:COMMENT: info from rate files.
138
139       If -s is given, the number of the service is also listed  with  -X1  or
140       -X2.
141
142       -Z Print info for LCR
143       e.g. isdnrate -p1 -ZX 19430
144       shows the rate for provider 1 and the cheapest rate to this service.
145
146       Note:  Various  output  options  may  not be used together. Conflicting
147       options will produce a warning.
148       Note also: Sort by name or providernumber and -bbest will bring you the
149       first best providers in sorting order, not the cheapest.
150       And finally: Some options like -X50, -X51, -X52, -D, -V don't require a
151       telephone NUMBER.
152

FILES

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

EXAMPLES

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

SIGNALS

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

SEE ALSO

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

BUGS

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

AUTHORS

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