The
isdnrate
program prints various information from rate-files(5). It's main purpose
is the calculation of telefon rates from your location to an arbitrary
destination at a certain time and of a certain length for all the providers in a rate-file.
NUMBER
A telefon number may be
1234
a local area number
01234
a different area in your country
+12345
a foreign country
China
text for a foreign country
Paris
a town
US
a code as defined in
country.dat.
Internet
a Service name (if option
-s
is also given).
Note that currently only city names in AT, DE, NL are supported plus some international capitals.
Note also, spaces in country- or service names may be given as underscores.
OPTIONS
-bbest
Print only best providers. Default is all.
-crateconf
Use rateconf as provider selection file and ignore setting in
isdn.conf.
-dday
Calc rates for day. day can be one of
dd
day of current month
dd.mm
day month
dd.mm.yy[yy]
day, month, year
W
Weekday
N
Weekday - night
E
Weekend
Default is now.
-ffrom
Callers location. Default ist from
isdn.conf.
-hhour
Time
hh[:mm[:ss]]
of call. Default is now.
-iratefile
Use ratefile (usually rate-CC.dat) as source for telephone fees and
ignore setting in
isdn.conf.
-llen
Length of call in second. Default value is 153 secs.
-o
Show only booked providers. These are providers, which are listed in
rate.conf.
-p provider[,provider...]
Print only info for given provider(s).
provider
is the provider number, without the leading VBN, or
provider_variant
if there are more variations, or
B
for business providers.
-rvNN
Show only providers whose vbn begins with NN.
The vbn is also known as provider prefix consisting of VBN and provider number.
-s
Consider
NUMBER
as the name of a service and print all numbers / providers, which supply
this service.
-ttakt
Print only providers, which have calculation impulses smaller or equal to takt.
Default is 9999.
-vverbose
Set verbose level.
-x provider[,provider...]
Exclude these provider(s).
DISPLAY AND RUN OPTIONS
-C
Connect to a running isdnrate daemon. This avoids long startup times.
-D
Start as a daemon, waiting for connections from a client. The socket
/tmp/isdnrate
is created, which clients can connect to.
-D2
Start as a daemon and go background.
-CD3
Stop a running daemon.
-Gn
Print raw data for connection. n may be currently 97,98,99.
-H
Print a header.
-L
Print a semicolon separated list of
vbn ; providername ; zone ; day ; time ; currency ; charge ; basicprice ; price ;
duration ; charge/min ; takt ; minimum price
-N
Show info about following numbers. If no provider is given, the preselected
provider is used.
-Osocketfile
Write socket to given filename on start of daemon. Default is
tmp/isdnrate.
-Ppiddir
Write own PID to
piddir/isdnrate.pid
on start of daemon.
-Ssort
Sort output by sort, which may be
v
vbn or
n
provider name. Default is by charge.
-T
Print a table of charges for daytimes weekday/weekend.
-V
Print version info and exit.
-Xexplain
Print additional information for charge or from rate-file.
explain
may be
1
(zone)
2
(charge/min, zone, day, time)
50
International areas
51
National zones
52
Services
COMMENT
Print C:COMMENT: info from rate files.
If
-s
is given, the number of the service is also listed with
-X1
or
-X2.
-Z
Print info for LCR
e.g. isdnrate -p1 -ZX 19430
shows the rate for provider 1 and the cheapest rate to this service.
Note: Various output options may not be used together. If you gave conflicting
options you'll see a warning.
Note also: Sort by name or providernumber and
-bbest
will bring you the first
best
providers in sorting order, not the cheapest.
And finally: Some options like
-X50, -X51, -X52, -D, -V
don't require a telefon
NUMBER.
FILES
rate-CC.dat,
holiday-CC.dat,
dest.gdbm,
zone-CC-PPP.gdbm,
isdn.conf,
telrate.cgi
and more.
Note: The extension of zone- and dest data files depends on configuration.
Recently
.cdb
is used.
EXAMPLES
isdnrate -D2
Start the isdnrate daemon.
isdnrate -D2 -P /var/run -O /tmp/isdnr_socket
Start the isdnrate daemon, write
isdnrate.pid
to /var/run and create the given socket.
isdnrate -CH -b5 -f01 -l120 Attersee
Connect to running daemon, print a header and the best 5 rates from Vienna
(01)
to destination
Attersee
for a connection length of 2 Minutes.
isdnrate -CX -p1_2,24 +1
Show rates and zones for destination USA for providers
1_2 and 24.
isdnrate -C -l60 -rv010 HAM
Show rates for a one minute call to Hamburg (HAM: airport code) and
use only providers whose vbn begins with 010.
So provider A with vbn 01030 is displayed,
provider B with vbn 0190023 is not.
isdnrate -CX -H -dW -b5 US CA
Show a header, rates and zones for destinations USA and Canada for best 5
providers during workday.
isdnrate -CHoX US
Show header, rate and zone for destination USA for booked providers only.
isdnrate -CsX -l60 Internet
Show rates and numbers for service
Internet
for a 1 minutes call.
isdnrate -CZ 19430
Show rates and the best provider for this (service-)number.
isdnrate -CD3
Stop the running isdnrate daemon.
SIGNALS
A isdnrate daemon restarts (and therefore rereads its configuration) on
getting a SIGHUP signal.
Definitely yes. Sometimes more then one daemon can be started, sometimes the
socket is not removed, when the daemon terminates. if this happens
('socket in use'), do a
rm /tmp/isdnrate
and try again.
AUTHORS
Andreas Kool <akool@isdn4linux.de> started this program.
Leopold Toetsch <lt@toetsch.at> continued the work and brought this man
page to you. Michael Reinelt
<reinelt@eunet.at> did the calculation engine and various tools for it.
