bionic (5) isdn.conf.5.gz

Provided by: isdnlog_3.25+dfsg1-9ubuntu2_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 one 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 separated 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>.