1isdn.conf(5)              Linux System Administration             isdn.conf(5)
2
3
4

NAME

6       /etc/isdn/isdn.conf - config file for isdnlog
7

FORMAT

9       The  config file has the format described in isdnformat(5). I recommend
10       starting isdnlog with -f/etc/isdn/isdn.conf, and storing all options in
11       this file in section [options]. Read the man page for more details.
12
13       Isdnlog  will  always  read the /etc/isdn/isdn.conf config file for the
14       sections [global] [variables] and [isdnlog]; it will ignore other  sec‐
15       tions.   To make isdnlog process the [options] section you must pass it
16       with the -f option!
17

GLOBAL SECTION

19       This section holds common information for all isdn programs.  All  set‐
20       tings are for EuroISDN (DSS1).
21
22       AREACODE
23              Telephone  area  code  of your city. With 1TR6 ISDN protocol you
24              must  specify  your  whole  telephone  number   (without   MSN).
25              Required.
26
27       AREAPREFIX
28              Prefix  for  area code. Default is "0". Your area code may start
29              with this prefix (e.g. "0721" and "721" is the same area  code).
30              Optional.
31
32       COUNTRYCODE
33              Telephone country code (e.g. 49 for Germany). Required.
34
35       COUNTRYPREFIX
36              Prefix  for  country code. Default is "+". Your country code may
37              start with this prefix (e.g. "+49" and "49" is the same  country
38              code). Optional.
39

VARIABLES

41       The ISDN tools allow to set variables and use them later. All variables
42       must be uppercase. Example : "MYPATH = /home/foo".
43

ISDNLOG

45       Settings for isdnlog.
46
47       VBN    The initial numbers of the alternate carrier prefix  (to  choose
48              an  alternate  telephone  provider).   If there is more than one
49              possible prefix, separate them with colons.
50
51       VBNLEN The number of significant digits after the VBN prefix that iden‐
52              tify the chosen carrier (provider).  If there are different num‐
53              bers possible, separate them with colons.
54
55       PRESELECTED
56              The default telephone carrier (provider), if no  alternate  car‐
57              rier prefix is dialed.
58
59       COUNTRYFILE
60              Location  and  name  of country.dat.  This file contains country
61              names, aliases, codes and prefixes.
62
63       RATECONF
64              Location and  name  of  rate.conf.   This  file  defines  booked
65              providers and provider variants.
66
67       RATEFILE
68              Location and name of rate-CC.dat, where CC is your country code.
69              This file contains all the connection fees for all providers  to
70              various  destinations at certain dates/times.  See rate-files(5)
71              for more info.
72
73       HOLIDAYS
74              Name and location of holiday-CC.dat.
75
76       ZONEFILE
77              Name and location of zone-CC-PPP.cdb.  The provider PPP is taken
78              from  the  D:-tag  in rate-CC.dat and is substituted for '%s' in
79              the configuration entry. This file contains domestic  zone  info
80              for all areas of a country.
81
82       DESTFILE
83              Name and location of the destination database dest.cdb.
84
85       LOGFILE
86              Isdnlog will store a list of all calls in this file, and isdnrep
87              will read this file to calculate isdn telephone  costs.  Default
88              value is "/var/log/isdn.log". Optional.
89
90       RELOADCMD
91              Isdnlog  can  use this command to reactivate the isdn subsystem.
92              Default value is "/etc/rc.d/init.d/isdn restart". Optional.
93
94       STOPCMD
95              Isdnlog can  use  this  command  to  stop  the  isdn  subsystem.
96              Default value is "/etc/rc.d/init.d/isdn stop". Optional.
97
98       REBOOTCMD
99              Isdnlog  can  use  this  command  to reboot Linux (when all else
100              fails).  Default value is "/sbin/reboot". Optional.
101
102       CURRENCY
103              Cost per charge unit and currency. Default is "0.12,DM".
104              Note: the charge entry is not used anymore.
105
106       CHARGEMAX
107              Isdnlog can manage your isdn costs and prevent you from spending
108              more than a maximum per day. Unit is national currency. Example:
109              In Germany you want to set CURRENCY to "0.12,DM"  and  CHARGEMAX
110              to "15.00", so you will spend max.  15 DM per day.  Required.
111
112       CONNECTMAX
113              Isdnlog  can  also  limit your online time in seconds per month.
114              Example: "CONNECTMAX=18000,0" will  allow  you  to  be  5  hours
115              online per month. Optional.
116
117       BYTEMAX
118              Isdnlog  can  also  limit  your  transfer  in  bytes.   Example:
119              "BYTEMAX=67108864" will limit your transfer to 64 MB per  month.
120              Optional.
121
122       REPOPTIONS
123              General  commandline options for isdnrep. The options noted here
124              have the same effect as appended to  each  isdnrep  commandline.
125              Options are separated by ; instead of the usual space.
126              Example:  "REPOPTIONS=-LP;-E" will turn off the provider summary
127              and show failed calls. Optional.
128
129       VBOXPATH
130              Isdnrep can include information from the voice box  system  vbox
131              in  its  report.  To do this, you must specify the vbox spooldir
132              (e.g.  VBOXPATH=/var/spool/vbox/foo/incoming). Optional.
133
134       VBOXCMD1 VBOXCMD2
135              Isdnrep can convert vbox messages. To do this, you should supply
136              a command. VBOXCMD1 is used with old vbox files (<2.0), VBOXCMD2
137              is  used  with  new  vbox   files   (>=2.0).   Example:   "VBOX‐
138              CMD1=/usr/bin/zyxeltowav".  Optional.
139
140       MGETTYPATH
141              Isdnrep  can  include  information from the mgetty fax system in
142              its report. To do this, you must  specify  the  mgetty  spooldir
143              (e.g.  MGETTYPATH=/var/spool/fax/incoming). Optional.
144
145       MGETTYCMD
146              Isdnrep  can  convert  mgetty  fax files. To do this, you should
147              supply  a   command.    Example:   "MGETTYCMD=/usr/bin/g3tojpg".
148              Optional.
149
150       START = { ... }
151              This  option  is  ignored without -S flag or start=yes. Here you
152              can instruct isdnlog to act on any event by starting a  command.
153              However,  isdnlog  can  not  react  on outgoing connections from
154              other isdn devices (e.g. an isdn telephone). Any start  commands
155              listed  here are used for all connections, including connections
156              from unknown telephone numbers.  For  more  information,  please
157              read callerid.conf(5).
158

FORMAT OPTIONS

160       You  can  specify  different format strings for the way isdnlog reports
161       incoming messages, outgoing messages, isdnrep, and the WWW mode of isd‐
162       nrep.
163
164       REPFMT Format for isdnrep (normal mode). Default is "  %X %D %15.15H %T
165              %-15.15F %7u %U %I %O".
166
167       REPFMTWWW
168              Format for isdnrep (WWW mode). Default  is  "%X  %D  %17.17H  %T
169              %-17.17F -20.20l SI: %S %9u %U %I %O".
170
171       REPFMTxxx
172              Additional format strings for isdnrep.
173
174       ILABEL Format for isdnlog (incoming connections).  Isdnlog will add the
175              additional information such as RING, TIME, CONNECT ...
176
177       OLABEL Format for isdnlog (outgoing connections).  Isdnlog will add the
178              additional information such as RING, TIME, CONNECT ...
179
180       FORMAT MACROS
181              You  can  build  the format string for any combination of normal
182              chars, digits and these special cookies:
183
184       %t     tei
185
186       %C     Call reference
187
188       %Nx    Remote site's telephone number: %N0 exact  number,  %N1  isdnlog
189              adds  country  and area prefix to number, %N2 isdnlog beautifies
190              number and adds location, %N3 area code, %N4 number without area
191              code, %N5 alias name, %N6 location, %N7 country code
192
193       %nx    Local site's telephone number (encoding like %N).
194
195       %cx    Telephone number as given by CLIP (encoding like %N).
196
197       %A     the text " alias <MSN>" if CLIP message, otherwise empty.
198
199       %I     Magic  tab : empty if first active B-Channel, two blanks if sec‐
200              ond B-Channel,  "*  "  if  new  connection  (B-Channel  not  yet
201              assigned).
202
203       %a     Day of week (e.g. "Fri")
204
205       %b     Month (e.g. "Aug")
206
207       %e     Day of month (e.g. " 8")
208
209       %T     time of day (e.g. "13:17:11")
210
211       %B     B-channel (0 or 1)
212
213       %k     Number of isdn card.
214
215       %( %/ %)
216              If  the  number of the remote side is known: this char, i.e. the
217              (, /, or ) that comes after the %.  If the number if not  known,
218              a blank is substituted.
219

EXAMPLE

221       [GLOBAL]
222       COUNTRYPREFIX=+
223       AREAPREFIX=0
224       COUNTRYCODE=49  # Germany
225       AREACODE=0721   # Karlsruhe
226
227       [VARIABLES]
228
229       [ISDNLOG]
230       VBN = 010
231       VBNLEN = 2:3
232       PRESELECTED = 33
233
234       LOGFILE = /var/log/isdn.log
235       ILABEL  = %b %e %T %ICall to tei %t from %N2 on %n2
236       OLABEL  = %b %e %T %Itei %t calling %N2 with %n2
237       REPFMTWWW       = "%X %D %17.17H %T %-17.17F %-20.20l SI: %S %9u %U %I %O"
238       REPFMTSHORT     = "%X%D %8.8H %T %-14.14F%U%I %O"
239       REPFMT  = "  %X %D %15.15H %T %-15.15F %7u %U %I %O"
240       CHARGEMAX       = 50.00
241       CURRENCY = 0.12,DEM
242
243       COUNTRYFILE = /usr/share/isdn/country.dat
244       RATECONF= /etc/isdn/rate.conf
245       RATEFILE= /usr/share/isdn/rate-de.dat
246       HOLIDAYS= /usr/share/isdn/holiday-de.dat
247       ZONEFILE= /usr/share/isdn/zone-de-%s.cdb
248       DESTFILE= /usr/share/isdn/dest.cdb
249
250

FILES

252       /etc/isdn/isdn.conf
253              This file.
254

SEE ALSO

256       isdnlog(8) callerid.conf(5) rate-files(5) isdnrep(1)
257       isdnformat(5) and samples/isdn.conf.*
258

AUTHOR

260       This   manual   page   was  written  by  Andreas  Jellinghaus  <aj@dun‐
261       geon.inka.de>, for Debian GNU/Linux and isdn4linux.  Now maintained  by
262       Paul   Slootman   <paul@isdn4linux.de>,   updated  by  Leopold  Toetsch
263       <lt@toetsch.at>.
264
265
266
267ISDN 4 Linux 3.13                 2004/07/24                      isdn.conf(5)
Impressum