Ubuntu Manpage: /etc/isdn/isdn.conf - config file for isdnlog

Provided by: isdnlog_3.25+dfsg1-3.3ubuntu2_amd64

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

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