2 .\" Copyright (c) 1997, 2001 Hellmuth Michaelis. All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 .\" $Id: isdnd.8,v 1.29 2000/05/02 11:50:28 hm Exp $
29 .\" last edit-date: [Wed May 2 10:48:30 2001]
36 .Nd isdn4bsd ISDN connection management daemon
39 .Op Fl c Ar configfile
40 .Op Fl d Ar debuglevel
48 .Op Fl t Ar terminaltype
49 .Op Fl u Ar charging unit length
55 is the isdn4bsd package daemon which manages all ISDN related connection
56 and disconnection of ISDN devices supported by the package.
58 The options are as follows:
63 as the name of the runtime configuration filename for
65 instead of the default file
66 .Li /etc/isdn/isdnd.rc .
68 If debugging support is compiled into
70 this option is used to specify the debugging level, or better which kind
71 of debugging messages are displayed.
72 The debugging level is the sum of the
75 .Bl -tag -width Ds -compact -offset indent
91 isdn4bsd kernel i/o calls.
93 controller and channel busy/free messages.
95 isdnd.rc configuration file processing.
97 outgoing call budget handling.
99 valid keyword and holiday file processing.
102 The value can be specified in any number base supported by the
106 In addition, this option accepts also the character 'n' as an argument to
107 disable displaying debug messages on the full-screen display.
110 Specifying this option causes
112 to enter the full-screen mode of operation.
113 When operating in this mode,
114 entering the control character
116 causes the display to be refreshed and entering
120 will pop-up a command window.
123 utility will not listen to messages while the command window is active,
124 this command window will disappear automatically after 5 seconds without
125 any command key press.
127 While the command window is active,
131 advances to the next menu item.
132 To execute a command, press
136 for the highlighted menu item, or enter the number corresponding to the
137 item to be executed or enter the capitalized character in the menu item
140 If this option is set, logging is not done via the
142 facility but instead is appended to a file.
144 Specifies the name of the logfile which is used when the option
149 in the system section of
152 This option prints out the parsed and verified isdnd configuration in the same
153 format as the isdnd.rc file.
154 This output can be used as an isdnd.rc file.
156 feature is especially useful when debugging an isdnd.rc file to see, what the
157 default settings of options are when they are not set in the isdnd.rc input
162 exits after the printout is done.
166 to detach from the controlling tty and become a daemon.
168 In conjunction with the
172 specifies a terminal device which becomes the controlling tty for
174 and on which the full-screen mode output is displayed.
176 This option may be used to specify the logging facility in case
178 logging is configured and another facility than the default LOCAL0
179 facility shall be used.
180 The facility is to be specified as an integer in
181 the range 0-11 or 16-23 (see the file /usr/include/syslog.h).
183 In conjunction with the
189 specifies a terminal type or termcap entry name (such as vt220) for the device
193 This is useful if an unused (no getty running) tty line is
194 used for full-screen output for which no
196 environment variable exists.
198 Specifies the length of a charging unit in case the config file entry
204 If the isdn daemon is compiled with local or remote monitoring support,
205 this option disables all monitoring access.
206 It overrides the config
208 .Em monitor-allowed .
210 .Sh INTERACTION WITH THE KERNEL
214 communicates with the kernel part of isdn4bsd by receiving status and
219 and by transmitting commands and responses
224 The messages and message parameters are documented in the include
226 .Em /usr/include/i4b/i4b_ioctl.h .
228 Supported command and response messages (ioctls) to the kernel are:
229 .Bl -tag -width Ds -compact -offset indent
231 Request a unique Call Description IDentifier (cdid) which identifies
232 uniquely a single interaction of the local D channel with the exchange.
233 .It Ar I4B_CONNECT_REQ
234 Actively request a call setup to a remote ISDN subscriber.
235 .It Ar I4B_CONNECT_RESP
236 Respond to an incoming call, either accept, reject or ignore it.
237 .It Ar I4B_DISCONNECT_REQ
238 Actively terminate a connection.
239 .It Ar I4B_CTRL_INFO_REQ
240 Request information about an installed ISDN controller card.
241 .It Ar I4B_DIALOUT_RESP
242 Give information about call setup to driver who requested dialing out.
243 .It Ar I4B_TIMEOUT_UPD
244 Update the kernels timeout value(s) in case of dynamically calculated
245 shorthold mode timing changes.
246 .It Ar I4B_UPDOWN_IND
247 Inform the kernel userland drivers about interface soft up/down status
249 .It Ar I4B_CTRL_DOWNLOAD
250 Download firmware to active card(s).
251 .It Ar I4B_ACTIVE_DIAGNOSTIC
252 Return diagnostic information from active cards.
256 Supported status and event messages from the kernel are:
257 .Bl -tag -width Ds -compact -offset indent
258 .It Ar MSG_CONNECT_IND
259 An incoming call from a remote ISDN user is indicated.
260 .It Ar MSG_CONNECT_ACTIVE_IND
261 After an incoming call has been accepted locally or an outgoing call has
262 been accepted by a remote, the exchange signaled an active connection
263 and the corresponding B-channel is switched through.
264 .It Ar MSG_DISCONNECT_IND
265 A call was terminated.
266 .It Ar MSG_DIALOUT_IND
267 A userland interface driver requests the daemon to dial out (typically a
268 network interface when a packet arrives in its send queue).
269 .It Ar MSG_IDLE_TIMEOUT_IND
270 A call was terminated by the isdn4bsd kernel driver because a B-channel
271 idle timeout occurred.
273 Accounting information from a network driver.
274 .It Ar MSG_CHARGING_IND
275 Charging information from the kernel.
279 Currently the only possibility to trigger an outgoing call is that an
280 isdn4bsd network driver
288 The daemon requests a new CDID from the kernel by using the
290 ioctl message, this CDID is now used in all interactions with the kernel
291 to identify this single call until a disconnect occurs.
293 After getting the CDID, the daemon looks up several additional information
294 in its entry section of the configuration corresponding to that connection
297 ioctl message to the kernel.
298 The kernel now dials the remote side and
299 if the remote side accepts the call, the kernel sends a
300 .Em MSG_CONNECT_ACTIVE_IND
303 The call is terminated by either the local side timing out or the remote
304 side hanging up the connection or the local side actively sending a
305 .Em I4B_DISCONNECT_REQ
306 ioctl message, both events are signaled to the
308 by the kernel sending the
309 .Em I4B_DISCONNECT_IND
310 message and the CDID corresponding to the call is no longer valid.
313 Incoming calls are signaled to the
315 by the kernel transmitting the
317 message to the daemon.
319 With the information contained in this message, the
321 searches the entry section of its configuration database and if a match is
322 found, it accepts or rejects the call or, if no match is found, it ignores the
323 call - all by issuing a
325 ioctl message with the appropriate parameters to the kernel.
327 In case the daemon decided to accept the call, the kernel signals this
329 .Em MSG_CONNECT_ACTIVE_IND
330 message to the daemon.
332 The call is terminated by either the local side timing out or the remote
333 side hanging up the connection or the local side actively sending a
334 .Em I4B_DISCONNECT_REQ
335 ioctl message, both events are signaled to the
337 by the kernel sending the
338 .Em I4B_DISCONNECT_IND
339 message and the CDID corresponding to the call is no longer valid.
341 Sending a HUP signal to
343 causes all open connections to be terminated and the configuration file is
345 In case aliasfile handling was enabled, the aliasfile is also
348 Sending a USR1 signal to
350 causes the accounting file and the logfile (if logging to a file is used
351 instead of logging via the
353 facility) to be closed and reopened to make logfile rotation possible.
355 The following environment variables affect the execution of
359 The terminal type when running in full-screen display mode.
362 for more information.
365 .Bl -tag -width /etc/isdn/isdnd.rates
367 The device-file used to communicate with the kernel ISDN driver subsystem.
368 .It Pa /var/log/messages
369 A record of the actions in case of syslogd logging support.
370 .It Pa /var/log/isdnd.acct
371 The default accounting information filename (if accounting is configured).
372 .It Pa /var/log/isdnd.log
373 The default logging filename (if logging to a file is configured).
374 .It Pa /var/run/isdnd.pid
375 The process id of the isdn daemon (also known as "lockfile" to isdnd, preventing multiple invocations of it).
376 .It Pa /usr/local/lib/isdn
378 The directory where isdnd expects some supplementary data files and programs
379 for telephone answering support.
380 .It Pa /etc/isdn/isdnd.rc
381 The default runtime configuration file.
382 .It Pa /etc/isdn/isdnd.rates
383 The default unit charging rates specification file.
384 .It Pa /etc/isdn/isdntel.alias
385 The default table (if aliasing is enabled) to convert phone number to caller's name.
388 Exit status is 0 on success, 1 on error.
390 For a first try, the following command should be used to start
392 in foreground mode for better debugging the configuration setup:
393 .Bd -literal -offset indent
397 This will start isdnd with reasonable debugging settings and produce
398 output on the current terminal.
401 utility can then be terminated by entering Control-C.
403 Another example, the command:
404 .Bd -literal -offset indent
405 isdnd -d0xf9 -f -r /dev/ttyv3 -t vt100
410 with reasonable debugging messages enabled, full-screen mode of operation,
411 full-screen display redirected to /dev/ttyv3 and using a termcap entry
412 for vt100 on this display.
425 utility and this manual page were written by
426 .An Hellmuth Michaelis Aq hm@FreeBSD.org .
428 Still one or more left.