---
name: "isdnrate"
section: "1"
platform: "linux"
package: "isdnlog"
version: "1:3.25+dfsg1-10"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/isdnrate"
---

# isdnrate(1)

Print telefon rates and various info from rate-files(5).

## NAME

isdnrate - Print telefon rates and various info from [rate-files(5)](/rate-files/5.md).

## SYNOPSIS

**isdnrate -b***best* **-d***day* **-f***from* **-h***hour* **-l***len* **-o** **-p***provs* **-r** *vNN* **-s** **-t***takt* **-v***verbose* **-x***exclude*  **-C -D***det* **-G***data* **-H -L -N -O***socketfile* **-P***piddir*  **-S***sort* **-T -U -V -X***explain* **-Z** **NUMBER ...**

All options are optional.

## DESCRIPTION

The **isdnrate** program prints various information from [rate-files(5)](/rate-files/5.md). 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**

**-b***best* Print only *best* providers. Default is all.

**-c***rateconf* Use *rateconf* as provider selection file and ignore setting in *isdn.conf*.

**-d***day* 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.

**-f***from* Callers location. Default ist from *isdn.conf*.

**-h***hour* Time *hh*\[*:mm*\[*:ss*\]\] of call. Default is now.

**-i***ratefile* Use *ratefile* (usually rate-CC.dat) as source for telephone fees and ignore setting in *isdn.conf*.

**-l***len* 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.

**-r**v*NN* 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.

**-t***takt* Print only providers, which have calculation impulses smaller or equal to *takt*. Default is 9999.

**-v***verbose* 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.

**-G***n* 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.

**-O***socketfile* Use given filename as the socket on start of daemon. Default is */var/run/isdnrate/socket*.

**-P***piddir* Write own PID to *piddir/isdnrate.pid* on start of daemon.

**-S***sort* 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.

**-X***explain* 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 **-b***best* 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.

## SEE ALSO

**[rate-files(5)](/rate-files/5.md)**, **[isdnlog(8)](/isdnlog/8.md)**, **[isdn.conf(5)](/isdn.conf/5.md)**

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