Provided by: isdnlog_3.12.20071127-0ubuntu11_amd64 bug

NAME

       /etc/isdn/isdn.conf - config file for isdnlog

FORMAT

       The  config  file  has the format described in isdnformat(5). I recommend starting isdnlog
       with -f/etc/isdn/isdn.conf, and storing all options in this  file  in  section  [options].
       Read the man page for more details.

       Isdnlog  will  always  read  the /etc/isdn/isdn.conf config file for the sections [global]
       [variables] and [isdnlog]; it will ignore other sections.  To  make  isdnlog  process  the
       [options] section you must pass it with the -f option!

GLOBAL SECTION

       This section holds common information for all isdn programs. All settings are for EuroISDN
       (DSS1).

       AREACODE
              Telephone area code of your city. With 1TR6 ISDN protocol  you  must  specify  your
              whole telephone number (without MSN). Required.

       AREAPREFIX
              Prefix  for  area  code.  Default is "0". Your area code may start with this prefix
              (e.g. "0721" and "721" is the same area code). Optional.

       COUNTRYCODE
              Telephone country code (e.g. 49 for Germany). Required.

       COUNTRYPREFIX
              Prefix for country code. Default is "+". Your country  code  may  start  with  this
              prefix (e.g. "+49" and "49" is the same country code). Optional.

VARIABLES

       The ISDN tools allow to set variables and use them later. All variables must be uppercase.
       Example : "MYPATH = /home/foo".

ISDNLOG

       Settings for isdnlog.

       VBN    The initial numbers of  the  alternate  carrier  prefix  (to  choose  an  alternate
              telephone provider).  If there is more than one possible prefix, separate them with
              colons.

       VBNLEN The number of significant digits after the VBN  prefix  that  identify  the  chosen
              carrier  (provider).   If  there are different numbers possible, separate them with
              colons.

       PRESELECTED
              The default telephone carrier (provider), if no alternate carrier prefix is dialed.

       COUNTRYFILE
              Location and name of country.dat.  This file contains country names, aliases, codes
              and prefixes.

       RATECONF
              Location  and  name  of rate.conf.  This file defines booked providers and provider
              variants.

       RATEFILE
              Location and name of rate-CC.dat, where CC is your country code. This file contains
              all  the  connection  fees  for  all  providers  to various destinations at certain
              dates/times.  See rate-files(5) for more info.

       HOLIDAYS
              Name and location of holiday-CC.dat.

       ZONEFILE
              Name and location of zone-CC-PPP.cdb.  The provider PPP is taken from the D:-tag in
              rate-CC.dat  and  is  substituted  for  '%s'  in the configuration entry. This file
              contains domestic zone info for all areas of a country.

       DESTFILE
              Name and location of the destination database dest.cdb.

       LOGFILE
              Isdnlog will store a list of all calls in this file, and  isdnrep  will  read  this
              file  to  calculate  isdn  telephone costs. Default value is "/var/lib/isdn/calls".
              Optional.

       RELOADCMD
              Isdnlog can use this command to reactivate the isdn subsystem.   Default  value  is
              "reload". Optional.

       STOPCMD
              Isdnlog  can use this command to stop the isdn subsystem.  Default value is "stop".
              Optional.

       REBOOTCMD
              Isdnlog can use this command to reboot linux (when all else fails).  Default  value
              is "/sbin/reboot". Optional.

       CURRENCY
              Cost per charge unit and currency. Default is "0.12,DM".
              Note: the charge entry is not used anymore.

       CHARGEMAX
              Isdnlog  can  manage  your  isdn  costs  and  prevent you from spending more than a
              maximum per day. Unit is national currency. Example: In Germany  you  want  to  set
              CURRENCY  to  "0.12,DM" and CHARGEMAX to "15.00", so you will spend max.  15 DM per
              day.  Required.

       CONNECTMAX
              Isdnlog  can  also  limit  your  online  time  in  seconds  per  month.    Example:
              "CONNECTMAX=18000,0" will allow you to be 5 hours online per month. Optional.

       BYTEMAX
              Isdnlog  can  also  limit your transfer in bytes.  Example: "BYTEMAX=67108864" will
              limit your transfer to 64 MB per month. Optional.

       REPOPTIONS
              General commandline options for isdnrep. The  options  noted  here  have  the  same
              effect  as appended to each isdnrep commandline. Options are seperated by ; instead
              of the usual space.
              Example: "REPOPTIONS=-LP;-E" will turn off the provider  summary  and  show  failed
              calls. Optional.

       VBOXPATH
              Isdnrep can include information from the voice box system vbox in its report. To do
              this,      you      must      specify      the      vbox       spooldir       (e.g.
              VBOXPATH=/var/spool/vbox/foo/incoming). Optional.

       VBOXCMD1 VBOXCMD2
              Isdnrep  can  convert  vbox  messages.  To  do  this,  you should supply a command.
              VBOXCMD1 is used with old vbox files (<2.0), VBOXCMD2 is used with new  vbox  files
              (>=2.0). Example: "VBOXCMD1=/usr/bin/zyxeltowav".  Optional.

       MGETTYPATH
              Isdnrep  can  include  information  from the mgetty fax system in its report. To do
              this,      you      must      specify      the      mgetty      spooldir      (e.g.
              MGETTYPATH=/var/spool/fax/incoming). Optional.

       MGETTYCMD
              Isdnrep  can  convert  mgetty  fax  files. To do this, you should supply a command.
              Example: "MGETTYCMD=/usr/bin/g3tojpg". Optional.

       START = { ... }
              This option is ignored without -S flag or start=yes. Here you can instruct  isdnlog
              to  act  on  any  event  by  starting  a command. However, isdnlog can not react on
              outgoing connections from other isdn devices (e.g. an isdn  telephone).  Any  start
              commands  listed  here  are  used  for  all connections, including connections from
              unknown telephone numbers.  For more information, please read callerid.conf(5).

FORMAT OPTIONS

       You can specify different format strings for the way isdnlog  reports  incoming  messages,
       outgoing messages, isdnrep, and the WWW mode of isdnrep.

       REPFMT Format for isdnrep (normal mode). Default is "  %X %D %15.15H %T %-15.15F %7u %U %I
              %O".

       REPFMTWWW
              Format for isdnrep (WWW mode). Default is "%X %D %17.17H %T %-17.17F -20.20l SI: %S
              %9u %U %I %O".

       REPFMTxxx
              Additional format strings for isdnrep.

       ILABEL Format  for  isdnlog  (incoming  connections).   Isdnlog  will  add  the additional
              information such as RING, TIME, CONNECT ...

       OLABEL Format for  isdnlog  (outgoing  connections).   Isdnlog  will  add  the  additional
              information such as RING, TIME, CONNECT ...

       FORMAT MACROS
              You  can  build  the  format string for any combination of normal chars, digits and
              these special cookies:

       %t     tei

       %C     Call reference

       %Nx    Remote site's telephone number: %N0 exact number, %N1 isdnlog adds country and area
              prefix  to  number, %N2 isdnlog beautifies number and adds location, %N3 area code,
              %N4 number without area code, %N5 alias name, %N6 location, %N7 country code

       %nx    Local site's telephone number (encoding like %N).

       %cx    Telephone number as given by CLIP (encoding like %N).

       %A     the text " alias <MSN>" if CLIP message, otherwise empty.

       %I     Magic tab : empty if first active B-Channel, two blanks if second B-Channel,  "*  "
              if new connection (B-Channel not yet assigned).

       %a     Day of week (e.g. "Fri")

       %b     Month (e.g. "Aug")

       %e     Day of month (e.g. " 8")

       %T     time of day (e.g. "13:17:11")

       %B     B-channel (0 or 1)

       %k     Number of isdn card.

       %( %/ %)
              If  the  number  of  the  remote side is known: this char, i.e. the (, /, or ) that
              comes after the %.  If the number if not known, a blank is substituted.

EXAMPLE

       [GLOBAL]
       COUNTRYPREFIX=+
       AREAPREFIX=0
       COUNTRYCODE=49  # Germany
       AREACODE=0721   # Karlsruhe

       [VARIABLES]

       [ISDNLOG]
       VBN = 010
       VBNLEN = 2:3
       PRESELECTED = 33

       LOGFILE = /var/log/isdn.log
       ILABEL  = %b %e %T %ICall to tei %t from %N2 on %n2
       OLABEL  = %b %e %T %Itei %t calling %N2 with %n2
       REPFMTWWW       = "%X %D %17.17H %T %-17.17F %-20.20l SI: %S %9u %U %I %O"
       REPFMTSHORT     = "%X%D %8.8H %T %-14.14F%U%I %O"
       REPFMT  = "  %X %D %15.15H %T %-15.15F %7u %U %I %O"
       CHARGEMAX       = 50.00
       CURRENCY = 0.12,DEM

       COUNTRYFILE = /usr/share/isdn/country.dat
       RATECONF= /etc/isdn/rate.conf
       RATEFILE= /usr/share/isdn/rate-de.dat
       HOLIDAYS= /usr/share/isdn/holiday-de.dat
       ZONEFILE= /usr/share/isdn/zone-de-%s.cdb
       DESTFILE= /usr/share/isdn/dest.cdb

FILES

       /etc/isdn/isdn.conf
              This file.

SEE ALSO

       isdnlog(8) callerid.conf(5) rate-files(5) isdnrep(1)
       isdnformat(5) and samples/isdn.conf.*

AUTHOR

       This manual page was written  by  Andreas  Jellinghaus  <aj@dungeon.inka.de>,  for  Debian
       GNU/Linux  and  isdn4linux.  Now maintained by Paul Slootman <paul@isdn4linux.de>, updated
       by Leopold Toetsch <lt@toetsch.at>.