SYNOPSIS

isdnrate -bbest -dday -ffrom -hhour -llen -o -pprovs -r vNN -s -ttakt -vverbose -xexclude -C -Ddet -\Gdata -H -L -N -Osocketfile -Ppiddir -Ssort -T -U -V -Xexplain -Z NUMBER ...

All options are optional.

DESCRIPTION

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 /var/run/isdnrate/socket is created, which clients can connect to (the socket can be changed by using the -O option).

-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 Use given filename as the socket on start of daemon. Default is /var/run/isdnrate/socket.

-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.

RELATED TO isdnrate…

BUGS

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 <[email protected]> started this program. Leopold Toetsch <[email protected]> continued the work and brought this man page to you. Michael Reinelt <[email protected]> did the calculation engine and various tools for it.