Provided by: isdnlog_3.12.20071127-0ubuntu1_i386 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>.