Bash Cures Cancer
Learn the UNIX/Linux command line

Home     Man Pages     SpamDefeator


ISDNRATE(1)							  ISDNRATE(1)



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	loca-
       tion  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 under-
       scores.

   OPTIONS
       -bbest Print only best providers. Default is all.

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

       -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 configura-
       tion.  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
       thew 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	 Min-
       utes.


       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
       Definitly yes. Sometimes more then one daemon can  be  started,	some-
       times  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    started  this  program.   Leopold
       Toetsch		 continued the work and brought this man page
       to you. Michael Reinelt  did the calculation  engine
       and various tools for it.



-lt-				  2003/09/04			  ISDNRATE(1)


UNIX/Linux commands referenced on this page:
  1. info
  2. at
  3. time
  4. as
  5. dd
  6. which
  7. more
  8. raw
  9. sort
  10. write
  11. rm
  12. man