Provided by: isdnlog_3.8.2005-12-06-2ubuntu4_i386 bug

NAME

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

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.

SEE ALSO

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

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.

-lt-                              2004/07/13                       ISDNRATE(1)