/etc/isdn/callerid.conf  - config file for isdnlog numbers
       and scripts


FORMAT

       This file has the format described  in  isdnformat(5).  It
       must  be  owned  by  root,  and  only  root may have write
       access. Every user can create his private  telephone  book
       as ~/.isdn with the same file format.


VARIABLES SECTION

       Like  in  isdn.conf, this file has an optional [VARIABLES]
       section. All variable names must  be  uppercase.  Warning:
       variables  in  callerid.conf  will  override  variables in
       isdn.conf, and variables in ~/.isdn  will  override  vari­
       ables  in  both  files. First all variables are read, then
       they are substituted, so a variable defined in ~/.isdn can
       be used in isdn.conf.  This might be a security hole. How­
       ever, if programs are to be run as root, these files  (and
       the program) cannot be writeable for non-root users.

       Using variables: if a reference to a non existing variable
       is used, isdnrep and isdnlog will give  warning  messages,
       and use the variable name (e.g if $FRED isn't set, isdnlog
       will use "$FRED"). The dollar sign can be backslashed if a
       real  dollar  sign is needed instead of variable substitu­
       tion (e.g. \$PATH will be "$PATH").


NUMBER and MSN

       In [NUMBER] sections, you can supply information  for  the
       outer world, in [MSN] sections; you can supply information
       about your msns. The format is the same:

       NUMBER=xxxx
           Set the telephone number. This should be your  msn  or
           the  telephone  number with area code (with or without
           areprefix, countrycode and countryprefix)

       SI=x
           Service indicator. Isdnlog knows these service indica­
           tors:
           1   speech (telephone, fax g3, modem etc.)
           2   restricted digital information
           3   unrestricted digital information with tones/announcements
           4   video
           7   unrestricted digital information (hdlc, x.75 etc.)

       Alias=xxxx
           Supply a name as alias (e.g. ALIAS=Fred's Number)

       ZONE=xxx
           Only useful with remote numbers: billing zone for con­
           nections to this number:
           0   internal connection in your s0 bus (no charge)

           2   region 50
           3   region 200
           4   far region
           5   the same as 1

       INTERFACE=xxx
           Isdn network interface. This information  is  required
           with the "-hx" / hangup="value" option.

       START
           You can define a subsection here. The whole section is
           ignored unless you gave the "-S" /  start=yes  option.
           Each  subsection  should  have the name [FLAG]. It may
           hold these values:

           FLAGS=x|y|z
               Combine these flags (with or without the pipe  "|"
               char;  with  is  preferred) to get the combination
               you want:

               Part 1: Incoming and Outgoing
               I   Incoming call
               O   Outgoing call

               Part 2: Signals from isdn system
               C   Connect (can be used with interval, see below)
               B   Busy
               E   Error
               R   Ring (can be used with interval, see below)
               A   AOCD (advice of charge signal)
               H   Hangup

               Part 3: Modifiers
               L   Start  the  program again and again every time
                   it terminates.
               U   Start the program only once within a interval.
                   Without  this,  several instances of a program
                   can run in parallel. (Interval required.)
               K   Kill program at the end of the interval.

           USER=xxx
               Isdnlog will not run programs as  root,  and  will
               switch  to  a  different user id for security. You
               must give the name or uid of the user isdnlog  has
               to use here.

           GROUP=xxx
               Isdnlog  will  not run programs as group root, and
               will switch to a different group id for  security.
               You  must  give  the  name  or  gid  of the groups
               isdnlog has to use here.

               Restrict this flag to a special time.  Pleas  read
               isdntime(5).

           INTERVAL=xx
               With  connect (C) or ring (R) flag you can specify
               an interval, so isdnlog  will  start  the  program
               after  every  interval. The interval is in seconds
               and should be at least 2 seconds. If the flags  do
               not include C or R, this option is ignored.

           PROGRAM=xxx
               The  program  you want to start, with the required
               arguments.  You  may  use  the  following  special
               tokens:

               \$1    flags  that  caused  execution,  e.g. "IR",
                      "OC". There are always exactly two  charac­
                      ters.
               \$2    Caller number (complete with area code).
               \$3    Called number (complete with area code).
               \$4    Time the connection started. Example:
                      "Wed May 28 23:07:44 1997".
                      Contains  "?" if there is no connection yet
                      (e.g. still at RING phase).
               \$5    Duration of connection up to now  (in  sec­
                      onds).
               \$6    Time  the  connection ended. Same format as
                      \$4.
               \$7    Number of input bytes.
               \$8    Number of output bytes.
               \$9    Input bytes per second.
               \$10   Output bytes per second.
               \$11   Service indicator.
               \$12   Charges.
               \$13   Caller country code.
               \$14   Called country code.
               \$15   Caller area code.
               \$16   Called area code.
               \$17   Caller town (derived from area code).
               \$18   Called town
               \$19   Caller alias.
               \$20   Called alias.

               Note: within a string you must use \${1} \${2} ...


FILES

       /etc/isdn/callerid.conf
              This file.

       ~/.isdn
              Per user telephone book.

       isdnlog(8) isdnformat(5) isdntime(5)

AUTHOR

       This  manual  page  was  written  by  Andreas  Jellinghaus
       <aj@dungeon.inka.de>, for Debian GNU/Linux and isdn4linux.


Man(1) output converted with man2html