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