*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->FreeBSD man pages -> isdnd (8)              



NAME    [Toc]    [Back]

     isdnd -- isdn4bsd ISDN connection management daemon

SYNOPSIS    [Toc]    [Back]

     isdnd [-c configfile] [-d debuglevel] [-f] [-F] [-l] [-L logfile] [-P]
	   [-r device] [-s facility] [-t terminaltype]
	   [-u charging unit length] [-m]

DESCRIPTION    [Toc]    [Back]

     The isdnd utility is the isdn4bsd package daemon which manages all ISDN
     related connection and disconnection of ISDN devices supported by the

     The options are as follows:

     -c      Use configfile as the name of the runtime configuration filename
	     for isdnd instead of the default file /etc/isdn/isdnd.rc.

     -d      If debugging support is compiled into isdnd this option is used
	     to specify the debugging level, or better which kind of debugging
	     messages are displayed.  The debugging level is the sum of the
	     following values:

		   0x001   general debugging.
		   0x002   rates calculation.
		   0x004   timing calculations.
		   0x008   state transitions.
		   0x010   retry handling.
		   0x020   dialing.
		   0x040   process handling.
		   0x080   isdn4bsd kernel i/o calls.
		   0x100   controller and channel busy/free messages.
		   0x200   isdnd.rc configuration file processing.
		   0x400   outgoing call budget handling.
		   0x800   valid keyword and holiday file processing.

	     The value can be specified in any number base supported by the
	     sscanf(3) library routine.

	     In addition, this option accepts also the character 'n' as an
	     argument to disable displaying debug messages on the full-screen

     -f      Specifying this option causes isdnd to enter the full-screen mode
	     of operation.  When operating in this mode, entering the control
	     character Control-L causes the display to be refreshed and entering
 Carriage-Return or Enter will pop-up a command window.
	     Because the isdnd utility will not listen to messages while the
	     command window is active, this command window will disappear
	     automatically after 5 seconds without any command key press.

	     While the command window is active, Tab or Space advances to the
	     next menu item.  To execute a command, press Return or Enter for
	     the highlighted menu item, or enter the number corresponding to
	     the item to be executed or enter the capitalized character in the
	     menu item description.

     -l      If this option is set, logging is not done via the syslogd(8)
	     facility but instead is appended to a file.

     -L      Specifies the name of the logfile which is used when the option
	     -l is set.  See also the keyword rotatesuffix in the system section
 of isdnd.rc(5).

     -P      This option prints out the parsed and verified isdnd configuration
 in the same format as the isdnd.rc file.  This output can be
	     used as an isdnd.rc file.	This feature is especially useful when
	     debugging an isdnd.rc file to see, what the default settings of
	     options are when they are not set in the isdnd.rc input file.

	     The isdnd exits after the printout is done.

     -F      This option prevents isdnd to detach from the controlling tty and
	     become a daemon.

     -r      In conjunction with the -t option, device specifies a terminal
	     device which becomes the controlling tty for isdnd and on which
	     the full-screen mode output is displayed.

     -s      This option may be used to specify the logging facility in case
	     syslog(3) logging is configured and another facility than the
	     default LOCAL0 facility shall be used.  The facility is to be
	     specified as an integer in the range 0-11 or 16-23 (see the file

     -t      In conjunction with the -f and -r options, terminaltype specifies
	     a terminal type or termcap entry name (such as vt220) for the
	     device used for isdnd full-screen output.	This is useful if an
	     unused (no getty running) tty line is used for full-screen output
	     for which no TERM environment variable exists.

     -u      Specifies the length of a charging unit in case the config file
	     entry keyword unitlenghtsrc is set to cmdl.

     -m      If the isdn daemon is compiled with local or remote monitoring
	     support, this option disables all monitoring access.  It overrides
 the config file option monitor-allowed.


     The isdnd utility communicates with the kernel part of isdn4bsd by
     receiving status and event messages (read(2) from device /dev/i4b) and by
     transmitting commands and responses (ioctl(2) from device /dev/i4b).

     The messages and message parameters are documented in the include file

     Supported command and response messages (ioctls) to the kernel are:
		   Request a unique Call Description IDentifier (cdid) which
		   identifies uniquely a single interaction of the local D
		   channel with the exchange.
		   Actively request a call setup to a remote ISDN subscriber.
		   Respond to an incoming call, either accept, reject or
		   ignore it.
		   Actively terminate a connection.
		   Request information about an installed ISDN controller
		   Give information about call setup to driver who requested
		   dialing out.
		   Update the kernels timeout value(s) in case of dynamically
		   calculated shorthold mode timing changes.
		   Inform the kernel userland drivers about interface soft
		   up/down status changes.
		   Download firmware to active card(s).
		   Return diagnostic information from active cards.

     Supported status and event messages from the kernel are:
		   An incoming call from a remote ISDN user is indicated.
		   After an incoming call has been accepted locally or an outgoing
 call has been accepted by a remote, the exchange signaled
 an active connection and the corresponding B-channel
		   is switched through.
		   A call was terminated.
		   A userland interface driver requests the daemon to dial out
		   (typically a network interface when a packet arrives in its
		   send queue).
		   A call was terminated by the isdn4bsd kernel driver because
		   a B-channel idle timeout occurred.
		   Accounting information from a network driver.
		   Charging information from the kernel.

   OUTGOING CALLS    [Toc]    [Back]
     Currently the only possibility to trigger an outgoing call is that an
     isdn4bsd network driver (ipr<n>) sends a MSG_DIALOUT_IND to the isdnd

     The daemon requests a new CDID from the kernel by using the I4B_CDID_REQ
     ioctl message, this CDID is now used in all interactions with the kernel
     to identify this single call until a disconnect occurs.

     After getting the CDID, the daemon looks up several additional information
 in its entry section of the configuration corresponding to that connection
 and issues a I4B_CONNECT_REQ ioctl message to the kernel.	The
     kernel now dials the remote side and if the remote side accepts the call,
     the kernel sends a MSG_CONNECT_ACTIVE_IND to the daemon.

     The call is terminated by either the local side timing out or the remote
     side hanging up the connection or the local side actively sending a
     I4B_DISCONNECT_REQ ioctl message, both events are signaled to the isdnd
     by the kernel sending the I4B_DISCONNECT_IND message and the CDID corresponding
 to the call is no longer valid.

   INCOMING CALLS    [Toc]    [Back]
     Incoming calls are signaled to the isdnd by the kernel transmitting the
     MSG_CONNECT_IND message to the daemon.

     With the information contained in this message, the isdnd searches the
     entry section of its configuration database and if a match is found, it
     accepts or rejects the call or, if no match is found, it ignores the call
     - all by issuing a I4B_CONNECT_RESP ioctl message with the appropriate
     parameters to the kernel.

     In case the daemon decided to accept the call, the kernel signals this by
     sending a MSG_CONNECT_ACTIVE_IND message to the daemon.

     The call is terminated by either the local side timing out or the remote
     side hanging up the connection or the local side actively sending a
     I4B_DISCONNECT_REQ ioctl message, both events are signaled to the isdnd
     by the kernel sending the I4B_DISCONNECT_IND message and the CDID corresponding
 to the call is no longer valid.

SIGNALS    [Toc]    [Back]

     Sending a HUP signal to isdnd causes all open connections to be terminated
 and the configuration file is reread.  In case aliasfile handling
     was enabled, the aliasfile is also reread.

     Sending a USR1 signal to isdnd causes the accounting file and the logfile
     (if logging to a file is used instead of logging via the syslog(3) facility)
 to be closed and reopened to make logfile rotation possible.

ENVIRONMENT    [Toc]    [Back]

     The following environment variables affect the execution of isdnd:

     TERM    The terminal type when running in full-screen display mode.  See
	     environ(7) for more information.

FILES    [Toc]    [Back]

     /dev/i4b		    The device-file used to communicate with the kernel
 ISDN driver subsystem.

     /var/log/messages	    A record of the actions in case of syslogd logging

     /var/log/isdnd.acct    The default accounting information filename (if
			    accounting is configured).

     /var/log/isdnd.log     The default logging filename (if logging to a file
			    is configured).

     /var/run/isdnd.pid     The process id of the isdn daemon (also known as
			    "lockfile" to isdnd, preventing multiple invocations
 of it).


     /etc/isdn		    The directory where isdnd expects some supplementary
 data files and programs for telephone answering

     /etc/isdn/isdnd.rc     The default runtime configuration file.

     /etc/isdn/isdnd.rates  The default unit charging rates specification

			    The default table (if aliasing is enabled) to convert
 phone number to caller's name.

EXAMPLES    [Toc]    [Back]

     For a first try, the following command should be used to start isdnd in
     foreground mode for better debugging the configuration setup:

	   isdnd -d0xf9 -F

     This will start isdnd with reasonable debugging settings and produce output
 on the current terminal.  The isdnd utility can then be terminated by
     entering Control-C.

     Another example, the command:

	   isdnd -d0xf9 -f -r /dev/ttyv3 -t vt100

     will start isdnd with reasonable debugging messages enabled, full-screen
     mode of operation, full-screen display redirected to /dev/ttyv3 and using
     a termcap entry for vt100 on this display.

DIAGNOSTICS    [Toc]    [Back]

     Exit status is 0 on success, 1 on error.

SEE ALSO    [Toc]    [Back]

     i4bing(4), i4bipr(4), i4bisppp(4), isdnd.rates(5), isdnd.rc(5),
     isdntel(8), isdntrace(8), syslogd(8)

BUGS    [Toc]    [Back]

     Still one or more left.

AUTHORS    [Toc]    [Back]

     The isdnd utility and this manual page were written by Hellmuth Michaelis

FreeBSD 5.2.1			  May 2, 2001			 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
isdnd.rc FreeBSD isdn4bsd ISDN connection management daemon config file format
isdnd.acct FreeBSD isdn4bsd ISDN management daemon accounting file format
isdnd.rates FreeBSD isdn4bsd ISDN management daemon rates description file
EvmConnection Tru64 Connection to the Event Management daemon
isdndecode FreeBSD isdn4bsd ISDN protocol decode utility
i4b FreeBSD isdn4bsd call control ISDN driver
i4brbch FreeBSD isdn4bsd ISDN Raw B-CHannel access driver
i4bipr FreeBSD isdn4bsd IP over ISDN B-channel network driver
isdntrace FreeBSD isdn4bsd ISDN protocol trace utility
i4bing FreeBSD isdn4bsd NetGraph ISDN B-channel interface driver
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service