/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  pro­
       grams. All settings are for EuroISDN (DSS1).

       AREACODE
              Telephone  area  code  of your city. With 1TR6 ISDN
              protocol you must specify your whole telephone num­
              ber (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 coun­
              try 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 dial prefix.   If  there
              is  more than one possible prefix, separate them by
              semicolons.

       VBNLEN The length of the VBN prefix.

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

              Location  and  name of country.dat.  This file con­
              tains 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/log/isdn.log". Optional.

       RELOADCMD
              Isdnlog can use this command to reactivate the isdn
              subsystem.  Default value is "/etc/rc.d/init.d/isdn
              restart". Optional.

       STOPCMD
              Isdnlog  can use this command to stop the isdn sub­
              system.  Default  value  is  "/etc/rc.d/init.d/isdn
              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.

              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  trans­
              fer to 64 MB per month. 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.    VBOX­
              PATH=/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/zyxel­
              towav".  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.       MGETTY­
              PATH=/var/spool/fax/incoming). Optional.

       MGETTYCMD
              Isdnrep  can  convert mgetty fax files. To do this,
              you should supply  a  command.   Example:  "MGETTY­
              CMD=/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 num­
              bers.   For  more  information,  please  read  cal­
              lerid.conf(5).


FORMAT OPTIONS

       You  can  specify  different  format  strings  for the way

       nrep, 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")


       %k     Number of isdn card.

       %( %/ %)
              if the number of the remote  side  is  known:  this
              char; a blank otherwise.


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/lib/isdn/country.dat
       RATECONF= /etc/isdn/rate.conf
       RATEFILE= /usr/lib/isdn/rate-de.dat
       HOLIDAYS= /usr/lib/isdn/holiday-de.dat
       ZONEFILE= /usr/lib/isdn/zone-de-%s.cdb
       DESTFILE= /usr/lib/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>.


Man(1) output converted with man2html