1callerid.conf(5) Linux System Administration callerid.conf(5)
2
3
4
6 /etc/isdn/callerid.conf - config file for isdnlog numbers and scripts
7
9 This file has the format described in isdnformat(5). It must be owned
10 by root, and only root may have write access. Every user can create his
11 private telephone book as ~/.isdn with the same file format.
12
14 Like in isdn.conf, this file has an optional [VARIABLES] section. All
15 variable names must be uppercase. Warning: variables in callerid.conf
16 will override variables in isdn.conf, and variables in ~/.isdn will
17 override variables in both files. First all variables are read, then
18 they are substituted, so a variable defined in ~/.isdn can be used in
19 isdn.conf. This might be a security hole. However, if programs are to
20 be run as root, these files (and the program) cannot be writable for
21 non-root users.
22
23 Using variables: if a reference to a non existing variable is used,
24 isdnrep and isdnlog will give warning messages, and use the variable
25 name (e.g if $FRED isn't set, isdnlog will use "$FRED"). The dollar
26 sign can be backslashed if a real dollar sign is needed instead of
27 variable substitution (e.g. \$PATH will be "$PATH").
28
30 In [NUMBER] sections, you can supply information for the outer world,
31 in [MSN] sections; you can supply information about your msns. The for‐
32 mat is the same:
33
34 NUMBER=xxxx
35 Set the telephone number. This should be your msn or the telephone
36 number with area code (with or without areprefix, countrycode and
37 countryprefix)
38
39 SI=x
40 Service indicator. Isdnlog knows these service indicators:
41 1 speech (telephone, fax g3, modem etc.)
42 2 restricted digital information
43 3 unrestricted digital information with tones/announcements
44 4 video
45 7 unrestricted digital information (hdlc, x.75 etc.)
46
47 Alias=xxxx
48 Supply a name as alias (e.g. ALIAS=Fred's Number)
49
50 ZONE=xxx
51 Only useful with remote numbers: billing zone for connections to
52 this number:
53 0 internal connection in your s0 bus (no charge)
54 1 city area
55 2 region 50
56 3 region 200
57 4 far region
58 5 the same as 1
59
60 INTERFACE=xxx
61 Isdn network interface. This information is required with the "-hx"
62 / hangup="value" option.
63
64 START
65 You can define a subsection here. The whole section is ignored
66 unless you gave the "-S" / start=yes option. Each subsection should
67 have the name [FLAG]. It may hold these values:
68
69 FLAGS=x|y|z
70 Combine these flags (with or without the pipe "|" char; with is
71 preferred) to get the combination you want:
72
73 Part 1: Incoming and Outgoing
74 I Incoming call
75 O Outgoing call
76
77 Part 2: Signals from isdn system
78 C Connect (can be used with interval, see below)
79 B Busy
80 E Error
81 R Ring (can be used with interval, see below)
82 A AOCD (advice of charge signal)
83 H Hangup
84
85 Part 3: Modifiers
86 L Start the program again and again every time it terminates.
87 U Start the program only once within a interval. Without
88 this, several instances of a program can run in parallel.
89 (Interval required.)
90 K Kill program at the end of the interval.
91
92 USER=xxx
93 Isdnlog will not run programs as root, and will switch to a
94 different user id for security. You must give the name or uid
95 of the user isdnlog has to use here.
96
97 GROUP=xxx
98 Isdnlog will not run programs as group root, and will switch to
99 a different group id for security. You must give the name or
100 gid of the groups isdnlog has to use here.
101
102 TIME=xx
103 Restrict this flag to a special time. Pleas read isdntime(5).
104
105 INTERVAL=xx
106 With connect (C) or ring (R) flag you can specify an interval,
107 so isdnlog will start the program after every interval. The
108 interval is in seconds and should be at least 2 seconds. If the
109 flags do not include C or R, this option is ignored.
110
111 PROGRAM=xxx
112 The program you want to start, with the required arguments. You
113 may use the following special tokens:
114
115 \$1 flags that caused execution, e.g. "IR", "OC". There are
116 always exactly two characters.
117 \$2 Caller number (complete with area code).
118 \$3 Called number (complete with area code).
119 \$4 Time the connection started. Example:
120 "Wed May 28 23:07:44 1997".
121 Contains "?" if there is no connection yet (e.g. still
122 at RING phase).
123 \$5 Duration of connection up to now (in seconds).
124 \$6 Time the connection ended. Same format as \$4.
125 \$7 Number of input bytes.
126 \$8 Number of output bytes.
127 \$9 Input bytes per second.
128 \$10 Output bytes per second.
129 \$11 Service indicator.
130 \$12 Charges.
131 \$13 Caller country code.
132 \$14 Called country code.
133 \$15 Caller area code.
134 \$16 Called area code.
135 \$17 Caller town (derived from area code).
136 \$18 Called town
137 \$19 Caller alias.
138 \$20 Called alias.
139
140 Note: within a string you must use \${1} \${2} ...
141
142
144 /etc/isdn/callerid.conf
145 This file.
146
147 ~/.isdn
148 Per user telephone book.
149
151 isdnlog(8) isdnformat(5) isdntime(5)
153 This manual page was written by Andreas Jellinghaus <aj@dun‐
154 geon.inka.de>, for Debian GNU/Linux and isdn4linux.
155
156
157
158ISDN 4 Linux 3.27 2000/09/15 callerid.conf(5)